jit.displays

jit.displays

Set/query monitor attributes

Attributes:

Name Type Description

gamma (set) float list[4] Monitor gamma settings (Macintosh default = 0 1.8 1.8 1.8) (Windows default = 0 2.2 2.2 2.2)
The first argument specifies the device. The latter three arguments are used as coefficients in the generation of power-curve gamma tables for the red, green and blue channels. 1.8 represents standard Macintosh gamma, while 2.2 represents standard Windows gamma.

resetmode int Macintosh only
Display mode flag (default = 1)
Enables or disables reset when the object is freed The jit.displays object remembers the original state of your system’s display settings when the object is instantiated (display settings can also be saved using the snapshot message. A resetmode 1 will cause the original display settings to be restored when the patch is closed or the object is otherwise freed.

unsafe int Macintosh OS 9 only
Unsafe display mode flag (default = 0)
Enables or disables listing and setting of modes the Display Manager considers "unsafe". In general, these are display modes which require user confirmation when selected from the Monitors Control Panel.

Messages:

bang

Equivalent to the count message. Sends a count of the attached displays out the object’s outlet in the form count number-of-displays.

coords [display-index (int)]

Sends the display screen coordinates for the display whose index is specified out the object’s right outlet as a list in the form coords display-index left top bottom right. Displays are counted from 0 (0 is the primary display).

count

Sends a count of the attached displays out the object’s outlet in the form count number-of-displays.

currentstate [display-index (int)]

Sends the current state of the display out the object’s outlet as a list in the form currentstate display-index width height color-bit-depth refresh-rate. Note that LCD displays report a refresh rate of 0.

gammatable2matrix [display-index (int)] [matrix-name (symbol)]

Copies the gamma table for the display specified by display-index to the matrix named matrix-name.

getmode [display-index (int)]

Sends available display modes for display specified by display-index out the right outlet as a sequence of lists, one display per line. Each display is described by a list in the form mode display-index mode-index width height color-bit-depth refresh-rate. Note: LCD displays have a refresh rate of 0.

matrix2gammatable [matrix-name (symbol)] [display-index (int)]

Copies the Jitter matrix named matrix-name to the gamma table for the display specified by display-index. On Windows, gamma tables with negative slope are not permitted, and will result in an error message.

mirror [src-display-index (int)] [dst-display-index (int)]

Macintosh only
Enables video mirroring of the display whose number is specified by src-display-index to the display whose number is specified by dst-display-index.

move [display-index (int)] [newxtop (int)] [newytop (int)]

Changes the logical screen location of the display whose number is specified by src-display-index. Two additional arguments specify the new screen location. If a location is chosen which overlaps with the location of another display, a new non-overlapping location will be automatically assigned. The final position of the display after a move can be verified using the coords message.

reset

Return displays to their snapshot state (see the snapshot method). Note that reset does not have any affect on video mirroring settings, which must be maintained manually.

resetgamma

Return display gamma settings to their system default state.

setmode [display-index (int)] [mode-index (int)]

Change the display mode. The two arguments specify the display index, and the mode index (derived from the getmode message).

snapshot

Saves the current display mode (on all active displays) for use with the reset and resetmode messages. A snapshot is automatically taken when the object is instantiated.

unmirror [display-index (int)]

Macintosh only
Disables video mirroring on the specified display.

Example:

See Also:

jit.desktop

Name	Type	Description
gamma (set)	float list[4]	Monitor gamma settings (Macintosh default = 0 1.8 1.8 1.8) (Windows default = 0 2.2 2.2 2.2) The first argument specifies the device. The latter three arguments are used as coefficients in the generation of power-curve gamma tables for the red, green and blue channels. 1.8 represents standard Macintosh gamma, while 2.2 represents standard Windows gamma.
resetmode	int	Macintosh only Display mode flag (default = 1) Enables or disables reset when the object is freed The jit.displays object remembers the original state of your system’s display settings when the object is instantiated (display settings can also be saved using the snapshot message. A resetmode 1 will cause the original display settings to be restored when the patch is closed or the object is otherwise freed.
unsafe	int	Macintosh OS 9 only Unsafe display mode flag (default = 0) Enables or disables listing and setting of modes the Display Manager considers "unsafe". In general, these are display modes which require user confirmation when selected from the Monitors Control Panel.