# IBM Visualization Data Explorer Programmer's Reference

[ Bottom of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]

## 16.5 Screen Class

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.

[ Top of Page | Previous Page | Next Page | Table of Contents | Partial Table of Contents | Index ]
[Data Explorer Documentation | QuickStart Guide | User's Guide | User's Reference | Programmer's Reference | Installation and Configuration Guide ]

[Data Explorer Home Page]

[IBM Home Page | Order | Search | Contact IBM | Legal ]