\section{Image}
\label{group__Image}\index{Image@{Image}}
\subsection*{Data Structures}
\begin{DoxyCompactItemize}
\item 
struct \hyperlink{struct__Elm__Image__Progress}{\+\_\+\+Elm\+\_\+\+Image\+\_\+\+Progress}
\begin{DoxyCompactList}\small\item\em Structure associated with smart callback \textquotesingle{}download,progress\textquotesingle{}. \end{DoxyCompactList}\item 
struct \hyperlink{struct__Elm__Image__Error}{\+\_\+\+Elm\+\_\+\+Image\+\_\+\+Error}
\begin{DoxyCompactList}\small\item\em Structure associated with smart callback \textquotesingle{}download,progress\textquotesingle{}. \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Typedefs}
\begin{DoxyCompactItemize}
\item 
typedef Evas\+\_\+\+Image\+\_\+\+Orient \hyperlink{group__Image_gae83b55151d822d1ab06c18d1e97af0c4}{Elm\+\_\+\+Image\+\_\+\+Orient}
\begin{DoxyCompactList}\small\item\em Using Evas\+\_\+\+Image\+\_\+\+Orient enums. \end{DoxyCompactList}\item 
typedef struct \hyperlink{struct__Elm__Image__Progress}{\+\_\+\+Elm\+\_\+\+Image\+\_\+\+Progress} \hyperlink{group__Image_ga37535cccf98fb95787e77daa4bc1d902}{Elm\+\_\+\+Image\+\_\+\+Progress}
\begin{DoxyCompactList}\small\item\em Structure associated with smart callback \textquotesingle{}download,progress\textquotesingle{}. \end{DoxyCompactList}\item 
typedef struct \hyperlink{struct__Elm__Image__Error}{\+\_\+\+Elm\+\_\+\+Image\+\_\+\+Error} \hyperlink{group__Image_ga17cebc1e6a1180094b31c9777d5ce5da}{Elm\+\_\+\+Image\+\_\+\+Error}
\begin{DoxyCompactList}\small\item\em Structre associated with smart callback \textquotesingle{}download,error\textquotesingle{}. \end{DoxyCompactList}\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\+\_\+\+Object $\ast$ \hyperlink{group__Image_ga5d211c8af4f6e297a24fc4e8737c81a9}{elm\+\_\+image\+\_\+add} (Evas\+\_\+\+Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Add a new image to the parent. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Image_gad1a96ede5f513042cef3c1dac4572f73}{elm\+\_\+image\+\_\+file\+\_\+set} (Evas\+\_\+\+Object $\ast$obj, const char $\ast$file, const char $\ast$group)
\begin{DoxyCompactList}\small\item\em Set the file that will be used as the image\textquotesingle{}s source. \end{DoxyCompactList}\item 
void \hyperlink{group__Image_ga2457a336d2123a8074725e814e459cba}{elm\+\_\+image\+\_\+file\+\_\+get} (const Eo $\ast$obj, const char $\ast$$\ast$file, const char $\ast$$\ast$group)
\begin{DoxyCompactList}\small\item\em Get the file that will be used as image. \end{DoxyCompactList}\item 
void \hyperlink{group__Image_gafb6dd2b235e25b2bd0b93d82e205a4f6}{elm\+\_\+image\+\_\+prescale\+\_\+set} (Evas\+\_\+\+Object $\ast$obj, int size)
\begin{DoxyCompactList}\small\item\em Set the prescale size for the image. \end{DoxyCompactList}\item 
int \hyperlink{group__Image_ga1aeca8dbe2367d817492099887ca8f2d}{elm\+\_\+image\+\_\+prescale\+\_\+get} (const Evas\+\_\+\+Object $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get the prescale size for the image. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Image_gace214b3e6e6a8c95eb24f3e0d48be24b}{elm\+\_\+image\+\_\+mmap\+\_\+set} (Evas\+\_\+\+Object $\ast$obj, const Eina\+\_\+\+File $\ast$file, const char $\ast$group)
\begin{DoxyCompactList}\small\item\em Set the file that will be used as the image\textquotesingle{}s source. \end{DoxyCompactList}\item 
void \hyperlink{group__Image_gac4d8f9a8c756e478c0b31bb1371dee46}{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+set} (Evas\+\_\+\+Object $\ast$obj, Eina\+\_\+\+Bool play)
\begin{DoxyCompactList}\small\item\em Start or stop an image object\textquotesingle{}s animation. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Image_gafc3120f2ff8cc7403238783b8561bf55}{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+get} (const Evas\+\_\+\+Object $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get whether an image object is under animation or not. \end{DoxyCompactList}\item 
void \hyperlink{group__Image_gafb3915f863b15be7e5d41d80a6bf3a08}{elm\+\_\+image\+\_\+animated\+\_\+set} (Evas\+\_\+\+Object $\ast$obj, Eina\+\_\+\+Bool anim)
\begin{DoxyCompactList}\small\item\em Set whether an image object (which supports animation) is to animate itself or not. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Image_gaba9148979630af8ab6351ccfa7f6156a}{elm\+\_\+image\+\_\+animated\+\_\+get} (const Evas\+\_\+\+Object $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get whether an image object has animation enabled or not. \end{DoxyCompactList}\item 
Eina\+\_\+\+Bool \hyperlink{group__Image_ga1f61c469baddcaed97ab9846ea294594}{elm\+\_\+image\+\_\+animated\+\_\+available\+\_\+get} (const Evas\+\_\+\+Object $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get whether an image object supports animation or not. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
 
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics[width=\textwidth,height=\textheight/2,keepaspectratio=true]{image_inheritance_tree}}
\end{DoxyImageNoCaption}


 
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics[width=\textwidth,height=\textheight/2,keepaspectratio=true]{img/widget/image/preview-00}}
\end{DoxyImageNoCaption}


An Elementary image object is a direct realization of \hyperlink{group__Widget_elm-image-class}{The Elementary Image Class}, and it allows one to load and display an {\bfseries image} file on it, be it from a disk file or from a memory region. Exceptionally, one may also load an Edje group as the contents of the image. In this case, though, most of the functions of the image A\+PI will act as a no-\/op.

One can tune various properties of the image, like\+:
\begin{DoxyItemize}
\item pre-\/scaling,
\item smooth scaling,
\item orientation,
\item aspect ratio during resizes, etc.
\end{DoxyItemize}

An image object may also be made valid source and destination for drag and drop actions, through the elm\+\_\+image\+\_\+editable\+\_\+set() call.

Signals that you can add callbacks for are\+:

\begin{DoxyItemize}
\item {\ttfamily \char`\"{}drop\char`\"{}} -\/ This is called when a user has dropped an image typed object onto the object in question -- the event info argument is the path to that image file \item {\ttfamily \char`\"{}clicked\char`\"{}} -\/ This is called when a user has clicked the image\end{DoxyItemize}
An example of usage for this A\+PI follows\+: \begin{DoxyItemize}
\item \hyperlink{tutorial_image}{Image example} \end{DoxyItemize}


\subsection{Typedef Documentation}
\index{Image@{Image}!Elm\+\_\+\+Image\+\_\+\+Error@{Elm\+\_\+\+Image\+\_\+\+Error}}
\index{Elm\+\_\+\+Image\+\_\+\+Error@{Elm\+\_\+\+Image\+\_\+\+Error}!Image@{Image}}
\subsubsection[{\texorpdfstring{Elm\+\_\+\+Image\+\_\+\+Error}{Elm_Image_Error}}]{\setlength{\rightskip}{0pt plus 5cm}typedef struct {\bf \+\_\+\+Elm\+\_\+\+Image\+\_\+\+Error} {\bf Elm\+\_\+\+Image\+\_\+\+Error}}\label{group__Image_ga17cebc1e6a1180094b31c9777d5ce5da}


Structre associated with smart callback \textquotesingle{}download,error\textquotesingle{}. 

\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\index{Image@{Image}!Elm\+\_\+\+Image\+\_\+\+Orient@{Elm\+\_\+\+Image\+\_\+\+Orient}}
\index{Elm\+\_\+\+Image\+\_\+\+Orient@{Elm\+\_\+\+Image\+\_\+\+Orient}!Image@{Image}}
\subsubsection[{\texorpdfstring{Elm\+\_\+\+Image\+\_\+\+Orient}{Elm_Image_Orient}}]{\setlength{\rightskip}{0pt plus 5cm}typedef Evas\+\_\+\+Image\+\_\+\+Orient {\bf Elm\+\_\+\+Image\+\_\+\+Orient}}\label{group__Image_gae83b55151d822d1ab06c18d1e97af0c4}


Using Evas\+\_\+\+Image\+\_\+\+Orient enums. 

\begin{DoxySince}{Since}
1.\+14 
\end{DoxySince}
\index{Image@{Image}!Elm\+\_\+\+Image\+\_\+\+Progress@{Elm\+\_\+\+Image\+\_\+\+Progress}}
\index{Elm\+\_\+\+Image\+\_\+\+Progress@{Elm\+\_\+\+Image\+\_\+\+Progress}!Image@{Image}}
\subsubsection[{\texorpdfstring{Elm\+\_\+\+Image\+\_\+\+Progress}{Elm_Image_Progress}}]{\setlength{\rightskip}{0pt plus 5cm}typedef struct {\bf \+\_\+\+Elm\+\_\+\+Image\+\_\+\+Progress} {\bf Elm\+\_\+\+Image\+\_\+\+Progress}}\label{group__Image_ga37535cccf98fb95787e77daa4bc1d902}


Structure associated with smart callback \textquotesingle{}download,progress\textquotesingle{}. 

\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}


\subsection{Function Documentation}
\index{Image@{Image}!elm\+\_\+image\+\_\+add@{elm\+\_\+image\+\_\+add}}
\index{elm\+\_\+image\+\_\+add@{elm\+\_\+image\+\_\+add}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+add(\+Evas\+\_\+\+Object $\ast$parent)}{elm_image_add(Evas_Object *parent)}}]{\setlength{\rightskip}{0pt plus 5cm}Evas\+\_\+\+Object$\ast$ elm\+\_\+image\+\_\+add (
\begin{DoxyParamCaption}
\item[{Evas\+\_\+\+Object $\ast$}]{parent}
\end{DoxyParamCaption}
)}\label{group__Image_ga5d211c8af4f6e297a24fc4e8737c81a9}


Add a new image to the parent. 


\begin{DoxyParams}{Parameters}
{\em parent} & The parent object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The new object or N\+U\+LL if it cannot be created
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_gad1a96ede5f513042cef3c1dac4572f73}{elm\+\_\+image\+\_\+file\+\_\+set()} 
\end{DoxySeeAlso}
\index{Image@{Image}!elm\+\_\+image\+\_\+animated\+\_\+available\+\_\+get@{elm\+\_\+image\+\_\+animated\+\_\+available\+\_\+get}}
\index{elm\+\_\+image\+\_\+animated\+\_\+available\+\_\+get@{elm\+\_\+image\+\_\+animated\+\_\+available\+\_\+get}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+animated\+\_\+available\+\_\+get(const Evas\+\_\+\+Object $\ast$obj)}{elm_image_animated_available_get(const Evas_Object *obj)}}]{\setlength{\rightskip}{0pt plus 5cm}Eina\+\_\+\+Bool elm\+\_\+image\+\_\+animated\+\_\+available\+\_\+get (
\begin{DoxyParamCaption}
\item[{const Evas\+\_\+\+Object $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Image_ga1f61c469baddcaed97ab9846ea294594}


Get whether an image object supports animation or not. 

\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} if the image supports animation, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise.
\end{DoxyReturn}
This function returns if this Elementary image object\textquotesingle{}s internal image can be animated. Currently Evas only supports G\+IF animation. If the return value is {\bfseries E\+I\+N\+A\+\_\+\+F\+A\+L\+SE}, other {\ttfamily elm\+\_\+image\+\_\+animated\+\_\+xxx} A\+PI calls won\textquotesingle{}t work.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_gafb3915f863b15be7e5d41d80a6bf3a08}{elm\+\_\+image\+\_\+animated\+\_\+set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+7 
\end{DoxySince}


Referenced by elm\+\_\+icon\+\_\+animated\+\_\+available\+\_\+get().

\index{Image@{Image}!elm\+\_\+image\+\_\+animated\+\_\+get@{elm\+\_\+image\+\_\+animated\+\_\+get}}
\index{elm\+\_\+image\+\_\+animated\+\_\+get@{elm\+\_\+image\+\_\+animated\+\_\+get}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+animated\+\_\+get(const Evas\+\_\+\+Object $\ast$obj)}{elm_image_animated_get(const Evas_Object *obj)}}]{\setlength{\rightskip}{0pt plus 5cm}Eina\+\_\+\+Bool elm\+\_\+image\+\_\+animated\+\_\+get (
\begin{DoxyParamCaption}
\item[{const Evas\+\_\+\+Object $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Image_gaba9148979630af8ab6351ccfa7f6156a}


Get whether an image object has animation enabled or not. 

\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} if the image has animation enabled, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise.
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_gafb3915f863b15be7e5d41d80a6bf3a08}{elm\+\_\+image\+\_\+animated\+\_\+set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+7 
\end{DoxySince}


References elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+get(), and elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+set().



Referenced by elm\+\_\+icon\+\_\+animated\+\_\+get().

\index{Image@{Image}!elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+get@{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+get}}
\index{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+get@{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+get}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+get(const Evas\+\_\+\+Object $\ast$obj)}{elm_image_animated_play_get(const Evas_Object *obj)}}]{\setlength{\rightskip}{0pt plus 5cm}Eina\+\_\+\+Bool elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+get (
\begin{DoxyParamCaption}
\item[{const Evas\+\_\+\+Object $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Image_gafc3120f2ff8cc7403238783b8561bf55}


Get whether an image object is under animation or not. 

\begin{DoxyReturn}{Returns}
{\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE}, if the image is being animated, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise.
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_gafc3120f2ff8cc7403238783b8561bf55}{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+7 
\end{DoxySince}


Referenced by elm\+\_\+icon\+\_\+animated\+\_\+play\+\_\+get(), and elm\+\_\+image\+\_\+animated\+\_\+get().

\index{Image@{Image}!elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+set@{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+set}}
\index{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+set@{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+set}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+set(\+Evas\+\_\+\+Object $\ast$obj, Eina\+\_\+\+Bool play)}{elm_image_animated_play_set(Evas_Object *obj, Eina_Bool play)}}]{\setlength{\rightskip}{0pt plus 5cm}void elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+set (
\begin{DoxyParamCaption}
\item[{Evas\+\_\+\+Object $\ast$}]{obj, }
\item[{Eina\+\_\+\+Bool}]{play}
\end{DoxyParamCaption}
)}\label{group__Image_gac4d8f9a8c756e478c0b31bb1371dee46}


Start or stop an image object\textquotesingle{}s animation. 

To actually start playing any image object\textquotesingle{}s animation, if it supports it, one must do something like\+:


\begin{DoxyCode}
1 if (elm\_image\_animated\_available\_get(img))
2 \{
3 elm\_image\_animated\_set(img, EINA\_TRUE);
4 elm\_image\_animated\_play\_set(img, EINA\_TRUE);
5 \}
\end{DoxyCode}


\hyperlink{group__Image_gafb3915f863b15be7e5d41d80a6bf3a08}{elm\+\_\+image\+\_\+animated\+\_\+set()} will enable animation on the image, {\bfseries but not start it yet}. This is the function one uses to start and stop animations on image objects.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_ga1f61c469baddcaed97ab9846ea294594}{elm\+\_\+image\+\_\+animated\+\_\+available\+\_\+get()} 

\hyperlink{group__Image_gafb3915f863b15be7e5d41d80a6bf3a08}{elm\+\_\+image\+\_\+animated\+\_\+set()} 

\hyperlink{group__Image_gafc3120f2ff8cc7403238783b8561bf55}{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+get()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+7
\end{DoxySince}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em play} & {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} to start the animation, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise. Default is {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE}. \\
\hline
\end{DoxyParams}


Referenced by elm\+\_\+icon\+\_\+animated\+\_\+play\+\_\+set(), and elm\+\_\+image\+\_\+animated\+\_\+get().

\index{Image@{Image}!elm\+\_\+image\+\_\+animated\+\_\+set@{elm\+\_\+image\+\_\+animated\+\_\+set}}
\index{elm\+\_\+image\+\_\+animated\+\_\+set@{elm\+\_\+image\+\_\+animated\+\_\+set}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+animated\+\_\+set(\+Evas\+\_\+\+Object $\ast$obj, Eina\+\_\+\+Bool anim)}{elm_image_animated_set(Evas_Object *obj, Eina_Bool anim)}}]{\setlength{\rightskip}{0pt plus 5cm}void elm\+\_\+image\+\_\+animated\+\_\+set (
\begin{DoxyParamCaption}
\item[{Evas\+\_\+\+Object $\ast$}]{obj, }
\item[{Eina\+\_\+\+Bool}]{anim}
\end{DoxyParamCaption}
)}\label{group__Image_gafb3915f863b15be7e5d41d80a6bf3a08}


Set whether an image object (which supports animation) is to animate itself or not. 

An image object, even if it supports animation, will be displayed by default without animation. Call this function with {\itshape animated} set to {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} to enable its animation. To start or stop the animation, actually, use \hyperlink{group__Image_gac4d8f9a8c756e478c0b31bb1371dee46}{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+set()}.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_gaba9148979630af8ab6351ccfa7f6156a}{elm\+\_\+image\+\_\+animated\+\_\+get()} 

\hyperlink{group__Image_ga1f61c469baddcaed97ab9846ea294594}{elm\+\_\+image\+\_\+animated\+\_\+available\+\_\+get()} 

\hyperlink{group__Image_gac4d8f9a8c756e478c0b31bb1371dee46}{elm\+\_\+image\+\_\+animated\+\_\+play\+\_\+set()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+7
\end{DoxySince}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em anim} & {\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} if the object is to animate itself, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} otherwise. Default is {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE}. \\
\hline
\end{DoxyParams}


Referenced by elm\+\_\+icon\+\_\+animated\+\_\+set().

\index{Image@{Image}!elm\+\_\+image\+\_\+file\+\_\+get@{elm\+\_\+image\+\_\+file\+\_\+get}}
\index{elm\+\_\+image\+\_\+file\+\_\+get@{elm\+\_\+image\+\_\+file\+\_\+get}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+file\+\_\+get(const Eo $\ast$obj, const char $\ast$$\ast$file, const char $\ast$$\ast$group)}{elm_image_file_get(const Eo *obj, const char **file, const char **group)}}]{\setlength{\rightskip}{0pt plus 5cm}void elm\+\_\+image\+\_\+file\+\_\+get (
\begin{DoxyParamCaption}
\item[{const Eo $\ast$}]{obj, }
\item[{const char $\ast$$\ast$}]{file, }
\item[{const char $\ast$$\ast$}]{group}
\end{DoxyParamCaption}
)}\label{group__Image_ga2457a336d2123a8074725e814e459cba}


Get the file that will be used as image. 

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_gad1a96ede5f513042cef3c1dac4572f73}{elm\+\_\+image\+\_\+file\+\_\+set()}
\end{DoxySeeAlso}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em file} & The path to file that will be used as image source \\
\hline
\mbox{\tt out}  & {\em group} & The group that the image belongs to, in case it\textquotesingle{}s an E\+ET (including Edje case) file. This can be used as a key inside evas image cache if this is a normal image file not eet file. \\
\hline
\end{DoxyParams}


Referenced by elm\+\_\+icon\+\_\+file\+\_\+get().

\index{Image@{Image}!elm\+\_\+image\+\_\+file\+\_\+set@{elm\+\_\+image\+\_\+file\+\_\+set}}
\index{elm\+\_\+image\+\_\+file\+\_\+set@{elm\+\_\+image\+\_\+file\+\_\+set}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+file\+\_\+set(\+Evas\+\_\+\+Object $\ast$obj, const char $\ast$file, const char $\ast$group)}{elm_image_file_set(Evas_Object *obj, const char *file, const char *group)}}]{\setlength{\rightskip}{0pt plus 5cm}Eina\+\_\+\+Bool elm\+\_\+image\+\_\+file\+\_\+set (
\begin{DoxyParamCaption}
\item[{Evas\+\_\+\+Object $\ast$}]{obj, }
\item[{const char $\ast$}]{file, }
\item[{const char $\ast$}]{group}
\end{DoxyParamCaption}
)}\label{group__Image_gad1a96ede5f513042cef3c1dac4572f73}


Set the file that will be used as the image\textquotesingle{}s source. 


\begin{DoxyParams}{Parameters}
{\em obj} & The image object \\
\hline
{\em file} & The path to file that will be used as image source \\
\hline
{\em group} & The group that the image belongs to, in case it\textquotesingle{}s an E\+ET (including Edje case) file. This can be used as a key inside evas image cache if this is a normal image file not eet file.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
({\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} = success, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} = error)
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_ga2457a336d2123a8074725e814e459cba}{elm\+\_\+image\+\_\+file\+\_\+get()}
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
This function will trigger the Edje file case based on the extension of the {\itshape file} string (expects {\ttfamily \char`\"{}.\+edj\char`\"{}}, for this case).

If you use animated gif image and create multiple image objects with one gif image file, you should set the {\ttfamily group} differently for each object. Or image objects will share one evas image cache entry and you will get unwanted frames. 
\end{DoxyNote}


Referenced by elm\+\_\+hoversel\+\_\+add(), elm\+\_\+photo\+\_\+add(), elm\+\_\+toolbar\+\_\+add(), and elm\+\_\+transit\+\_\+effect\+\_\+rotation\+\_\+add().

\index{Image@{Image}!elm\+\_\+image\+\_\+mmap\+\_\+set@{elm\+\_\+image\+\_\+mmap\+\_\+set}}
\index{elm\+\_\+image\+\_\+mmap\+\_\+set@{elm\+\_\+image\+\_\+mmap\+\_\+set}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+mmap\+\_\+set(\+Evas\+\_\+\+Object $\ast$obj, const Eina\+\_\+\+File $\ast$file, const char $\ast$group)}{elm_image_mmap_set(Evas_Object *obj, const Eina_File *file, const char *group)}}]{\setlength{\rightskip}{0pt plus 5cm}Eina\+\_\+\+Bool elm\+\_\+image\+\_\+mmap\+\_\+set (
\begin{DoxyParamCaption}
\item[{Evas\+\_\+\+Object $\ast$}]{obj, }
\item[{const Eina\+\_\+\+File $\ast$}]{file, }
\item[{const char $\ast$}]{group}
\end{DoxyParamCaption}
)}\label{group__Image_gace214b3e6e6a8c95eb24f3e0d48be24b}


Set the file that will be used as the image\textquotesingle{}s source. 


\begin{DoxyParams}{Parameters}
{\em obj} & The image object \\
\hline
{\em file} & The handler to an Eina\+\_\+\+File that will be used as image source \\
\hline
{\em group} & The group that the image belongs to, in case it\textquotesingle{}s an E\+ET (including Edje case) file. This can be used as a key inside evas image cache if this is a normal image file not eet file.\\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
({\ttfamily E\+I\+N\+A\+\_\+\+T\+R\+UE} = success, {\ttfamily E\+I\+N\+A\+\_\+\+F\+A\+L\+SE} = error)
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_gad1a96ede5f513042cef3c1dac4572f73}{elm\+\_\+image\+\_\+file\+\_\+set()}
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
This function will trigger the Edje file case based on the extension of the {\itshape file} string use to create the Eina\+\_\+\+File (expects {\ttfamily \char`\"{}.\+edj\char`\"{}}, for this case).

If you use animated gif image and create multiple image objects with one gif image file, you should set the {\ttfamily group} differently for each object. Or image objects will share one evas image cache entry and you will get unwanted frames. 
\end{DoxyNote}
\index{Image@{Image}!elm\+\_\+image\+\_\+prescale\+\_\+get@{elm\+\_\+image\+\_\+prescale\+\_\+get}}
\index{elm\+\_\+image\+\_\+prescale\+\_\+get@{elm\+\_\+image\+\_\+prescale\+\_\+get}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+prescale\+\_\+get(const Evas\+\_\+\+Object $\ast$obj)}{elm_image_prescale_get(const Evas_Object *obj)}}]{\setlength{\rightskip}{0pt plus 5cm}int elm\+\_\+image\+\_\+prescale\+\_\+get (
\begin{DoxyParamCaption}
\item[{const Evas\+\_\+\+Object $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Image_ga1aeca8dbe2367d817492099887ca8f2d}


Get the prescale size for the image. 


\begin{DoxyParams}{Parameters}
{\em obj} & The image object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The prescale size
\end{DoxyReturn}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_gafb6dd2b235e25b2bd0b93d82e205a4f6}{elm\+\_\+image\+\_\+prescale\+\_\+set()} 
\end{DoxySeeAlso}


References elm\+\_\+drop\+\_\+target\+\_\+add(), elm\+\_\+drop\+\_\+target\+\_\+del(), and E\+L\+M\+\_\+\+S\+E\+L\+\_\+\+F\+O\+R\+M\+A\+T\+\_\+\+I\+M\+A\+GE.



Referenced by elm\+\_\+icon\+\_\+prescale\+\_\+get().

\index{Image@{Image}!elm\+\_\+image\+\_\+prescale\+\_\+set@{elm\+\_\+image\+\_\+prescale\+\_\+set}}
\index{elm\+\_\+image\+\_\+prescale\+\_\+set@{elm\+\_\+image\+\_\+prescale\+\_\+set}!Image@{Image}}
\subsubsection[{\texorpdfstring{elm\+\_\+image\+\_\+prescale\+\_\+set(\+Evas\+\_\+\+Object $\ast$obj, int size)}{elm_image_prescale_set(Evas_Object *obj, int size)}}]{\setlength{\rightskip}{0pt plus 5cm}void elm\+\_\+image\+\_\+prescale\+\_\+set (
\begin{DoxyParamCaption}
\item[{Evas\+\_\+\+Object $\ast$}]{obj, }
\item[{int}]{size}
\end{DoxyParamCaption}
)}\label{group__Image_gafb6dd2b235e25b2bd0b93d82e205a4f6}


Set the prescale size for the image. 


\begin{DoxyParams}{Parameters}
{\em obj} & The image object \\
\hline
{\em size} & The prescale size. This value is used for both width and height.\\
\hline
\end{DoxyParams}
This function sets a new size for pixmap representation of the given image. It allows the image to be loaded already in the specified size, reducing the memory usage and load time when loading a big image with load size set to a smaller size.

It\textquotesingle{}s equivalent to the elm\+\_\+bg\+\_\+load\+\_\+size\+\_\+set() function for bg.

\begin{DoxyNote}{Note}
this is just a hint, the real size of the pixmap may differ depending on the type of image being loaded, being bigger than requested.
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Image_ga1aeca8dbe2367d817492099887ca8f2d}{elm\+\_\+image\+\_\+prescale\+\_\+get()} 

elm\+\_\+bg\+\_\+load\+\_\+size\+\_\+set() 
\end{DoxySeeAlso}


Referenced by elm\+\_\+icon\+\_\+prescale\+\_\+set(), and elm\+\_\+photo\+\_\+add().

