Git commit 62ae5379846fb9830737916cb1d5e864eb6dc144 by Yuri Chornoivan. Committed on 10/03/2013 at 20:55. Pushed by yurchor into branch 'master'.
Add figures to illustrate the enhancement methods (courtesy of Thomas Freitag) A +- -- doc/enhance-lowcontrast.png A +- -- doc/enhance-shape.png A +- -- doc/enhance-solid.png A +- -- doc/enhance-thinline.png M +75 -1 doc/index.docbook D +- -- doc/rating.png http://commits.kde.org/okular/62ae5379846fb9830737916cb1d5e864eb6dc144 diff --git a/doc/enhance-lowcontrast.png b/doc/enhance-lowcontrast.png new file mode 100644 index 0000000..da7d9e0 Binary files /dev/null and b/doc/enhance-lowcontrast.png differ diff --git a/doc/enhance-shape.png b/doc/enhance-shape.png new file mode 100644 index 0000000..412ef54 Binary files /dev/null and b/doc/enhance-shape.png differ diff --git a/doc/enhance-solid.png b/doc/enhance-solid.png new file mode 100644 index 0000000..a5dcf85 Binary files /dev/null and b/doc/enhance-solid.png differ diff --git a/doc/enhance-thinline.png b/doc/enhance-thinline.png new file mode 100644 index 0000000..daab11b Binary files /dev/null and b/doc/enhance-thinline.png differ diff --git a/doc/index.docbook b/doc/index.docbook index 538f71f..55bb079 100644 --- a/doc/index.docbook +++ b/doc/index.docbook @@ -1535,16 +1535,89 @@ Add a 'Find Previous' entry <para> Drawing lines in &okular; is implemented in two steps: generation of the clipping path and filling this clipping path. When the line in the original document is less than one pixel this two step implementation could cause problems. For those lines, the clipping path is filled with the filling color that depends on the thickness of the line part inside the clipping area. If the part of the line inside the clipping area gets very small the contrast between the shape and the background color can become too low for the line to be recognizable. The grids of such lines then looks very unpretty. </para> + <informaltable> + <tgroup cols="2"> + <tbody> + <row> + <entry> + <para> + <screenshot> + <screeninfo> + </screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="enhance-thinline.png" format="PNG"/> + </imageobject> + </mediaobject> + </screenshot> + </para> + </entry> + <entry> + <para> + <screenshot> + <screeninfo> + </screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="enhance-lowcontrast.png" format="PNG"/> + </imageobject> + </mediaobject> + </screenshot> + </para> + </entry> + </row> + <row> + <entry>Thin line (red), its clipping path (dashed line) and pixel boundaries (black solid lines)</entry> + <entry>Thin line shown at a low contrast</entry> + </row> + </tbody> + </tgroup> + </informaltable> <para> To enhance the look of the thin lines &okular; implements two options. </para> <para> - The first option is <guimenuitem>Solid</guimenuitem>. With this option &okular; adjusts clipping path and line position so that clipping path and line are on the same pixel boundary, &ie; &okular; enlarges the thin lines to one pixel on the output device. This mode is similar to the <guilabel>Enhance thin lines</guilabel> in <trademark class="registered">Adobe</trademark> <trademark class="registered">Reader</trademark>. If this option is chosen, the thin lines are always enlarged. + The first option is <guimenuitem>Solid</guimenuitem>. With this option &okular; adjusts clipping path and line position so that clipping path and line are on the same pixel boundary, &ie; &okular; enlarges the thin lines to one pixel on the output device. This mode is similar to the <guilabel>Enhance thin lines</guilabel> in <trademark class="registered">Adobe</trademark> + <trademark class="registered">Reader</trademark>. If this option is chosen, the thin lines are always enlarged. + </para> + <para> + <screenshot> + <screeninfo> + </screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="enhance-solid.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Thin line with <guimenuitem>Solid</guimenuitem> enhancement</phrase> + </textobject> + <caption> + <para>Thin line with <guimenuitem>Solid</guimenuitem> enhancement</para> + </caption> + </mediaobject> + </screenshot> </para> <para> The second option is <guimenuitem>Shape</guimenuitem>. With this option the clipping path and line are adjusted to pixel boundary as well, but the line intensity is corrected according to its width. </para> <para> + <screenshot> + <screeninfo> + </screeninfo> + <mediaobject> + <imageobject> + <imagedata fileref="enhance-shape.png" format="PNG"/> + </imageobject> + <textobject> + <phrase>Thin line with <guimenuitem>Shape</guimenuitem> enhancement</phrase> + </textobject> + <caption> + <para>Thin line with <guimenuitem>Shape</guimenuitem> enhancement</para> + </caption> + </mediaobject> + </screenshot> + </para> + <para> The thin lines are not enhanced by default (option <guimenuitem>No</guimenuitem>). </para> </listitem> @@ -1552,6 +1625,7 @@ Add a 'Find Previous' entry </variablelist> </para> </sect1> + </sect1> </chapter> <chapter id="configure"> <title>Configuring &okular;</title> diff --git a/doc/rating.png b/doc/rating.png deleted file mode 100644 index 3630d8f..0000000 Binary files a/doc/rating.png and /dev/null differ
