dx-doc 1:4.4.4-7 / usr / share / doc / dx / help / dxall771

#!F-adobe-helvetica-medium-r-normal--18*
#!N 
#!N  #!Rautocam AutoCamera #!N #!N Category #!N #!N  #!Lcatren,dxall760 h Rendering  #!EL  #!N #!N 
Function #!N #!N Constructs a camera for viewing an object. #!N 
#!N Syntax #!CForestGreen #!N #!N  #!F-adobe-courier-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   #!N camera #!EF = 
AutoCamera(  #!F-adobe-times-bold-r-normal--18*   object, direction, width, resolution, #!N aspect, up, perspective, angle, 
background #!EF ); #!EF #!N #!N #!EC #!N #!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 Default TAB Description 
#!EF #!N TAB object TAB object or vector TAB none TAB 
object to be looked at #!N TAB direction TAB vector, string, 
or object TAB "front" TAB position of camera #!N TAB width 
TAB scalar or object TAB input dependent TAB width of field 
of view #!N TAB resolution TAB integer TAB 640 TAB pixels 
across image #!N TAB aspect TAB scalar TAB 0.75 TAB height/width 
#!N TAB up TAB vector TAB [0 1 0] TAB up 
direction #!N TAB perspective TAB flag TAB 0 TAB 0: orthographic 
projection #!N TAB - TAB - TAB - TAB 1: perspective 
projection #!N TAB angle TAB scalar TAB 30.0 TAB view angle 
(in degrees) (for #!N TAB - TAB - TAB - TAB 
perspective projection) #!N TAB background TAB vector or string TAB "black" 
TAB image background color #!N TAB - TAB - 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 TAB Name 
TAB Type TAB Description #!EF #!N TAB camera TAB camera TAB 
resulting camera #!N TAB - TAB - TAB #!EF #!N #!N 
Functional Details #!N #!N This module differs from Camera in specifying 
a  #!F-adobe-times-medium-i-normal--18*   direction #!EF from which to view a specified object. 
(Camera specifies a "look-from"  #!F-adobe-times-medium-i-normal--18*   point #!EF .) It will automatically 
create an appropriate Camera for a given object for use with 
Display or Render. #!N #!I0 #!N #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
object #!EF #!EF #!I50 #!N is the object for which a 
camera is to be created. You can specify this parameter as 
a 3-dimensional position in space. In that case,  #!F-adobe-times-bold-r-normal--18*   width #!EF 
must also be explicitly specified (see below) as a numeric value, 
since the module has no means of estimating object size. #!N 
#!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   direction #!EF #!EF #!I50 #!N specifies the 
direction from the camera eye to the center of the object 
and can be any of the following strings: "front," "back," "left," 
"right," "top," "bottom," and their corresponding "off" values ("off-front," "off-back," etc., 
which are all slightly offset from the direct positions). Hyphens and 
spaces are not required for the offset (i.e., "offleft" and "off 
left" are both valid, and Data Explorer ignores capitalization. #!N #!N 
The direction "front" means from the positive  #!F-adobe-times-medium-i-normal--18*   z #!EF direction; 
"back" means from the negative  #!F-adobe-times-medium-i-normal--18*   z #!EF direction; "left" means 
from the negative  #!F-adobe-times-medium-i-normal--18*   x #!EF direction, "top" means from the 
positive  #!F-adobe-times-medium-i-normal--18*   y #!EF direction, and so on. Note: This parameter 
controls only the direction of viewing; it does not allow you 
inside the object. For interior views, use the ClipPlane or ClipBox 
module, make the object translucent, or use the Camera module in 
perspective mode. #!N #!N This parameter can also be specified as 
a vector to be added to the look-to point. You can 
use the Direction module for constructing look-from directions. But note that 
only the direction of the parameter is important; its magnitude does 
not affect the size of the object in the image. #!N 
#!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   width #!EF #!EF #!I50 #!N specifies the 
width of the image in the units of  #!F-adobe-times-bold-r-normal--18*   object #!EF 
. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   resolution #!EF #!EF #!I50 #!N 
specifies the width of the image in pixels. #!N #!I0 #!N 
 #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   aspect #!EF #!EF #!I50 #!N specifies the 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 #!EF #!EF 
#!I50 #!N specifies a vector that will be aligned with the 
vertical axis of the image. The default is [0 1 0]. 
#!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   perspective #!EF #!EF #!I50 #!N specifies 
the method of projection used in rendering  #!F-adobe-times-bold-r-normal--18*   object #!EF . 
The choices are perspective (0) and orthographic (1). #!N #!I0 #!N 
#!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*   Perspective projection #!EF #!I50 #!N This method 
produces a realistic rendering of objects, but does not preserve the 
exact shape and measurements of the object (e.g., parallel lines usually 
do not project as being parallel). The camera is positioned at 
the vertex of the viewing angle (see  #!F-adobe-times-bold-r-normal--18*   angle #!EF below). 
The base of this angle is determined by the  #!F-adobe-times-bold-r-normal--18*   width 
#!EF parameter. Thus the actual camera position is determined by  #!F-adobe-times-bold-r-normal--18*   
width #!EF and  #!F-adobe-times-bold-r-normal--18*   angle #!EF along the  #!F-adobe-times-bold-r-normal--18*   direction #!EF 
vector. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*   Orthographic projection #!EF #!I50 #!N This 
method produces a somewhat artificial view of an object (the distance 
between the front and back of an object appears small compared 
to the distance between the object and the camera), but it 
preserves exact scale measurements and parallel lines. #!N #!N The  #!F-adobe-times-bold-r-normal--18*   
angle #!EF parameter has no effect on orthographic projection. The size 
of the object can be changed only by  #!F-adobe-times-bold-r-normal--18*   width #!EF 
(the default is a field of view slightly greater than the 
width of the object). #!I0 #!N #!N For more information on 
these projection methods, consult a text on computer graphics. #!N #!I0 
#!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   angle #!EF #!EF #!I50 #!N specifies the viewing 
angle in degrees for perspective projection. #!N #!I0 #!N  #!F-adobe-times-bold-r-normal--18*    #!F-adobe-times-bold-r-normal--18*   
background #!EF #!EF #!I50 #!N specifies the color of the image 
background as either an RGB color or a color-name string. The 
string can be any of the defined color-name strings (see  #!Lcolor,dxall792 h Color  #!EL  
). #!I0 #!N #!N #!N #!N Example Visual Programs #!CForestGreen #!N 
#!N  #!F-adobe-courier-bold-r-normal--18*   #!N MovingCamera.net #!N PlotLine.net #!N PlotTwoLines.net #!N UsingCompute.net #!N 
UsingMorph.net #!EF #!N #!N #!EC #!N #!N See Also #!N #!N 
 #!Lcamera,dxall780 h Camera  #!EL  ,  #!Lcolor,dxall792 h Color  #!EL  ,  #!Ldirect,dxall806 h Direction  #!EL  ,  #!Lrender,dxall923 h Render  #!EL  ,  #!Ldisplay,dxall807 h Display  #!EL  #!N #!N 
#!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N #!N  #!Lautocol,dxall772 h AutoColor  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N