/*
* plugin for jsPsych based in Qisheng Li 11/2019. /// https://github.com/QishengLi/virtual_chinrest
Modified by Gustavo Juantorena 08/2020 // https://github.com/GEJ1
Contributions from Peter J. Kohler: https://github.com/pjkohler
*/
jsPsych.plugins["virtual-chinrest"] = (function () {
var plugin = {};
plugin.info = {
name: "virtual-chinrest",
parameters: {
resize_units: {
type: jsPsych.plugins.parameterType.STRING,
default: "none",
description:
'What units to resize to? ["none"/"cm"/"inch"/"deg"]. If "none", no resize will be done.',
},
pixels_per_unit: {
type: jsPsych.plugins.parameterType.INT,
pretty_name: "Pixels per unit",
default: 100,
description:
"After the scaling factor is applied, this many pixels will equal one unit of measurement.",
},
// mouse_adjustment: {
// type: jsPsych.plugins.parameterType.BOOL,
// pretty_name: "Adjust Using Mouse?",
// default: true,
// },
adjustment_prompt: {
type: jsPsych.plugins.parameterType.STRING,
default: `
Click and drag the lower right corner of the image until it is the same size as a credit card held up to the screen.
You can use any card that is the same size as a credit card, like a membership card or driver's license.
If you do not have access to a real card you can use a ruler to measure the image width to 3.37 inches or 85.6 mm.
`,
description:
"Any content here will be displayed above the card stimulus.",
},
adjustment_button_prompt: {
type: jsPsych.plugins.parameterType.STRING,
default: "Click here when the image is the correct size",
description:
" Content of the button displayed below the card stimulus.",
},
item_path: {
type: jsPsych.plugins.parameterType.STRING,
default: "img/card.png",
},
item_height_mm: {
type: jsPsych.plugins.parameterType.FLOAT,
pretty_name: "Item height",
default: 53.98,
description: "The height of the item to be measured.",
},
item_width_mm: {
type: jsPsych.plugins.parameterType.FLOAT,
pretty_name: "Item width",
default: 85.6,
description: "The width of the item to be measured.",
},
item_init_size: {
type: jsPsych.plugins.parameterType.INT,
pretty_name: "Initial Size",
default: 250,
description:
"The initial size of the card, in pixels, along the largest dimension.",
},
blindspot_reps: {
type: jsPsych.plugins.parameterType.INT,
pretty_name: "Blindspot measurement repetitions",
default: 5,
description:
"How many times to measure the blindspot location? If 0, blindspot will not detected and viewing distance not computed.",
},
blindspot_prompt: {
type: jsPsych.plugins.parameterType.STRING,
default: `
Now we will quickly measure how far away you are sitting.
Put your left hand on the space bar.
Cover your right eye with your right hand.
Using your left eye, focus on the black square. Keep your focus on the black square.
The red ball will disappear as it moves from right to left. Press the space bar as soon as the ball disappears.
Press the space bar when you are ready to begin.
`
},
blindspot_start_prompt: {
type: jsPsych.plugins.parameterType.STRING,
default: "Start",
description: "Content of the start button for the blindspot tasks.",
},
blindspot_measurements_prompt: {
type: jsPsych.plugins.parameterType.STRING,
default: "Remaining measurements: ",
description: "Text accompanying the remaining measures counter",
},
viewing_distance_report: {
type: jsPsych.plugins.parameterType.STRING,
default: "
Based on your responses, you are sitting about from the screen.
Does that seem about right?
",
description:
'If "none" is given, viewing distance will not be reported to the participant',
},
redo_measurement_button_label: {
type: jsPsych.plugins.parameterType.STRING,
default: 'No, that is not close. Try again.'
},
blindspot_done_prompt: {
type: jsPsych.plugins.parameterType.STRING,
default: "Yes",
description: "Text for final prompt",
},
},
};
plugin.trial = function (display_element, trial) {
/* check parameter compatibility */
if (!(trial.blindspot_reps > 0) && (trial.resize_units == "deg" || trial.resize_units == "degrees")) {
console.error("Blindspot repetitions set to 0, so resizing to degrees of visual angle is not possible!");
return;
}
/* some additional parameter configuration */
let trial_data = {
item_width_mm: trial.item_width_mm,
item_height_mm: trial.item_height_mm, //card dimension: 85.60 × 53.98 mm (3.370 × 2.125 in)
};
let blindspot_config_data = {
ball_pos: [],
slider_clck: false,
};
let aspect_ratio = trial.item_width_mm / trial.item_height_mm;
const start_div_height =
aspect_ratio < 1
? trial.item_init_size
: Math.round(trial.item_init_size / aspect_ratio);
const start_div_width =
aspect_ratio < 1
? Math.round(trial.item_init_size * aspect_ratio)
: trial.item_init_size;
const adjust_size = Math.round(start_div_width * 0.1);
/* create content for first screen, resizing card */
let pagesize_content = `
${trial.adjustment_prompt}
`
/* create content for second screen, blind spot */
let blindspot_content = `