A Screen Object is an Object that maintains a size and alignment with the screen (output image) independent of the camera view and scaling transformations applied to it.
Three options are provided for the interpretation of translations applied to a Screen Object. First, a translation applied to the Screen Object may specify a new position for the origin of the Screen Object in world space (SCREEN_WORLD). Second, a translation applied to the Screen Object may specify a new location for the Screen Object in the image, measured in pixels, where (0,0) refers to the lower-left corner of the image (SCREEN_PIXEL). Third, a translation applied to the Screen Object may specify a new location for the Screen Object in the image, measured in viewport-relative coordinates, where (0,0) refers to the lower-left corner of the image and (1,1) refers to the upper-right corner of the image (SCREEN_VIEWPORT).
In addition, with regard to z, the object may be displayed either in place in the scene, in front of all objects, or behind all objects, according to whether the z parameter to DXNewScreen() is 0, +1, or -1 respectively.
#define SCREEN_WORLD 0 #define SCREEN_VIEWPORT 1 #define SCREEN_PIXEL 2
Screen DXNewScreen() | Creates a new Object aligned to the final screen. See DXNewScreen. |
Screen DXGetScreenInfo() | Returns information about a Screen Object. See DXGetScreenInfo. |
Screen DXSetScreenObject() | Sets the Object to which a screen transform is to be applied. See DXSetScreenObject. |