Camcorder Element

Modified on 2018/08/03 01:07 by Administrator — Categorized as: Data Collection, Elements

Summary

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

Properties

NameDescription                              ConstraintsTypeOn
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

  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