class HT_Device

class HT_Device_Options

A set of options required by renderers that are device drivers. These options are provided by the application to the device driver and allow the driver to access features of the underlying operating system window interface.

See Also

Methods

colormap_id, set_colormap_id

Retrieves and sets the handle ID of the color map associated with the device that this renderer uses.

context_id, set_context_id

Retrieves and sets the context ID associated with a window that this device renders to.

window_id, set_window_id

Retrieves and sets the window ID associated with a window that this device renders to. Constructor

HT_Device_Options

Initializes a new HT_Device_Options object.

HT_Device_Options::colormap_id

Purpose

Retrieves and sets the handle ID of the color map associated with the device that this renderer uses. Synopsis

long colormap_id (void) const

void set_context_id (long val) alter

Details The first method retrieves the color map ID, and the second sets the color map ID within the device option table. The color map ID is provided by the application to the driver. This color map ID can be used to access the current application color map with the current operating system window interface. For Microsoft Windows, this context ID represents a handle to a palette (an HPALETTE).

HT_Device_Options::context_id, set_context_id

Purpose

Sets or retrieves the context ID associated with a window that this device renders into. Synopsis

long context_id (void) const

void set_context_id (long val) alter

Details The first method retrieves the context ID, and the second sets the context ID within the device option table. The context ID is provided by the application to the driver. This context ID can be used to access the drawing surface with the current operating system window interface. For Microsoft Windows, this context ID represents a handle to a DC (an HDC).

HT_Device_Options::HT_Device_Options

Purpose

Constructor to initialize a new HT_Device_Options object. Synopsis

HEIDI_API HT_Device_Options (
            HT_Option_Table & current)

Details This function is for use by physical devices not by applications. The physical device uses it to construct the initial current option table, which provides the root of the option table tree.

HT_Device_Options::window_id, set_window_id

Purpose

Sets or retrieves a handle to the window containing the drawing region into which the device renders.
Synopsis

long window_id (void) const

void set_window_id (long val) alter

Details

The first method retrieves the window ID, and the second sets the window ID within the device option table. The window ID is provided by the application to the driver. This ID can be used to access the window with the current operating system window interface. For Microsoft Windows, this ID represents a handle to a window (an HWND).