sig-content/testing-guidance/workflow-tests/Viewport/viewport-workflow-tests.md

# Viewport Workflow Tests ​ Testing in this area should focus on basic Viewport functionality. ​

Common Issues to Watch For

​ Test guidance will sometimes note specific issues to watch for. The common issues below should be watched for through all testing, even if unrelated to the current workflow being tested.

1. Console log errors/warnings/spam

2. Asserts ​

   Platforms:​

• Windows

• Linux​ ​

  Documentation pages:​

• Working with the 3D Viewport

• Reference Spaces

• Group Selection

• Advanced 3D Viewport Operations​ ​

  Workflow 1: Camera control

  ​ Product: A Level with multiple entities with a mesh component and assigned shaderball model asset. ​ Suggested Time Box: 5-10 mins

Workflow	Requests	Things to Watch For
Navigate level with camera controls	Select the Viewport. Navigate the camera with W, A, S, D, Q, E. Hold shift for fast move. Right-click and drag to rotate the camera. Press MMB and drag to pan up and down. Scroll up and down using the MMB, to zoom in and out. ALT+LMB to orbit. ALT+MMB or ALT+Scroll to Pan. ALT+RMB to Dolly.	Testing clicking in and out of the Viewport while moving the camera
Be this camera option	Select the camera entity or create one. In the Entity Inspector, press the Be this camera button. Move the camera around. Press the Return to default editor camera button.
Match Viewport	Select the camera entity or create one. In the Entity Inspector, press the Match Viewport button. Move the camera around. Press the Return to default editor camera button.
Viewport camera selector	Open the Viewport Camera Selector (Tools > Viewport > Viewport Camera Selector). Right-click in the Viewport and select "Create camera entity from view". Navigate to a different location in the Viewport and create another camera. Navigate through the available cameras in the Viewport Camera Selector while monitoring the Viewport.

---

Workflow 2: Viewport options

​ Product: A Level with multiple entities with a mesh component and assigned shaderball model asset. ​ Suggested Time Box: 20 mins

Workflow	Requests	Things to Watch For
Hide/Unhide	Select an entity with mesh component in the Entity Outliner and press the eye icon. Select the Show All menu option (Edit > Show All). Select the entity in the Viewport. Press H to hide the entity. Press Ctrl+SHIFT+H to unhide the entity.	Correct entity Hide/Unhide functionality. Shortcut functionality.
Lock/Unlock	Select an entity with mesh component in the Entity Outliner, press the lock icon. Attempt to select the entity in the Viewport. Select the Unlock All menu option (Edit > Unlock All). Select the entity in the Viewport and press L to lock the entity. Press Ctrl+SHIFT+L to unlock all entities.	Correct entity Lock/Unlock functionality. Shortcut functionality.
Go to position	Select View > Viewport > Go to Position... Input coordinates.	Camera responds as expected to the used control actions.
Find selected entities in Viewport	Select an entity and move the camera away from it. Select View > Viewport > Find selected entities in Viewport or use the Z key.	Position on the selected entity.
Save Location/Go to location	Select View > Viewport > Save Location > Save location 1. Move the camera around. Select View > Viewport > Go to location > Go to location 1. Use Ctrl+F<1-12> to save multiple bookmarks and load them with Shift+F<1-12>.	Saving and loading bookmarked locations.
Component Mode Switcher	Select an entity and add multiple components with component mode(e.g. Spline, PhysX collider, WhiteBox). Enter the component mode through the switcher in the upper left corner of the Viewport. Switch between component modes using the switcher.	Switchers added to the Viewport and functioning.
Stress test	Select an entity with mesh component and duplicate it (Ctrl+D) so you will have around 200 entities. Select all entities in the level and manipulate them using the Transform mode widgets.	Any drops in Editor stability, errors or framerate drops.
Field of View/Camera speed scale	Select dropdown menu next to the camera icon on the Viewport Toolbar and change the value of the Field of view. Look around with the camera. Select the camera speed scale under the FOV, change the value and move the camera around.	FOV and camera speed adjusting.
Toggle between states	Select dropdown menu next to the bug icon on the Viewport Toolbar and select Full. Switch between all of the modes. Press the bug icon multiple times to switch between the modes.
Show Helpers	Select dropdown menu next to the eye icon on the Viewport Toolbar and select show icons (or use Ctrl+space). Select an entity and from the dropdown menu, select Show helpers for selected entity. Switch to hide helpers.
Viewport Size	Select dropdown menu next to the double rectangle icon on the Viewport Toolbar > Ratio and switch between the ratios. From the ratio menu select Custom... and input custom ratio values. Select Resolution menu and switch between all of the resolutions in the menu. Select Resolution > Custom... and input custom resolution values.
Grid/Angle snapping	Select dropdown menu next to the triple bar icon on the Viewport Toolbar and select Show Grid. Select the Grid snapping option and change the Grid snapping size to 5. Select an entity and using the translate mode, move it around. Select the Angle Snapping option and change the Angle snapping size value to 60. Select an entity and using the rotate mode, turn the entity around.	Grid displaying around the entity
Viewport global preferences	Select Edit > Editor Settings > Global Preferences and select the Viewport tab. Change FOV value and press OK. Observe the changes in the Viewport. Return to the Preferences menu, modify any other option, confirm and observe the changes.	After restarting the Editor the aved changes should persist.

---

Workflow 3: Entity manipulation

Product: A Level with multiple entities with a mesh component and assigned shaderball model asset. ​ Suggested Time Box: 30 mins

Workflow	Requests	Things to Watch For
Manipulate the entity	Select an entity and use the Transform mode widgets to manipulate it. Switch between translate, rotate and scale modes (1, 2 and 3 key accordingly).	Shortcuts functionality. Correct entity manipulation.
Undo/Redo	While using the Transform mode widgets to manipulate an entity select Edit > Undo/Redo. Manipulate the entity and use the shortcuts for Undo - Ctrl+Z and Redo Ctrl+Shift+Z.	Shortcuts functionality.
Reference space widget	Select an entity and assign a child entity to it. Select the child entity, move it around the Viewport and switch between the Reference spaces.	Correct Translate and Rotate coordinates. Correct entity manipulation.
Pivots	Select an entity with a three-dimensional shape. Switch between pivots (P key) and manipulate the entity.	Schortcuts functionality. Correct entity manipulation.
Creating a custom reference spaces	Select an entity and select translation manipulator mode. Press and hold Ctrl+Alt and select a target entity in the Viewport with LMB. Use the manipulator to modify the entity.	Correct manipulator match to the translation or orientation of the target entity.
Selecting a group of entities	Select multiple entities by using LMB and drag. Deselect multiple entities by holding Ctrl+LMB and dragging in the Viewport. Add and remove an entity from the selection by holding Ctrl and left-clicking a target entity.	Correct entity selection.
Selecting a reference space for a group	With a group of entities selected, press and hold Ctrl+Alt and left-click a target entity. Use the manipulator to modify the entities.	Correct manipulator match to the translation or orientation of the target entity.
Creating a custom reference space for a group	With a group of entities selected, press and hold Ctrl, and move the manipulator in the Viewport.	Correct manipulator match to the translation or orientation of the target entity.
Parent reference spaces	Select multiple child entities of the same parent entity and use the manipulator to modify them.	Correct manipulator match to the translation or orientation of the target entity.
Using individual influence in a group	Press and hold Alt while modifying a group of selected entities to modify the entities in the local space. Select child entities from different parent entities and press and hold Alt. Press and release Alt to dynamically change the manipulator influence.	Correct manipulator match to the translation or orientation of the target entity.
Reset an entity's transform, rotation, or scale	In the Viewport, select an entity or group of entities and press R. Switch the manipulator mode and attempt to reset them.	Correct entity default location, rotation, and scale.
Modifying manipulators	Select multiple entities. Select the transform mode of the manipulator you want to modify. Press and hold Ctrl+LMB and drag the manipulator to modify its location, rotation, or scale.	Correct manipulator match to the translation or orientation of the target entity.
Reset a manipulator's transform, rotation, or scale	Reset a manipulator to its default location, rotation, or scale by pressing Ctrl+R while the related manipulator is active.	Correct manipulator default location, rotation, and scale.
Matching entity transforms	Select an entity. Press and hold Ctrl and press the middle mouse button as you hover over a target entity. After the target is selected, the current selection transform matches that of the target. Do this with location, rotation, or scale.	Correct matching location, rotation, and scale values.
Ditto a group selection	Select a group of entities. Press and hold Ctrl and press the middle mouse button as you hover over a target entity to match the group's transform data to the target's data. Do this with location, rotation, or scale.	Correct matching location, rotation, and scale values.
Ditto a group selection to local space	Select a group of entities. Press and hold Ctrl+Alt and press the middle mouse button as you hover over a target entity. This sets the local space of each entity in the selected group to the target entity that you specified.	Correct matching location, rotation, and scale values.

---