Blame Manuals/Latex/centos-art.sh-latex/Identity/Themes/Distro/Backgrounds/manual.tex

85c8b5
\documentclass{article}
85c8b5
\usepackage{longtable}
85c8b5
\usepackage[pdftex]{graphicx}
85c8b5
\usepackage{hyperref}
85c8b5
\hypersetup{pdfauthor={CentOS Documentation SIG},%
85c8b5
            pdftitle={GNOME Backgrounds},%
85c8b5
            pdfsubject={CentOS Corporate Visual Identity}%
85c8b5
            }
85c8b5
85c8b5
\title{Backgrounds}
85c8b5
\author{CentOS Documentation SIG}
85c8b5
85c8b5
\begin{document}
85c8b5
85c8b5
\maketitle
85c8b5
85c8b5
\begin{abstract}
85c8b5
This article describes GNOME and KDE background images.  The first
85c8b5
time a user's session has been loaded, the default background image is
85c8b5
shown on the screen as desktop background. Background image remains
85c8b5
visible in the screen as long as the user's session remains open. 
85c8b5
85c8b5
Copyright \copyright\ 2010\ The CentOS Project. Permission is
85c8b5
granted to copy, distribute and/or modify this document under the
85c8b5
terms of the GNU Free Documentation License, Version 1.2 or any later
85c8b5
version published by the Free Software Foundation; with no Invariant
85c8b5
Sections, no Front-Cover Texts, and no Back-Cover Texts. A copy of the
85c8b5
license is included in the section entitled ``GNU Free Documentation
85c8b5
License''.  
85c8b5
\end{abstract}
85c8b5
85c8b5
\tableofcontents
85c8b5
85c8b5
\section{Workplace}
85c8b5
85c8b5
\begin{itemize}
85c8b5
\item SVN:trunk/Identity/Themes/\$THEME/Distro/Backgrounds/
85c8b5
\end{itemize}
85c8b5
85c8b5
\section{Theme}
85c8b5
85c8b5
\input{table-theme.tex}
85c8b5
85c8b5
\section{Design}
85c8b5
85c8b5
Background design is based on CentOS Default Artistic Motif.
85c8b5
85c8b5
\begin{itemize}
85c8b5
\item There is no color limitation in this section.
85c8b5
\item There is no translation in these images.
85c8b5
\item There is no version, or textual information in these images.
85c8b5
\end{itemize}
85c8b5
85c8b5
\section{Rendering}
85c8b5
85c8b5
\section{Configuration}
85c8b5
85c8b5
\input{table-config.tex}
85c8b5
85c8b5
\begin{description}
85c8b5
85c8b5
\item[Default background]: The
85c8b5
\texttt{desktop\_gnome\_background.schemas} and \texttt{\%gconf-tree.xml}
85c8b5
files control which is the default background image loaded when new
85c8b5
users open their GNOME session for first time and as long as no change
85c8b5
be made in its ``Desktop Background Preferences''.
85c8b5
85c8b5
Inside \texttt{desktop\_gnome\_background.schemas} file the default
85c8b5
background image is defined in the line 6 of the following piece of
85c8b5
code:
85c8b5
85c8b5
\begin{verbatim}
85c8b5
...
85c8b5
 1| <schema>
85c8b5
 2|  <key>/schemas/desktop/gnome/background/picture_filename</key>
85c8b5
 3|  <applyto>/desktop/gnome/background/picture_filename</applyto>
85c8b5
 4|  <owner>gnome</owner>
85c8b5
 5|  <type>string</type>
85c8b5
 6|  <default>/usr/share/backgrounds/images/default.png</default>
85c8b5
 7|  <locale name="C">
85c8b5
 8|  <short>Picture Filename</short>
85c8b5
 9|  <long>File to use for the background image</long>
85c8b5
10|  </locale>
85c8b5
11|
85c8b5
...
85c8b5
\end{verbatim}
85c8b5
85c8b5
Inside \texttt{\%gconf-tree.xml} file, the default background image is
85c8b5
defined in the line 4 of the following piece of code:
85c8b5
85c8b5
\begin{verbatim}
85c8b5
...
85c8b5
1|  <entry name="picture_filename" mtime="1204075267" type="schema" stype="string" owner="gnome">
85c8b5
2|     <local_schema locale="C" short_desc="Picture Filename">
85c8b5
3|        <default type="string">
85c8b5
4|           <stringvalue>/usr/share/backgrounds/images/default.png</stringvalue>
85c8b5
5|        </default>
85c8b5
6|        <longdesc>File to use for the background image</longdesc>
85c8b5
7|     </local_schema>
85c8b5
8|  </entry>
85c8b5
...
85c8b5
\end{verbatim}
85c8b5
85c8b5
In both files \texttt{desktop\_gnome\_background.schemas} and
85c8b5
\texttt{\%gconf-tree.xml}, the image file name should be the same.
85c8b5
85c8b5
The \texttt{kdesktoprc} file controls KDE desktop configuration file.
85c8b5
The following lines were taken from that file and show the variables
85c8b5
that control default background on KDE desktop.
85c8b5
85c8b5
\begin{verbatim}
85c8b5
Wallpaper=/usr/share/backgrounds/images/default.png
85c8b5
WallpaperMode=Scaled
85c8b5
\end{verbatim}
85c8b5
85c8b5
\end{description}
85c8b5
85c8b5
\section{Testing}
85c8b5
85c8b5
\section{Issues}
85c8b5
85c8b5
\begin{description}
85c8b5
85c8b5
\item[Image format definition]: Images controlling default desktop
85c8b5
backgrounds are in JPG format. Nevertheless this doesn't match with
85c8b5
the definition in the configuration file
85c8b5
\texttt{desktop-backgrounds-basic.xml} which mention them as PNG format.
85c8b5
This issue makes those images not to be displayed in the GNOME
85c8b5
``Desktop Background Preferences''.
85c8b5
85c8b5
\end{description}
85c8b5
85c8b5
% License section
85c8b5
\input{../../../../Licenses/GFDL.tex}
85c8b5
85c8b5
\end{document}