How to collect and use photoCaptures and screenshots during runtime
This help tutorial explains how to collect and use your participants' photoCaptures (and screenshots) while running your Inquisit script.
(It's important to note that Inquisit will need to get permission from your users to use their internal cameras before such scripts can be run.
This permission request process is built-into the Inquisit software on most platforms.)
Example: You want to use an Inquisit Cyberball script and use real-life images of your players, including your participants.
Collect and use photoCaptures
To collect and use photoCaptures, we need three core elements:
- A <picture> element to store the collected photoCapture
- A trial to collect the photoCapture and store it under the picture element
- A trial that uses the photoCapture
//will store the selfie (can be used in other parts of a script) <picture selfie> </picture>
//presents camera to take a photoCapture (allows redos) <trial selfieTaker> / trialDuration = 0 / photoCapture = true //if set to 'true', the trial provides the camera App! / onTrialEnd = { picture.selfie.appendItem(this.lastPhotoCapturePath); //stores the photoCapture in <picture selfie> } </trial>The trial's property 'trial.XXX.lastPhotoCapturePath' is key for storing the location of the photo for further use.
//uses the presented photoCapture during a trial <trial showSelfie> / stimulusFrames = [1 = selfie] //presents the photoCapture that was taken / validResponse = (" ") </trial>
Collect and use screenCapture
The setup to collect and use screenCaptures ('screenShots') is very similar. The core difference is the setup of the trial that takes the screenCapture. This trials does not provide a camera app but simply takes a screenshot at the end:
//trial takes a screenShot at the end of the trial <trial screenTaker> / stimulusFrames = [1 = myStim] //whatever stimulus are presented during the trial / trialDuration = 500 / screenCapture = true //if set to 'true', the trial takes a screenShot at the end of the trial / onTrialEnd = { picture.screenTaker.appendItem(this.lastScreenCapturePath); //stores the screenShot in <picture screenTaker> } </trial>The trial's property 'trial.XXX.lastScreenCapturePath' is key for storing the location of the screenShot for further use.
Example Scripts that Use a Selfie Maker
The following Millisecond library script provides a basic selfie maker module:
pizzagame
Note that the default versions of the pizzagame scripts do NOT run the selfie maker. However, if you download version7,
the zip file will include a helper script called 'selfietaker_inc.iqjs'.
This selfie maker can be activated via parameters settings.