\section{Plug}
\label{group__Plug}\index{Plug@{Plug}}
\subsection*{Macros}
\begin{DoxyCompactItemize}
\item 
\#define \hyperlink{group__Plug_ga17ceb03bbe548be1c441fe3550f6f871}{elm\-\_\-obj\-\_\-plug\-\_\-image\-\_\-object\-\_\-get}(ret)~E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-P\-L\-U\-G\-\_\-\-I\-D(E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-P\-L\-U\-G\-\_\-\-S\-U\-B\-\_\-\-I\-D\-\_\-\-I\-M\-A\-G\-E\-\_\-\-O\-B\-J\-E\-C\-T\-\_\-\-G\-E\-T), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(Evas\-\_\-\-Object $\ast$$\ast$, ret)
\item 
\#define \hyperlink{group__Plug_ga6c9e1bb6789ca54cce0304a03c115784}{elm\-\_\-obj\-\_\-plug\-\_\-connect}(svcname, svcnum, svcsys, ret)~E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-P\-L\-U\-G\-\_\-\-I\-D(E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-P\-L\-U\-G\-\_\-\-S\-U\-B\-\_\-\-I\-D\-\_\-\-C\-O\-N\-N\-E\-C\-T), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(const char $\ast$, svcname), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(int, svcnum), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(Eina\-\_\-\-Bool, svcsys), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(Eina\-\_\-\-Bool $\ast$, ret)
\end{DoxyCompactItemize}
\subsection*{Functions}
\begin{DoxyCompactItemize}
\item 
Evas\-\_\-\-Object $\ast$ \hyperlink{group__Plug_gae3b978f52c632e5b0df1fc6e446beee4}{elm\-\_\-plug\-\_\-add} (Evas\-\_\-\-Object $\ast$parent)
\begin{DoxyCompactList}\small\item\em Add a new plug image to the parent. \end{DoxyCompactList}\item 
Evas\-\_\-\-Object $\ast$ \hyperlink{group__Plug_ga0f393fcbb3ab1b8aa28061b48a3e1287}{elm\-\_\-plug\-\_\-image\-\_\-object\-\_\-get} (const Evas\-\_\-\-Object $\ast$obj)
\begin{DoxyCompactList}\small\item\em Get the basic Evas\-\_\-\-Image object from this object (widget). \end{DoxyCompactList}\item 
Eina\-\_\-\-Bool \hyperlink{group__Plug_gaa16941ac6d8c28387b6424fc7dc057fa}{elm\-\_\-plug\-\_\-connect} (Evas\-\_\-\-Object $\ast$obj, const char $\ast$svcname, int svcnum, Eina\-\_\-\-Bool svcsys)
\begin{DoxyCompactList}\small\item\em Connect a plug widget to service provided by socket image. \end{DoxyCompactList}\end{DoxyCompactItemize}


\subsection{Detailed Description}
 
\begin{DoxyImageNoCaption}
  \mbox{\includegraphics{plug_inheritance_tree}}
\end{DoxyImageNoCaption}


An object that allows one to show an image which other process created. It can be used anywhere like any other elementary widget.

This widget emits the following signals\-: \begin{DoxyItemize}
\item \char`\"{}clicked\char`\"{}\-: the user clicked the image (press/release). The {\ttfamily event} parameter of the callback will be {\ttfamily N\-U\-L\-L}. \item \char`\"{}image,deleted\char`\"{}\-: the server side was deleted. The {\ttfamily event} parameter of the callback will be {\ttfamily N\-U\-L\-L}. \item \char`\"{}image,resized\char`\"{}\-: the server side was resized. The {\ttfamily event} parameter of the callback will be {\ttfamily Evas\-\_\-\-Coord\-\_\-\-Size} (two integers).\end{DoxyItemize}
\begin{DoxyNote}{Note}
the event \char`\"{}image,resized\char`\"{} will be sent whenever the server resized its image and this {\bfseries always} happen on the first time. Then it can be used to track when the server-\/side image is fully known (client connected to server, retrieved its image buffer through shared memory and resized the evas object). 
\end{DoxyNote}


\subsection{Macro Definition Documentation}
\index{Plug@{Plug}!elm\-\_\-obj\-\_\-plug\-\_\-connect@{elm\-\_\-obj\-\_\-plug\-\_\-connect}}
\index{elm\-\_\-obj\-\_\-plug\-\_\-connect@{elm\-\_\-obj\-\_\-plug\-\_\-connect}!Plug@{Plug}}
\subsubsection[{elm\-\_\-obj\-\_\-plug\-\_\-connect}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-plug\-\_\-connect(
\begin{DoxyParamCaption}
\item[{}]{svcname, }
\item[{}]{svcnum, }
\item[{}]{svcsys, }
\item[{}]{ret}
\end{DoxyParamCaption}
)~E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-P\-L\-U\-G\-\_\-\-I\-D(E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-P\-L\-U\-G\-\_\-\-S\-U\-B\-\_\-\-I\-D\-\_\-\-C\-O\-N\-N\-E\-C\-T), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(const char $\ast$, svcname), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(int, svcnum), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(Eina\-\_\-\-Bool, svcsys), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(Eina\-\_\-\-Bool $\ast$, ret)}\label{group__Plug_ga6c9e1bb6789ca54cce0304a03c115784}
\begin{DoxySince}{Since}
1.\-8
\end{DoxySince}
Connect a plug widget to service provided by socket image.


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt in}  & {\em svcname} & \\
\hline
\mbox{\tt in}  & {\em svcnum} & \\
\hline
\mbox{\tt in}  & {\em svcsys} & \\
\hline
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Plug_gaa16941ac6d8c28387b6424fc7dc057fa}{elm\-\_\-plug\-\_\-connect} 
\end{DoxySeeAlso}


Referenced by elm\-\_\-plug\-\_\-connect().

\index{Plug@{Plug}!elm\-\_\-obj\-\_\-plug\-\_\-image\-\_\-object\-\_\-get@{elm\-\_\-obj\-\_\-plug\-\_\-image\-\_\-object\-\_\-get}}
\index{elm\-\_\-obj\-\_\-plug\-\_\-image\-\_\-object\-\_\-get@{elm\-\_\-obj\-\_\-plug\-\_\-image\-\_\-object\-\_\-get}!Plug@{Plug}}
\subsubsection[{elm\-\_\-obj\-\_\-plug\-\_\-image\-\_\-object\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}\#define elm\-\_\-obj\-\_\-plug\-\_\-image\-\_\-object\-\_\-get(
\begin{DoxyParamCaption}
\item[{}]{ret}
\end{DoxyParamCaption}
)~E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-P\-L\-U\-G\-\_\-\-I\-D(E\-L\-M\-\_\-\-O\-B\-J\-\_\-\-P\-L\-U\-G\-\_\-\-S\-U\-B\-\_\-\-I\-D\-\_\-\-I\-M\-A\-G\-E\-\_\-\-O\-B\-J\-E\-C\-T\-\_\-\-G\-E\-T), E\-O\-\_\-\-T\-Y\-P\-E\-C\-H\-E\-C\-K(Evas\-\_\-\-Object $\ast$$\ast$, ret)}\label{group__Plug_ga17ceb03bbe548be1c441fe3550f6f871}
\begin{DoxySince}{Since}
1.\-8
\end{DoxySince}
Get the basic Evas\-\_\-\-Image object from this object (widget).


\begin{DoxyParams}[1]{Parameters}
\mbox{\tt out}  & {\em ret} & \\
\hline
\end{DoxyParams}
\begin{DoxySeeAlso}{See Also}
\hyperlink{group__Plug_ga0f393fcbb3ab1b8aa28061b48a3e1287}{elm\-\_\-plug\-\_\-image\-\_\-object\-\_\-get} 
\end{DoxySeeAlso}


Referenced by elm\-\_\-plug\-\_\-image\-\_\-object\-\_\-get().



\subsection{Function Documentation}
\index{Plug@{Plug}!elm\-\_\-plug\-\_\-add@{elm\-\_\-plug\-\_\-add}}
\index{elm\-\_\-plug\-\_\-add@{elm\-\_\-plug\-\_\-add}!Plug@{Plug}}
\subsubsection[{elm\-\_\-plug\-\_\-add}]{\setlength{\rightskip}{0pt plus 5cm}Evas\-\_\-\-Object$\ast$ elm\-\_\-plug\-\_\-add (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{parent}
\end{DoxyParamCaption}
)}\label{group__Plug_gae3b978f52c632e5b0df1fc6e446beee4}


Add a new plug image to the parent. 


\begin{DoxyParams}{Parameters}
{\em parent} & The parent object \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The new plug image object or N\-U\-L\-L if it cannot be created 
\end{DoxyReturn}
\index{Plug@{Plug}!elm\-\_\-plug\-\_\-connect@{elm\-\_\-plug\-\_\-connect}}
\index{elm\-\_\-plug\-\_\-connect@{elm\-\_\-plug\-\_\-connect}!Plug@{Plug}}
\subsubsection[{elm\-\_\-plug\-\_\-connect}]{\setlength{\rightskip}{0pt plus 5cm}Eina\-\_\-\-Bool elm\-\_\-plug\-\_\-connect (
\begin{DoxyParamCaption}
\item[{Evas\-\_\-\-Object $\ast$}]{obj, }
\item[{const char $\ast$}]{svcname, }
\item[{int}]{svcnum, }
\item[{Eina\-\_\-\-Bool}]{svcsys}
\end{DoxyParamCaption}
)}\label{group__Plug_gaa16941ac6d8c28387b6424fc7dc057fa}


Connect a plug widget to service provided by socket image. 


\begin{DoxyParams}{Parameters}
{\em obj} & The Evas\-\_\-\-Object where the new image object will live. \\
\hline
{\em svcname} & The service name to connect to set up by the socket. \\
\hline
{\em svcnum} & The service number to connect to (set up by socket). \\
\hline
{\em svcsys} & Boolean to set if the service is a system one or not (set up by socket). \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
({\ttfamily E\-I\-N\-A\-\_\-\-T\-R\-U\-E} = success, {\ttfamily E\-I\-N\-A\-\_\-\-F\-A\-L\-S\-E} = error) 
\end{DoxyReturn}


References elm\-\_\-obj\-\_\-plug\-\_\-connect.

\index{Plug@{Plug}!elm\-\_\-plug\-\_\-image\-\_\-object\-\_\-get@{elm\-\_\-plug\-\_\-image\-\_\-object\-\_\-get}}
\index{elm\-\_\-plug\-\_\-image\-\_\-object\-\_\-get@{elm\-\_\-plug\-\_\-image\-\_\-object\-\_\-get}!Plug@{Plug}}
\subsubsection[{elm\-\_\-plug\-\_\-image\-\_\-object\-\_\-get}]{\setlength{\rightskip}{0pt plus 5cm}Evas\-\_\-\-Object$\ast$ elm\-\_\-plug\-\_\-image\-\_\-object\-\_\-get (
\begin{DoxyParamCaption}
\item[{const Evas\-\_\-\-Object $\ast$}]{obj}
\end{DoxyParamCaption}
)}\label{group__Plug_ga0f393fcbb3ab1b8aa28061b48a3e1287}


Get the basic Evas\-\_\-\-Image object from this object (widget). 


\begin{DoxyParams}{Parameters}
{\em obj} & The image object to get the inlined image from \\
\hline
\end{DoxyParams}
\begin{DoxyReturn}{Returns}
The inlined image object, or N\-U\-L\-L if none exists
\end{DoxyReturn}
This function allows one to get the underlying {\ttfamily Evas\-\_\-\-Object} of type Image from this elementary widget. It can be useful to do things like get the pixel data, save the image to a file, etc.

\begin{DoxyNote}{Note}
Be careful to not manipulate it, as it is under control of elementary. 
\end{DoxyNote}


References elm\-\_\-obj\-\_\-plug\-\_\-image\-\_\-object\-\_\-get.

