Skip to main content

Color Dots

A processing speed task from the m2c2kit library. Participants briefly see an array of colored dots, then after a short blank interval must recall the color of a specific dot. Measures speed and accuracy of color–location binding.

Example URL commands​

# Plain launch (debug mode: results shown on-screen)
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-color-dots@0.8.33/

# Customized assessment parameters (values shown are the defaults)
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-color-dots@0.8.33/?fixation_duration_ms=500&dot_diameter=48&number_of_dots=3

# Production: submit results to your server
https://andreifoldes.github.io/m2c2-assessments/dist/assessments/@m2c2kit/assessment-color-dots@0.8.33/?token=<TOKEN>&callback_url=<CALLBACK_URL>

Session parameters​

Handled by the launch wrapper (results submission and optional sensors), not by the assessment itself.

ParameterTypeDefaultDescription
callback_urlstring—URL to POST results to when the assessment ends.
pidstring—Optional participant identifier. Echoed verbatim into the results: top-level pid next to token in the callback POST, inside data, and in the embed-mode postMessage. Useful when the callback endpoint does not mint per-participant tokens, or to link multi-session designs (e.g. FNAME-Pairs learning vs. delayed) from the URL alone.
tokenstring—Authentication token for results submission. When absent (along with callback_url), the assessment runs in debug mode and displays results on-screen instead of submitting them.

Assessment parameters​

Every parameter below can be set directly as a URL query parameter — the launch wrapper forwards all query parameters to the assessment.

ParameterTypeDefaultURLDescription
fixation_duration_msnumber500✅How long fixation scene is shown, milliseconds.
dot_colorsarray[{"colorName":"black","rgbaColor":[0,0,0,1]},{"colorName":"green","rgbaColor":[0,158,115,1]},{"colorName":"yellow","rgbaColor":[240,228,66,1]},{"colorName":"blue","rgbaColor":[0,114,178,1]},{"colorName":"orange","rgbaColor":[213,94,0,1]},{"colorName":"pink","rgbaColor":[204,121,167,1]}]✅Array of colors for dots.
dot_diameternumber48✅Diameter of dots.
number_of_dotsinteger3✅How many dots to present. Must be at least 3.
dot_present_duration_msnumber1000✅How long the dots are shown, milliseconds.
dot_blank_duration_msnumber750✅How long to show a blank square after dots are removed, milliseconds.
color_selected_hold_duration_msnumber500✅How long to show a square with the dot colored by the user's choice, before advancing to next scene, milliseconds.
number_of_trialsinteger12 (site override; package default 5)✅How many trials to run.
show_trials_complete_scenebooleantrue✅After the final trial, should a completion scene be shown? Otherwise, the game will immediately end.
instruction_typestringlong✅Type of instructions to show, 'short' or 'long'. Allowed values: "short", "long".
instructionsobject or nullnull✅When non-null, an InstructionsOptions object that will completely override the built-in instructions.
show_quit_buttonbooleanfalse✅Should the activity quit button be shown?
show_fpsbooleanfalse✅Should the FPS be shown?
show_locale_pickerbooleanfalse✅Should the icon that allows the participant to switch the locale be shown?
seedstring or nullnull✅Optional seed for the seeded pseudo-random number generator. When null, the default Math.random() is used.
scoringbooleanfalse✅Should scoring data be generated? Default is false.

Generated from dist/modules/@m2c2kit/assessment-color-dots@0.8.33/dist/index.js and dist/assessments/@m2c2kit/assessment-color-dots@0.8.33/index.js. Do not edit by hand.