Working with Digital Media in PDF Documents
Monitors
8
Monitors
The Acrobat JavaScript
Monitors
object is a read-only array of
Monitor
objects, each of
which represents a display monitor connected to the user’s system. It is available as a
property of the
app
object, and you may write customized Acrobat JavaScript code to
iterate through this array to obtain information about the available monitors and select one
for a full-screen or popup media player.
It is possible to apply filtering criteria to select a monitor. For example, you can select the
monitor with the best color, or if there are multiple instances, additionally select the
monitor with the greatest color depth. These criteria are methods of the
Monitor
object,
and are listed below in
Table 8.3.
T
ABLE
8.3
Monitors Filter Criteria Methods
Method
Description
Returns the monitors with the greatest color depth
Returns the smallest monitors with minimum specified
dimensions
Creates a new monitor representing the entire virtual
desktop
Returns the monitors containing the greatest amount of
the document
Returns the monitors having the highest rank according
to a ranking function supplied as a parameter
Returns the monitors with the greatest area in pixels
Returns the monitors overlapping the least with a given
rectangle
Returns the monitors overlapping the most with a given
rectangle
Returns the monitors displaying the least amount (or
none) of the document
Rreturns the primary monitor
Returns all monitors except for the primary one
Returns monitors filtered by monitor type
Returns the monitors with the greatest height in pixels
Returns the monitors with the greatest width in pixels
bestColor
bestFit
desktop
document
filter
largest
leastOverlap
mostOverlap
nonDocument
primary
secondary
select
tallest
widest
Acrobat JavaScript Scripting Guide
149