\hypertarget{group__Evas__Object__Group__Basic}{\section{Basic Object Manipulation}
\label{group__Evas__Object__Group__Basic}\index{Basic Object Manipulation@{Basic Object Manipulation}}
}


Almost every evas object created will have some generic function used to manipulate it.  


\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
E\+O\+A\+P\+I void \hyperlink{group__Evas__Object__Group__Basic_ga0edb6cead08bdc24d0cd25455e361980}{evas\+\_\+obj\+\_\+color\+\_\+set} (int r, int g, int b, int a)
\begin{DoxyCompactList}\small\item\em Sets the general/main color of the given Evas object to the given one. \end{DoxyCompactList}\item 
E\+O\+A\+P\+I void \hyperlink{group__Evas__Object__Group__Basic_ga53862e480604541904228868df21fef2}{evas\+\_\+obj\+\_\+color\+\_\+get} (int $\ast$r, int $\ast$g, int $\ast$b, int $\ast$a)
\begin{DoxyCompactList}\small\item\em Retrieves the general/main color of the given Evas object. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Object__Group__Basic_gad7be2189e28b052aeab0b1fa3af2a81e}{evas\+::object\+::color\+\_\+get} (int $\ast$r\+\_\+, int $\ast$g\+\_\+, int $\ast$b\+\_\+, int $\ast$a\+\_\+) const 
\begin{DoxyCompactList}\small\item\em Retrieves the general/main color of the given Evas object. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Object__Group__Basic_ga905319061ef2d2cdd1d3d6cd65b58fa2}{evas\+::object\+::color\+\_\+set} (int r\+\_\+, int g\+\_\+, int b\+\_\+, int a\+\_\+) const 
\begin{DoxyCompactList}\small\item\em Sets the general/main color of the given Evas object to the given one. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Object__Group__Basic_gae34bdcfd7f5100151f6ea8ef4a392949}{evas\+\_\+object\+\_\+color\+\_\+set} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, int r, int g, int b, int a)
\begin{DoxyCompactList}\small\item\em Sets the general/main color of the given Evas object to the given one. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Object__Group__Basic_ga0854bae878bfc39f51b9c989353c973f}{evas\+\_\+object\+\_\+color\+\_\+get} (const \hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, int $\ast$r, int $\ast$g, int $\ast$b, int $\ast$a)
\begin{DoxyCompactList}\small\item\em Retrieves the general/main color of the given Evas object. \end{DoxyCompactList}\end{DoxyCompactItemize}
\begin{DoxyCompactItemize}
\item 
void \hyperlink{group__Evas__Font__Group_ga54122012bd545441802a25b77e213132}{evas\+\_\+object\+\_\+ref} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj)
\begin{DoxyCompactList}\small\item\em Increments object reference count to defer its deletion. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Font__Group_ga6fb7ee04976299de53a4a4a9c6c4052a}{evas\+\_\+object\+\_\+unref} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj)
\begin{DoxyCompactList}\small\item\em Decrements object reference count. \end{DoxyCompactList}\item 
int \hyperlink{group__Evas__Font__Group_ga04e91b9d93851c11186cde50876d419f}{evas\+\_\+object\+\_\+ref\+\_\+get} (const \hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get the object reference count. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Font__Group_ga7e7a625dab7a3890532aa13b43117076}{evas\+\_\+object\+\_\+del} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj)
\begin{DoxyCompactList}\small\item\em Marks the given Evas object for deletion (when Evas will free its memory). \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Font__Group_ga6f52fab1a96dc58c85ee481d84bac871}{evas\+\_\+object\+\_\+geometry\+\_\+get} (const \hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, \hyperlink{Evas__Common_8h_a2453e92182bad3b0e0d84e5aff433b07}{Evas\+\_\+\+Coord} $\ast$x, \hyperlink{Evas__Common_8h_a2453e92182bad3b0e0d84e5aff433b07}{Evas\+\_\+\+Coord} $\ast$y, \hyperlink{Evas__Common_8h_a2453e92182bad3b0e0d84e5aff433b07}{Evas\+\_\+\+Coord} $\ast$w, \hyperlink{Evas__Common_8h_a2453e92182bad3b0e0d84e5aff433b07}{Evas\+\_\+\+Coord} $\ast$h)
\begin{DoxyCompactList}\small\item\em Retrieves the position and (rectangular) size of the given Evas object. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Font__Group_ga842bddc5ddd6ccc78ecb4ef663123d78}{evas\+\_\+object\+\_\+geometry\+\_\+set} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj, \hyperlink{Evas__Common_8h_a2453e92182bad3b0e0d84e5aff433b07}{Evas\+\_\+\+Coord} x, \hyperlink{Evas__Common_8h_a2453e92182bad3b0e0d84e5aff433b07}{Evas\+\_\+\+Coord} y, \hyperlink{Evas__Common_8h_a2453e92182bad3b0e0d84e5aff433b07}{Evas\+\_\+\+Coord} w, \hyperlink{Evas__Common_8h_a2453e92182bad3b0e0d84e5aff433b07}{Evas\+\_\+\+Coord} h)
\begin{DoxyCompactList}\small\item\em Set the position and (rectangular) size of the given Evas object. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Font__Group_ga9cbc13661584e49fb9d9cdab514a1eeb}{evas\+\_\+object\+\_\+show} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj)
\begin{DoxyCompactList}\small\item\em Makes the given Evas object visible. \end{DoxyCompactList}\item 
void \hyperlink{group__Evas__Font__Group_gacc307a0d7bfc9df151fd9ec75808c587}{evas\+\_\+object\+\_\+hide} (\hyperlink{group__Evas__Object__Group_ga9e19e6dd1f517a0ba437c0114d3e7c97}{Evas\+\_\+\+Object} $\ast$obj)
\begin{DoxyCompactList}\small\item\em Makes the given Evas object invisible. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
Almost every evas object created will have some generic function used to manipulate it. 

That's because there are a number of basic actions to be done to objects that are irrespective of the object's type, things like\+: \begin{DoxyItemize}
\item Showing/\+Hiding \item Setting(and getting) geometry \item Bring up or down a layer \item Color management \item Handling focus \item Clipping \item Reference counting\end{DoxyItemize}
All of this issues are handled through the functions here grouped. Examples of these function can be seen in \hyperlink{Example_Evas_Object_Manipulation}{Evas objects basic manipulation example}(which deals with the most common ones) and in \hyperlink{Example_Evas_Stacking}{Evas object stacking functions (and some event handling)}(which deals with stacking functions). 

\subsection{Function Documentation}
\hypertarget{group__Evas__Object__Group__Basic_ga0edb6cead08bdc24d0cd25455e361980}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+obj\+\_\+color\+\_\+set@{evas\+\_\+obj\+\_\+color\+\_\+set}}
\index{evas\+\_\+obj\+\_\+color\+\_\+set@{evas\+\_\+obj\+\_\+color\+\_\+set}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+obj\+\_\+color\+\_\+set}]{\setlength{\rightskip}{0pt plus 5cm}E\+O\+A\+P\+I void evas\+\_\+obj\+\_\+color\+\_\+set (
\begin{DoxyParamCaption}
\item[{int}]{r, }
\item[{int}]{g, }
\item[{int}]{b, }
\item[{int}]{a}
\end{DoxyParamCaption}
)}}\label{group__Evas__Object__Group__Basic_ga0edb6cead08bdc24d0cd25455e361980}


Sets the general/main color of the given Evas object to the given one. 

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Object__Group__Basic_ga0854bae878bfc39f51b9c989353c973f}{evas\+\_\+object\+\_\+color\+\_\+get()} (for an example) 
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
These color values are expected to be premultiplied by {\ttfamily a}.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em r} & The red component of the given color. \\
\hline
\mbox{\tt in}  & {\em g} & The green component of the given color. \\
\hline
\mbox{\tt in}  & {\em b} & The blue component of the given color. \\
\hline
\mbox{\tt in}  & {\em a} & The alpha component of the given color. \\
\hline
\end{DoxyParams}


Referenced by evas\+::object\+::color\+\_\+set(), and evas\+\_\+object\+\_\+color\+\_\+set().

\hypertarget{group__Evas__Object__Group__Basic_ga53862e480604541904228868df21fef2}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+obj\+\_\+color\+\_\+get@{evas\+\_\+obj\+\_\+color\+\_\+get}}
\index{evas\+\_\+obj\+\_\+color\+\_\+get@{evas\+\_\+obj\+\_\+color\+\_\+get}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+obj\+\_\+color\+\_\+get}]{\setlength{\rightskip}{0pt plus 5cm}E\+O\+A\+P\+I void evas\+\_\+obj\+\_\+color\+\_\+get (
\begin{DoxyParamCaption}
\item[{int $\ast$}]{r, }
\item[{int $\ast$}]{g, }
\item[{int $\ast$}]{b, }
\item[{int $\ast$}]{a}
\end{DoxyParamCaption}
)}}\label{group__Evas__Object__Group__Basic_ga53862e480604541904228868df21fef2}


Retrieves the general/main color of the given Evas object. 

Retrieves the “main” color's R\+G\+B component (and alpha channel) values, {\bfseries which range from 0 to 255}. For the alpha channel, which defines the object's transparency level, 0 means totally transparent, while 255 means opaque. These color values are premultiplied by the alpha value.

Usually you’ll use this attribute for text and rectangle objects, where the “main” color is their unique one. If set for objects which themselves have colors, like the images one, those colors get modulated by this one.

\begin{DoxyNote}{Note}
All newly created Evas rectangles get the default color values of {\ttfamily 255 255 255 255} (opaque white).

Use {\ttfamily N\+U\+L\+L} pointers on the components you're not interested in\+: they'll be ignored by the function.
\end{DoxyNote}
Example\+:  
\begin{DoxyCodeInclude}
1         int alpha, r, g, b;
2 
3         evas\_object\_color\_get(d.clipper, &r, &g, &b, &alpha);
4         evas\_color\_argb\_unpremul(alpha, &r, &g, &b);
5 
6         alpha -= 20;
7         if (alpha < 0)
8           alpha = 255;
9 
10         evas\_color\_argb\_premul(alpha, &r, &g, &b);
11         evas\_object\_color\_set(d.clipper, r, g, b, alpha);
12 
13         fprintf(stdout, "Changing clipper's opacity: %d%%\(\backslash\)n",
14                 (int)((alpha / 255.0) * 100));
15         return;

\end{DoxyCodeInclude}


See the full \hyperlink{Example_Evas_Object_Manipulation}{example}.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em r} & The red component of the given color. \\
\hline
\mbox{\tt out}  & {\em g} & The green component of the given color. \\
\hline
\mbox{\tt out}  & {\em b} & The blue component of the given color. \\
\hline
\mbox{\tt out}  & {\em a} & The alpha component of the given color. \\
\hline
\end{DoxyParams}


Referenced by evas\+::object\+::color\+\_\+get(), and evas\+\_\+object\+\_\+color\+\_\+get().

\hypertarget{group__Evas__Object__Group__Basic_gad7be2189e28b052aeab0b1fa3af2a81e}{\index{Basic Object Manipulation@{Basic Object Manipulation}!color\+\_\+get@{color\+\_\+get}}
\index{color\+\_\+get@{color\+\_\+get}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{color\+\_\+get}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+::object\+::color\+\_\+get (
\begin{DoxyParamCaption}
\item[{int $\ast$}]{r\+\_\+, }
\item[{int $\ast$}]{g\+\_\+, }
\item[{int $\ast$}]{b\+\_\+, }
\item[{int $\ast$}]{a\+\_\+}
\end{DoxyParamCaption}
) const\hspace{0.3cm}{\ttfamily [inline]}}}\label{group__Evas__Object__Group__Basic_gad7be2189e28b052aeab0b1fa3af2a81e}


Retrieves the general/main color of the given Evas object. 

Retrieves the “main” color's R\+G\+B component (and alpha channel) values, {\bfseries which range from 0 to 255}. For the alpha channel, which defines the object's transparency level, 0 means totally transparent, while 255 means opaque. These color values are premultiplied by the alpha value.

Usually you’ll use this attribute for text and rectangle objects, where the “main” color is their unique one. If set for objects which themselves have colors, like the images one, those colors get modulated by this one.

\begin{DoxyNote}{Note}
All newly created Evas rectangles get the default color values of {\ttfamily 255 255 255 255} (opaque white).

Use {\ttfamily N\+U\+L\+L} pointers on the components you're not interested in\+: they'll be ignored by the function.
\end{DoxyNote}
Example\+:  
\begin{DoxyCodeInclude}
        \textcolor{keywordtype}{int} alpha, r, g, b;

        \hyperlink{group__Evas__Object__Group__Basic_ga0854bae878bfc39f51b9c989353c973f}{evas\_object\_color\_get}(d.clipper, &r, &g, &b, &alpha);
        \hyperlink{group__Evas__Utils_ga862abed1097a429dd439fbe08813cd9d}{evas\_color\_argb\_unpremul}(alpha, &r, &g, &b);

        alpha -= 20;
        \textcolor{keywordflow}{if} (alpha < 0)
          alpha = 255;

        \hyperlink{group__Evas__Utils_gac02bf3973675ae7591b9f34deef1554f}{evas\_color\_argb\_premul}(alpha, &r, &g, &b);
        \hyperlink{group__Evas__Object__Group__Basic_gae34bdcfd7f5100151f6ea8ef4a392949}{evas\_object\_color\_set}(d.clipper, r, g, b, alpha);

        fprintf(stdout, \textcolor{stringliteral}{"Changing clipper's opacity: %d%%\(\backslash\)n"},
                (\textcolor{keywordtype}{int})((alpha / 255.0) * 100));
        \textcolor{keywordflow}{return};

\end{DoxyCodeInclude}


See the full \hyperlink{Example_Evas_Object_Manipulation}{example}.


\begin{DoxyParams}{Parameters}
{\em r} & The red component of the given color. \\
\hline
{\em g} & The green component of the given color. \\
\hline
{\em b} & The blue component of the given color. \\
\hline
{\em a} & The alpha component of the given color. \\
\hline
\end{DoxyParams}


References efl\+::eo\+::base\+::\+\_\+eo\+\_\+ptr(), and evas\+\_\+obj\+\_\+color\+\_\+get().

\hypertarget{group__Evas__Object__Group__Basic_ga905319061ef2d2cdd1d3d6cd65b58fa2}{\index{Basic Object Manipulation@{Basic Object Manipulation}!color\+\_\+set@{color\+\_\+set}}
\index{color\+\_\+set@{color\+\_\+set}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{color\+\_\+set}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+::object\+::color\+\_\+set (
\begin{DoxyParamCaption}
\item[{int}]{r\+\_\+, }
\item[{int}]{g\+\_\+, }
\item[{int}]{b\+\_\+, }
\item[{int}]{a\+\_\+}
\end{DoxyParamCaption}
) const\hspace{0.3cm}{\ttfamily [inline]}}}\label{group__Evas__Object__Group__Basic_ga905319061ef2d2cdd1d3d6cd65b58fa2}


Sets the general/main color of the given Evas object to the given one. 

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Object__Group__Basic_ga0854bae878bfc39f51b9c989353c973f}{evas\+\_\+object\+\_\+color\+\_\+get()} (for an example) 
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
These color values are expected to be premultiplied by {\ttfamily a}.
\end{DoxyNote}

\begin{DoxyParams}{Parameters}
{\em r} & The red component of the given color. \\
\hline
{\em g} & The green component of the given color. \\
\hline
{\em b} & The blue component of the given color. \\
\hline
{\em a} & The alpha component of the given color. \\
\hline
\end{DoxyParams}


References efl\+::eo\+::base\+::\+\_\+eo\+\_\+ptr(), and evas\+\_\+obj\+\_\+color\+\_\+set().

\hypertarget{group__Evas__Object__Group__Basic_gae34bdcfd7f5100151f6ea8ef4a392949}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+object\+\_\+color\+\_\+set@{evas\+\_\+object\+\_\+color\+\_\+set}}
\index{evas\+\_\+object\+\_\+color\+\_\+set@{evas\+\_\+object\+\_\+color\+\_\+set}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+object\+\_\+color\+\_\+set}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+color\+\_\+set (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{int}]{r, }
\item[{int}]{g, }
\item[{int}]{b, }
\item[{int}]{a}
\end{DoxyParamCaption}
)}}\label{group__Evas__Object__Group__Basic_gae34bdcfd7f5100151f6ea8ef4a392949}


Sets the general/main color of the given Evas object to the given one. 

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Object__Group__Basic_ga0854bae878bfc39f51b9c989353c973f}{evas\+\_\+object\+\_\+color\+\_\+get()} (for an example) 
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
These color values are expected to be premultiplied by {\ttfamily a}.
\end{DoxyNote}

\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em r} & The red component of the given color. \\
\hline
\mbox{\tt in}  & {\em g} & The green component of the given color. \\
\hline
\mbox{\tt in}  & {\em b} & The blue component of the given color. \\
\hline
\mbox{\tt in}  & {\em a} & The alpha component of the given color. \\
\hline
\end{DoxyParams}


References evas\+\_\+obj\+\_\+color\+\_\+set().



Referenced by ecore\+\_\+evas\+\_\+ews\+\_\+background\+\_\+set(), and emotion\+\_\+object\+\_\+bg\+\_\+color\+\_\+set().

\hypertarget{group__Evas__Object__Group__Basic_ga0854bae878bfc39f51b9c989353c973f}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+object\+\_\+color\+\_\+get@{evas\+\_\+object\+\_\+color\+\_\+get}}
\index{evas\+\_\+object\+\_\+color\+\_\+get@{evas\+\_\+object\+\_\+color\+\_\+get}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+object\+\_\+color\+\_\+get}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+color\+\_\+get (
\begin{DoxyParamCaption}
\item[{const {\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{int $\ast$}]{r, }
\item[{int $\ast$}]{g, }
\item[{int $\ast$}]{b, }
\item[{int $\ast$}]{a}
\end{DoxyParamCaption}
)}}\label{group__Evas__Object__Group__Basic_ga0854bae878bfc39f51b9c989353c973f}


Retrieves the general/main color of the given Evas object. 

Retrieves the “main” color's R\+G\+B component (and alpha channel) values, {\bfseries which range from 0 to 255}. For the alpha channel, which defines the object's transparency level, 0 means totally transparent, while 255 means opaque. These color values are premultiplied by the alpha value.

Usually you’ll use this attribute for text and rectangle objects, where the “main” color is their unique one. If set for objects which themselves have colors, like the images one, those colors get modulated by this one.

\begin{DoxyNote}{Note}
All newly created Evas rectangles get the default color values of {\ttfamily 255 255 255 255} (opaque white).

Use {\ttfamily N\+U\+L\+L} pointers on the components you're not interested in\+: they'll be ignored by the function.
\end{DoxyNote}
Example\+:  
\begin{DoxyCodeInclude}
1         int alpha, r, g, b;
2 
3         evas\_object\_color\_get(d.clipper, &r, &g, &b, &alpha);
4         evas\_color\_argb\_unpremul(alpha, &r, &g, &b);
5 
6         alpha -= 20;
7         if (alpha < 0)
8           alpha = 255;
9 
10         evas\_color\_argb\_premul(alpha, &r, &g, &b);
11         evas\_object\_color\_set(d.clipper, r, g, b, alpha);
12 
13         fprintf(stdout, "Changing clipper's opacity: %d%%\(\backslash\)n",
14                 (int)((alpha / 255.0) * 100));
15         return;

\end{DoxyCodeInclude}


See the full \hyperlink{Example_Evas_Object_Manipulation}{example}.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em r} & The red component of the given color. \\
\hline
\mbox{\tt out}  & {\em g} & The green component of the given color. \\
\hline
\mbox{\tt out}  & {\em b} & The blue component of the given color. \\
\hline
\mbox{\tt out}  & {\em a} & The alpha component of the given color. \\
\hline
\end{DoxyParams}


References evas\+\_\+obj\+\_\+color\+\_\+get().



Referenced by emotion\+\_\+object\+\_\+bg\+\_\+color\+\_\+get().

\hypertarget{group__Evas__Font__Group_ga54122012bd545441802a25b77e213132}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+object\+\_\+ref@{evas\+\_\+object\+\_\+ref}}
\index{evas\+\_\+object\+\_\+ref@{evas\+\_\+object\+\_\+ref}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+object\+\_\+ref}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+ref (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj}
\end{DoxyParamCaption}
)}}\label{group__Evas__Font__Group_ga54122012bd545441802a25b77e213132}


Increments object reference count to defer its deletion. 


\begin{DoxyParams}{Parameters}
{\em obj} & The given Evas object to reference\\
\hline
\end{DoxyParams}
This increments the reference count of an object, which if greater than 0 will defer deletion by \hyperlink{group__Evas__Font__Group_ga7e7a625dab7a3890532aa13b43117076}{evas\+\_\+object\+\_\+del()} until all references are released back (counter back to 0). References cannot go below 0 and unreferencing past that will result in the reference count being limited to 0. References are limited to {\ttfamily 2$^\wedge$32 -\/ 1} for an object. Referencing it more than this will result in it being limited to this value.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Font__Group_ga6fb7ee04976299de53a4a4a9c6c4052a}{evas\+\_\+object\+\_\+unref()} 

\hyperlink{group__Evas__Font__Group_ga7e7a625dab7a3890532aa13b43117076}{evas\+\_\+object\+\_\+del()}
\end{DoxySeeAlso}
\begin{DoxyNote}{Note}
This is a {\bfseries very simple} reference counting mechanism! For instance, Evas is not ready to check for pending references on a canvas deletion, or things like that. This is useful on scenarios where, inside a code block, callbacks exist which would possibly delete an object we are operating on afterwards. Then, one would \hyperlink{group__Evas__Font__Group_ga54122012bd545441802a25b77e213132}{evas\+\_\+object\+\_\+ref()} it on the beginning of the block and \hyperlink{group__Evas__Font__Group_ga6fb7ee04976299de53a4a4a9c6c4052a}{evas\+\_\+object\+\_\+unref()} it on the end. It would then be deleted at this point, if it should be.
\end{DoxyNote}
Example\+: 
\begin{DoxyCode}
1 evas\_object\_ref(obj);
2 
3 // action here...
4 evas\_object\_smart\_callback\_call(obj, SIG\_SELECTED, NULL);
5 // more action here...
6 evas\_object\_unref(obj);
\end{DoxyCode}


\begin{DoxySince}{Since}
1.\+1 
\end{DoxySince}
\hypertarget{group__Evas__Font__Group_ga6fb7ee04976299de53a4a4a9c6c4052a}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+object\+\_\+unref@{evas\+\_\+object\+\_\+unref}}
\index{evas\+\_\+object\+\_\+unref@{evas\+\_\+object\+\_\+unref}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+object\+\_\+unref}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+unref (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj}
\end{DoxyParamCaption}
)}}\label{group__Evas__Font__Group_ga6fb7ee04976299de53a4a4a9c6c4052a}


Decrements object reference count. 


\begin{DoxyParams}{Parameters}
{\em obj} & The given Evas object to unreference\\
\hline
\end{DoxyParams}
This decrements the reference count of an object. If the object has had \hyperlink{group__Evas__Font__Group_ga7e7a625dab7a3890532aa13b43117076}{evas\+\_\+object\+\_\+del()} called on it while references were more than 0, it will be deleted at the time this function is called and puts the counter back to 0. See \hyperlink{group__Evas__Font__Group_ga54122012bd545441802a25b77e213132}{evas\+\_\+object\+\_\+ref()} for more information.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Font__Group_ga54122012bd545441802a25b77e213132}{evas\+\_\+object\+\_\+ref()} (for an example) 

\hyperlink{group__Evas__Font__Group_ga7e7a625dab7a3890532aa13b43117076}{evas\+\_\+object\+\_\+del()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+1 
\end{DoxySince}


References evas\+\_\+object\+\_\+del().

\hypertarget{group__Evas__Font__Group_ga04e91b9d93851c11186cde50876d419f}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+object\+\_\+ref\+\_\+get@{evas\+\_\+object\+\_\+ref\+\_\+get}}
\index{evas\+\_\+object\+\_\+ref\+\_\+get@{evas\+\_\+object\+\_\+ref\+\_\+get}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+object\+\_\+ref\+\_\+get}]{\setlength{\rightskip}{0pt plus 5cm}int evas\+\_\+object\+\_\+ref\+\_\+get (
\begin{DoxyParamCaption}
\item[{const {\bf Evas\+\_\+\+Object} $\ast$}]{obj}
\end{DoxyParamCaption}
)}}\label{group__Evas__Font__Group_ga04e91b9d93851c11186cde50876d419f}


Get the object reference count. 


\begin{DoxyParams}{Parameters}
{\em obj} & The given Evas object to query\\
\hline
\end{DoxyParams}
This gets the reference count for an object (normally 0 until it is referenced). Values of 1 or greater mean that someone is holding a reference to this object that needs to be unreffed before it can be deleted.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Font__Group_ga54122012bd545441802a25b77e213132}{evas\+\_\+object\+\_\+ref()} 

\hyperlink{group__Evas__Font__Group_ga6fb7ee04976299de53a4a4a9c6c4052a}{evas\+\_\+object\+\_\+unref()} 

\hyperlink{group__Evas__Font__Group_ga7e7a625dab7a3890532aa13b43117076}{evas\+\_\+object\+\_\+del()}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+2 
\end{DoxySince}
\hypertarget{group__Evas__Font__Group_ga7e7a625dab7a3890532aa13b43117076}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+object\+\_\+del@{evas\+\_\+object\+\_\+del}}
\index{evas\+\_\+object\+\_\+del@{evas\+\_\+object\+\_\+del}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+object\+\_\+del}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+del (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj}
\end{DoxyParamCaption}
)}}\label{group__Evas__Font__Group_ga7e7a625dab7a3890532aa13b43117076}


Marks the given Evas object for deletion (when Evas will free its memory). 


\begin{DoxyParams}{Parameters}
{\em obj} & The given Evas object.\\
\hline
\end{DoxyParams}
This call will mark {\ttfamily obj} for deletion, which will take place whenever it has no more references to it (see \hyperlink{group__Evas__Font__Group_ga54122012bd545441802a25b77e213132}{evas\+\_\+object\+\_\+ref()} and \hyperlink{group__Evas__Font__Group_ga6fb7ee04976299de53a4a4a9c6c4052a}{evas\+\_\+object\+\_\+unref()}).

At actual deletion time, which may or may not be just after this call, \hyperlink{Evas__Common_8h_a99e208e463a20499aabe6faac8a8cb8aa4471afbcbb4a754b7b0bbde00fb9a277}{E\+V\+A\+S\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+D\+E\+L} and \hyperlink{Evas__Common_8h_a99e208e463a20499aabe6faac8a8cb8aaab869b5d534f02f1b3e151e2406a8c24}{E\+V\+A\+S\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+F\+R\+E\+E} callbacks will be called. If the object currently had the focus, its \hyperlink{Evas__Common_8h_a99e208e463a20499aabe6faac8a8cb8aab26a0af7efaa8b77e996bd438accf8d3}{E\+V\+A\+S\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+F\+O\+C\+U\+S\+\_\+\+O\+U\+T} callback will also be called.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Font__Group_ga54122012bd545441802a25b77e213132}{evas\+\_\+object\+\_\+ref()} 

\hyperlink{group__Evas__Font__Group_ga6fb7ee04976299de53a4a4a9c6c4052a}{evas\+\_\+object\+\_\+unref()} 
\end{DoxySeeAlso}


References E\+I\+N\+A\+\_\+\+T\+R\+U\+E.



Referenced by ecore\+\_\+evas\+\_\+ews\+\_\+background\+\_\+set(), edje\+\_\+edit\+\_\+part\+\_\+source\+\_\+set(), edje\+\_\+perspective\+\_\+free(), ethumb\+\_\+free(), and evas\+\_\+object\+\_\+unref().

\hypertarget{group__Evas__Font__Group_ga6f52fab1a96dc58c85ee481d84bac871}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+object\+\_\+geometry\+\_\+get@{evas\+\_\+object\+\_\+geometry\+\_\+get}}
\index{evas\+\_\+object\+\_\+geometry\+\_\+get@{evas\+\_\+object\+\_\+geometry\+\_\+get}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+object\+\_\+geometry\+\_\+get}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+geometry\+\_\+get (
\begin{DoxyParamCaption}
\item[{const {\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{{\bf Evas\+\_\+\+Coord} $\ast$}]{x, }
\item[{{\bf Evas\+\_\+\+Coord} $\ast$}]{y, }
\item[{{\bf Evas\+\_\+\+Coord} $\ast$}]{w, }
\item[{{\bf Evas\+\_\+\+Coord} $\ast$}]{h}
\end{DoxyParamCaption}
)}}\label{group__Evas__Font__Group_ga6f52fab1a96dc58c85ee481d84bac871}


Retrieves the position and (rectangular) size of the given Evas object. 


\begin{DoxyParams}{Parameters}
{\em obj} & The given Evas object. \\
\hline
{\em x} & Pointer to an integer in which to store the X coordinate of the object. \\
\hline
{\em y} & Pointer to an integer in which to store the Y coordinate of the object. \\
\hline
{\em w} & Pointer to an integer in which to store the width of the object. \\
\hline
{\em h} & Pointer to an integer in which to store the height of the object.\\
\hline
\end{DoxyParams}
The position, naturally, will be relative to the top left corner of the canvas' viewport.

\begin{DoxyNote}{Note}
Use {\ttfamily N\+U\+L\+L} pointers on the geometry components you're not interested in\+: they'll be ignored by the function.
\end{DoxyNote}
Example\+:  
\begin{DoxyCodeInclude}
1    int w, h, cw, ch;
2 
3    evas\_object\_geometry\_get(d.img, NULL, NULL, &w, &h);
4    ecore\_evas\_geometry\_get(d.ee, NULL, NULL, &cw, &ch);
5 
6    if (w < cw)
7      evas\_object\_resize(d.img, cw, ch);
8    else
9      evas\_object\_resize(d.img, cw / 2, ch / 2);
10 
11    return EINA\_TRUE; /* re-issue the timer */

\end{DoxyCodeInclude}


See the full \hyperlink{Example_Evas_Events}{example}. 

Referenced by emotion\+\_\+object\+\_\+border\+\_\+set(), and emotion\+\_\+object\+\_\+keep\+\_\+aspect\+\_\+set().

\hypertarget{group__Evas__Font__Group_ga842bddc5ddd6ccc78ecb4ef663123d78}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+object\+\_\+geometry\+\_\+set@{evas\+\_\+object\+\_\+geometry\+\_\+set}}
\index{evas\+\_\+object\+\_\+geometry\+\_\+set@{evas\+\_\+object\+\_\+geometry\+\_\+set}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+object\+\_\+geometry\+\_\+set}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+geometry\+\_\+set (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj, }
\item[{{\bf Evas\+\_\+\+Coord}}]{x, }
\item[{{\bf Evas\+\_\+\+Coord}}]{y, }
\item[{{\bf Evas\+\_\+\+Coord}}]{w, }
\item[{{\bf Evas\+\_\+\+Coord}}]{h}
\end{DoxyParamCaption}
)}}\label{group__Evas__Font__Group_ga842bddc5ddd6ccc78ecb4ef663123d78}


Set the position and (rectangular) size of the given Evas object. 


\begin{DoxyParams}{Parameters}
{\em obj} & The given Evas object. \\
\hline
{\em x} & X position to move the object to, in canvas units. \\
\hline
{\em y} & Y position to move the object to, in canvas units. \\
\hline
{\em w} & The new width of the Evas object. \\
\hline
{\em h} & The new height of the Evas object.\\
\hline
\end{DoxyParams}
The position, naturally, will be relative to the top left corner of the canvas' viewport.

If the object get moved, the object's \hyperlink{Evas__Common_8h_a99e208e463a20499aabe6faac8a8cb8aa9b66bd091da76fb13f551c6db04502b0}{E\+V\+A\+S\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+M\+O\+V\+E} callback will be called.

If the object get resized, the object's \hyperlink{Evas__Common_8h_a99e208e463a20499aabe6faac8a8cb8aa554e3341a4ae95e15d42da495f8adb21}{E\+V\+A\+S\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+R\+E\+S\+I\+Z\+E} callback will be called.

\begin{DoxySeeAlso}{See also}
evas\+\_\+object\+\_\+move() 

evas\+\_\+object\+\_\+resize() 

\hyperlink{group__Evas__Font__Group_ga6f52fab1a96dc58c85ee481d84bac871}{evas\+\_\+object\+\_\+geometry\+\_\+get}
\end{DoxySeeAlso}
\begin{DoxySince}{Since}
1.\+8 
\end{DoxySince}
\hypertarget{group__Evas__Font__Group_ga9cbc13661584e49fb9d9cdab514a1eeb}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+object\+\_\+show@{evas\+\_\+object\+\_\+show}}
\index{evas\+\_\+object\+\_\+show@{evas\+\_\+object\+\_\+show}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+object\+\_\+show}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+show (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj}
\end{DoxyParamCaption}
)}}\label{group__Evas__Font__Group_ga9cbc13661584e49fb9d9cdab514a1eeb}


Makes the given Evas object visible. 


\begin{DoxyParams}{Parameters}
{\em obj} & The given Evas object.\\
\hline
\end{DoxyParams}
Besides becoming visible, the object's \hyperlink{Evas__Common_8h_a99e208e463a20499aabe6faac8a8cb8aab433c293bd272670ac3b5e8b1928a540}{E\+V\+A\+S\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+S\+H\+O\+W} callback will be called.

\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Font__Group_gacc307a0d7bfc9df151fd9ec75808c587}{evas\+\_\+object\+\_\+hide()} for more on object visibility. 

evas\+\_\+object\+\_\+visible\+\_\+get() 
\end{DoxySeeAlso}


References E\+I\+N\+A\+\_\+\+T\+R\+U\+E.



Referenced by ecore\+\_\+evas\+\_\+ews\+\_\+background\+\_\+set(), and emotion\+\_\+object\+\_\+bg\+\_\+color\+\_\+set().

\hypertarget{group__Evas__Font__Group_gacc307a0d7bfc9df151fd9ec75808c587}{\index{Basic Object Manipulation@{Basic Object Manipulation}!evas\+\_\+object\+\_\+hide@{evas\+\_\+object\+\_\+hide}}
\index{evas\+\_\+object\+\_\+hide@{evas\+\_\+object\+\_\+hide}!Basic Object Manipulation@{Basic Object Manipulation}}
\subsubsection[{evas\+\_\+object\+\_\+hide}]{\setlength{\rightskip}{0pt plus 5cm}void evas\+\_\+object\+\_\+hide (
\begin{DoxyParamCaption}
\item[{{\bf Evas\+\_\+\+Object} $\ast$}]{obj}
\end{DoxyParamCaption}
)}}\label{group__Evas__Font__Group_gacc307a0d7bfc9df151fd9ec75808c587}


Makes the given Evas object invisible. 


\begin{DoxyParams}{Parameters}
{\em obj} & The given Evas object.\\
\hline
\end{DoxyParams}
Hidden objects, besides not being shown at all in your canvas, won't be checked for changes on the canvas rendering process. Furthermore, they will not catch input events. Thus, they are much ligher (in processing needs) than an object that is invisible due to indirect causes, such as being clipped or out of the canvas' viewport.

Besides becoming hidden, {\ttfamily obj} object's \hyperlink{Evas__Common_8h_a99e208e463a20499aabe6faac8a8cb8aab433c293bd272670ac3b5e8b1928a540}{E\+V\+A\+S\+\_\+\+C\+A\+L\+L\+B\+A\+C\+K\+\_\+\+S\+H\+O\+W} callback will be called.

\begin{DoxyNote}{Note}
All objects are created in the hidden state! If you want them shown, use \hyperlink{group__Evas__Font__Group_ga9cbc13661584e49fb9d9cdab514a1eeb}{evas\+\_\+object\+\_\+show()} after their creation.
\end{DoxyNote}
\begin{DoxySeeAlso}{See also}
\hyperlink{group__Evas__Font__Group_ga9cbc13661584e49fb9d9cdab514a1eeb}{evas\+\_\+object\+\_\+show()} 

evas\+\_\+object\+\_\+visible\+\_\+get()
\end{DoxySeeAlso}
Example\+:  
\begin{DoxyCodeInclude}
1         if (evas\_object\_visible\_get(d.clipper))
2           \{
3              evas\_object\_hide(d.clipper);
4              fprintf(stdout, "hidden\(\backslash\)n");
5           \}
6         else
7           \{
8              evas\_object\_show(d.clipper);
9              fprintf(stdout, "visible\(\backslash\)n");
10           \}
11         return;

\end{DoxyCodeInclude}


See the full \hyperlink{Example_Evas_Object_Manipulation}{example}. 

References E\+I\+N\+A\+\_\+\+F\+A\+L\+S\+E.



Referenced by ecore\+\_\+evas\+\_\+cursor\+\_\+unset(), edje\+\_\+edit\+\_\+part\+\_\+del(), and emotion\+\_\+object\+\_\+bg\+\_\+color\+\_\+set().

