Copy the KDE 3.5 branch to branches/trinity for new KDE 3.5 features.

BUG:215923


git-svn-id: svn://anonsvn.kde.org/home/kde/branches/trinity/kdegraphics@1054174 283d02a7-25f6-0310-bc7c-ecb5cbfe19da

1 files changed, 234 insertions, 0 deletions

diff --git a/doc/kgamma/index.docbook b/doc/kgamma/index.docbook
new file mode 100644
index 00000000..93be5949
--- /dev/null
+++ b/doc/kgamma/index.docbook
@@ -0,0 +1,234 @@
+<?xml version="1.0" ?>
+<!DOCTYPE book PUBLIC "-//KDE//DTD DocBook XML V4.1.2-Based Variant V1.1//EN"
+ "dtd/kdex.dtd" [
+  <!ENTITY kgamma '<application>KGamma</application>'>
+  <!ENTITY kappname "&kgamma;">
+  <!ENTITY package "kdegraphics">
+  <!ENTITY % addindex "IGNORE">
+  <!ENTITY % English "INCLUDE"><!-- change language only here -->
+]>
+
+<!-- ................................................................ -->
+
+<!-- The language must NOT be changed here. -->
+<book lang="&language;">
+<title>The KGamma Handbook</title>
+
+<bookinfo>
+<authorgroup>
+<author>
+<firstname>Michael</firstname>
+<surname>v.Ostheim</surname>
+<affiliation>
+<address><email>[email protected]</email></address>
+</affiliation>
+</author>
+</authorgroup>
+
+<!-- TRANS:ROLES_OF_TRANSLATORS -->
+<copyright>
+<year>2001, 2002, 2003</year>
+<holder>Michael v.Ostheim</holder>
+</copyright>
+<!-- Translators: put here the copyright notice of the translation -->
+
+<legalnotice>&FDLNotice;</legalnotice>
+<date>28/08/2003</date>
+<releaseinfo>1.00.20</releaseinfo>
+
+<!-- Abstract about this handbook -->
+<abstract>
+<para>&kgamma; is a simple tool for monitor gamma correction.</para>
+</abstract>
+
+<keywordset>
+<keyword>KDE</keyword>
+<keyword>KGamma</keyword>
+<keyword>Monitor</keyword>
+<keyword>Calibration</keyword>
+<keyword>Gamma</keyword>
+</keywordset>
+
+</bookinfo>
+
+<chapter id="introduction">
+<title>Introduction</title>
+
+<para>This document describes &kgamma; version 1.0.2 (KDE 3.2)</para>
+<para>&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.</para>
+<para>&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.</para>
+<para>This are system settings, please do not use &kgamma; to manipulate your
+image files.</para>
+</chapter>
+
+<chapter id="using-kgamma">
+<title>Using KGamma</title>
+<sect1 id="Setting-Gamma">
+<title>Setting Gamma Correction</title>
+<para>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.</para>
+<para>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.</para>
+<para>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.</para>
+<para>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.</para>
+</sect1>
+
+<sect1 id="Gray-Scale">
+<title>Gray Scale Test Image</title>
+<para>You should be able to see the following:</para>
+
+<itemizedlist>
+<listitem>
+<para>A gray scale with 20 different sections</para>
+</listitem>
+<listitem>
+<para>The darkest section pure black</para>
+</listitem>
+<listitem>
+<para>The lightest section pure white</para>
+</listitem>
+<listitem>
+<para>No hint of any color in the gray tones</para>
+</listitem>
+</itemizedlist>
+
+<para>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;.</para>
+</sect1>
+
+<sect1 id="RGB-Scale">
+<title>RGB Scale Test Image</title>
+<para>
+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.</para>
+</sect1>
+
+<sect1 id="CMY-Scale">
+<title>CMY Scale Test Image</title>
+<para>
+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.</para>
+
+<itemizedlist>
+<listitem>
+<para>If you can't see all cyan sections, try to lighten or darken red</para>
+</listitem>
+<listitem>
+<para>If you can't see all magenta sections, try to lighten or darken green</para>
+</listitem>
+<listitem>
+<para>If you can't see all yellow sections, try to lighten or darken blue</para>
+</listitem>
+</itemizedlist>
+</sect1>
+
+<sect1 id="advanced">
+<title>Advanced Test Images</title>
+<para>
+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.
+</para>
+<sect2 id="dark-gray">
+<title>Dark Gray Test Image</title>
+<para>
+You should be able to see 10 different rectangles of dark gray within a
+black box. The chart shows you 1% steps from black.
+</para>
+</sect2>
+<sect2 id="mid-gray">
+<title>Mid Gray Test Image</title>
+<para>
+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.
+</para>
+</sect2>
+<sect2 id="light-gray">
+<title>Light Gray Test Image</title>
+<para>
+You should be able to see 10 different rectangles of light gray within a white box.
+The chart shows you 1% steps from white.
+</para>
+</sect2>
+</sect1>
+
+</chapter>
+
+<chapter id="credits">
+<title>Credits and License</title>
+
+<para>
+&kgamma;
+</para>
+<para>
+Program copyright 2001, 2002, 3003 Michael v.Ostheim <email>[email protected]</email>
+</para>
+
+<para>
+Documentation copyright 2001, 2002, 2003 Michael v.Ostheim <email>[email protected]</email>
+</para>
+
+<!-- TRANS:CREDIT_FOR_TRANSLATORS -->
+
+&underFDL;           <!-- FDL: do not remove. -->
+&underGPL;        	 <!-- GPL License -->
+</chapter>
+
+<appendix id="installation">
+<title>Installation</title>
+
+<para>&kgamma;'s home site is
+<ulink url="http://kgamma.berlios.de/index2.php">http://kgamma.berlios.de/index2.php</ulink>
+</para>
+
+<sect1 id="compilation">
+<title>Compilation and Installation</title>
+
+<para>
+In order to compile and install &kgamma; on your system, type the following in the base
+folder of the &kgamma; distribution:
+<screen>
+<prompt>%</prompt> <userinput><command>./configure</command></userinput>
+<prompt>%</prompt> <userinput><command>make</command></userinput>
+<prompt>%</prompt> <userinput><command>make install</command></userinput>
+</screen>
+</para>
+
+</sect1>
+</appendix>
+
+&documentation.index;
+</book>
+<!--
+Local Variables:
+mode: sgml
+sgml-minimize-attributes:nil
+sgml-general-insert-case:lower
+sgml-indent-step:0
+sgml-indent-data:nil
+End:
+-->