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. | | String | |
| Audio Device | Defines an audio device for capturing. A drop-down selection list shows all devices available in the system | | 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. | | Int32 | |
| Edit Camera Settings | Opens a window with common settings for the selected video device. | | Boolean | |
| Select Video Format | Opens a window with the video format settings for the selected video device. | | 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. | | 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. | | 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. | | clSize | |
| Frame Rate | Define the custom framerate of video capturing, in frames per second | | 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="";' | | String | |
| Actual Settings | Returns the actual resolution and framerate of video capturing. The property is updated on every experiment run. | | String | |
| Control |
| Is Enabled | If set to false the element is completely omitted when the experiment is run | | Boolean | |
| Title | Title of the element | | String | |
|
Camcorder Element allows synchronized video recording using any computer video device, e.g. web-camera, at the background of experiment. The video is streamed into a file (one per experiment run) together with custom text markers that can denote experiment events or carry other information. Use Windows Media Player for playback of recorded videos to unsure visibility of the markers.
Description
The camcorder element streams a video into a file (one per experiment run) together with custom text markers that can denote experiment events or carry other information. Use Windows Media Player for playback of recorded videos to unsure visibility of the markers.
Practical Use
- Add new Camcorder element to any event in your experiment
- Click on the Camcorder element and select video and audio devices for capturing.
- Select a local folder for storing the captured videos via the 'Output Folder' property of the Camcorder element
- 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
- 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"
- 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.