Version 4.0
How to Use
Chromatic Vision Simulator is a color vision simulation tool that lets you experience how people with various color vision characteristics see colors.It converts images from your device's camera or image files in your photo library in real time, and shows how colors look to each color vision type (dichromacy).
Version 4.0 adds Difference mode, which shows how much the colors change from the original image as brightness, and Show Color Name, which tells you the name of a color on the screen.
Basic Usage
Point your device's camera at what you want to see. The video appears on the screen and is simulated in real time. You can also simulate image files in your photo library.-
1.
Choose color vision types.
Use the C, P, D and T buttons at the left of the bottom bar to choose the color vision types to simulate. The screen is divided according to the number of types you choose (1 to 4). -
2.
Adjust the strength.
Tap the eye button to change the simulation strength (the default is 100%). -
3.
Switch the image source.
Switch between the rear camera, the front camera and an image file in your photo library. -
4.
Save the image.
Save the image on the screen to your photo library.
The Screen
- Color vision type name The top center of each panel shows the name of the color vision type simulated in that panel. If a name does not fit the width of a panel, all panels switch together to short names, and if they still do not fit, the text becomes smaller.
- Zoom ratio The top right shows the current digital zoom ratio.
- Gear A faint gear is shown at the top left. Tap it to open the settings screen.
- Bottom bar From the left: the color vision type buttons (C, P, D, T), the strength button (eye), the image source button and the save button.
- When 10 seconds have passed since the last operation, the controls (the bottom bar, the gear, the labels and so on) hide, and the whole screen shows the simulated image. Tap the screen once to show the controls again. They are also shown when you rotate the device.
Color Vision Types (C, P, D, T)
- C is Common (normal color vision, the original image), P is Protanope, D is Deuteranope and T is Tritanope. When the simulation strength is 100%, each type shows the color appearance of the most severe form of dichromacy of that type.
- Tap a button to turn that type on or off. The last remaining type cannot be turned off.
- Press and hold a button (for 1.2 seconds) to turn off all the other types and show only that type.
- The panels are always in the order C, P, D, T, not in the order you chose them. On a portrait screen, 2 types are stacked vertically, 3 types in three rows, and 4 types in a 2×2 grid. On a landscape screen, 2 types are side by side, 3 types in three columns, and 4 types in a 2×2 grid.
- While only C is chosen, the original image is shown.
Simulation Strength
-
Tap the eye button to show a vertical slider. The top is 100% (the default) and the bottom is 0%.
- The simulation strength is a value for showing the intermediate image between the color appearance of the most severe form of dichromacy of each type (100%) and the original image (0%). It does not simulate the color appearance of anomalous trichromacy (mild color vision deficiency).
- When the strength is not 100%, the eye button shows the number (%).
- While only C is chosen, the eye button is not available.
Image Source (Camera and Image File)
-
Tap the image source button to show three choices: Rear Camera, Front Camera and File. Choices that are not available are grayed out.
- When you choose File, a screen for choosing an image file from your photo library appears, and the chosen image is simulated. If you cancel the selection, the zoom and the position do not change.
- While you use the front camera, the screen shows a mirror image (reversed left to right).
Saving Images
-
Tap the save button to save the image on the screen (all panels included) to your photo library. When you save, the screen shrinks toward the save button and a sound plays. You can adjust the sound in the settings.
- On the saved image (JPEG), the color vision type letter (C, P, D, T) is drawn at the top left of each panel, and the simulation strength (xx%) at the top right. If you turn off Embed Text in Saved Images in the settings, no text is drawn. The strength is not drawn while only C is chosen, or when the strength is 100%.
- Saved images are not mirrored, even when you use the front camera.
- Saved images do not include location information.
- If you turn on Save on Volume in the settings, you can save by pressing a volume button of the device.
Zooming and Moving
- Pinch the screen with two fingers (spread or close them) to zoom in or out (up to 500%). All panels zoom together. The point at the center of the screen stays at the center when you zoom.
- While File is chosen, you can move the image by dragging with one finger. You cannot move the image while the camera is used.
- Double-tap the screen to reset the zoom and the position and show the controls.
- When you rotate the device, the zoom and the position of a file are reset. The zoom of the camera is kept.
Show Color Name (Color Cursor)
You can point at a place on the screen and find out the name of the color there. When Show Color Name is on, a circular cursor appears on the screen.- Turning it on and off Use Show Color Name in the settings. You can also touch and hold the image on the screen with one finger (for 1.2 seconds) to turn it on or off. When you turn it on this way, the cursor appears where you held. It is off by default.
- Choosing a place Tap the screen and the cursor moves there. The cursor is fixed on the screen, so it does not move when you zoom or move the image; the color under the cursor changes instead. When you rotate the device or double-tap the screen, the cursor returns to the center of the screen.
- What is shown The color names are shown above the cursor (below it when there is no room above). The color examined is the color of the original image, before the simulation. The value used is the average of the colors inside the cursor's circle, calculated in the Oklab color space.
- Items to show Up to 4 lines are shown. Choose the item for each line under Color Name Display in the settings. The available items are Systematic Color Name (JIS), Traditional Color Name (JIS), Systematic Color Name (ISCC-NBS), Traditional Color Name (TCCA), CIELAB, Oklab, CIELUV, RGB, XYZ, xyY, Munsell and None. By default, the Japanese screen shows Systematic Color Name (JIS) and Traditional Color Name (JIS), and the English screen shows Systematic Color Name (ISCC-NBS) and Traditional Color Name (TCCA).
- Systematic Color Name (JIS): The systematic color name of JIS Z 8102. A color expressed by Munsell hue, value and chroma is matched to the regions the standard defines, and named by a basic color name with modifiers.
- Traditional Color Name (JIS): The nearest of the traditional color names of JIS Z 8102 that are defined by Munsell values (267 colors; public sources give 269). A "?" follows the name when the nearest color is not close.
- Systematic Color Name (ISCC-NBS): The systematic color name of ISCC-NBS (NBS Circular 553). A color expressed by Munsell hue, value and chroma is matched to the regions of the system and named. The names are shown in English on the Japanese screen as well.
- Traditional Color Name (TCCA): The name of the nearest color among the names chosen from the colors that NBS Research Paper RP1700 measured on the standard color cards of the Textile Color Card Association (TCCA). The 13 basic terms (such as red and pink) use the colors of ISCC-NBS Level 1. The names are shown in English on the Japanese screen as well.
- Munsell: The Munsell value, in the notation of JIS Z 8721, obtained from the Munsell renotation tables.
- Oklab: The L, a and b values in the Oklab color space.
Difference Mode
Difference mode shows how much the colors change between the original image and the simulated image, as brightness. Places with no difference are black, places with a difference at or above the limit are white, and places in between get a brightness that follows the difference. The difference is the distance between the two colors in the Oklab color space. The conventional screen, which lines up the simulated images of each type, is called Appearance mode, and this one is called Difference mode.- Switching You can switch in any of these ways (repeating a swipe in the same direction goes back and forth between the two modes).
- Swipe left or right on the bottom bar with one finger.
- Swipe left or right on the screen with two fingers.
- Turn Difference mode on or off in the settings.
- Panels In Difference mode, the panels depend on the chosen types.
- C and one other type (X) are chosen: 3 panels (the original image, the simulated image of X, and the C vs X difference).
- Only X is chosen: 2 panels (the simulated image of X and the C vs X difference).
- Only C is chosen: 2 panels (the original image and the difference). The difference from the original image is 0, so the difference is completely black.
- Choosing types You can choose one or two types at a time, and when you choose two, one of them is always C. If you tap another type, the type other than C is replaced by that type. Touching and holding to show only that type works as in Appearance mode.
-
Difference limit In Difference mode, the eye button adjusts the difference limit. With the vertical slider, you change the distance at which the difference becomes white, in the range 0.01 to 0.19 (the default is 0.10). At the top (0.19), only large differences become white; at the bottom (0.01), even small differences become white. When the value is not the default 0.10, it is shown on the eye button. The pictures at the ends of the slider are pairs of colors: the left half is before the simulation and the right half is after it.
- The simulation strength in Difference mode stays at the value it had before you entered the mode. When you return to Appearance mode, the slider adjusts the strength again.
- Zooming, moving, Show Color Name and saving work as in Appearance mode. On a saved image, "Diff" is drawn at the top left of the difference panel (the strength is not drawn).
Settings
Tap the gear at the top left of the screen to open the settings screen.- SAVE
- Embed Text in Saved Images: Draws the color vision type and strength text on saved images. On by default.
- CONTROLS
- Save on Volume: Saves when you press a volume button of the device. Off by default. On iOS, available on iOS 17.2 or later.
- Difference mode: Switches between Appearance mode and Difference mode. Off by default. The swipe gestures for switching are also described here.
- Color Name Display
- Show Color Name: Turns the color cursor and the color names on or off. Off by default.
- Line 1 to Line 4: Choose the item shown on each line. You cannot choose while Show Color Name is off.
- SOUND
- Save Sound: Plays a sound when you save. On by default.
- Volume: The loudness of the save sound, as a percentage of the device volume (never louder than the device volume). 100% by default.
- Color Space
- Choose Automatic or sRGB. With Automatic, images are shown and saved in Display P3 on devices with a wide color gamut. Choose sRGB to keep shared images in sRGB. You cannot choose it when the device's screen supports sRGB only.
- Importing the camera video in P3 is available on iOS only.
- OTHER
- Reset: Returns all settings to their defaults.
- How to Use: Shows this manual.
- Privacy Policy: Shows the privacy policy.
- APPLICATION INFO. Shows the app version and the copyright.
Screen Reader (VoiceOver and TalkBack)
- The color vision type buttons are read with their name and state, such as "C Common, selected". Instead of touching and holding, you can use the "Show only this type" action.
- The strength button is read as "Strength, xx%", and you can change the slider value with the increase and decrease actions. In Difference mode, "Difference limit" is read instead of the strength.
- The image has actions for zooming in and out, moving (while a file is chosen), resetting the position, and turning Show Color Name on or off.
- When you switch modes, the name of the current mode is read.
Troubleshooting
-
The camera does not show
You may not have allowed the use of the camera. Allow camera access in the device settings. -
Tapping the save button does not save the image to the photo library
On iOS, you may have answered "Don't Allow" to the message asking for access to your photos. In that case, go to Settings > Privacy & Security > Photos > Chromatic Vision Simulator and allow adding photos (saving also works with the add-only permission). On Android 9 and earlier, permission to access storage is required. -
An image file cannot be loaded, or saving fails
The app tells you with a message. Try another image, and check the free space on the device and the permission for photos.
Others
- This application software was developed by Kazunori Asada (MD, PhD in Media Design) and is released free of charge.
- The simulation algorithm used in this application is based on the method proposed in the following academic paper. It reproduces, by fast computation, the colors that would be seen by dichromats of the most severe form of each color vision type.
H. Brettel, F. Viénot, and J. D. Mollon: Computerized simulation of color appearance for dichromats, Journal of the Optical Society of America A, vol.14, no.10, pp.2647-2655 (Oct. 1997).
- The simulated images shown in this application are predictions of how dichromats see colors under a specific method and conditions, and are not necessarily accurate. Color vision also varies from person to person.
- The color names shown in this application are calculated from standards under specific assumptions, and are not necessarily accurate. The characteristics of the screen and the camera of your device also vary.
- The color difference shown in Difference mode is the distance between the simulated image and the original image, calculated in a specific color space under specific conditions, and does not necessarily represent the size of the difference in appearance accurately.
- Terms such as "color vision deficiency", "protan", "deutan" and "tritan" used in this manual are academic terms.
- The details of the theory are described on the "Theory" page of the website.
- The Android version and the iPhone/iPad version work the same way (the differences are only where it says "On iOS", "iOS 17.2 or later" or "Android 9 and earlier" above).
Licenses
Color Simulator uses the open-source software and font listed below. The full license texts are in the second half of this section.Components and copyright notices
- Android Jetpack (AndroidX, Compose, CameraX): Copyright The Android Open Source Project (Apache-2.0)
- Kotlin standard library, kotlinx (coroutines, serialization, atomicfu): Copyright JetBrains s.r.o. and Kotlin Programming Language contributors (Apache-2.0)
- JetBrains annotations: Copyright JetBrains s.r.o. (Apache-2.0)
- Dagger: Copyright Google, Inc. (Apache-2.0)
- AutoValue annotations: Copyright (C) 2012 Google, Inc. (Apache-2.0)
- JSpecify: Copyright The JSpecify Authors (Apache-2.0)
- Jakarta Inject: Copyright Eclipse Foundation and the respective authors (Apache-2.0)
- javax.inject (JSR-330), Guava ListenableFuture: Apache-2.0
- libyuv (included in CameraX): Copyright 2011 The LibYuv Project Authors. All rights reserved. Licensed under BSD-3-Clause.
- Roboto Bold font (a subset of Latin characters): Copyright 2011 Google Inc. All Rights Reserved. (Apache-2.0)
Sources of the color name data: NBS Circular 553 (ISCC-NBS); NBS Special Publication 440 (the figures of the ISCC-NBS regions); Kelly, J. Res. NBS 61(5), 1958 (the central notations of the ISCC-NBS color-name blocks); NBS Research Paper RP1700 (Reimann, Judd and Keegan, 1946; the TCCA standard color cards). All are publications of the U.S. National Bureau of Standards (NBS).
The full texts of the Apache-2.0 and BSD-3-Clause licenses follow.
Apache License, Version 2.0
Apache License
Version 2.0, January 2004
http://www.apache.org/licenses/
TERMS AND CONDITIONS FOR USE, REPRODUCTION, AND DISTRIBUTION
1. Definitions.
"License" shall mean the terms and conditions for use, reproduction,
and distribution as defined by Sections 1 through 9 of this document.
"Licensor" shall mean the copyright owner or entity authorized by
the copyright owner that is granting the License.
"Legal Entity" shall mean the union of the acting entity and all
other entities that control, are controlled by, or are under common
control with that entity. For the purposes of this definition,
"control" means (i) the power, direct or indirect, to cause the
direction or management of such entity, whether by contract or
otherwise, or (ii) ownership of fifty percent (50%) or more of the
outstanding shares, or (iii) beneficial ownership of such entity.
"You" (or "Your") shall mean an individual or Legal Entity
exercising permissions granted by this License.
"Source" form shall mean the preferred form for making modifications,
including but not limited to software source code, documentation
source, and configuration files.
"Object" form shall mean any form resulting from mechanical
transformation or translation of a Source form, including but
not limited to compiled object code, generated documentation,
and conversions to other media types.
"Work" shall mean the work of authorship, whether in Source or
Object form, made available under the License, as indicated by a
copyright notice that is included in or attached to the work
(an example is provided in the Appendix below).
"Derivative Works" shall mean any work, whether in Source or Object
form, that is based on (or derived from) the Work and for which the
editorial revisions, annotations, elaborations, or other modifications
represent, as a whole, an original work of authorship. For the purposes
of this License, Derivative Works shall not include works that remain
separable from, or merely link (or bind by name) to the interfaces of,
the Work and Derivative Works thereof.
"Contribution" shall mean any work of authorship, including
the original version of the Work and any modifications or additions
to that Work or Derivative Works thereof, that is intentionally
submitted to Licensor for inclusion in the Work by the copyright owner
or by an individual or Legal Entity authorized to submit on behalf of
the copyright owner. For the purposes of this definition, "submitted"
means any form of electronic, verbal, or written communication sent
to the Licensor or its representatives, including but not limited to
communication on electronic mailing lists, source code control systems,
and issue tracking systems that are managed by, or on behalf of, the
Licensor for the purpose of discussing and improving the Work, but
excluding communication that is conspicuously marked or otherwise
designated in writing by the copyright owner as "Not a Contribution."
"Contributor" shall mean Licensor and any individual or Legal Entity
on behalf of whom a Contribution has been received by Licensor and
subsequently incorporated within the Work.
2. Grant of Copyright License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
copyright license to reproduce, prepare Derivative Works of,
publicly display, publicly perform, sublicense, and distribute the
Work and such Derivative Works in Source or Object form.
3. Grant of Patent License. Subject to the terms and conditions of
this License, each Contributor hereby grants to You a perpetual,
worldwide, non-exclusive, no-charge, royalty-free, irrevocable
(except as stated in this section) patent license to make, have made,
use, offer to sell, sell, import, and otherwise transfer the Work,
where such license applies only to those patent claims licensable
by such Contributor that are necessarily infringed by their
Contribution(s) alone or by combination of their Contribution(s)
with the Work to which such Contribution(s) was submitted. If You
institute patent litigation against any entity (including a
cross-claim or counterclaim in a lawsuit) alleging that the Work
or a Contribution incorporated within the Work constitutes direct
or contributory patent infringement, then any patent licenses
granted to You under this License for that Work shall terminate
as of the date such litigation is filed.
4. Redistribution. You may reproduce and distribute copies of the
Work or Derivative Works thereof in any medium, with or without
modifications, and in Source or Object form, provided that You
meet the following conditions:
(a) You must give any other recipients of the Work or
Derivative Works a copy of this License; and
(b) You must cause any modified files to carry prominent notices
stating that You changed the files; and
(c) You must retain, in the Source form of any Derivative Works
that You distribute, all copyright, patent, trademark, and
attribution notices from the Source form of the Work,
excluding those notices that do not pertain to any part of
the Derivative Works; and
(d) If the Work includes a "NOTICE" text file as part of its
distribution, then any Derivative Works that You distribute must
include a readable copy of the attribution notices contained
within such NOTICE file, excluding those notices that do not
pertain to any part of the Derivative Works, in at least one
of the following places: within a NOTICE text file distributed
as part of the Derivative Works; within the Source form or
documentation, if provided along with the Derivative Works; or,
within a display generated by the Derivative Works, if and
wherever such third-party notices normally appear. The contents
of the NOTICE file are for informational purposes only and
do not modify the License. You may add Your own attribution
notices within Derivative Works that You distribute, alongside
or as an addendum to the NOTICE text from the Work, provided
that such additional attribution notices cannot be construed
as modifying the License.
You may add Your own copyright statement to Your modifications and
may provide additional or different license terms and conditions
for use, reproduction, or distribution of Your modifications, or
for any such Derivative Works as a whole, provided Your use,
reproduction, and distribution of the Work otherwise complies with
the conditions stated in this License.
5. Submission of Contributions. Unless You explicitly state otherwise,
any Contribution intentionally submitted for inclusion in the Work
by You to the Licensor shall be under the terms and conditions of
this License, without any additional terms or conditions.
Notwithstanding the above, nothing herein shall supersede or modify
the terms of any separate license agreement you may have executed
with Licensor regarding such Contributions.
6. Trademarks. This License does not grant permission to use the trade
names, trademarks, service marks, or product names of the Licensor,
except as required for reasonable and customary use in describing the
origin of the Work and reproducing the content of the NOTICE file.
7. Disclaimer of Warranty. Unless required by applicable law or
agreed to in writing, Licensor provides the Work (and each
Contributor provides its Contributions) on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or
implied, including, without limitation, any warranties or conditions
of TITLE, NON-INFRINGEMENT, MERCHANTABILITY, or FITNESS FOR A
PARTICULAR PURPOSE. You are solely responsible for determining the
appropriateness of using or redistributing the Work and assume any
risks associated with Your exercise of permissions under this License.
8. Limitation of Liability. In no event and under no legal theory,
whether in tort (including negligence), contract, or otherwise,
unless required by applicable law (such as deliberate and grossly
negligent acts) or agreed to in writing, shall any Contributor be
liable to You for damages, including any direct, indirect, special,
incidental, or consequential damages of any character arising as a
result of this License or out of the use or inability to use the
Work (including but not limited to damages for loss of goodwill,
work stoppage, computer failure or malfunction, or any and all
other commercial damages or losses), even if such Contributor
has been advised of the possibility of such damages.
9. Accepting Warranty or Additional Liability. While redistributing
the Work or Derivative Works thereof, You may choose to offer,
and charge a fee for, acceptance of support, warranty, indemnity,
or other liability obligations and/or rights consistent with this
License. However, in accepting such obligations, You may act only
on Your own behalf and on Your sole responsibility, not on behalf
of any other Contributor, and only if You agree to indemnify,
defend, and hold each Contributor harmless for any liability
incurred by, or claims asserted against, such Contributor by reason
of your accepting any such warranty or additional liability.
END OF TERMS AND CONDITIONS
APPENDIX: How to apply the Apache License to your work.
To apply the Apache License to your work, attach the following
boilerplate notice, with the fields enclosed by brackets "[]"
replaced with your own identifying information. (Don't include
the brackets!) The text should be enclosed in the appropriate
comment syntax for the file format. We also recommend that a
file or class name and description of purpose be included on the
same "printed page" as the copyright notice for easier
identification within third-party archives.
Copyright [yyyy] [name of copyright owner]
Licensed under the Apache License, Version 2.0 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.apache.org/licenses/LICENSE-2.0
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
libyuv (BSD-3-Clause)
Copyright 2011 The LibYuv Project Authors. All rights reserved.
Redistribution and use in source and binary forms, with or without
modification, are permitted provided that the following conditions are
met:
* Redistributions of source code must retain the above copyright
notice, this list of conditions and the following disclaimer.
* Redistributions in binary form must reproduce the above copyright
notice, this list of conditions and the following disclaimer in
the documentation and/or other materials provided with the
distribution.
* Neither the name of Google nor the names of its contributors may
be used to endorse or promote products derived from this software
without specific prior written permission.
THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
"AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR
A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT
HOLDER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL,
SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT
LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE,
DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY
THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
open image
open image
open image
open image
open image
open image
open image
open image
open image
open image