"Fossies" - the Fresh Open Source Software Archive

Member "dx-4.4.4/help/dxall1325" (5 Feb 2002, 2867 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  #!Rdxnsn DXNewScreen #!N 
    4 #!N Function #!N #!N Creates a new Object aligned to the 
    5 final screen. #!N #!N Syntax #!N  #!F-adobe-times-bold-r-normal--18*   #include <dx/dx.h> Screen DXNewScreen(Object 
    6 o, int position, int z) #!EF #!N #!N Functional Details #!N 
    7 #!N A Screen Object is an Object that maintains a size 
    8 and alignment with the screen (output image) independent of the camera 
    9 view and scaling transformations applied to it. #!N #!N The  #!F-adobe-times-bold-r-normal--18*   
   10 position #!EF parameter specifies one of the three options for positioning 
   11 of the Screen Object as explained in the following material; it 
   12 must be one of  #!F-adobe-times-bold-r-normal--18*   SCREEN_WORLD #!EF ,  #!F-adobe-times-bold-r-normal--18*   SCREEN_PIXEL #!EF 
   13 or  #!F-adobe-times-bold-r-normal--18*   SCREEN_VIEWPORT #!EF . The  #!F-adobe-times-bold-r-normal--18*   z #!EF parameter determines 
   14 the relative depth of the Object, as described in the following 
   15 text. #!N #!N Three options are provided for the interpretation of 
   16 translations applied to a Screen Object. First, a translation applied to 
   17 the Screen Object may specify a new position for the origin 
   18 of the Screen Object in world space (  #!F-adobe-times-bold-r-normal--18*   SCREEN_WORLD #!EF 
   19 ). Second, a translation applied to the Screen Object may specify 
   20 a new location for the Screen Object in the image, measured 
   21 in pixels, where (0,0) refers to the lower-left corner of the 
   22 image (  #!F-adobe-times-bold-r-normal--18*   SCREEN_PIXEL #!EF ). Third, a translation applied to 
   23 the Screen Object may specify a new location for the Screen 
   24 Object in the image, measured in viewport-relative coordinates, where (0,0) refers 
   25 to the lower-left corner of the image and (1,1) refers to 
   26 the upper-right corner of the image (  #!F-adobe-times-bold-r-normal--18*   SCREEN_VIEWPORT #!EF ). 
   27 #!N #!N The  #!F-adobe-times-bold-r-normal--18*   z #!EF parameter controls where the Screen 
   28 Object is displayed relative to all other Objects in the scene. 
   29  #!F-adobe-times-medium-i-normal--18*   -1 #!EF displays behind, 0 is in the scene, and 
   30  #!F-adobe-times-medium-i-normal--18*   +1 #!EF is in front of all other Objects. #!N 
   31 #!N The Object created can be deleted with DXDelete. See  #!Lmemng,dxall1023 h Memory Management  #!EL  
   32 . #!N #!N Return Value #!N #!N Returns the Screen Object 
   33 or returns  #!F-adobe-times-bold-r-normal--18*   NULL #!EF and sets an error code. #!N 
   34 #!N See Also #!N #!N  #!F-adobe-times-bold-r-normal--18*    #!Ldxgsi,dxall1265 h DXGetScreenInfo  #!EL  ,  #!Ldxsso,dxall1390 h DXSetScreenObject  #!EL  #!EF #!N 
   35 #!N  #!Lsncs,dxall1136 h Screen Class  #!EL  . #!N #!N #!N  #!F-adobe-times-medium-i-normal--18*   Next Topic #!EF #!N 
   36 #!N  #!Ldxns,dxall1326 h DXNewSeries  #!EL  #!N  #!F-adobe-times-medium-i-normal--18*   #!N