Arena statement
Arena Rect=center_x,center_y,width,height Type=Hidden[-Corners-Isotropic]
Type conventions and statement syntax are explained in the Glossary.
This statement defines the arena and maps the 32767x32767 pixel internal Wintrack workspace to a real world coordinate system which uses metric dimensions. You can think of Wintrack's workspace as a "field" in the real world coordinate system.
Parameters...
Rect
Rectangle parameter describing the dimensions of Wintrack's workspace:
- center_x indicates the x-position of the center of the workspace within the real world coordinate system. Default is zero.
- center_y indicates the y-position of the center of the workspace within the real world coordinate system. Default is zero.
- height assigns a metric distance to the height of Wintrack's workspace. No default, this value must be specified!
- width assigns a metric distance to the width of Wintrack's workspace. No default, this value must be specified!
Type
Check box parameter indicating field properties.
- Hidden: must be specified.
- Corners: Rect to be interpreted as Rect=left,bottom,right,top rather than as Rect=center_x,center_y,width,height
- Isotropic: enforces the use of isotropic scaling, that is identical pixel to metric unit ratios for the x- and y-axes. If necessary, the specified rectangle is symmetrically enlarged in the x- or y- direction until it becomes a square.
Note that...
This is merely a Field statement with a reserved name. Only the Rect and Type parameters are used, the others must be left to default. Two points are important however:
- The Arena statement must be the first in the file, since the Rect parameters in all subsequent Field statements will refer to the coordinate system it defines.
- One is not allowed to assign trial ranges or versions to the Arena statement: the calibration of the coordinate system applies to all trials and versions of the setup.
Additional information...
- The topic Arena Properties command explains how to apply arena properties.
- See the topic Case Properties command for basic information on that command.
- Managing custom setup files provides general information on custom setup files.
