# The &kmyapplication; Handbook

## Introduction

&kmyapplication; allows the user to check the contrast ratio between colors and determine if the result is suitable for people with color vision deficiencies. Users may select colors in a variety of ways, for example, by inputting the hex values manually, or by using the color picker tool to select any color value on their screen.

The contrast ratio check by this application is related to the difference in color between two objects that allows them to be distinguished. A contrast value of 21 indicates a perfect contrast (usually black on white) and a value of 0 indicates that the two colors are the same. The colors are checked against Web Content Accessibility Guidelines (WCAG).

## Using &kmyapplication;

Here's a screenshot of &kmyapplication; Screenshot of &kmyapplication;

After opening the application, you will be presented with a screen similar to the one above - this is the main screen of &kmyapplication; and contains most of its features. A randomly selected text color, background color and their contrast ratio will be displayed as an example.

### Selecting Text and Background Colors

There are five main ways in which colors can be selected for comparison. These are outlined below.

#### Input Hex Values

If you know the hex values of the colors that you would like to check, then you can input them directly. To do so, click on the hex value of the sample color currently on the screen and type in the desired value.

#### Color Picker

If there is a color that you currently have on the screen - for example, from a sample image - then you can use the color picker tool to input this color directly into the application. To do so, click the color picker icon to the right of the hex value of the currently selected color, and click the color anywhere on the screen that you would like to sample. The color will then be selected in the application.

#### Hue, Saturation and Lightness

If you would like to tweak your current selection to see if certain changes have an effect on the contrast, then you can do so by using the hue, saturation and lightness sliders. These are located underneath the hex value of the current selection. The color selection will automatically update as you make changes to these sliders.

#### Invert

The Invert button will swap the two currently selected colors, setting the background color as the text color and vice versa.

#### Randomize

The Randomize button will assign random colors to both the background and the text colors.

### Contrast Result

The contrast ratio resulting from your selection will be shown on the top of the screen, together with a short note explaining how well this contrast is suited to text of varying sizes. This text will be updated automatically as changes are made to the color values.

### Favorites

&kmyapplication; allows the user to save favourite color combinations for future reference. To do so, press the Mark as favourite located at the bottom of the screen. These color combinations can be accessed again through the Favorite Colors menu item, as more particularly described in the next chapter.

## Menu Options

This chapter describes all application features accessible after clicking the Menu icon in the top left corner.

### Contrast Checker

This is the default screen of the application, allowing the user to select colors and view their contrast ratio. The functionality is described in the previous chapter.

### Favorite Colors

This screen will contain all color combinations saved as "favorite" in the Contrast Checker screen. Color combinations may be deleted by pressing the Remove button.

### Help

This screen contains a brief summary of the theory behind this application, with an explanation of how contrast works and how best to interpret the contrast ratio in line with the WCAG standard.

### About

This screen contains some general information relating to the application, such as the authors and the libraries used. There is also a button that allows users to submit any bug that they may encounter to the developers.

## Credits and License

&kmyapplication;

Program copyright 2020-2022 Carl Schwan carl@carlschwan.eu

Documentation Copyright © 2022 Vlad Rakhmanin vladimir.rakhmanin@ucdconnect.ie

&underGPL;
&documentation.index;