"Fossies" - the Fresh Open Source Software Archive

Member "dx-4.4.4/help/dxall780" (5 Feb 2002, 7299 Bytes) of package /linux/misc/old/dx-4.4.4.tar.gz:


As a special service "Fossies" has tried to format the requested text file into HTML format (style: standard) with prefixed line numbers. Alternatively you can here view or download the uninterpreted source code file.

    1 #!F-adobe-helvetica-medium-r-normal--18*
    2 #!N 
    3 #!N  #!Rcamera Camera #!N #!N Category #!N #!N 
    4  #!Lcatren,dxall760 h Rendering  #!EL  #!N #!N Function #!N #!N Constructs a camera for viewing 
    5 an object. #!N #!N Syntax #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   #!N 
    6 camera #!EF = Camera(  #!F-adobe-times-bold-r-normal--18*   to, from, width, resolution, aspect, up, 
    7 #!N perspective, angle, background #!EF ); #!EF #!N #!N #!EC #!N 
    8 #!N Inputs #!T,1,91,276,461,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N TAB Name TAB Type TAB 
    9 Default TAB Description #!EF #!N TAB to TAB vector or object 
   10 TAB [0 0 0] TAB look-to point #!N TAB from TAB 
   11 vector or object TAB [0 0 1] TAB position of camera 
   12 #!N TAB width TAB scalar or object TAB 100 TAB width 
   13 of field of view (for #!N TAB - TAB - TAB 
   14 - TAB orthographic projection) #!N TAB resolution TAB integer TAB 640 
   15 TAB horizontal resolution of image (in #!N TAB - TAB - 
   16 TAB - TAB pixels) #!N TAB aspect TAB scalar TAB 0.75 
   17 TAB height/width #!N TAB up TAB vector TAB [0 1 0] 
   18 TAB up direction #!N TAB perspective TAB flag TAB 0 TAB 
   19 0: orthographic projection #!N TAB - TAB - TAB - TAB 
   20 1: perspective projection #!N TAB angle TAB scalar TAB 30.0 TAB 
   21 view angle (in degrees) (for #!N TAB - TAB - TAB 
   22 - TAB perspective projection) #!N TAB background TAB vector or string 
   23 TAB "black" TAB image background color #!N TAB - TAB - 
   24 TAB - TAB #!EF #!N #!N Outputs #!T,1,161,321,646  #!F-adobe-times-medium-r-normal--14*    #!F-adobe-times-bold-r-normal--18*   #!N 
   25 TAB Name TAB Type TAB Description #!EF #!N TAB camera TAB 
   26 camera TAB resulting camera #!N TAB - TAB - TAB #!EF 
   27 #!N #!N Functional Details #!N #!N This module differs from AutoCamera 
   28 in that it specifies a "look-from"  #!F-adobe-times-medium-i-normal--18*   point #!EF for viewing 
   29 an object (AutoCamera specifies a  #!F-adobe-times-medium-i-normal--18*   direction #!EF from which to 
   30 view an object). #!N #!I0 #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
   31 to #!EF #!EF #!I50 #!N specifies a point in the scene 
   32 that appears at the center of the image; the default is 
   33 the origin of world space. This parameter can also be specified 
   34 as an object, in which case the center of the object 
   35 serves as the look-to point. Note: This parameter cannot have the 
   36 same value as  #!F-adobe-times-bold-r-normal--18*   from #!EF (see below). #!N #!I0 #!N 
   37  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   from #!EF #!EF #!I50 #!N specifies the location of 
   38 the camera; the default is [0 0 1]. This parameter can 
   39 also be specified as an object, in which case its value 
   40 is the center of the object's bounding box. Note: This parameter 
   41 cannot have the same value as  #!F-adobe-times-bold-r-normal--18*   to #!EF (see above). 
   42 #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   width #!EF #!EF #!I50 #!N functions 
   43 only for an orthographic projection (see  #!F-adobe-times-bold-r-normal--18*   perspective #!EF below). It 
   44 specifies the width of the field of view, in world coordinates. 
   45 If this parameter is specified as an object, the module uses 
   46 a value that is slightly larger than the diagonal of the 
   47 object's bounding box. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   resolution #!EF #!EF 
   48 #!I50 #!N specifies the width of the image in pixels. #!N 
   49 #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   aspect #!EF #!EF #!I50 #!N specifies the 
   50 height-to-width ratio of the image. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   up 
   51 #!EF #!EF #!I50 #!N specifies a vector that will be aligned 
   52 with the vertical axis of the image. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*   
   53  #!F-adobe-times-bold-r-normal--18*   perspective #!EF #!EF #!I50 #!N specifies the method of projection 
   54 used in rendering  #!F-adobe-times-bold-r-normal--18*   object #!EF : perspective (0) or orthographic 
   55 (1). #!N #!I0 #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*   Perspective projection #!EF 
   56 #!I50 #!N This method produces a realistic rendering of objects, but 
   57 does not preserve their exact shape and measurements (e.g., parallel lines 
   58 usually do not project as being parallel). The camera is positioned 
   59 at the vertex of the viewing angle (see  #!F-adobe-times-bold-r-normal--18*   angle #!EF 
   60 below). The two end-points of that angle are the left and 
   61 right sides of the image area. Thus the wider the angle, 
   62 the greater the amount of object space that can be fitted 
   63 into the viewing area. Note: The  #!F-adobe-times-bold-r-normal--18*   width #!EF parameter has 
   64 no effect on perspective projection. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*   Orthographic projection 
   65 #!EF #!I50 #!N This method produces a somewhat artificial view of 
   66 an object (the distance between the front and back of an 
   67 object appears small compared to the distance between the object and 
   68 the camera), but it preserves exact scale measurements and parallel lines. 
   69 The size of the object can be changed only by  #!F-adobe-times-bold-r-normal--18*   
   70 width #!EF (the default is a field of view slightly greater 
   71 than the width of the object). #!N #!N The  #!F-adobe-times-bold-r-normal--18*   angle 
   72 #!EF parameter has no effect on orthographic projection. #!N #!N In 
   73 orthographic projection, only the direction of the  #!F-adobe-times-bold-r-normal--18*   from #!EF - 
   74  #!F-adobe-times-bold-r-normal--18*   to #!EF vector is important, not its magnitude. The object's 
   75 distance does not affect its size in the image, which can 
   76 be changed only with the  #!F-adobe-times-bold-r-normal--18*   width #!EF parameter. In perspective 
   77 projection, the object's size can be changed only by changing  #!F-adobe-times-bold-r-normal--18*   
   78 from #!EF or  #!F-adobe-times-bold-r-normal--18*   angle #!EF (because  #!F-adobe-times-bold-r-normal--18*   width #!EF is 
   79 ignored). #!I0 #!N #!N For more information on these projection methods, 
   80 consult a text on computer graphics. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
   81 angle #!EF #!EF #!I50 #!N specifies the viewing angle in degrees. 
   82 The vertex of this angle is  #!F-adobe-times-bold-r-normal--18*   to #!EF . #!N 
   83 #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   background #!EF #!EF #!I50 #!N specifies the 
   84 color of the image background as either an RGB color or 
   85 a color-name string. The string can be any of the defined 
   86 color-name strings (see  #!Lcolor,dxall792 h Color  #!EL  ). #!I0 #!N #!N #!N #!N Example 
   87 Visual Programs #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*   #!N FlyThrough.net (uses the macro 
   88 InterpolatePositionsMacro.net) #!N FlyThrough2.net #!EF #!N #!N #!EC #!N #!N See Also 
   89 #!N #!N  #!Lautocam,dxall771 h AutoCamera  #!EL  ,  #!Lautocol,dxall772 h AutoColor  #!EL  ,  #!Ldirect,dxall806 h Direction  #!EL  ,  #!Lrender,dxall923 h Render  #!EL  #!N #!N 
   90 #!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N #!N  #!Lcaption,dxall781 h Caption  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N 
   91