Panorama Component¶

Panorama: Present a panoramic image (such as from a phone camera in Panorama mode) on screen.

Categories:: Stimuli
Works in:: PsychoPy

Note: Since this is still in beta, keep an eye out for bug fixes.

Parameters¶

Basic¶

The required attributes of the stimulus, controlling its basic function and behaviour

Name: Everything in a PsychoPy^® experiment needs a unique name. The name should contain only letters, numbers and underscores (no punctuation marks or spaces).

Start: When the Panorama Component should start, see Defining the onset/duration of components.

Expected start (s): If you are using frames to control timing of your stimuli, you can add an expected start time to display the component timeline in the routine.

Start type

How do you want to define your start point?

Options:

time (s)
frame N
condition

Stop: When the Panorama Component should stop, see Defining the onset/duration of components.

Expected duration (s): If you are using frames to control timing of your stimuli, you can add an expected duration to display the component timeline in the routine.

Stop type

How do you want to define your end point?

Options:

duration (s)
duration (frames)
time (s)
frame N
condition

Image: The image to be displayed - a filename, including path. The image used cannot be more than 18,000,000 pixels - this is roughly the resolution of a 6k screen

Position control

How to control looking around the panorama scene

Options:

Mouse
Drag
Keyboard (Arrow Keys)
Keyboard (WASD)
Keyboard (Custom keys)
Custom

Azimuth (if :ref:`panoramacomponent-posCtrl` is “Custom”): Horizontal look position, ranging from -1 (fully left) to 1 (fully right)

Elevation (if :ref:`panoramacomponent-posCtrl` is “Custom”): Vertical look position, ranging from -1 (fully down) to 1 (fully up)

Up / Down / Left / Right / Stop (if :ref:`panoramacomponent-posCtrl` is “Keyboard (Custom keys)”): What key corresponds to each view action?

Movement sensitivity (if :ref:`panoramacomponent-posCtrl` is not “Custom”)

Multiplier to apply to view changes. 1 means that moving the mouse from the center of the screen to the edge or holding down a key for 2s will rotate 180°.

Note: The bigger the multiplier, the quicker the movement

Smooth? (if :ref:`panoramacomponent-posCtrl` is not “Custom” or “Mouse”): Should movement be smoothed, so the view keeps moving a little after a change?

Zoom control

How to control zooming in and out of the panorama scene

Options:

Mouse Wheel
Mouse Wheel (Inverted)
Keyboard (Arrow Keys)
Keyboard (+-)
Keyboard (Custom keys)
Custom

Zoom (if :ref:`panoramacomponent-zoomCtrl` is “Custom”): How zoomed in the scene is, with 1 being no adjustment.

Zoom in / Zoom out (if :ref:`panoramacomponent-zoomCtrl` is “Keyboard (Custom keys)”): What keys correspond to zooming in and out?

Zoom sensitivity (if :ref:`panoramacomponent-zoomCtrl` is not “Custom”): Multiplier to apply to zoom changes. 1 means that pressing the zoom in key for 1s or scrolling the mouse wheel 100% zooms in 100%.

Interpolate

How should the image be interpolated if/when rescaled

Options:

linear
nearest

Data¶

What information about this Component should be saved?

Save onset/offset times: Store the onset/offset times in the data file (as well as in the log file).

Sync timing with screen refresh: Synchronize times with screen refresh (good for visual stimuli and responses based on them)

Testing¶

Tools for testing, debugging and checking the performance of this Component.

Disable Component: Disable this Component

Validate with…: Name of the Validator Routine to use to check the timing of this stimulus. Options are generated live, so will vary according to your setup.