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.
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.
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.
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
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.
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 Full-Screen Control Panel
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.
Most of the buttons in the Viewer window toolbar are also represented as menu items in theControl menu.
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.
Enter Capture Mode
Enter Live Mode
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.
Show Full Size
Scale to Fit
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.
The Home button presses the home button on mobile devices.
The Back button presses the back button on Android mobile devices.
The Rotate button rotates the screen of mobile devices in the Viewer window 90 degrees clockwise.
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.
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.