\section{App}
\label{group__App}\index{App@{App}}


Provide information in order to make Elementary determine the {\bfseries run} time location of the software in question, so other data files such as images, sound files, executable utilities, libraries, modules and locale files can be found.  


\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
void \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set} (void $\ast$mainfunc, const char $\ast$dom, const char $\ast$checkfile)
\begin{DoxyCompactList}\small\item\em Re-\/locate the application somewhere else after compilation, if the developer wishes for easier distribution of pre-\/compiled binaries. \end{DoxyCompactList}\item 
void \hyperlink{group__App_gaaf3c92bd231522a13036dc00d585be87}{elm\-\_\-app\-\_\-name\-\_\-set} (const char $\ast$name)
\begin{DoxyCompactList}\small\item\em Set a formal name to be used with the elm application. \end{DoxyCompactList}\item 
void \hyperlink{group__App_ga43d405c9c12c0765f10892944696819e}{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-set} (const char $\ast$path)
\begin{DoxyCompactList}\small\item\em Set the path to the '.desktop' file to be associated with the elm application. \end{DoxyCompactList}\item 
void \hyperlink{group__App_gaedf0adf5c965a79a28f43b9c4cb49762}{elm\-\_\-app\-\_\-compile\-\_\-bin\-\_\-dir\-\_\-set} (const char $\ast$dir)
\begin{DoxyCompactList}\small\item\em Provide information on the {\bfseries fallback} application's binaries directory, in scenarios where they get overridden by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. \end{DoxyCompactList}\item 
void \hyperlink{group__App_ga9e553b1adb80795b58e101c28fc0adef}{elm\-\_\-app\-\_\-compile\-\_\-lib\-\_\-dir\-\_\-set} (const char $\ast$dir)
\begin{DoxyCompactList}\small\item\em Provide information on the {\bfseries fallback} application's libraries directory, on scenarios where they get overridden by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. \end{DoxyCompactList}\item 
void \hyperlink{group__App_ga4e875d27efb02b4c425619957c0ae7c7}{elm\-\_\-app\-\_\-compile\-\_\-data\-\_\-dir\-\_\-set} (const char $\ast$dir)
\begin{DoxyCompactList}\small\item\em Provide information on the {\bfseries fallback} application's data directory, on scenarios where they get overridden by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. \end{DoxyCompactList}\item 
void \hyperlink{group__App_ga3dfa8f300581e98d168fa7d7eea5c3d2}{elm\-\_\-app\-\_\-compile\-\_\-locale\-\_\-set} (const char $\ast$dir)
\begin{DoxyCompactList}\small\item\em Provide information on the {\bfseries fallback} application's locale directory, on scenarios where they get overridden by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. \end{DoxyCompactList}\item 
const char $\ast$ \hyperlink{group__App_ga2fab77e6331fe16cb7d4cb4800ce2ddb}{elm\-\_\-app\-\_\-name\-\_\-get} (void)
\begin{DoxyCompactList}\small\item\em Retrieve the application formal name, as set by \hyperlink{group__App_gaaf3c92bd231522a13036dc00d585be87}{elm\-\_\-app\-\_\-name\-\_\-set()}. \end{DoxyCompactList}\item 
const char $\ast$ \hyperlink{group__App_ga9a8953536a002809525f7699f9e03936}{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-get} (void)
\begin{DoxyCompactList}\small\item\em Retrieve the path to the '.desktop' file, as set by \hyperlink{group__App_ga43d405c9c12c0765f10892944696819e}{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-set()}. \end{DoxyCompactList}\item 
const char $\ast$ \hyperlink{group__App_gaff335edd418543d7fba447757c1da585}{elm\-\_\-app\-\_\-prefix\-\_\-dir\-\_\-get} (void)
\begin{DoxyCompactList}\small\item\em Retrieve the application's run time prefix directory, as set by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} and the way (environment) the application was run from. \end{DoxyCompactList}\item 
const char $\ast$ \hyperlink{group__App_ga471dc35475c84c81eb91108801d5d0c5}{elm\-\_\-app\-\_\-bin\-\_\-dir\-\_\-get} (void)
\begin{DoxyCompactList}\small\item\em Retrieve the application's run time binaries prefix directory, as set by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} and the way (environment) the application was run from. \end{DoxyCompactList}\item 
const char $\ast$ \hyperlink{group__App_gaebb58baebbfa5cc79ec0668293ee3623}{elm\-\_\-app\-\_\-lib\-\_\-dir\-\_\-get} (void)
\begin{DoxyCompactList}\small\item\em Retrieve the application's run time libraries prefix directory, as set by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} and the way (environment) the application was run from. \end{DoxyCompactList}\item 
const char $\ast$ \hyperlink{group__App_ga92a09dbf88cc1ca3eab51c51dea589d0}{elm\-\_\-app\-\_\-data\-\_\-dir\-\_\-get} (void)
\begin{DoxyCompactList}\small\item\em Retrieve the application's run time data prefix directory, as set by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} and the way (environment) the application was run from. \end{DoxyCompactList}\item 
const char $\ast$ \hyperlink{group__App_ga387d986f89742ea5d5ee6453ba60996e}{elm\-\_\-app\-\_\-locale\-\_\-dir\-\_\-get} (void)
\begin{DoxyCompactList}\small\item\em Retrieve the application's run time locale prefix directory, as set by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} and the way (environment) the application was run from. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
Provide information in order to make Elementary determine the {\bfseries run} time location of the software in question, so other data files such as images, sound files, executable utilities, libraries, modules and locale files can be found. 

\subsection{Function Documentation}
\index{App@{App}!elm\-\_\-app\-\_\-bin\-\_\-dir\-\_\-get@{elm\-\_\-app\-\_\-bin\-\_\-dir\-\_\-get}}
\index{elm\-\_\-app\-\_\-bin\-\_\-dir\-\_\-get@{elm\-\_\-app\-\_\-bin\-\_\-dir\-\_\-get}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-bin\-\_\-dir\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ elm\-\_\-app\-\_\-bin\-\_\-dir\-\_\-get (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__App_ga471dc35475c84c81eb91108801d5d0c5}


Retrieve the application's run time binaries prefix directory, as set by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} and the way (environment) the application was run from. 

\begin{DoxyReturn}{Returns}
The binaries directory prefix the application is actually using. 
\end{DoxyReturn}
\index{App@{App}!elm\-\_\-app\-\_\-compile\-\_\-bin\-\_\-dir\-\_\-set@{elm\-\_\-app\-\_\-compile\-\_\-bin\-\_\-dir\-\_\-set}}
\index{elm\-\_\-app\-\_\-compile\-\_\-bin\-\_\-dir\-\_\-set@{elm\-\_\-app\-\_\-compile\-\_\-bin\-\_\-dir\-\_\-set}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-compile\-\_\-bin\-\_\-dir\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-app\-\_\-compile\-\_\-bin\-\_\-dir\-\_\-set (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{dir}
\end{DoxyParamCaption}
)}\label{group__App_gaedf0adf5c965a79a28f43b9c4cb49762}


Provide information on the {\bfseries fallback} application's binaries directory, in scenarios where they get overridden by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. 


\begin{DoxyParams}{Parameters}
{\em dir} & The path to the default binaries directory (compile time one)\\
\hline
\end{DoxyParams}
\begin{DoxyNote}{Note}
Elementary will as well use this path to determine actual names of binaries' directory paths, maybe changing it to be {\ttfamily something/local/bin} instead of {\ttfamily something/bin}, only, for example.
\end{DoxyNote}
\begin{DoxyWarning}{Warning}
You should call this function {\bfseries before} \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. 
\end{DoxyWarning}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{general_funcs_example_8c-example}{general\-\_\-funcs\-\_\-example.\-c}.\end{Desc}
\index{App@{App}!elm\-\_\-app\-\_\-compile\-\_\-data\-\_\-dir\-\_\-set@{elm\-\_\-app\-\_\-compile\-\_\-data\-\_\-dir\-\_\-set}}
\index{elm\-\_\-app\-\_\-compile\-\_\-data\-\_\-dir\-\_\-set@{elm\-\_\-app\-\_\-compile\-\_\-data\-\_\-dir\-\_\-set}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-compile\-\_\-data\-\_\-dir\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-app\-\_\-compile\-\_\-data\-\_\-dir\-\_\-set (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{dir}
\end{DoxyParamCaption}
)}\label{group__App_ga4e875d27efb02b4c425619957c0ae7c7}


Provide information on the {\bfseries fallback} application's data directory, on scenarios where they get overridden by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. 


\begin{DoxyParams}{Parameters}
{\em dir} & The path to the default data directory (compile time one)\\
\hline
\end{DoxyParams}
\begin{DoxyNote}{Note}
Elementary will as well use this path to determine actual names of data directory paths, maybe changing it to be {\ttfamily something/local/share} instead of {\ttfamily something/share}, only, for example.
\end{DoxyNote}
\begin{DoxyWarning}{Warning}
You should call this function {\bfseries before} \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. 
\end{DoxyWarning}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{general_funcs_example_8c-example}{general\-\_\-funcs\-\_\-example.\-c}.\end{Desc}
\index{App@{App}!elm\-\_\-app\-\_\-compile\-\_\-lib\-\_\-dir\-\_\-set@{elm\-\_\-app\-\_\-compile\-\_\-lib\-\_\-dir\-\_\-set}}
\index{elm\-\_\-app\-\_\-compile\-\_\-lib\-\_\-dir\-\_\-set@{elm\-\_\-app\-\_\-compile\-\_\-lib\-\_\-dir\-\_\-set}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-compile\-\_\-lib\-\_\-dir\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-app\-\_\-compile\-\_\-lib\-\_\-dir\-\_\-set (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{dir}
\end{DoxyParamCaption}
)}\label{group__App_ga9e553b1adb80795b58e101c28fc0adef}


Provide information on the {\bfseries fallback} application's libraries directory, on scenarios where they get overridden by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. 


\begin{DoxyParams}{Parameters}
{\em dir} & The path to the default libraries directory (compile time one)\\
\hline
\end{DoxyParams}
\begin{DoxyNote}{Note}
Elementary will as well use this path to determine actual names of libraries' directory paths, maybe changing it to be {\ttfamily something/lib32} or {\ttfamily something/lib64} instead of {\ttfamily something/lib}, only, for example.
\end{DoxyNote}
\begin{DoxyWarning}{Warning}
You should call this function {\bfseries before} \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. 
\end{DoxyWarning}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{general_funcs_example_8c-example}{general\-\_\-funcs\-\_\-example.\-c}.\end{Desc}
\index{App@{App}!elm\-\_\-app\-\_\-compile\-\_\-locale\-\_\-set@{elm\-\_\-app\-\_\-compile\-\_\-locale\-\_\-set}}
\index{elm\-\_\-app\-\_\-compile\-\_\-locale\-\_\-set@{elm\-\_\-app\-\_\-compile\-\_\-locale\-\_\-set}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-compile\-\_\-locale\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-app\-\_\-compile\-\_\-locale\-\_\-set (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{dir}
\end{DoxyParamCaption}
)}\label{group__App_ga3dfa8f300581e98d168fa7d7eea5c3d2}


Provide information on the {\bfseries fallback} application's locale directory, on scenarios where they get overridden by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. 


\begin{DoxyParams}{Parameters}
{\em dir} & The path to the default locale directory (compile time one)\\
\hline
\end{DoxyParams}
\begin{DoxyWarning}{Warning}
You should call this function {\bfseries before} \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()}. 
\end{DoxyWarning}
\index{App@{App}!elm\-\_\-app\-\_\-data\-\_\-dir\-\_\-get@{elm\-\_\-app\-\_\-data\-\_\-dir\-\_\-get}}
\index{elm\-\_\-app\-\_\-data\-\_\-dir\-\_\-get@{elm\-\_\-app\-\_\-data\-\_\-dir\-\_\-get}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-data\-\_\-dir\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ elm\-\_\-app\-\_\-data\-\_\-dir\-\_\-get (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__App_ga92a09dbf88cc1ca3eab51c51dea589d0}


Retrieve the application's run time data prefix directory, as set by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} and the way (environment) the application was run from. 

\begin{DoxyReturn}{Returns}
The data directory prefix the application is actually using. 
\end{DoxyReturn}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{bg_example_02_8c-example}{bg\-\_\-example\-\_\-02.\-c}, \hyperlink{bg_example_03_8c-example}{bg\-\_\-example\-\_\-03.\-c}, \hyperlink{general_funcs_example_8c-example}{general\-\_\-funcs\-\_\-example.\-c}, \hyperlink{gengrid_example_8c-example}{gengrid\-\_\-example.\-c}, \hyperlink{image_example_01_8c-example}{image\-\_\-example\-\_\-01.\-c}, \hyperlink{index_example_02_8c-example}{index\-\_\-example\-\_\-02.\-c}, \hyperlink{layout_example_01_8c-example}{layout\-\_\-example\-\_\-01.\-c}, \hyperlink{layout_example_03_8c-example}{layout\-\_\-example\-\_\-03.\-c}, \hyperlink{map_example_02_8c-example}{map\-\_\-example\-\_\-02.\-c}, \hyperlink{photocam_example_01_8c-example}{photocam\-\_\-example\-\_\-01.\-c}, \hyperlink{popup_example_02_8c-example}{popup\-\_\-example\-\_\-02.\-c}, \hyperlink{popup_example_03_8c-example}{popup\-\_\-example\-\_\-03.\-c}, \hyperlink{progressbar_example_8c-example}{progressbar\-\_\-example.\-c}, \hyperlink{slideshow_example_8c-example}{slideshow\-\_\-example.\-c}, \hyperlink{thumb_example_01_8c-example}{thumb\-\_\-example\-\_\-01.\-c}, and \hyperlink{win_example_8c-example}{win\-\_\-example.\-c}.\end{Desc}
\index{App@{App}!elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-get@{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-get}}
\index{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-get@{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-get}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-get (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__App_ga9a8953536a002809525f7699f9e03936}


Retrieve the path to the '.desktop' file, as set by \hyperlink{group__App_ga43d405c9c12c0765f10892944696819e}{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-set()}. 

\begin{DoxyReturn}{Returns}
The '.desktop' file path.
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\index{App@{App}!elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-set@{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-set}}
\index{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-set@{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-set}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-app\-\_\-desktop\-\_\-entry\-\_\-set (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{path}
\end{DoxyParamCaption}
)}\label{group__App_ga43d405c9c12c0765f10892944696819e}


Set the path to the '.desktop' file to be associated with the elm application. 


\begin{DoxyParams}{Parameters}
{\em path} & The path to the '.desktop' file\\
\hline
\end{DoxyParams}
\begin{DoxyWarning}{Warning}
Since this path is very environment dependent, this will hold whatever value is passed to it.
\end{DoxyWarning}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\index{App@{App}!elm\-\_\-app\-\_\-info\-\_\-set@{elm\-\_\-app\-\_\-info\-\_\-set}}
\index{elm\-\_\-app\-\_\-info\-\_\-set@{elm\-\_\-app\-\_\-info\-\_\-set}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-info\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-app\-\_\-info\-\_\-set (
\begin{DoxyParamCaption}
\item[{void $\ast$}]{mainfunc, }
\item[{const char $\ast$}]{dom, }
\item[{const char $\ast$}]{checkfile}
\end{DoxyParamCaption}
)}\label{group__App_ga0cefb59efb95841232561d67e34d9909}


Re-\/locate the application somewhere else after compilation, if the developer wishes for easier distribution of pre-\/compiled binaries. 


\begin{DoxyParams}{Parameters}
{\em mainfunc} & This is your application's main function name, whose binary's location is to be found. Providing {\ttfamily N\-U\-L\-L} will make Elementary not to use it \\
\hline
{\em dom} & This will be used as the application's \char`\"{}domain\char`\"{}, in the form of a prefix to any environment variables that may override prefix detection and the directory name, inside the standard share or data directories, where the software's data files will be looked for. \\
\hline
{\em checkfile} & This is an (optional) magic file's path to check for existence (and it must be located in the data directory, under the share directory provided above). Its presence will help determine the prefix found was correct. Pass {\ttfamily N\-U\-L\-L} if the check is not to be done.\\
\hline
\end{DoxyParams}
The prefix system is designed to locate where the given software is installed (under a common path prefix) at run time and then report specific locations of this prefix and common directories inside this prefix like the binary, library, data and locale directories, through the {\ttfamily elm\-\_\-app\-\_\-$\ast$\-\_\-get}() family of functions.

Call \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} early on before you change working directory or anything about {\ttfamily argv}\mbox{[}0\mbox{]}, so it gets accurate information.

It will then try and trace back which file {\ttfamily mainfunc} comes from, if provided, to determine the application's prefix directory.

The {\ttfamily dom} parameter provides a string prefix to prepend before environment variables, allowing a fallback to {\bfseries specific} environment variables to locate the software. You would most probably provide a lowercase string there, because it will also serve as directory domain, explained next. For environment variables purposes, this string is made uppercase. For example if {\ttfamily \char`\"{}myapp\char`\"{}} is provided as the prefix, then the program would expect {\ttfamily \char`\"{}\-M\-Y\-A\-P\-P\-\_\-\-P\-R\-E\-F\-I\-X\char`\"{}} as a master environment variable to specify the exact install prefix for the software, or more specific environment variables like {\ttfamily \char`\"{}\-M\-Y\-A\-P\-P\-\_\-\-B\-I\-N\-\_\-\-D\-I\-R\char`\"{}}, {\ttfamily \char`\"{}\-M\-Y\-A\-P\-P\-\_\-\-L\-I\-B\-\_\-\-D\-I\-R\char`\"{}}, {\ttfamily \char`\"{}\-M\-Y\-A\-P\-P\-\_\-\-D\-A\-T\-A\-\_\-\-D\-I\-R\char`\"{}} and {\ttfamily \char`\"{}\-M\-Y\-A\-P\-P\-\_\-\-L\-O\-C\-A\-L\-E\-\_\-\-D\-I\-R\char`\"{}}, which could be set by the user or scripts before launching. If not provided ({\ttfamily N\-U\-L\-L}), environment variables will not be used to override compiled-\/in defaults or auto detections.

The {\ttfamily dom} string also provides a subdirectory inside the system shared data directory for data files. For example, if the system directory is {\ttfamily /usr/local/share}, then this directory name is appended, creating {\ttfamily /usr/local/share/myapp}, if it {\ttfamily was} {\ttfamily \char`\"{}myapp\char`\"{}}. It is expected that the application installs data files in this directory.

The {\ttfamily checkfile} is a file name or path of something inside the share or data directory to be used to test that the prefix detection worked. For example, your app will install a wallpaper image as {\ttfamily /usr/local/share/myapp/images/wallpaper}.jpg and so to check that this worked, provide {\ttfamily \char`\"{}images/wallpaper.\-jpg\char`\"{}} as the {\ttfamily checkfile} string.

\begin{DoxySeeAlso}{See Also}
\hyperlink{group__App_gaedf0adf5c965a79a28f43b9c4cb49762}{elm\-\_\-app\-\_\-compile\-\_\-bin\-\_\-dir\-\_\-set()} 

\hyperlink{group__App_ga9e553b1adb80795b58e101c28fc0adef}{elm\-\_\-app\-\_\-compile\-\_\-lib\-\_\-dir\-\_\-set()} 

\hyperlink{group__App_ga4e875d27efb02b4c425619957c0ae7c7}{elm\-\_\-app\-\_\-compile\-\_\-data\-\_\-dir\-\_\-set()} 

\hyperlink{group__App_ga3dfa8f300581e98d168fa7d7eea5c3d2}{elm\-\_\-app\-\_\-compile\-\_\-locale\-\_\-set()} 

\hyperlink{group__App_gaff335edd418543d7fba447757c1da585}{elm\-\_\-app\-\_\-prefix\-\_\-dir\-\_\-get()} 

\hyperlink{group__App_ga471dc35475c84c81eb91108801d5d0c5}{elm\-\_\-app\-\_\-bin\-\_\-dir\-\_\-get()} 

\hyperlink{group__App_gaebb58baebbfa5cc79ec0668293ee3623}{elm\-\_\-app\-\_\-lib\-\_\-dir\-\_\-get()} 

\hyperlink{group__App_ga92a09dbf88cc1ca3eab51c51dea589d0}{elm\-\_\-app\-\_\-data\-\_\-dir\-\_\-get()} 

\hyperlink{group__App_ga387d986f89742ea5d5ee6453ba60996e}{elm\-\_\-app\-\_\-locale\-\_\-dir\-\_\-get()} 
\end{DoxySeeAlso}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{bg_example_02_8c-example}{bg\-\_\-example\-\_\-02.\-c}, \hyperlink{bg_example_03_8c-example}{bg\-\_\-example\-\_\-03.\-c}, \hyperlink{general_funcs_example_8c-example}{general\-\_\-funcs\-\_\-example.\-c}, \hyperlink{gengrid_example_8c-example}{gengrid\-\_\-example.\-c}, \hyperlink{image_example_01_8c-example}{image\-\_\-example\-\_\-01.\-c}, \hyperlink{index_example_02_8c-example}{index\-\_\-example\-\_\-02.\-c}, \hyperlink{layout_example_01_8c-example}{layout\-\_\-example\-\_\-01.\-c}, \hyperlink{layout_example_03_8c-example}{layout\-\_\-example\-\_\-03.\-c}, \hyperlink{map_example_02_8c-example}{map\-\_\-example\-\_\-02.\-c}, \hyperlink{photocam_example_01_8c-example}{photocam\-\_\-example\-\_\-01.\-c}, \hyperlink{popup_example_02_8c-example}{popup\-\_\-example\-\_\-02.\-c}, \hyperlink{popup_example_03_8c-example}{popup\-\_\-example\-\_\-03.\-c}, \hyperlink{progressbar_example_8c-example}{progressbar\-\_\-example.\-c}, \hyperlink{slideshow_example_8c-example}{slideshow\-\_\-example.\-c}, \hyperlink{thumb_example_01_8c-example}{thumb\-\_\-example\-\_\-01.\-c}, and \hyperlink{win_example_8c-example}{win\-\_\-example.\-c}.\end{Desc}
\index{App@{App}!elm\-\_\-app\-\_\-lib\-\_\-dir\-\_\-get@{elm\-\_\-app\-\_\-lib\-\_\-dir\-\_\-get}}
\index{elm\-\_\-app\-\_\-lib\-\_\-dir\-\_\-get@{elm\-\_\-app\-\_\-lib\-\_\-dir\-\_\-get}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-lib\-\_\-dir\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ elm\-\_\-app\-\_\-lib\-\_\-dir\-\_\-get (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__App_gaebb58baebbfa5cc79ec0668293ee3623}


Retrieve the application's run time libraries prefix directory, as set by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} and the way (environment) the application was run from. 

\begin{DoxyReturn}{Returns}
The libraries directory prefix the application is actually using. 
\end{DoxyReturn}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{general_funcs_example_8c-example}{general\-\_\-funcs\-\_\-example.\-c}.\end{Desc}
\index{App@{App}!elm\-\_\-app\-\_\-locale\-\_\-dir\-\_\-get@{elm\-\_\-app\-\_\-locale\-\_\-dir\-\_\-get}}
\index{elm\-\_\-app\-\_\-locale\-\_\-dir\-\_\-get@{elm\-\_\-app\-\_\-locale\-\_\-dir\-\_\-get}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-locale\-\_\-dir\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ elm\-\_\-app\-\_\-locale\-\_\-dir\-\_\-get (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__App_ga387d986f89742ea5d5ee6453ba60996e}


Retrieve the application's run time locale prefix directory, as set by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} and the way (environment) the application was run from. 

\begin{DoxyReturn}{Returns}
The locale directory prefix the application is actually using. 
\end{DoxyReturn}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{general_funcs_example_8c-example}{general\-\_\-funcs\-\_\-example.\-c}.\end{Desc}
\index{App@{App}!elm\-\_\-app\-\_\-name\-\_\-get@{elm\-\_\-app\-\_\-name\-\_\-get}}
\index{elm\-\_\-app\-\_\-name\-\_\-get@{elm\-\_\-app\-\_\-name\-\_\-get}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-name\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ elm\-\_\-app\-\_\-name\-\_\-get (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__App_ga2fab77e6331fe16cb7d4cb4800ce2ddb}


Retrieve the application formal name, as set by \hyperlink{group__App_gaaf3c92bd231522a13036dc00d585be87}{elm\-\_\-app\-\_\-name\-\_\-set()}. 

\begin{DoxyReturn}{Returns}
The application formal name.
\end{DoxyReturn}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}
\index{App@{App}!elm\-\_\-app\-\_\-name\-\_\-set@{elm\-\_\-app\-\_\-name\-\_\-set}}
\index{elm\-\_\-app\-\_\-name\-\_\-set@{elm\-\_\-app\-\_\-name\-\_\-set}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-name\-\_\-set}]{\setlength{\rightskip}{0pt plus 5cm}void elm\-\_\-app\-\_\-name\-\_\-set (
\begin{DoxyParamCaption}
\item[{const char $\ast$}]{name}
\end{DoxyParamCaption}
)}\label{group__App_gaaf3c92bd231522a13036dc00d585be87}


Set a formal name to be used with the elm application. 


\begin{DoxyParams}{Parameters}
{\em name} & Application name.\\
\hline
\end{DoxyParams}
\begin{DoxySince}{Since}
1.\-8 
\end{DoxySince}


Referenced by elm\-\_\-quicklaunch\-\_\-init().

\index{App@{App}!elm\-\_\-app\-\_\-prefix\-\_\-dir\-\_\-get@{elm\-\_\-app\-\_\-prefix\-\_\-dir\-\_\-get}}
\index{elm\-\_\-app\-\_\-prefix\-\_\-dir\-\_\-get@{elm\-\_\-app\-\_\-prefix\-\_\-dir\-\_\-get}!App@{App}}
\subsubsection[{elm\-\_\-app\-\_\-prefix\-\_\-dir\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}const char$\ast$ elm\-\_\-app\-\_\-prefix\-\_\-dir\-\_\-get (
\begin{DoxyParamCaption}
\item[{void}]{}
\end{DoxyParamCaption}
)}\label{group__App_gaff335edd418543d7fba447757c1da585}


Retrieve the application's run time prefix directory, as set by \hyperlink{group__App_ga0cefb59efb95841232561d67e34d9909}{elm\-\_\-app\-\_\-info\-\_\-set()} and the way (environment) the application was run from. 

\begin{DoxyReturn}{Returns}
The directory prefix the application is actually using. 
\end{DoxyReturn}
\begin{Desc}
\item[Examples\-: ]\par
\hyperlink{general_funcs_example_8c-example}{general\-\_\-funcs\-\_\-example.\-c}.\end{Desc}
