help/dxall1384 - dx (782aabd8-0af7-4651-9fe4-817694841323/main)

Tree @782aabd8-0af7-4651-9fe4-817694841323/main (Download .tar.gz)

dxall1384 @782aabd8-0af7-4651-9fe4-817694841323/main — raw · history · blame

#!F-adobe-helvetica-medium-r-normal--18*
#!N 
#!N 
 #!Rdxsoc DXSetOrthographic, DXGetOrthographic #!N #!N Function #!N #!N Sets and retrieves 
an orthographic camera view. #!N #!N Syntax #!N  #!F-adobe-times-bold-r-normal--18*   #include <dx/dx.h> 
Camera DXSetOrthographic(Camera c, double width, double aspect) Camera DXGetOrthographic(Camera c, double 
width, double aspect) #!EF #!N #!N Functional Details #!N #!N A 
camera defines the position and orientation of the viewer, the volume 
of interest of the object being viewed, and the size of 
the image to contain the resulting view. #!N #!N  #!F-adobe-times-bold-r-normal--18*   DXSetOrthographic 
#!EF defines the volume of interest for an orthographic camera  #!F-adobe-times-bold-r-normal--18*   
c #!EF . This can be thought of as a box 
that is centered on the  #!F-adobe-times-bold-r-normal--18*   to #!EF point, with its 
 #!F-adobe-times-bold-r-normal--18*   z #!EF axis parallel to the  #!F-adobe-times-bold-r-normal--18*   to #!EF - 
 #!F-adobe-times-bold-r-normal--18*   from #!EF vector, and infinite in length. Its  #!F-adobe-times-bold-r-normal--18*   y 
#!EF axis is perpendicular to the  #!F-adobe-times-bold-r-normal--18*   to #!EF -  #!F-adobe-times-bold-r-normal--18*   
from #!EF vector in the direction of the  #!F-adobe-times-bold-r-normal--18*   up #!EF 
vector. Its  #!F-adobe-times-bold-r-normal--18*   x #!EF axis is perpendicular to its  #!F-adobe-times-bold-r-normal--18*   
y #!EF and  #!F-adobe-times-bold-r-normal--18*   z #!EF axes. The x and y 
dimensions of the box are given by the  #!F-adobe-times-bold-r-normal--18*   width #!EF 
and  #!F-adobe-times-bold-r-normal--18*   aspect #!EF parameters of the camera respectively, where  #!F-adobe-times-bold-r-normal--18*   
aspect #!EF is defined as the ration of the height to 
width. #!N #!N In orthographic projection, objects do not appear smaller 
as they get more distant, and in fact, distance between the 
object and viewer have no effect on the appearance of the 
object. The distance between the  #!F-adobe-times-bold-r-normal--18*   to #!EF and  #!F-adobe-times-bold-r-normal--18*   from 
#!EF points is irrelevant; only the direction is important. #!N #!N 
 #!F-adobe-times-bold-r-normal--18*   DXGetOrthographic #!EF returns the  #!F-adobe-times-bold-r-normal--18*   width #!EF and  #!F-adobe-times-bold-r-normal--18*   aspect 
#!EF parameters of an orthographic camera  #!F-adobe-times-bold-r-normal--18*   c #!EF . If 
width is not  #!F-adobe-times-bold-r-normal--18*   NULL #!EF , the camera width is 
returned in  #!F-adobe-times-bold-r-normal--18*   *width #!EF . If aspect is not  #!F-adobe-times-bold-r-normal--18*   
NULL #!EF , the camera aspect is returned in  #!F-adobe-times-bold-r-normal--18*   *aspect 
#!EF . #!N #!N Return Value #!N #!N  #!F-adobe-times-bold-r-normal--18*   DXSetOrthographic #!EF 
returns the camera or returns  #!F-adobe-times-bold-r-normal--18*   NULL #!EF and sets an 
error code. #!N #!N  #!F-adobe-times-bold-r-normal--18*   DXGetOrthographic #!EF returns the parameters or 
returns  #!F-adobe-times-bold-r-normal--18*   NULL #!EF (if the camera is not orthographic) and 
sets an error code (if  #!F-adobe-times-bold-r-normal--18*   c #!EF is not a 
valid camera). #!N #!N See Also #!N #!N  #!F-adobe-times-bold-r-normal--18*    #!Ldxgcmp,dxall1225 h DXGetCameraMatrix, DXGetCameraRotation, DXGetCameraMatrixWithFuzz  #!EL  , 
 #!Ldxnca,dxall1311 h DXNewCamera  #!EL  ,  #!Ldxrndr,dxall1357 h DXRender  #!EL  ,  #!Ldxspe,dxall1388 h DXSetPerspective, DXGetPerspective  #!EL  ,  #!Ldxsrn,dxall1389 h DXSetResolution, DXGetCameraResolution  #!EL  ,  #!Ldxsvw,dxall1393 h DXSetView, DXGetView  #!EL  #!EF #!N 
#!N  #!Lcamsec,dxall1138 h Camera Class  #!EL  . #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N 
#!N  #!Ldxsp,dxall1385 h DXSetPart  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N 