jit.displays
Set and query monitor attributes
Description
Senses additional display hardware attached to your computer and allows you to use standard Jitter
Typically, the jit.displays object is saved as a portion of a performance patch setup to automatically determine the exact position of your attached hardware and move your output window as needed.
Arguments
None.
Attributes
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 message. A will cause the original display settings to be restored when the patch is closed or the object is otherwise freed.
Common Box Attributes
annotation[symbol]
Sets the text that will be displayed in the Clue window when the user moves the mouse over the object.
background[int]: 0
Adds or removes the object from the patcher's background layer.
adds the object to the background layer, removes it. Objects in the background layer are shown behind all objects in the default foreground layer.
color[4 floats]
Sets the color for the object box outline.
fontface[int]
Sets the type style used by the object. The options are:
plain
bold
italic
bold italic
Possible values:
0 = 'regular'
1 = 'bold'
2 = 'italic'
3 = 'bold italic'
fontname[symbol]
Sets the object's font.
fontsize[float]
Sets the object's font size (in points).
Possible values:
'8'
'9'
'10'
'11'
'12'
'13'
'14'
'16'
'18'
'20'
'24'
'30'
'36'
'48'
'64'
'72'
hint[symbol]
Sets the text that will be displayed in as a pop-up hint when the user moves the mouse over the object in a locked patcher.
ignoreclick[int]: 0
Toggles whether an object ignores mouse clicks in a locked patcher.
jspainterfile[symbol]
JS Painter File
patching_rect[4 floats]: 0. 0. 100. 0.
Sets the position and size of the object in the patcher window.
position[2 floats]
write-only
Sets the object's x and y position in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its size unchanged.
presentation[int]: 0
Sets whether an object belongs to the patcher's presentation.
presentation_rect[4 floats]: 0. 0. 0. 0.
Sets the x and y position and width and height of the object in the patcher's presentation, leaving its patching position unchanged.
rect[4 floats]
write-only
Sets the x and y position and width and height of the object in both patching and presentation modes (if the object belongs to its patcher's presentation).
size[2 floats]
write-only
Sets the object's width and height in both patching and presentation modes (if the object belongs to its patcher's presentation), leaving its position unchanged.
textcolor[4 floats]
Sets the color for the object's text in RGBA format.
textjustification[int]
Sets the justification for the object's text.
Possible values:
0 = 'left'
1 = 'center'
2 = 'right'
varname[symbol]
Sets the patcher's scripting name, which can be used to address the object by name in pattr, scripting messages to thispatcher, and the js object.
Messages
bang
Equivalent to the
message. Sends a count of the attached displays out the object's outlet in the form number-of-displays .
coords
Sends the display screen coordinates for the display whose index is specified out the object's right outlet as a list in the form
display-index left top bottom right . Displays are counted from 0 (0 is the primary display).- display-index
[int]
count
Sends a count of the attached displays out the object's outlet in the form
number-of-displays .
currentstate
Sends the current state of the display out the object's outlet as a list in the form
display-index width height color-bit-depth refresh-rate . Note that LCD displays report a refresh rate of 0.- display-index
[int]
getmode
Sends available display modes for display specified by
out the right outlet as a sequence of lists, one display per line. Each display is described by a list in the form display-index mode-index width height color-bit-depth refresh-rate . Note: LCD displays have a refresh rate of 0.- display-index
[int]
manual
Macintosh only
Sets the display to a configuration which provides the closest match for the ideal configuration specified by the arguments.
- display-index
[int]
- width
[int]
- height
[int]
- bit-depth
[int]
mirror
Macintosh only
Enables video mirroring of the display whose number is specified by to the display whose number is specified by .
- src-display-index
[int]
- dst-display-index
[int]
move
Changes the logical screen location of the display whose number is specified by
. 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 can be verified using the message.- display-index
[int]
- newxtop
[int]
- newytop
[int]
reset
Return displays to their snapshot state (see the
method). Note that reset does not have any affect on video mirroring settings, which must be maintained manually.
setmode
Change the display mode. The two arguments specify the display index, and the mode index (derived from the
message).- display-index
[int]
- mode-index
[int]
snapshot
Saves the current display mode (on all active displays) for use with the
and messages. A snapshot is automatically taken when the object is instantiated.
unmirror
Macintosh only
Disables video mirroring on the specified display.
- display-index
[int]
See Also
Name | Description |
---|---|
jit.desktop | Copy the display into a matrix |
screensize | Output the monitor size |