Skip to content

Action Area

This view allows you to manage your Actions Areas. An Action Area is a volume of a determined size and position. It can be used for different purposes as it can have different behaviors.

img

To create an Action Area view, check the Layout organization section.

Controls

Name Description Image
Area list At the left of the view is the list of all the Areas of the show. img
Create Area button At the bottom of the Area list, this button allows you to create a new Area. img
Delete Area button At the top right of the view, the trash icon allows you to delete the selected Area. img
Enable ActionArea toggle Allows you to enable or disable the selected Action Area when needed.
A disabled Action area will disable all related Actions.
When disabled, the area will still be visible in the 3D Stage view but it will be greyed out.
img
Show ActionArea toggle Allows you to show or not the Action Area in the 3D Stage view.
A hidden area can still be enabled.
img
Name textfield Allows you to rename the selected Action Area. img
Behavior selection Allows you to choose the behavior of the selected Action Area (see the Behaviors section). img
Transformations vector Allows you to change the position, scale and rotation of the selected Action Area. (see the Transformations section). img

Behaviors

An Action area can have different behaviors that impact the way people will be detected and tracked by the IA.

Action Area

Action Area are simple volumes used for Actions. You can for example use one to trigger the send of an OSC message when a person enters it or map the position of a Target between two values in function of its position in the Area.

Action areas are represented in yellow in the 3D Stage view.

img img

Spawning, Tracking and No Tracking areas


Spawning Area

Spawning Area is an area where the IA is allowed to create a Tracker and assign it to a person when this person enters the area. On a Show, Spawning Areas have to be setup correctly to avoid the creation of undesired Trackers when and where it is not needed (if for example a part of the public is seen by the Kapta).

Spawning areas are represented in green in the 3D Stage view.

img img

It is fundamental to create at least one Spawning area in the show of the correct position and size.

Otherwise the IA will not be able to spawn any Tracker even if it detects people


Tracking area

Tracking Area is an area where the IA is allowed to keep the track of Trackers that are already assigned to people. If a person that is assigned to a Tracker moves and is not in a Spawning or a Tracking area anymore, the IA will delete the Tracker.

Tracking areas are represented in blue in the 3D Stage view.

img img

In a standard stage setup, we recommend setting-up a Spawning area that has the size of the stage and a Tracking area that is bigger and extends to the backstage.

This way the people that are present backstage are not spawned unnecessarily but if a performer that is spawned goes backstage, it will not be lost by the IA (if he is still seen by the Kapta of course)


No tracking area

No Tracking Area is an area where every Tracker will be deleted when the person assigned to it enters in.

No Tracking areas are represented in red in the 3D Stage view.

img img

When in a situation the IA doesn't spawn any Trackers, check if at least one Spawning area has been created at the right place and that no No Tracking areas are present in this place.


Behavior recap

This animation show how the Spawning, Tracking and No Tracking areas behave when a person enters them. From left to right, zones are : Spawning, Tracking, No Tracking.

Transformations

You can transform each Action Area by using the Position, Scale and Rotation vectors. Each Action area has its own coordinate system that is different from the Kratos coordinate system.

The transformations of a Action area are performed with the following rules :

  • When creating an Action Area, its origin will be placed at the origin of Kratos coordinate system, its axes aligning to the Kratos axis. It's size will be set to 2x2x2 meters.
  • The position of the Action Area is the position of its origin relative to the Kratos origin in the Kratos coordinate system. Unit are in meters.
  • The scale of the Action Area is the size of the Action Area from it's origin. Changing the scale of an Action Area will not move the position of its origin. Unit are in meters.
  • The rotation of the Action Area are made from the Action Area's origin and along the axis of the Action Area coordinate system. Units are in degrees.

You can drag and move on each textfield of the transformations vectors to change their values quickly.

The following table will show you the behavior of the Action Area when performing different transformations. The Kratos axis are represented with continuous line. The Action Area axis are represented with dashed line. X axis are red, Y axis are green and Z axis are blue.

Action performed 3D Stage view Action Area transformations
Creation of the Action Area img img
Moving the position of the Action Area img img
Scaling the Action Area img img
Rotating the Action Area by 30 degrees along its Z axis img img
Making a second rotation along the Action Area's Y axis img img
Scaling the Action Area again img img
Moving the Action Area again img img

Use in Actions

Every Action Area can be used in the Actions of the show, even Spawning, Tracking and No Tracking areas.

When you use an Action Area to get the coordinates of a Target, the result are expressed in the coordinate system of the Action Area. This means that if you use an Action Area to map the position of a Target between two values and that this Action Area that has a 90° rotation along its Z axis; if the Target moves along the Kratos X axis, the mapped values that will change is the Y position of the Target. This is useful if the third party system that you want to send position information to has a different coordinate system than Kratos.