The plugin works in two phases.
Phase 1. To calculate the pixel-to-cm conversion rate for a participant’s display, participants are asked to place a credit card or other item of the same size on the screen and resize an image until it is the same size as the credit card. Since we know the physical dimensions of the card, we can find the conversion rate for the participant's display.
Phase 2. To measure the participant's viewing distance from their screen we use a blind spot task. Participants are asked to focus on a black square on the screen with their right eye closed, while a red dot repeatedly sweeps from right to left. They press the spacebar on their keyboard whenever they perceive that the red dot has disappeared. This part allows the plugin to use the distance between the black square and the red dot when it disappears from eyesight to estimate how far the participant is from the monitor. This estimation assumes that the blind spot is located at 13.5° temporally.
-This plugin requires the SVG.js library, available at https://svgjs.com or via the CDN link below. You must include the library in the <head> section of your experiment page.
<script src="https://cdnjs.cloudflare.com/ajax/libs/svg.js/2.6.3/svg.min.js"></script>
-Parameters can be left unspecified if the default value is acceptable.
| item_path | string | -"img/card.png" | -Path of the item to be presented in the card stimulus during the resizing phase. The default image is available in /examples/img/card.png |
+null | +Path of the item to be presented in the card stimulus during the resizing phase. If null then no image is shown, and a solid color background is used instead. An example image is available in /examples/img/card.png |
| item_height_mm | diff --git a/7.2/search/search_index.json b/7.2/search/search_index.json index e6409a0c..49258ff4 100755 --- a/7.2/search/search_index.json +++ b/7.2/search/search_index.json @@ -1 +1 @@ -{"config":{"indexing":"full","lang":["en"],"min_search_length":3,"prebuild_index":false,"separator":"[\\s\\-]+"},"docs":[{"location":"","text":"\u00b6 jsPsych is a JavaScript framework for creating behavioral experiments that run in a web browser. Experiments in jsPsych are created using plugins . Each plugin defines different kinds of events, like showing an image on the screen, and collects different kinds of data, like recording which key was pressed at which time. You can use the plugins that are included with jsPsych , use plugins that are developed by community members in the contrib repository , or create your own plugins . By assembling different plugins together into a timeline , it is possible to create a wide range of experiments. The page on timelines is a good place to start learning about jsPsych. From there, you might want to complete the hello world tutorial to learn how to set up a jsPsych experiment and the reaction time experiment tutorial to learn the core features of the framework.","title":"Introduction"},{"location":"#_1","text":"jsPsych is a JavaScript framework for creating behavioral experiments that run in a web browser. Experiments in jsPsych are created using plugins . Each plugin defines different kinds of events, like showing an image on the screen, and collects different kinds of data, like recording which key was pressed at which time. You can use the plugins that are included with jsPsych , use plugins that are developed by community members in the contrib repository , or create your own plugins . By assembling different plugins together into a timeline , it is possible to create a wide range of experiments. The page on timelines is a good place to start learning about jsPsych. From there, you might want to complete the hello world tutorial to learn how to set up a jsPsych experiment and the reaction time experiment tutorial to learn the core features of the framework.","title":""},{"location":"about/about/","text":"About jsPsych \u00b6 jsPsych is open source project with numerous contributors . The project is currently managed by the core team of Josh de Leeuw ( @jodeleeuw ), Becky Gilbert ( @becky-gilbert ), and Bj\u00f6rn Luchterhandt ( @bjoluc ). jsPsych was created by Josh de Leeuw . Citation \u00b6 If you use jsPsych please cite the following paper. de Leeuw, J. R. (2015). jsPsych: A JavaScript library for creating behavioral experiments in a web browser. Behavior Research Methods , 47 (1), 1-12. doi:10.3758/s13428-014-0458-y .","title":"About jsPsych"},{"location":"about/about/#about-jspsych","text":"jsPsych is open source project with numerous contributors . The project is currently managed by the core team of Josh de Leeuw ( @jodeleeuw ), Becky Gilbert ( @becky-gilbert ), and Bj\u00f6rn Luchterhandt ( @bjoluc ). jsPsych was created by Josh de Leeuw .","title":"About jsPsych"},{"location":"about/about/#citation","text":"If you use jsPsych please cite the following paper. de Leeuw, J. R. (2015). jsPsych: A JavaScript library for creating behavioral experiments in a web browser. Behavior Research Methods , 47 (1), 1-12. doi:10.3758/s13428-014-0458-y .","title":"Citation"},{"location":"about/license/","text":"License \u00b6 jsPsych is licensed under the MIT license. The MIT License (MIT) Copyright (c) 2014-2021 Joshua R. de Leeuw Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.","title":"License"},{"location":"about/license/#license","text":"jsPsych is licensed under the MIT license. The MIT License (MIT) Copyright (c) 2014-2021 Joshua R. de Leeuw Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the \"Software\"), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions: The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software. THE SOFTWARE IS PROVIDED \"AS IS\", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.","title":"License"},{"location":"developers/configuration/","text":"Configuring the jsPsych development environment \u00b6 Setup \u00b6 JsPsych is written using TypeScript , a superset of JavaScript that adds static typing, but compiles to plain JavaScript. The TypeScript compiler itself is written in JavaScript and can be run by Node.js , a runtime to execute JavaScript code without a web browser. Node.js comes with a package manager called NPM (Node Package Manager) that can install JavaScript libraries to run on your machine, such as TypeScript and other build tools for jsPsych. In order to work on code in the jsPsych or the jspsych-contrib repository, it is recommended that you follow the steps below to set up your development environment. Install Node.js \u00b6 The jsPsych development setup requires Node.js >= v14 to be installed on your machine. We recommend that you install version 16 since it includes version 7 of NPM (required for the workspaces feature that the jsPsych repositories use). If you are bound to Node.js v14, make sure to install NPM v7 manually (via npm install -g npm@7 ). Clone the repository and install the dependencies \u00b6 Clone either the jsPsych repository or the jspsych-contrib repository by running git clone https://github.com/jspsych/jsPsych.git && cd jsPsych or git clone https://github.com/jspsych/jspsych-contrib.git && cd jspsych-contrib in a terminal. Then run npm install . This will create a node_modules directory and install all the dependencies into it that are required to build and test jsPsych. Attention It is important that npm install is only run in the root directory of the repository (due to the NPM workspaces feature). If you accidentally ran npm install anywhere else, remove the node_modules directory and the package-lock.json file that were created at that location and run npm install in the root directory again. Info If you are running npm install in the core jsPsych repository, this will also execute the build chain for all packages in the jsPsych repository. This step may take a few minutes. If you would like to use that time efficiently, consider reading the following two sections to know what's happening. Repository structure \u00b6 A Node.js package is a directory that contains a package.json file describing it. Most importantly, a package.json file lists other packages that the package depends on. The jsPsych and jspsych-contrib repositories use NPM workspaces . That means, running npm install in the repository root will install the dependencies for all packages in the packages directory. The core jsPsych library and every jsPsych plugin or extension is laid out as an individual package. These packages are published to the NPM registry where they can be downloaded by NPM or any CDN (such as unpkg ). Build chain and build artifacts \u00b6 JsPsych comes with a build chain (specified in the @jspsych/config package) that can be executed by running npm run build in a package's directory. The build chain will read the package (starting at its src/index.ts file) and create the following build artifacts in the package's dist directory: index.js This file contains everything from index.ts , but as plain JavaScript and bundled in a single file (i.e. without import ing files from the same package). It is used by bundlers like webpack . index.cjs Like index.js , but using the old CommonJS standard to support backwards-compatible tools like the Jest testing framework. index.browser.js This file, like index.js , contains the entire package as plain JavaScript, but this time wrapped in a function so that it can be included directly by browsers using the