track-view-tests.md

Track View Workflow Tests

Testing in this area should focus on the functionality of Track View. This is a general tool for the creation, editing and exporting of cutscenes.

General Docs

• https://www.o3de.org/docs/user-guide/visualization/cinematics/track-view/

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.

• The Camera parameter does not take effect.
• Track View keyframe attributes cannot be modified.
• Nodes cannot be added to the Sequence.
• Unable to switch between multiple cameras.
• Editor or Track View crashes.
• Track View does not display the recorded Sequence.

Workflows

Area: Track View LKG Workflow

Project Requirements

• You've read through the Using the Track View Editor docs.
• FFMpeg plugin installed.

Editor Platforms:

• Windows
• Linux

Game Launcher Supported Platforms:

• Windows
• Linux

Product: Visible and responsive Track View editor.

Suggested Time Box: 15 minutes per platform.

Workflow	Requests	Things to Watch For
Track View editor can be launched and configured	Open Track View editor by multiple ways including: Tools menu Keyboard shortcut ( a shortcut can be assigned via Edit > Editor Settings > Keyboard Customization > Customize Keyboard) Perform resize, maximize, minimize undock, dock actions with Track View editor and its panes and drag them around the Editor. Close and reopen the Track View editor.	Track View editor launch method does not work or does not launch quickly. Track View editor not retaining configuration settings on close/relaunch. Track View editor not retaining configuration settings on close/relaunch. Track View panes not rendering, having rendering issues after being altered. Not being able to resize, dock or drag panes borders.
A Sequence can be created and configured	Add Sequence to the Track View by multiple ways including: Tools menu Node shortcut Name the Sequence. Edit Sequence properties by multiple ways including: Enabling autostart Editing Sequences name Changing start/end timings. Changing display time from seconds to frames. Selecting different Out of Range options. Delete and recreate the Sequence.	The Sequence name is left empty. Created Sequences do not appear in the Sequence dropdown. Sequence properties changes do not take place in the Track Editor and the Curve Editor.
Using basic Track View editor controls	Select the Shaderball entity in the viewport. RMB on the Sequence and select "Add selected entity". Add some keys to the position track. Verify that Track View toolbars are enabled.	Entities do not add to the Sequence. Keys cannot be edited with the Keys toolbar.
FFmpeg plugin can be added to the Editor	You can open Start menu and find Registry Editor In the Computer\HKEY_CURRENT_USER\SOFTWARE\O3DE\O3DE, create Keys Settings In the Settings, right click to add string value FFMPEG_PLUGIN and modify it to point to the path of ffmpeg executable Reopen the Editor > Track View > Tools > Render Output.	FFMpeg plugin is not available. After reopening, the Render Output tool shows errors or is not functional.

---

Area: Default Track View tools

Project Requirements

• Track View editor opened with a working Sequence.
• Autostart is enabled for the Sequence.

Product: Responsive Track View editor with full functionality.

Suggested Time Box: 60 minutes

Workflow	Requests	Things to Watch For
Configure nodes in the Sequence	RMB on the Node Browser and add all nodes from the list. Rename nodes. Copy/paste nodes. Expand/Collapse all nodes. Delete nodes.	Nodes cannot be added to the Sequence. Nodes are disabled. Nodes cannot be expanded and collapsed. Nodes cannot be copied and pasted. Nodes cannot be deleted.
Configure entity nodes in the Track View	Select Shaderball or create any other visible entity. Enter the Track View. RMB on the Node Browser and select "Add selected entity". Enable Recording in the Play toolbar. Move the entity in the Viewport to create a key in the Track editor. In Track editor change position of the playhead. Move the entity in the Viewport to create a second key in the Track editor. Enter the Game Mode.	Some entities cannot be added to the Sequence. Recording option cannot be enabled in the track editor's toolbar. Keys are not added to the Track editor after the entity is moved in the Viewport. Added keys have incorrect positions. Key properties do not exist or cannot be edited. The entity does not move in Game Mode.
Configure Track editor toolbars	Complete the steps for the "Configure entity nodes in the Track View". Select all Track editors toolbar options. Edit the keys added to the tracks.	Track editor toolbar options do not affect the keys. The Sequence cannot be played, paused, resumed and stopped. The Sequence cannot be played in a loop. The framerate cannot be changed. The snap options for the keys do not work. The playhead cannot be moved with the toolbar options.
Configure events in the Track View	RMB on the Sequence and select Edit Events. Select the "Add" option and provide a valid event name. In the Track editor add a key to the track. In the key properties select the provided event name. Open Script Canvas and create a simple script that triggers when the event is invoked. Enter Game Mode.	Events cannot be created. Key cannot be added to the tracker. Events cannot be set in the keys properties. Events are not triggered by the scripts. Events are not triggered at the correct time. Cannot create multiple events. Events cannot be triggered one after another.
Configure Curve editor	Complete the steps for the "Configure entity nodes in the Track View". Add 5 more keys to the tracker. Select the component in the Node Browser. Go to Curve editor. Select any key in the Curve editor. Move the selected key and observe changes on the Viewport.	Keys cannot be selected in the Curve editor by clicking or dragging. Keys cannot be moved around the Curve editor. Changes made to the keys are not visible in the Viewport. Multiple keys cannot be moved at once. Keys cannot be added/removed by double-clicking the line.
Configure Curve editor toolbar	Select one of the keys in the Curve editor. Select each of the toolbar options, then move the key and the tangents.	The toolbar options cannot be selected. Tangents and keys do not react differently after another toolbar option is selected. Changes made in the Curve editor are not reflected in the running Sequence.

---

Area: The Renderer Output tests

Project Requirements

• Track View editor opened with a working Sequence.
• Autostart is enabled for the Sequence.
• The FFmpeg plugin has been enabled.

Product: Responsive Renderer Output with full functionality.

Suggested Time Box: 60 minutes

Workflow	Requests	Things to Watch For
Basic functionality of the Renderer Output	Complete the steps for the "Configure entity nodes in the Track View". Add Director node to the Sequence. Open the Renderer Output. Set destination folder for the output. Add Batch for the Director node. Start the output generation.	The Renderer Output tool does not open. The destination folder cannot be set. A batch Director cannot be added. Frame files are not generated inside the selected directory.
Configuration of the Renderer Output	Complete the steps for the "Basic functionality of the Renderer Output". Change the Input settings. Change the resolution outputs. Change FPS options. Change capture options. Save Batch settings. Change the Sequence and load the previous Batch.	Input settings cannot be changed. Output settings cannot be changed. An mp4 file cannot be created as an output. Batch cannot be set, saved and loaded.

---