In the Parameter Packet, the caller specifies a 1-WORD height value (Rows) for the pointer shape, and a 1-WORD width value (Columns) for the pointer shape. For text-mode and mono-mode applications, these values must be equal to 1. For graphics-mode applications, these values must be greater than or equal to 1.

The Length, in bytes, of the pointer shape varies, depending on the display mode: 

Mono & Text
Buffer length = (height in characters) * (width in characters) * 2 * 2
              = 1 * 1 * 2 * 2
                Notice that for text mode, height and width must be 1, so length is always 4.

Graphics
Buffer length = (height in pels) * (width in pels) * (bits per pel) * 2 / 8
                Notice that width must be a multiple of 8.

Modes 4 & 5 (320 x 200)
Buffer length = (height) * (width) * 2 * 2 / 8

Mode 6 (640 x 200)
Buffer length = (height) * (width) * 1 * 2 / 8
                Notice that length calculations produce byte boundary buffer sizes.

All of the Pointer Definition record fields and the Pointer Shape buffer are validated using the session's mode table values. The parameter values must be the same orientation as the current session display mode:

[Back] [Next]