MatVis Home Manual Commands Demonstration Code User Sites Acquiring MatVis

Neurometrics Home

System Trials Spatial LUTs Sprites Top of Page

example: error = MatVis('help')

this command prints this summary list of commands that you are reading.

Initialize the MatVis system, determine framerate
('init',number) where number is duration in frames for testing
('init',number,width,height) width & height in pixels
('init',number,width,height,depth) depth in bits (currently limited to 8 bits)
('init',number,width,height,depth,rate) rate in hertz

MatVis('initMode', mode)

Initialize the MatVis system for a supported video mode & determine the framerate
('initMode',mode) where mode is one returned by the showModes command.
('initMode,mode,number) where number is duration in frames for testing (default 500)

MatVis('getFramerate')

return current estimate of framerate in Hz.

MatVis('putFramerate')

set framerate estimate in Hz.

MatVis('showModes')

For each video mode supported print the width, height, and frame rate.

MatVis('setModeDimensions',mode)

set width,height,depth,rate according to the numbered mode

MatVis('background', backgroundLevel)

set the background intensity level (1-256)
if fixation point has been set, display it

MatVis('exit')

restore the normal MATLAB display interface

MatVis('flip')

flip from current screen, matvis-to-MATLAB or MATLAB-to-matvis

MatVis('vsync',count)

count - delay for count vertical sync pulses

MatVis('patch')

list history of patches to this version of MatVis

System Trials Spatial LUTs Sprites Top of Page

trial = condition or trial number
nImages = number of images in the trial
origin = image sequence location, [1,1] = upper left corner
extent = size of image, [100,200] =100 rows by 200 cols.

MatVis('trialLUT', trial, nTables)

trial = condition or trial number
nTables = number of look up tables in the trial

MatVis('fixation', origin, image)

Fixation point pattern superimposed on each video frame
origin= location of image on screen ([1 1] = upper left corner)
image values set to 0 are transparent

MatVis('print',ntrial)

Print to the MATLAB window the parameters for a trial
ntrial = the trial number

MatVis('run',trialNumber, mode)

trialNumber = Present the predefined trial of this number
mode = if true return to MATLAB window when trial has completed

System Trials Spatial LUTs Sprites Top of Page

Load an image for a specific condition/trial
trialNumber = trial number of image
nImage = image number in the sequence of images for the trial
[startframe stopframe] = start and stop image number for loading a sequence of images
image = image intensity values (0-255, transparent = 0) double or UINT8
type = type of logic operation (not functional)

MatVis('temporal', trialNumber, nrepeats, sequence[nframes][image#])

Arbitrary presentation order (and number of video frames) for each image
trialNumber = trial number associated with this temporal sequence
nrepeats = number of times to repeat the presentation order
sequence = number of frames for the image number listed

MatVis('flashImage',origin, flip, image)

Show now an arbitrary image (must have called init,trial & run first)
origin = location of image on screen ([1 1] = upper left corner)
flip = show it on next vertical sync, y/n= 1/0

System Trials Spatial LUTs Sprites Top of Page

Load a LUT for a specific condition/trial
trialNumber = trial number
nTable = LUT table number in the sequence of LUT's for the trial
red = 256 red intensity values (0-255, transparent = 0)
green = 256 green intensity values (0-255, transparent = 0)
blue = 256 blue intensity values (0-255, transparent = 0)

MatVis('temporalLUT', trialNumber, sequence[nframes][image#])

Arbitrary presentation order (and number of video frames) for each LUT
trialNumber = trial number associated with this LUT sequence
sequence = number of frames for the LUT number listed

MatVis('LUT8', [red], [green],[blue], start, stop)

Load a default LUT -otherwise the default is a ramp
start, stop - locations in the hardware LUT to be filled
[red], [green], [blue] - Three vectors of values in range 0-255.

System Trials Spatial LUTs Sprites Top of Page

Sprite commands do not implemented.
MatVis('setSprite', trial, level, dynamic)

Setup the Sprite structures
trial = current trial number
level = sprite number for trial, low numbers have low priority
dynamic = if = 0 then a static image, else new image each frame

MatVis('originSprite', trial, level, xorigin, yorigin)

Setup the Sprite origin locations
trial = current trial number
level = sprite number for trial, low numbers have low priority
xorigin = list of locations in x of sprite
yorigin = lost oflocation in y of sprite

MatVis('spatialSprite', trial, level, frame, image)

Load a spatialSprite image for one frame
trial = current trial number
level = sprite number for trial
frame = video frame number
image = 2D spatial pattern

System Trials Spatial LUTs Sprites Top of Page

MatVis Home Demostration Code User Sites Acquiring MatVis Neurometrics Home