Welcome Guest, you are in: Login

EventIDE Wiki

RSSRSS

Navigation




Search the wiki


PoweredBy

LSL Video element

RSS
Modified on 2023/05/22 05:43 by Administrator Categorized as Elements, Visual Stimuli

Summary

Element Icon LSL Video
Info
Category: Visual Stimuli AddIn: LSL
Creator: OkazoLab Scope: Parent event
Owns Snippets: None Usage: Stimulus screen

Properties

NameDescription                              ConstraintsTypeOn
runtime
change
Control
Is Enabled        If set to false the element is completely omitted when the experiment is run                Boolean         
Title        Title of the element                String         
Visual Appearance
Pivot Point        Defines alignment of the pivot point (or, element's position) relative to element's rendering area. The pivot point sets the center of element's rotation and scale directions.                stAlig..         
Position        Defines a position of the rendering viewport on the screen                clPoint         
Size        Defines a size of the element's rendering viewport on the screen                clSize         
Alpha Masking        Defines, whether the visual content is used to create an opacity mask on the event surface. If masking is on, the content's pixel luminance (or, its inverse) defines transparency within element's viewport. The alpha masking allows, for example, create transparent holes on the event surface.                Int32         
AntiAliasing        if true, the rendered content will be antialiased for smoother visual appeariance. If false, rendering will be authentic to its source, e.g. a bitmap.                Boolean         
Z Order        Indicates Z Order of the element on the given event                Int32         
Visible        Defines whether the element is visible                Boolean         
Rotation        Rotation angle in degrees                Double         
LSL Settings
Stream Type        Defines the LSL stream that delivers signal data                String         
LSL Stream        Defines which LSL stream will be connected at runtime. You must have the LSL stream running, when you change this property for the first time. Note that the channel configuration of the element is updated each time as you change this property                String         
Chink Size        Defines the chuck size (in ms) in signal acquisition                clTime         
Effects
Transparent Color        The color of the original pixels of rendered content that will be set as transparent                stColor         
Transparent Tolerance        Tolerance ratio for choosing colors that become transparent. Zero means that effect is not applied, 1 denotes that all colors will become trasparent                Int32         
Color Mask        Produces a multiplicative combination of the original pixels and the selected mask color (except the alpha channel).  The effect emulates a look through a colored glass.  White or transparent mask color dont change the original pixels                stColor         
Opacity        Opacity of the rendered content                Int32         
Contrast        Contrast of the rendered content                Int32         
Brightness        Brightness the rendered content                Int32         
Saturation        Saturation of the rendered content                Double         
Pixelation        Pixelation of the rendered content                Int32         
Blurring        The radius used in the gaussian blur of rendered content, as a pixel-based factor. The default is 0 which means no blurring.                Int32         
Scrambling        Defines a proportion of the scrambled voxels                Double         
Scrambling Grid Size        Defines dimensions of the scrambling grid. The dimensions has to be less than the element size have the zero reminders to that                clSize         
Positional Jitter
Reset Jitter Now        Runtime command that resets the positional jitter.                Boolean         
Current Jitter        Returns the current jitter                clPoint         
Jitter Range        Defines a possible range for the random jitter. The range is centered to the position of the element.                clSize         
Test Jitter        Click to test the current jitter                Boolean         

This element renders a video clip made of sequential video frames, which are streamed by an external app/hardware by the LSL protocol

Description

Apart from bio-signals, the LSL protocol allows streaming other data, such as text and video. The LSL video element can read a LSL stream that sends sequential video frames in real-time. The frames must be stored in the uncompressed RGB24 formats (3 bytes per pixel). The LSL stream must have a channel number equal to the total number of pixels in a single video frame. Each channel thus streams a color of the same single pixel represented by three Int8 (byte) values.

Practical Use

Configuring the element

  1. Add a new LSL Video element to a stimulus event and go to its properties
  2. Make sure that a LSL video stream is running and visible in a network. You may need to start an application that generates the video stream
  3. Define Stream Type property, if it is known. If it is not, make the property blank
  4. Expand an editor for the LSL stream property. If the target stream is detected, it will be available for selection. If not, check the stream and re-select the element in the EventIDE GUI
  5. Set the size and position of the frame rendering area on the event surface

Notes

  • The LSL video stream must be active before an onset of the parent event
  • The element automatically starts rendering received video frames at the onset of the parent event
  • Rendering is faster, if the size of the rendering area matches the original resolution of video frames
  • The element supports only RGB24 raw frames

 
  Name Size
- LSL-Video-Element-Icon.png 4.44 KB

ScrewTurn Wiki version 5.2.0.8. Some of the icons created by FamFamFam.