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 | Contact Data Explorer | Same document on Data Explorer Home Page ]


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