Spec Orbit Camera Actor

COMPONENT 3.6.0

The Spec Orbit Camera is a specialised Spec Scene Capture 2D Actor, for use in machine learning or data analytics task, that orbits about a given target writing captured image output to Saved/VideoCaptures.

images/confluence/download/attachments/106792895/image2019-7-16_9-8-47.png

To capture image output ensure you specify a Camera Writer.

Camera Orbit Properties

Property

Description

Target

Orbit about a given target

Target Offset

Optionally provide a target offset

Delay Start Time

Optionally specify a delay start time (in seconds), this is useful if you which to give the simulation physics some time to settle or to wait for some custom simulation event

Orbit Completed

Action to perform when orbit has completed

End Play : stop recording and end the simulation

Stop Recording : the recording will stop, but simulation will continue to run

Loop : recording will continue and the orbit will loop

Display Camera Widget

Enable the display of the camera widget

Time Stamped Path Enabled

For each run record to a unique time-stamped directory under:

Saved/VideoCaptures/TargetName-YYYYMMDDHHMMSS

Write JSON

Enable JSON ouput for each captured frame:

  • Camera yaw, pitch, range, offset, location and rotation

  • Target location, rotation and bounding box extents

Yaw Span

Yaw span (in degrees)

Yaw Step

Yaw step (in degrees)

Pitch Span

Pitch span (in degrees)

Pitch Step

Pitch step (in degrees)

Range Span

Range span (in cm)

Range Step

Range step (in cm)

Num Random Offsets

Number of random offsets per step

Random Offset

Random offset applied to camera viewport (in pixels)

Camera Orbit Functions

Function

Returns

Parameters

Description

StartOrbit

none

none

Start the orbit and start recording images (if a Camera Writer has been specified).

StopOrbit

none

none

Stop the orbit and stop recording, the OnOrbitCompletedDelegate will be notified

Camera Orbit Delegates

Delegate

Parameters

Description

OnOrbitCompletedDelegate

none

A notification that the orbit has completed (will fire on all action types as specified by Orbit Completed)