Camcorder Element

Summary ¶

	Camcorder
Info
Category:	Data Collection		AddIn:	Surveillance
Creator:	OkazoLab		Scope:	Experiment
Owns Snippets:	None		Usage:	Snippets

Properties ¶

Name	Description	Constraints	Type	On runtime change
Settings
Video Device	Defines a video device for capturing. A drop-down selection list shows all devices available in the system.	Normal..	String
Audio Device	Defines an audio device for capturing. A drop-down selection list shows all devices available in the system	Normal..	String
Encoding Bitrate	Defines the quality of a recorded video by its bitrate in kbps. The recommended values, from excellent(2250) to poor(450), are estimated for the 640x480x30fps format.	Normal..	Int32
Edit Camera Settings	Opens a window with common settings for the selected video device.	Design Time..	Boolean
Select Video Format	Opens a window with the video format settings for the selected video device.	Design Time..	Boolean
Output Folder	Opens the dialog for selecting a local folder that will hold all recorded videos. If no or relative path is defined, the videos will be saved relative to the location of the experiment file.	Design Time..	String
Custom Settings
Use Custom Settings	Define whether custom frame size and framerate are used for video capturing. The custom settings are only applied, if the resolution and framerate values are supported by the selected video device. Otherwise, the device's default settings are used.	Normal..	Boolean
Resolution	Define the resolution of captured video. The video frames are automatically stretched to any destination size in rendering, however, a large resolution improves rendering quality with a cost in performance.	Normal..	clSize
Frame Rate	Define the custom framerate of video capturing, in frames per second	Normal..	Int32
Runtime Status
Save Marker Now	Runtime snippet action that that adds a sync text marker into the recorded video. Use the action in the code snippets, e.g. 'SaveMarkerNow="Trial Onset";'. In order to end the marker, save an empty string: 'SaveMarkerNow="";'	Runtime Command..	String
Actual Settings	Returns the actual resolution and framerate of video capturing. The property is updated on every experiment run.	Normal..	String
Control
Is Enabled	If set to false the element is completely omitted when the experiment is run	Design Time..	Boolean
Title	Title of the element	Design Time..	String

¶

Description ¶

Practical Use ¶

1. Add new Camcorder element to any event in your experiment
2. Click on the Camcorder element and select video and audio devices for capturing.
3. Select a local folder for storing the captured videos via the 'Output Folder' property of the Camcorder element
4. If you want to add custom text markers in a captured video at runtime, add a proxy variable to the 'Save Marker Now' property of the Camcorder element
5. Captured video will be streamed in a new file each time as you run your experiment. The file name is composed of the run time and title of the experiment, e.g. "2014-04-11 01_52-camcorder.wmv"
6. In order to record a marker into the video file, assign a custom text value to the 'Save Marker Now' proxy at the selected moment in your experiment (see the code example below).
   

 //
SaveMarkerNow="Fixation Event | Trial"+TrialNumber;

Demo video ¶

Notes ¶

• We recommend to use Windows Media Player for viewing recorded video files because other video players may not be able to show the embedded text markers.