# The KGamma Handbook

Michael v.Ostheim

    ostheimm@users.berlios.de

2001, 2002, 2003 Michael v.Ostheim
&FDLNotice;
28/08/2003
1.00.20

&kgamma; is a simple tool for monitor gamma correction.

KDE KGamma Monitor Calibration Gamma

## Introduction

This document describes &kgamma; version 1.0.2 (KDE 3.2)

&kgamma; is a tool for monitor gamma correction. With proper gamma settings, your display (websites, images, etc.) will look the same on your monitor as on other monitors.

&kgamma; allows you to alter the monitor's gamma correction of XFree86. But that's not all to do. For good results you have to set the correct brightness, contrast and color balance of your monitor. This may be difficult and you have to repeat every step several times. For perfect results you need really good (and expensive) hardware.

This are system settings, please do not use &kgamma; to manipulate your image files.

## Using KGamma

### Setting Gamma Correction

Use the four sliders to define the gamma correction either as a single value, or separately for the red, green and blue components. The XFree86 default setting for gamma is 1.00 (Mac 1.80, WinXX 2.20). The test images help you to find proper settings.

To store the gamma settings system wide, enable the option 'Store settings to XF86Config'. The system settings will be restored at next XFree86 startup. You need root access to use this option. Use this if you want to correct the gamma settings for all users and graphical environments on this machine.

To store the gamma settings to your personal KDE configuration, do not enable that option. The user settings will be restored at next KDE startup and replace temporary the system gamma settings. The system settings are not removed by that and will be restored at next XFree86 startup.

On multi head systems, select the screen you want to alter with the combo box. This will also work with xinerama enabled. If you want to set all screens to the same gamma values, enable the 'Sync screens' option. On systems with only one screen this option will take no effect.

### Gray Scale Test Image

You should be able to see the following:

- A gray scale with 20 different sections

- The darkest section pure black

- The lightest section pure white

- No hint of any color in the gray tones

If you can't see all of the 20 sections, use your monitors contrast settings or the "Gamma" slider of &kgamma; to correct this. If black is not pure black, try to darken the monitor, if white is not pure white, try to lighten it. If you see any colors in the gray tones alter the color balance settings of your monitor or the "Red", "Green" and "Blue" slider of &kgamma;.

### RGB Scale Test Image

You should be able to see three strips, each with 16 sections of red, green or blue tones. The darkest sections should be pure black, the brightest should be pure red, green or blue. If you don't see all sections of a color strip, try to lighten or darken this color.

### CMY Scale Test Image

You should be able to see three strips, each with 11 sections of cyan, magenta or yellow tones. The brightest sections should be pure white, the darkest should be pure cyan, magenta or yellow.

- If you can't see all cyan sections, try to lighten or darken red

- If you can't see all magenta sections, try to lighten or darken green

- If you can't see all yellow sections, try to lighten or darken blue

### Advanced Test Images

The following three pictures shows you the abilities of your monitor at three points of the gray spectrum. If you can't see all of the details, don't be worry, or buy better hardware.

#### Dark Gray Test Image

You should be able to see 10 different rectangles of dark gray within a black box. The chart shows you 1% steps from black.

#### Mid Gray Test Image

This picture shows you 11 gray rectangles within a 50% gray box. You should be able to see all of the rectangles except the middle one. The rectangles represent the steps from 45% to 55% gray.

#### Light Gray Test Image

You should be able to see 10 different rectangles of light gray within a white box. The chart shows you 1% steps from white.

## Credits and License

&kgamma;

Program copyright 2001, 2002, 3003 Michael v.Ostheim ostheimm@users.berlios.de

Documentation copyright 2001, 2002, 2003 Michael v.Ostheim ostheimm@users.berlios.de

&underFDL; &underGPL;

## Installation

&kgamma;'s home site is http://kgamma.berlios.de/index2.php

### Compilation and Installation

In order to compile and install &kgamma; on your system, type the following in the base folder of the &kgamma; distribution:

    % ./configure
    % make
    % make install

&documentation.index;