checkerBoardStimulus – using a GLSL shader to make the checkerboard More...

Detailed Description

checkerBoardStimulus – using a GLSL shader to make the checkerboard

See docs for more property details

Inheritance diagram for checkerboardStimulus:

Public Types
enum	Events { changeScale , changePhaseIncrement }

Public Types inherited from baseStimulus
enum	Events { readPanelUpdate }

Public Member Functions
function	checkerboardStimulus (in varargin)
	Class constructor.

function	setup (in me, in sM)
	Setup this object in preparation for use When displaying a stimulus object, the main properties that are to be modified are copied into cache copies of the property, both to convert from visual description (c/d, Hz, degrees) to computer metrics, and to be animated and modified as independant variables. So xPosition is copied to xPositionOut and converted from degrees to pixels. The animation and drawing functions use these modified properties, and when they are updated, for example to change to a new xPosition, internal methods ensure reconversion and update any dependent properties. This method initialises the object with all the cache properties for display.

function	set_sfOut (in me, in value)

function	set_tfOut (in me, in value)

function	set_reverseDirectionOut (in me, in value)

function	set_sizeOut (in me, in value)

function	set_xPositionOut (in me, in value)

function	set_yPositionOut (in me, in value)

function	update (in me)
	Update this stimulus object for display.

function	draw (in me, in win, in sf)
	Draw this stimulus object for display.

function	animate (in me)
	Animate this object for runExperiment.

function	reset (in me)
	Reset an structure for runExperiment.

function set	sf (in me, in value)
	sf Set method

function set	colour2 (in me, in value)
	SET Colour2 method Allow 1 (R=G=B) 3 (RGB) or 4 (RGBA) value colour.

function set	baseColour (in me, in value)
	SET baseColour method Allow 1 (R=G=B) 3 (RGB) or 4 (RGBA) value colour.

function	calculatePhase (in me)
	calculate phase offset

Public Member Functions inherited from baseStimulus
virtual	setup (in runObject)
	ALL Children must implement these 5 methods!

virtual	draw (in runObject)
	draw to the screen buffer, ready for flip()

function	baseStimulus (in varargin)
	Class constructor.

function set	colour (in me, in value)
	colour set method Allow 1 (R=G=B) 3 (RGB) or 4 (RGBA) value colour

function set	alpha (in me, in value)
	alpha set method

function get	delta (in me)
	delta Get method delta is the normalised number of pixels per frame to move a stimulus

function get	dX (in me)
	dX Get method X position increment for a given delta and angle

function get	dY (in me)
	dY Get method Y position increment for a given delta and angle

function	show (in me)
	Method to set isVisible=true.

function	hide (in me)
	Method to set isVisible=false.

function	setOffTime (in me, in time)
	set offTime

function	setDelayTime (in me, in time)
	set delayTime

function	resetTicks (in me)
	reset the various tick counters for our stimulus

function	getMousePosition (in me)
	get mouse position we make sure this is only called once per animation tick to improve performance and ensure all stimuli that are following mouse position have consistent X and Y per frame update This sets mouseX and mouseY and mouseValid if mouse is within PTB screen (useful for mouse override positioning for stimuli)

function	run (in me, in benchmark, in runtime, in s, in forceScreen, in showVBL)
	Run stimulus in a window to preview it.

function	makePanel (in me, in parent)
	make a GUI properties panel for this object

function	selectFilePanel (in me, in varargin)
	read values from a GUI properties panel for this object

function	readPanel (in me, in varargin)
	read values from a GUI properties panel for this object

function	showPanel (in me)
	show GUI properties panel for this object

function	hidePanel (in me)
	hide GUI properties panel for this object

function	closePanel (in me, in varargin)
	close GUI panel for this object

function	cleanHandles (in me, in ignoredArg)
	clean any handles

function	getP (in me, in name, in range)
	gets a property copy or original property

function	setP (in me, in name, in value)
	sets a property copy or original property

function	updateXY (in me, in x, in y, in useDegrees)
	Update only position info, faster and doesn't reset image etc.

Public Member Functions inherited from optickaCore
function	optickaCore (in varargin)
	Class constructor.

function get	fullName (in me)

function	getALF (in me, in subject, in sessionPrefix, in lab, in create)

function	findAttributes (in me, in attrName, in attrValue)

function	findAttributesandType (in me, in attrName, in attrValue, in type)
	find properties of object with specific attributes, for example all properties whose GetAcccess attribute is public and type is logical.

function	findPropertyDefault (in me, in propName)

function	clone (in me)
	Use this syntax to make a deep copy of the object, i.e. OBJ_OUT has the same field values, but will not behave as a handle-copy of me anymore.

function	checkSuperclasses (in List)

function	editProperties (in me, in properties)
	method to modify a set of properties

function	setProp (in me, in property, in value)
	method to fast change a particular value. This is useful for use in anonymous functions, like in the state machine.

function	initialiseGlobals (in me, in doReset, in doOpen)

function	initialiseSaveFile (in me)
	Initialise Save prefix.

function	checkPaths (in me)
	checks the paths are valid

Public Attributes
Property	type
	family type

Property	sf
	spatial frequency of the checkerboard

Property	tf
	temporal frequency of the checkerboard

Property	colour2
	second colour of the checkerboard

Property	baseColour

Property	rotateTexture
	rotate the grating patch (false) or the grating texture within the patch (default = true)?

Property	phase
	phase of grating

Property	contrast
	contrast of grating (technically the contrast from the baseColour)

Property	mask
	use a circular mask for the grating (default = true).

Property	reverseDirection
	direction of the drift; default = false means drift left>right when angle is 0deg.

Property	direction
	the direction of the grating object if moving.

Property	correctPhase

Property	phaseReverseTime
	Reverse phase of grating X times per second? Useful with a static grating for linearity testing.

Property	phaseOfReverse
	What phase to use for reverse?

Property	aspectRatio
	aspect ratio of the grating

Property	specialFlags
	special flags passed to drawing functions

Property	family

Property	scale
	scale is used when changing size as an independent variable to keep sf accurate

Property	phaseIncrement
	the phase amount we need to add for each frame of animation

Public Attributes inherited from baseStimulus
Property	type
	stimulus type

Property	xPosition

Property	yPosition

Property	size

Property	colour

Property	alpha
	Alpha (opacity) [0-1], this gets combined with the RGB colour.

Property	startPosition

Property	speed

Property	angle
	angle in degrees (0 - 360)

Property	delayTime

Property	offTime
	time to turn stimulus off, relative to stimulus onset

Property	isVisible
	true or false, whether to draw() this object

Property	mouseOverride
	override X and Y position with mouse input? Useful for RF mapping

Property	showOnTracker
	show the position on the Eyetracker display?

Property	verbose
	Do we log extra details to the command-line?

Property	xFinal

Property	yFinal

Property	mvRect

Property	szIsPx

Property	szPx
	computed size in pixels

Property	szD
	computed size in °

Property	xFinalD
	X and Y position in °

Property	yFinalD

Property	isRect

Property	tick
	tick updates +1 on each call of draw (even if delay or off is true and no stimulus is drawn, resets on each update

Property	drawTick
	draw tick only updates when a draw is actually performed, resets on each update

Property	ppd
	pixels per degree (normally inhereted from screenManager)

Property	delta
	What our per-frame motion delta is.

Property	dX
	X update which is computed from our speed and angle.

Property	dY
	X update which is computed from our speed and angle.

Public Attributes inherited from optickaCore
Property	name
	object name

Property	comment
	comment

Property	verbose
	verbose logging, subclasses must assign this. This is normally logical true/false

Property	dateStamp
	clock() dateStamp set on construction

Property	uuid
	universal ID

Property	paths
	storage of various paths

Property	fullName
	The fullName is the object name combined with its uuid and class name.

Protected Member Functions
function	setRect (in me)
	setRect setRect makes the PsychRect based on the texture and screen values this is modified over parent method as gratings have slightly different requirements.

function	calculateScale (in me, in ignoredArg, in ignoredArg)
	calculateScale Use an event to recalculate scale as get method is slower (called many more times), than an event which is only called on update

function	calculatePhaseIncrement (in me, in ignoredArg, in ignoredArg)
	calculatePhaseIncrement Use an event to recalculate as get method is slower (called many more times), than an event which is only called on update

Protected Member Functions inherited from baseStimulus
function	addRuntimeProperties (in me)
	These are transient properties that specify actions during runtime.

function	updateRuntimeProperties (in me)
	Update transient properties that specify actions during runtime.

function	computePosition (in me)
	compute xFinal and yFinal (in pixels) taking startPosition, xPosition, yPosition and direction/angle into account

function	setAnimationDelta (in me)

function	setRect (in me)

function	toStructure (in me, in tmp)
	Converts properties to a structure.

function	removeTmpProperties (in me)
	Finds and removes dynamic properties.

function	delete (in me)

Protected Member Functions inherited from optickaCore
function	parseArgs (in me, in args, in allowedProperties)
	Sets properties from a structure or normal arguments pairs, ignores invalid or non-allowed properties.

function	addArgs (in me, in args)

function	setPaths (in me)
	Sets properties from a structure or normal arguments pairs, ignores invalid or non-allowed properties.

function	getFonts (in me)
	set paths for object

function	toStructure (in me)
	Converts properties to a structure.

function	getType (in me, in in)

function	logOutput (in me, in in, in message, in override)
	Give a metaproperty return the likely property class.

function	salutation (in me, in varargin)
	Prints messages dependent on verbosity.

Protected Attributes
Property	sfCache

Property	sfRecurse
	to stop a loop between set method and an event

Property	allowedProperties
	allowed properties passed to object upon construction

Property	ignoreProperties
	properties to not create transient copies of during setup phase

Property	phaseCounter
	how many frames between phase reverses

Property	maskValue
	mask value (radius for the procedural shader)

Property	shader
	the raw shader, we can try to change colours.

Protected Attributes inherited from baseStimulus
Property	family
	the stimulus family (grating, dots etc.)

Property	texture
	Our texture pointer for texture-based stimuli.

Property	handles
	handles for the GUI

Property	sM
	our screen manager

Property	animator
	animation manager

Property	screenVals
	screen settings generated by sM on setup

Property	isSetup

Property	isGUI
	is panel constructed?

Property	dstRect
	initial screen rectangle position [LEFT TOP RIGHT BOTTOM]

Property	mouseValid
	is mouse position within screen co-ordinates?

Property	mouseX
	mouse X position

Property	mouseY
	mouse Y position

Property	delayTicks
	delay ticks to wait until display

Property	offTicks
	ticks before stimulus turns off

Property	inSetup
	are we setting up?

Property	delta_
	delta cache

Property	dX_
	dX cache

Property	dY_
	dY cache

Property	isInSetColour
	deal with interaction of colour and alpha

Property	setLoop

Property	ignorePropertiesBase
	Which properties to ignore cloning when making transient copies in setup.

Property	ignorePropertiesUIBase
	Which properties to not draw in the UI panel.

Protected Attributes inherited from optickaCore
Property	cloning
	are we cloning this from another object

Property	mversion
	Matlab version number, this is transient so it is not saved.

Property	sansFont
	sans font

Property	monoFont
	monoFont

Property	className
	class name

Property	savePrefix
	save prefix generated from clock time

Property	fullName_
	cached full name

Additional Inherited Members
Static Public Member Functions inherited from baseStimulus
static function	d2r (in degrees)
	degrees2radians

static function	r2d (in r)
	radians2degrees

static function	findDistance (in x1, in y1, in x2, in y2)
	findDistance in X and Y coordinates

static function	updatePosition (in delta, in angle)
	updatePosition returns dX and dY given an angle and delta

Static Public Member Functions inherited from optickaCore
static function	makeArgs (in args)
	Converts cell args to structure array.

static function	addDefaults (in args, in defs)
	add default options to arg input

static function	hasKey (in in, in key)
	check if a struct / object has a propery / field

static function	getKeys (in device)
	PTB Get key presses, stops key bouncing.

Member Enumeration Documentation

◆ Events

enum checkerboardStimulus::Events

Enumerator
changeScale	triggered when changing size, so we can change sf etc to compensate
changePhaseIncrement	triggered when changing tf or drift direction

                   :length(fn)
                if ~matches(fn{j}, me.ignoreProperties) %create a temporary dynamic property
                    p=me.addprop([fn{j} 'Out']);
                    if strcmp(fn{j},'sf');p.SetMethod = @set_sfOut;end
                    if strcmp(fn{j},'tf');p.SetMethod = @set_tfOut;end
                    if strcmp(fn{j},'reverseDirection');p.SetMethod = @set_reverseDirectionOut;end
                    if strcmp(fn{j},'size');p.SetMethod = @set_sizeOut;end
                    if strcmp(fn{j},'xPosition');p.SetMethod = @set_xPositionOut;end
                    if strcmp(fn{j},'yPosition');p.SetMethod = @set_yPositionOut;end
                    me.([fn{j} 'Out']) = me.(fn{j}); %copy our property value to our tempory copy
                end
            end
 
            addRuntimeProperties(me);
            
            if isempty(me.findprop('rotateMode'));p=me.addprop('rotateMode');p.Transient=true;p.Hidden=true;end
            if me.rotateTexture
                me.rotateMode = kPsychUseTextureMatrixForRotation;
            else
                me.rotateMode = [];
            end
            me.specialFlags = mor(me.specialFlags, me.rotateMode);
 
            if isempty(me.findprop('gratingSize'));p=me.addprop('gratingSize');p.Transient=true;end
            me.gratingSize = round(me.ppd*me.size); %virtual support larger than initial size
            
            if isempty(me.findprop('phaseIncrement'))
                p=me.addprop('phaseIncrement');
            end
            
            if isempty(me.findprop('driftPhase'));p=me.addprop('driftPhase');p.Transient=true;end
            if me.correctPhase
                ps=me.calculatePhase;
                me.driftPhase=me.phaseOut-ps;
            else
                me.driftPhase=me.phaseOut;
            end
            
            if isempty(me.findprop('res'));p=me.addprop('res');p.Transient=true;end
            
            switch length(me.aspectRatio)
                case 1
                    me.res = round([me.gratingSize*me.aspectRatio me.gratingSize]);
                case 2
                    me.res = round([me.gratingSize*me.aspectRatio(1) me.gratingSize*me.aspectRatio(2)]);
            end
            if max(me.res) > me.sM.screenVals.width %scale to be no larger than screen width
                me.res = floor( me.res / (max(me.res) / me.sM.screenVals.width));
            end
            
            if me.mask == true
                me.maskValue = floor((me.ppd*me.size))/2;
            else
                me.maskValue = [];
            end
            
            if me.phaseReverseTime > 0
                me.phaseCounter = round(me.phaseReverseTime / me.sM.screenVals.ifi);
            end
            
            if isempty(me.baseColour)
                me.baseColourOut = me.sM.backgroundColour;
                me.baseColourOut(4) = me.alpha;
            end
                
            % this is a checkerboard shader
            [me.texture, ~, me.shader] = CreateProceduralCheckerboard(me.sM.win, ...
                me.res(1), me.res(2), me.maskValue);
            
            me.inSetup = false; me.isSetup = true;
            calculateScale(me);
            computePosition(me);
            setRect(me);
 
            function set_sfOut(me,value)
                if value <= 0; value = 0.01; end
                me.sfCache = value;
                me.sfOut = me.sfCache;
                %fprintf('SET SFOut: %.2f | in: %.2f | scale: %.2f\n', me.sfOut, me.sfCache, me.scale);
            end
            function set_tfOut(me,value)
                me.tfOut = value;
                notify(me,'changePhaseIncrement');
            end
            function set_reverseDirectionOut(me,value)
                me.reverseDirectionOut = value;
                notify(me,'changePhaseIncrement');
            end
            function set_sizeOut(me,value)
                me.sizeOut = ceil(value*me.ppd);
                me.szPx = me.sizeOut;
                %fprintf('SET sizeOut: %.2f | in: %.2f \n', me.sizeOut, value);
            end
            function set_xPositionOut(me, value)
                me.xPositionOut = value * me.ppd;
            end
            function set_yPositionOut(me,value)
                me.yPositionOut = value*me.ppd; 
            end
            
        end
        
        % ===================================================================
        %> @brief Update this stimulus object for display
        %>
        % ===================================================================
        function update(me)
            resetTicks(me);
            if me.correctPhase
                ps=me.calculatePhase;
                me.driftPhase=me.phaseOut-ps;
            else
                me.driftPhase=me.phaseOut;
            end
            glUseProgram(me.shader);
            if me.mask == true
                me.maskValue = me.sizeOut/2;
            else
                me.maskValue = 0;
            end
            glUniform1f(glGetUniformLocation(me.shader, 'radius'), me.maskValue);
            glUseProgram(0);
            calculateScale(me);
            computePosition(me);
            setRect(me);
        end
        
        % ===================================================================
        %> @brief Draw this stimulus object for display
        %>
        %> @param win -- optional [i.e. offscreen] window pointer
        %> @param sf - optional special Flags override
        % ===================================================================
        function draw(me, win, sf)
            if ~exist('win','var'); win = me.sM.win; end
            if ~exist('sf','var'); sf = me.specialFlags; end
            if me.isVisible && me.tick >= me.delayTicks && me.tick < me.offTicks
                Screen('DrawTexture', win, me.texture, [],me.mvRect,...
                    me.angleOut, [], [], me.baseColourOut, [], sf,...
                    [me.ppd, me.sfOut, me.contrastOut, me.driftPhase, ...
                    me.colourOut, me.colour2Out]);
                me.drawTick = me.drawTick + 1;
            end
            if me.isVisible; me.tick = me.tick + 1; end
        end
        
        % ===================================================================
        %> @brief Animate this object for runExperiment
        %>
        % ===================================================================
        function animate(me)
            if me.isVisible && me.tick >= me.delayTicks
                if me.mouseOverride
                    getMousePosition(me);
                    if me.mouseValid
                        me.mvRect = CenterRectOnPointd(me.mvRect, me.mouseX, me.mouseY);
                    end
                end
                if me.doMotion
                    me.mvRect=OffsetRect(me.mvRect,me.dX_,me.dY_);
                end
                if me.doDrift
                    me.driftPhase = me.driftPhase + me.phaseIncrement;
                    %fprintf('Drift Phase: %.2f\n',me.driftPhase);
                end
                if mod(me.tick, me.phaseCounter) == 0
                    %tmp = me.colourOut;me.colourOut = me.colour2Out;me.colour2Out = tmp;
                    me.driftPhase = me.driftPhase + me.phaseOfReverse;
                end
            end
        end
        
        % ===================================================================
        %> @brief Reset an structure for runExperiment
        %>
        %> @param rE runExperiment object for reference
        %> @return stimulus structure.
        % ===================================================================
        function reset(me)
            resetTicks(me);
            if ~isempty(me.texture) && Screen(me.texture,'WindowKind') == -1
                try Screen('Close',me.texture); end
            end
            me.texture=[];
            me.shader=[];
            if me.mask > 0
                me.mask = true;
            end
            me.sfCache = me.sf;
            me.maskValue = [];
            removeTmpProperties(me);
        end
        
        % ===================================================================
        %> @brief sf Set method
        %>
        % ===================================================================
        function set.sf(me,value)
            if value <= 0; value = 0.05; end
            me.sfCache = value;
            me.sf = value;
            me.salutation(['set sf: ' num2str(me.sf)],'Custom set method')
        end
        
        % ===================================================================
        %> @brief SET Colour2 method
        %> Allow 1 (R=G=B) 3 (RGB) or 4 (RGBA) value colour
        % ===================================================================
        function set.colour2(me,value)
            len=length(value);
            switch len
                case {4,3}
                    me.colour2 = [value(1:3) me.alpha]; %force our alpha to override
                case 1
                    me.colour2 = [value value value me.alpha]; %construct RGBA
                otherwise
                    me.colour2 = [1 1 1 me.alpha]; %return white for everything else
            end
            me.colour2(me.colour2<0)=0; me.colour2(me.colour2>1)=1;
        end
        
        % ===================================================================
        %> @brief SET baseColour method
        %> Allow 1 (R=G=B) 3 (RGB) or 4 (RGBA) value colour
        % ===================================================================
        function set.baseColour(me,value)
            len=length(value);
            switch len
                case 4
                    me.baseColour = value;
                case 3
                    me.baseColour = [value(1:3) me.alpha]; %force our alpha to override
                case 1
                    me.baseColour = [value value value me.alpha]; %construct RGBA
                case 0
                    me.baseColour = [];
                otherwise
                    me.baseColour = [1 1 1 me.alpha]; %return white for everything else 
            end
            me.baseColour(me.baseColour<0)=0; me.baseColour(me.baseColour>1)=1;
        end
            
        % ===================================================================
        %> @brief calculate phase offset
        %>
        % ===================================================================
        function phase = calculatePhase(me)
            phase = 0;
            if me.correctPhase > 0
                ppd = me.ppd;
                size = (me.sizeOut/2); %divide by 2 to get the 0 point
                sfTmp = (me.sfOut/me.scale)*me.ppd;
                md = size / (ppd/sfTmp);
                md=md-floor(md);
                phase = (360*md);
            end
        end
        
    end %---END PUBLIC METHODS---%
    
    
    %=======================================================================
    methods ( Access = protected ) %-------PROTECTED METHODS-----%
    %=======================================================================
    
        % ===================================================================
        %> @brief setRect
        %> setRect makes the PsychRect based on the texture and screen values
        %> this is modified over parent method as gratings have slightly different
        %> requirements.
        % ===================================================================
        function setRect(me)
            %me.dstRect=Screen('Rect',me.texture);
            me.dstRect=ScaleRect([0 0 me.res(1) me.res(2)],me.scale,me.scale);
            if me.mouseOverride && me.mouseValid
                    me.dstRect = CenterRectOnPointd(me.dstRect, me.mouseX, me.mouseY);
            else
                if isempty(me.findprop('directionOut'))
                    [sx, sy]=pol2cart(me.d2r(me.direction),me.startPosition);
                else
                    [sx, sy]=pol2cart(me.d2r(me.directionOut),me.startPosition);
                end
                me.dstRect=CenterRectOnPointd(me.dstRect,me.sM.xCenter,me.sM.yCenter);
                if isempty(me.findprop('xPositionOut'))
                    me.dstRect=OffsetRect(me.dstRect,(me.xPosition)*me.ppd,(me.yPosition)*me.ppd);
                else
                    me.dstRect=OffsetRect(me.dstRect,me.xPositionOut+(sx*me.ppd),me.yPositionOut+(sy*me.ppd));
                end
            end
            me.mvRect=me.dstRect;
            me.szPx = RectWidth(me.mvRect);
            me.setAnimationDelta();
        end
        
        
        % ===================================================================
        %> @brief calculateScale 
        %> Use an event to recalculate scale as get method is slower (called
        %> many more times), than an event which is only called on update
        % ===================================================================
        function calculateScale(me,~,~)
            me.scale = me.sizeOut/(me.size*me.ppd);
            me.maskValue = me.sizeOut / 2;
            if me.verbose;fprintf('Calculate SFOut: %.2f | in: %.2f | scale: %.2f | size: %.2f\n', me.sfOut, me.sfCache, me.scale, me.sizeOut);end
        end
        
        % ===================================================================
        %> @brief calculatePhaseIncrement
        %> Use an event to recalculate as get method is slower (called
        %> many more times), than an event which is only called on update
        % ===================================================================
        function calculatePhaseIncrement(me,~,~)
            if ~isempty(me.findprop('tfOut'))
                me.phaseIncrement = (me.tfOut * 360) * me.sM.screenVals.ifi;
                if ~isempty(me.findprop('reverseDirectionOut'))
                    if me.reverseDirectionOut == false
                        me.phaseIncrement = -me.phaseIncrement;
                    end
                end
            end
        end
        
    end
end

Constructor & Destructor Documentation

◆ checkerboardStimulus()

function checkerboardStimulus::checkerboardStimulus ( in varargin )

Class constructor.

More detailed description of what the constructor does.

Parameters

args	are passed as a structure of properties which is parsed.

Returns: instance of class.

Member Function Documentation

◆ animate()

function checkerboardStimulus::animate ( in me )

virtual

Animate this object for runExperiment.

Reimplemented from baseStimulus.

◆ baseColour()

function set checkerboardStimulus::baseColour	(	in	me,
		in	value
	)

SET baseColour method Allow 1 (R=G=B) 3 (RGB) or 4 (RGBA) value colour.

◆ calculatePhase()

function checkerboardStimulus::calculatePhase ( in me )

calculate phase offset

◆ calculatePhaseIncrement()

function checkerboardStimulus::calculatePhaseIncrement	(	in	me,
		in	ignoredArg,
		in	ignoredArg
	)

protected

calculatePhaseIncrement Use an event to recalculate as get method is slower (called many more times), than an event which is only called on update

◆ calculateScale()

function checkerboardStimulus::calculateScale	(	in	me,
		in	ignoredArg,
		in	ignoredArg
	)

protected

calculateScale Use an event to recalculate scale as get method is slower (called many more times), than an event which is only called on update

◆ colour2()

function set checkerboardStimulus::colour2	(	in	me,
		in	value
	)

SET Colour2 method Allow 1 (R=G=B) 3 (RGB) or 4 (RGBA) value colour.

◆ draw()

function checkerboardStimulus::draw	(	in	me,
		in	win,
		in	sf
	)

Draw this stimulus object for display.

Parameters

win	– optional [i.e. offscreen] window pointer
sf	- optional special Flags override

◆ reset()

function checkerboardStimulus::reset ( in me )

virtual

Reset an structure for runExperiment.

Parameters

rE	runExperiment object for reference

Returns: stimulus structure.

Reimplemented from baseStimulus.

◆ set_reverseDirectionOut()

function checkerboardStimulus::set_reverseDirectionOut	(	in	me,
		in	value
	)

◆ set_sfOut()

function checkerboardStimulus::set_sfOut	(	in	me,
		in	value
	)

◆ set_sizeOut()

function checkerboardStimulus::set_sizeOut	(	in	me,
		in	value
	)

◆ set_tfOut()

function checkerboardStimulus::set_tfOut	(	in	me,
		in	value
	)

◆ set_xPositionOut()

function checkerboardStimulus::set_xPositionOut	(	in	me,
		in	value
	)

◆ set_yPositionOut()

function checkerboardStimulus::set_yPositionOut	(	in	me,
		in	value
	)

◆ setRect()

function checkerboardStimulus::setRect ( in me )

protected

setRect setRect makes the PsychRect based on the texture and screen values this is modified over parent method as gratings have slightly different requirements.

◆ setup()

function checkerboardStimulus::setup	(	in	me,
		in	sM
	)

Setup this object in preparation for use When displaying a stimulus object, the main properties that are to be modified are copied into cache copies of the property, both to convert from visual description (c/d, Hz, degrees) to computer metrics, and to be animated and modified as independant variables. So xPosition is copied to xPositionOut and converted from degrees to pixels. The animation and drawing functions use these modified properties, and when they are updated, for example to change to a new xPosition, internal methods ensure reconversion and update any dependent properties. This method initialises the object with all the cache properties for display.

Parameters

sM	screenManager object to use

◆ sf()

function set checkerboardStimulus::sf	(	in	me,
		in	value
	)

sf Set method

◆ update()

function checkerboardStimulus::update ( in me )

virtual

Update this stimulus object for display.

Reimplemented from baseStimulus.

Member Data Documentation

◆ allowedProperties

Property checkerboardStimulus::allowedProperties

protected

allowed properties passed to object upon construction

◆ aspectRatio

Property checkerboardStimulus::aspectRatio

aspect ratio of the grating

◆ baseColour

Property checkerboardStimulus::baseColour

base colour from which colour and colour2 are blended via contrast value if empty [default], uses the background colour from screenManager

◆ colour2

Property checkerboardStimulus::colour2

second colour of the checkerboard

◆ contrast

Property checkerboardStimulus::contrast

contrast of grating (technically the contrast from the baseColour)

◆ correctPhase

Property checkerboardStimulus::correctPhase

Do we need to correct the phase to be relative to center not edge? This enables centre surround stimuli are phase matched, and if we enlarge a grating object its phase stays identical at the centre of the object (where we would imagine our RF)

◆ direction

Property checkerboardStimulus::direction

the direction of the grating object if moving.

◆ family

Property checkerboardStimulus::family

◆ ignoreProperties

Property checkerboardStimulus::ignoreProperties

protected

properties to not create transient copies of during setup phase

◆ mask

Property checkerboardStimulus::mask

use a circular mask for the grating (default = true).

◆ maskValue

Property checkerboardStimulus::maskValue

protected

mask value (radius for the procedural shader)

◆ phase

Property checkerboardStimulus::phase

phase of grating

◆ phaseCounter

Property checkerboardStimulus::phaseCounter

protected

how many frames between phase reverses

◆ phaseIncrement

Property checkerboardStimulus::phaseIncrement

the phase amount we need to add for each frame of animation

◆ phaseOfReverse

Property checkerboardStimulus::phaseOfReverse

What phase to use for reverse?

◆ phaseReverseTime

Property checkerboardStimulus::phaseReverseTime

Reverse phase of grating X times per second? Useful with a static grating for linearity testing.

◆ reverseDirection

Property checkerboardStimulus::reverseDirection

direction of the drift; default = false means drift left>right when angle is 0deg.

◆ rotateTexture

Property checkerboardStimulus::rotateTexture

rotate the grating patch (false) or the grating texture within the patch (default = true)?

◆ scale

Property checkerboardStimulus::scale

scale is used when changing size as an independent variable to keep sf accurate

◆ sf

Property checkerboardStimulus::sf

spatial frequency of the checkerboard

◆ sfCache

Property checkerboardStimulus::sfCache

protected

as get methods are slow, we cache sf, then recalculate sf whenever changeScale event is called

◆ sfRecurse

Property checkerboardStimulus::sfRecurse

protected

to stop a loop between set method and an event

◆ shader

Property checkerboardStimulus::shader

protected

the raw shader, we can try to change colours.

◆ specialFlags

Property checkerboardStimulus::specialFlags

special flags passed to drawing functions

◆ tf

Property checkerboardStimulus::tf

temporal frequency of the checkerboard

◆ type

Property checkerboardStimulus::type

family type

The documentation for this class was generated from the following file:

stimuli/checkerboardStimulus.m

Detailed Description

Public Types

Public Member Functions

Public Attributes

Protected Member Functions

Protected Attributes

Additional Inherited Members

Member Enumeration Documentation

◆ Events

Constructor & Destructor Documentation

◆ checkerboardStimulus()

Member Function Documentation

◆ animate()

◆ baseColour()

◆ calculatePhase()

◆ calculatePhaseIncrement()

◆ calculateScale()

◆ colour2()

◆ draw()

◆ reset()

◆ set_reverseDirectionOut()

◆ set_sfOut()

◆ set_sizeOut()

◆ set_tfOut()

◆ set_xPositionOut()

◆ set_yPositionOut()

◆ setRect()

◆ setup()

◆ sf()

◆ update()

Member Data Documentation

◆ allowedProperties

◆ aspectRatio

◆ baseColour

◆ colour2

◆ contrast

◆ correctPhase

◆ direction

◆ family

◆ ignoreProperties

◆ mask

◆ maskValue

◆ phase

◆ phaseCounter

◆ phaseIncrement

◆ phaseOfReverse

◆ phaseReverseTime

◆ reverseDirection

◆ rotateTexture

◆ scale

◆ sf

◆ sfCache

◆ sfRecurse

◆ shader

◆ specialFlags

◆ tf

◆ type