Computer - Display

Declaration

<AMCOMPUTER ACTIVITY="display" COLORS="number" DISPLAY="text" FREQUENCY="number" WIDTH="number" HEIGHT="number" />

Related Topics   

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.

Description

Error Causes

On Error

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.

TIP: Use of the Less/More slider control is recommended when selecting a resolution.

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.

TIP: Use of the Test chosen display settings button is recommended to ensure functionality before task execution.

Example

NOTE:
  • 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).  

Copy
<AMCOMPUTER ACTIVITY="display" COLORS="32" DISPLAY="VMware SVGA 3D (Microsoft Corporation - WDDM).  " FREQUENCY="59" WIDTH="1680" HEIGHT="1050" />