The Eggplant Manual Viewer Window

The Viewer window shows an image of the system under test (SUT) as you would see it on its own display.

The Viewer window has two modes: Live Mode and Capture Mode. You can interact with the SUT as a user while in Live Mode, and capture images to use in Eggplant Functional scripts while in Capture Mode. To toggle between Live Mode and Capture Mode, click the Enter Capture Mode or Enter Live Mode icon in the toolbar.

Tip: To toggle between Live Mode and Capture Mode quickly, press Control on Windows or Command on Mac. You can select a different key to perform this action in Viewer Preferences.

Live Mode

The Eggplant Manual Viewer window in Live Mode

The Viewer window in Live Mode

In Live Mode, you can use your local mouse and keyboard to interact with the SUT as a user. This works just as if you were using the SUT keyboard and mouse directly. In Live Mode, you can also copy and paste text between applications running on the SUT and your local computer.

Note: If the Viewer window is not your active window, your clicks and keystrokes are applied to your local computer, not the SUT.

Capture Mode

The Eggplant Manual Viewer window in Capture Mode

The Viewer window in Capture Mode

In Capture Mode, you can capture images of your SUT using the Capture Area. These images can then be used with Eggplant Functional scripts. You continue to receive display updates from the SUT, but your mouse and keyboard events are applied to your local computer. The Viewer window is dimmed in Capture Mode, except for the Capture Area, described below.

Capturing Images

To capture an image of the portion of the SUT selected by the Capture Area, click the image. The Eggplant Manual edge detection functionality automatically sizes the Capture Area around the image for you. You can manually adjust the size and placement of the Capture Area as well; see The Capture Area, below, for details.

To save the image, double-click the Capture Area. This action brings up a save image dialog box that lets you save the captured image in a specified location on your local system. Images captured with Eggplant Manual are compatible for use with Eggplant Functional scripts.

The Capture Area

The capture area in the Eggplant Manual Viewer window

The Capture Area

In Capture Mode, the Capture Area shows the area that is included when you save an image. It is the rectangle shown at normal brightness when the rest of the Viewer window is dimmed.

If you click an area of the screen where there is no image, or Eggplant Manual can't detect the edges of an image, the Capture Area still moves to that location and the size is set to the default, 64 X 64 pixels. You can use Shift+click to move the Capture Area to an image without using edge detection; the Capture Area moves to the new location without changing size so that you can manually adjust the edges as you wish.

To move the Capture Area, you can click and drag it to a new location. You can also nudge the Capture Area one pixel at a time by pressing the arrow keys. (Add the Shift key to move the Capture Area in ten-pixel increments.)

To resize the Capture Area, drag its edges. You can also nudge the size one pixel at a time with Alt + arrow (Option + arrow on Mac) keys. Add the Shift key to resize in ten-pixel increments.

Note: The Capture Area is drawn with a gray border to make it easier to see on dark backgrounds; you can turn this border off in Viewer Preferences.

Full-Screen Control

With full-screen control, you can view the SUT as your entire desktop. A small control panel provides access to the regular Viewer window features.

To open the control panel, choose Control > Control Panel from the menu.

To customize the buttons displayed on the control panel, right-click in the panel, and choose the Viewer window items that you want to display from the drop-down list.

To return to your own desktop, click Exit Full Screen, or use the keyboard shortcut Option + Command + 1.

The Viewer windows Control Panel in Eggplant Manual

The Full-Screen Control Panel

Zooming

It is possible to zoom in on the SUT while in capture mode. The Viewer window must be set to show the SUT at full scale rather than in "Scale to Fit" mode. To zoom in on Windows or Linux, hold Control and press "+". To zoom out, hold Control and press "-". This process is the same on Mac, except use the Command key instead of Control.

The Viewer Window Toolbar

Most of the buttons in the Viewer window toolbar are also represented as menu items in theControl menu.

Highlight of the toolbar in the Eggplant Manual Viewer window

The Eggplant Manual Viewer window toolbar in horizontal view

The toolbar can also be displayed vertically. To do this, go to Window > Show Vertical Toolbar. To switch to a horizontal toolbar, go to Window > Show Toolbar.

The toolbar buttons are described below. Since the toolbar can be customized, you might not see all of the buttons on your own toolbar. For more information about adding and removing toolbar buttons, see Customize below.

Enter Capture Mode / Enter Live Mode

This button toggles the Viewer window between Live Mode and Capture Mode. When you click Enter Capture Mode, the button changes to Enter Live Mode, and vice versa. Images of both instances of this button as it appears in the Viewer window can be seen below.

The Enter Capture Mode button icon on the eggMan Viewer window Enter Capture Mode

The Enter Live Mode button icon on the eggMan Viewer window toolbar Enter Live Mode

Note: You can also toggle between Live Mode and Capture Mode quickly by pressing Control on Windows or Command on Mac. You can select a different key to perform this action in Viewer window preferences.

Show Full Size / Scale to Fit

This button toggles between showing the Viewer window at the SUT's full display size, and showing the entire SUT scaled to fit the size of the Viewer window. Images of both instances of this button as it is shown in the viewer window can be seen below.

The Show Full Size button icon in the eggMan Viewer window Show Full Size

The Scale To Fit button icon in the eggMan Viewer window Scale to Fit

Note: Switching between the sizing options has no effect on the functionality of the Viewer window, image captures, or image matching.

The Capture Screen button icon in the eggMan Viewer windowCapture Screen

The Capture Screen button takes a snapshot of the entire Viewer window of your SUT.

Although screen captures in your Images directory appear in the Images pane of the Suite Editor, they are not added to a script when you choose Capture Screen. Instead, Capture Screen is useful for other purposes, such as reporting, documentation, and interface design discussions.

Note: The CaptureScreen command performs screen captures from within a script, as opposed to the Capture Screen button, which performs screen captures independently of a script.

The Home icon on the eggMan Viewer window toolbar Home

The Home button presses the home button on mobile devices.

The Back button in the Viewer Window Back

The Back button presses the back button on Android mobile devices.

The Rotate icon on the eggMan Viewer window toolbar Rotate

The Rotate button rotates the screen of mobile devices in the Viewer window 90 degrees clockwise.

PinchIn and PinchOut buttons from the ePF and eMN Viewer Window PinchIn/PinchOut

The PinchIn and PinchOut buttons perform those actions on a mobile SUT. They don't work on the home screen. Note that the actions might display more slowly in Eggplant Manual than they do on the SUT itself.

Customize

To customize the Viewer window toolbar, go to Window > Customize Toolbar. A panel opens in which you can select the buttons that are available for the Viewer window toolbar.

To add a button to the toolbar, drag the button from the Customize panel to the toolbar. To remove a button from the toolbar, drag it off of the toolbar. While the Customize panel is open, you can also drag buttons to different locations within the toolbar.

 

This topic was last updated on August 19, 2021, at 03:30:51 PM.

Eggplant icon Eggplantsoftware.com | Documentation Home | User Forums | Support | Copyright © 2022 Eggplant