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.
Parameters
General
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. Click Test chosen display settings 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. Click Test chosen display settings to determine proper values for both parameters. |
Additional notes
Resolution Slider
The Less/More slider is available in visual mode to assist with selecting width height combinations supported by the display device specified in the Display Device parameter.
Test Chosen Display Settings Button
Clicking Test chosen display settings allows a given resolution/frequency/color-depth setting to be tested before being added to a task. It also provides an automatic switchback mechanism if a user does not respond within 15 seconds in the event the display is unreadable due to incompatible settings.
Example
- Copy and paste the sample AML code below directly into the Task Builder Steps Panel.
- To successfully run the sample code, update parameters containing user credentials, files, file paths, or other information specific to the task to match your environment.
Description
This sample task sets a computer's display settings to the following:1680 x 1050 x 32 bit x 59 Hz mode on VMware SVGA 3D (Microsoft Corporation - WDDM).
<AMCOMPUTER ACTIVITY="display" COLORS="32" DISPLAY="VMware SVGA 3D (Microsoft Corporation - WDDM). " FREQUENCY="59" WIDTH="1680" HEIGHT="1050" />