up Inquisit Language Reference

screenCapture property

Indicates whether a snapshot of the screen as it appears during the final frame of the trial should be saved to an image file.

Member of

<block> <expt> <likert> <openended> <sliderTrial> <survey> <surveyPage> <trial>

Syntax

event.name.screenCapture

Read/Write

Type

boolean

Remarks

A value of 1 indicates the screenCapture will be saved, 0 indicates it will not.

This property is useful if you want to dynamically set trials to take screencaptures.

Examples

The following displays the value of screenCapture in a text stimulus:

<text myText>
/ items= ("screenCapture = <% trial.q1.screenCapture %>")
</text>

The following displays the value of screenCapture in an instruction page:

<page myPage>
screenCcapture = <% trial.q2.screenCapture %>
</page>

The following code shows how to use the 'screencapture' property to dynamically turn on and off the screencapture setting of a feedback trial. For correct responses, trial.feedback is instructed to take screencaptures. For error responses, no screencaptures will be taken.

<trial myTrial>
/ stimulusFrames = [1 = myStim]
/ validResponse = ("A", "B")
/ correctResponse = ("B")
/ onTrialEnd = {
  if (this.correct){
    trial.feedback.screenCapture = true;
  } else {
    trial.feedback.screenCapture = false;
  }
}
/ branch = {
  return trial.feedback;
}
</trial>

Copyright Millisecond Software, LLC. All rights reserved.