The Bitmap object describes the video region that will be used for displaying graphics. It holds details on the width, height, type, number of colours and so on. The display class inherits the bitmap's attributes, so it is not necessary to retrieve a direct reference to the bitmap object in order to make adjustments.

The Bitmap⇒Width and Bitmap⇒Height can be larger than the display area, but never smaller.

This field defines the horizontal offset for the Bitmap, which is positioned 'behind' the display. To achieve hardware scrolling, call the Move() action on the Bitmap in order to change this value and update the display.

This field defines the vertical offset for the Bitmap, which is positioned 'behind' the display. To achieve hardware scrolling, you will need to call the Move() action on the Bitmap in order to change this value and update the display.

If the display is hosted in a client window, the BottomMargin indicates the number of pixels between the client area and the bottom window edge.

This string describes the graphic card's chipset, if known.

This string describes the display device that is connected to the user's graphics card.

This string names the manufacturer of the user's display device.

If the display is hosted in a client window, the BottomMargin indicates the number of pixels between the client area and the bottom window edge.

Optional display flags can be defined here. Post-initialisation, the only flags that can be set are AUTO_SAVE and BORDERLESS.

The gamma settings for the display are stored in this field. The settings are stored in an array of 3 floating point values that represent red, green and blue colours guns. The default gamma value for each colour gun is 1.0.

To modify the display gamma values, please refer to the SetGamma() and SetGammaLinear() methods.

Reading the HDensity field will return the horizontal pixel density for the display (pixels per inch). If the physical size of the display is unknown, a default value based on knowledge of the platform will be retuned. For standard PC's this will usually be 96.

A custom density value can be enforced by setting the /interface/@dpi value in the loaded style, or by setting HDensity.

Reading this field always succeeds.

This field defines the height of a display. This is known as the 'viewport' that the bitmap data is displayed through. If the height exceeds allowable limits, it will be restricted to a value that the display hardware can handle.

If the display is hosted, the height reflects the internal height of the host window. On some hosted systems, the true height of the window can be calculated by reading the TopMargin and BottomMargin fields.

On full-screen displays, the video data area can exceed the height of the screen display. The InsideHeight reflects the height of the video data in pixels. If this feature is not in use or is unavailable, the InsideWidth is equal to the display Height.

On full-screen displays, the video data area can exceed the width of the screen display. The InsideWidth reflects the width of the video data in pixels. If this feature is not in use or is unavailable, the InsideWidth is equal to the display Width.

If the display is hosted in a client window, the LeftMargin indicates the number of pixels between the client area and the left window edge.

The string in this field returns the name of the manufacturer that created the user's graphics card. If this information is not detectable, a NULL pointer is returned.

If the display output device supports variable refresh rates, this field will refer to the maximum horizontal scan rate supported by the device. If variable refresh rates are not supported, this field is set to zero.

If the display output device supports variable refresh rates, this field will refer to the maximum vertical scan rate supported by the device. If variable refresh rates are not supported, this field is set to zero.

If the display output device supports variable refresh rates, this field will refer to the minimum horizontal scan rate supported by the device. If variable refresh rates are not supported, this field is set to zero.

If the display output device supports variable refresh rates, this field will refer to the minimum vertical scan rate supported by the device. If variable refresh rates are not supported, this field is set to zero.

This field determines the translucency level applied to a display. Its support level is limited to hosted displays that support translucent windows (for example, Windows XP). The default setting is 100%, which means that the display will be solid. High values will retain the boldness of the display, while low values reduce visibility.

The PopOver field can be used when a display is hosted as a window. Setting the PopOver field to refer to the object ID of another display will ensure that the host window is always in front of the other display's window (assuming both windows are visible on the desktop).

The ERR::NoSupport error code is returned if the host does not support this functionality or if the display owns the output device.

When DPMS is enabled via a call to Disable(), the DPMS method that is applied is controlled by this field.

DPMS is a user configurable option and it is not recommended that the PowerMode value is changed manually.

The value in this field reflects the refresh rate of the currently active display, if operating in full-screen mode.

The value in this field reflects the refresh rate of the currently active display, if operating in full-screen mode.

Reading the VDensity field will return the vertical pixel density for the display (pixels per inch). If the physical size of the display is unknown, a default value based on knowledge of the platform will be retuned. For standard PC's this will usually be 96.

A custom density value can be enforced by setting the /interface/@dpi value in the loaded style, or by setting VDensity.

Reading this field always succeeds.

This field defines the width of a display. This is known as the 'viewport' that the bitmap data is displayed through. If the width exceeds allowable limits, it will be restricted to a value that the display hardware can handle.

If the display is hosted, the width reflects the internal width of the host window. On some hosted systems, the true width of the window can be calculated by reading the LeftMargin and RightMargin fields.

This field refers to the window handle of a display object, but only if such a thing is relevant to the platform that the system is running on. Currently, this field is only usable when creating a display within an X11 window manager or Microsoft Windows.

It is possible to set the WindowHandle field prior to initialisation if you want a display object to be based on a window that already exists.

The X field defines the horizontal hardware coordinate for a display. This field should be set to zero unless the screen requires adjustment. Most hardware drivers and output devices do not support this feature.

On hosted displays, prior to initialisation the coordinate will reflect the position of the display window when it is created. After initialisation, the coordinate is altered to reflect the absolute position of the client area of the display window. The LeftMargin can be used to determine the actual position of the host window.

To adjust the position of the display, use the MoveToPoint() action rather than setting this field directly.

The Y field defines the vertical hardware coordinate for a display. This field should be set to zero unless the screen requires adjustment. Most hardware drivers and output devices do not support this feature.

On hosted displays, prior to initialisation the coordinate will reflect the position of the display window when it is created. After initialisation, the coordinate is altered to reflect the absolute position of the client area of the display window. The TopMargin can be used to determine the actual position of the host window.

To adjust the position of the display, use the MoveToPoint() action rather than setting this field directly.