Computer - Display
Declaration
<AMCOMPUTER ACTIVITY="display" COLORS="number" DISPLAY="text" FREQUENCY="number" WIDTH="number" HEIGHT="number" />
Description: Adjusts the current resolution, color depth and/or display frequency settings of the specified display device (video card).
Practical Usage
Example 1: Change the resolution back to a standard setting so that mouse click pixel coordinates would match system conditions and the time a task was created.
Example 2: Create a task that quickly switches the resolution at the press of a hot-key or other trigger.
General Parameters
|
Property |
Type |
Required |
Default |
Markup |
Description |
|---|---|---|---|---|---|
|
Display device |
Text |
No |
(Primary) |
DISPLAY="NVIDIA GeForce 9800 GT" |
The display device that should be acted on. This parameter is required and especially useful for multi-monitor systems. Click the drop-down arrow to display a list of available display devices that are installed on the system. |
|
Color depth (bits) |
Number |
No |
(System Default) |
COLORS="32" |
The color depth (in bits) to modify. Color depth describes how many colors that can be displayed on a monitor's screen. Click the drop-down arrow to display a list of available color depth values for the current display device. |
|
Display frequency |
Number |
No |
(System Default) |
FREQ="70" |
The frequency (in Hz) to modify. Click the drop-down arrow to display a list of available frequency values for the current display device. |
|
Width |
Number |
No |
(System Default) |
WIDTH="1680" |
The width (in pixels) that the resolution should be modified to. Use the slider control to adjust the resolution to the desired height/width values. Press the Test chosen display settings button to determine proper values for both parameters. |
|
Height |
Number |
No |
(System Default) |
HEIGHT="1050" |
The height (in pixels) that the resolution should be modified to. Use the slider control to adjust the resolution to the desired height/width values. Press the Test chosen display settings button to determine proper values for both parameters. |
Description tab - A custom description can be provided on the Description tab to convey additional information or share special notes about a task step.
Error Causes tab - Specify how this step should behave upon the occurrence of an error. (Refer to Task Builder > Error Causes Tab for details.)
On Error tab - Specify what AWE should do if this step encounters an error as defined on the Error Causes tab. (Refer to Task Builder > On Error Tab for details.)
Resolution Slider
The "Less/More" slider is available in visual mode to assist in selecting width height combinations that are supported by the display device specified in the "Display Device" parameter. Use of this slider control is recommended in selecting resolutions.
Test chosen display settings button
The Test button allows a given resolution/frequency/color-depth setting to be tested before being added to a task. It also provides the user with an automatic switchback mechanism if the user does not respond within 15 seconds in case the display is unreadable using the settings. Use of the test button is recommended to ensure functionality before task execution.
Example
The sample AML code below can be copied and pasted directly into the Steps panel of the Task Builder.
Description: Set 1680 x 1050 x 32 bit x 59 Hz mode on VMware SVGA 3D (Microsoft Corporation - WDDM).
<AMDISPLAY WIDTH="1680" HEIGHT="1050" COLORS="32" FREQUENCY="59" />