Computer - Display

Declaration

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

Related Topics   

Overview

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 the mouse click pixel coordinates matches system conditions and the time a task is created.

Example 2: Create a task that quickly switches the resolution at the press of a hot-key or another trigger.

Parameters

General

Property Type Required Default Markup Description
Display device Text No (Primary) DISPLAY="NVIDIA GeForce 9800 GT" The display device to act on. This parameter is required and 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). Color depth describes how many colors 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). 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 is 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 is 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 select 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 you to test resolution/frequency/color-depth setting before adding it to a task. It also provides an automatic switchback mechanism if a user does not respond within 15 seconds if 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

The following 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" />