Blame Manual/repository-latex/Identity/Themes/Distro/Backgrounds/manual.tex

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