\hypertarget{simplewidget_8h}{
\subsection{simplewidget.h File Reference}
\label{simplewidget_8h}\index{simplewidget.h@{simplewidget.h}}
}


\subsubsection{Detailed Description}
\begin{Desc}
\item[Version:]00.10\end{Desc}
Put the file comments here.



\footnotesize\begin{verbatim} * ============================================================================
 * Copyright (c) Texas Instruments Inc 2005
 *
 * Use of this software is controlled by the terms and conditions found in the
 * license agreement under which this software has been supplied or provided.
 * ============================================================================
 * \end{verbatim}
\normalsize
 

\subsubsection*{Defines}
\begin{CompactItemize}
\item 
\#define \hyperlink{simplewidget_8h_fa892bd520d0eadbc417961a609d38c5}{BYTES\_\-PER\_\-PIXEL}~2
\begin{CompactList}\small\item\em Only 16 bit color supported. \item\end{CompactList}\item 
\#define \hyperlink{simplewidget_8h_3d6b3908442ada378cec5139e1153899}{SIMPLEWIDGET\_\-SUCCESS}~0
\begin{CompactList}\small\item\em Success return code. \item\end{CompactList}\item 
\#define \hyperlink{simplewidget_8h_d49730e9e4b8811d379c9285089cd2b1}{SIMPLEWIDGET\_\-FAILURE}~-1
\begin{CompactList}\small\item\em Failure return code. \item\end{CompactList}\end{CompactItemize}
\subsubsection*{Typedefs}
\begin{CompactItemize}
\item 
typedef void $\ast$ \hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button}
\begin{CompactList}\small\item\em Opaque handle to a button. \item\end{CompactList}\item 
typedef void $\ast$ \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen}
\begin{CompactList}\small\item\em Opaque handle to a screen. \item\end{CompactList}\item 
typedef void $\ast$ \hyperlink{simplewidget_8h_86cf1f72d96896eccf3f45a681ca7d09}{simplewidget\_\-text}
\begin{CompactList}\small\item\em Opaque handle to a line of text. \item\end{CompactList}\item 
typedef void $\ast$ \hyperlink{simplewidget_8h_085b4b145460dde59f0a47e45e45fe52}{simplewidget\_\-jpeg}
\begin{CompactList}\small\item\em Opaque handle to a jpeg image. \item\end{CompactList}\item 
typedef void $\ast$ \hyperlink{simplewidget_8h_6d5d0d3a49e3a6bd055cb1c583c438c0}{simplewidget\_\-png}
\begin{CompactList}\small\item\em Opaque handle to a png image. \item\end{CompactList}\end{CompactItemize}
\subsubsection*{Functions}
\begin{CompactItemize}
\item 
int \hyperlink{simplewidget_8h_4735b7b1acdb19065ee74a9c7dd1d39a}{simplewidget\_\-screen\_\-init} (void $\ast$fbp, int fbw, int fbh, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} $\ast$swsp)
\begin{CompactList}\small\item\em Initializes a simplewidget screen. Must be called before any other simplewidget API call on this screen. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_bc24fedc5436467d58203fe9dd20da91}{simplewidget\_\-screen\_\-clear} (\hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} sws, int x, int y, int w, int h)
\begin{CompactList}\small\item\em Clear an area of the screen. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_d4c9748aa8edf78232b2238e1b3990ac}{simplewidget\_\-screen\_\-draw\_\-rectangle} (\hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} sws, int x, int y, int w, int h, int r, int g, int b)
\begin{CompactList}\small\item\em Draw a rectangle on the screen. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_070e4c841bb69aea329a768a7f53d9fe}{simplewidget\_\-screen\_\-exit} (\hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} sws)
\begin{CompactList}\small\item\em Deinitalize the simplewidget screen and free up associated resources. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_b0d13e0d7667915f730379b912a4acec}{simplewidget\_\-button\_\-create} (int x, int y, int w, int h, int r, int g, int b, int font\_\-height, int border, char $\ast$txt, \hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} $\ast$swbp)
\begin{CompactList}\small\item\em Creates a button, but does not show it on screen. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_3cf333a7e5969b6c04770c508dd0d8f5}{simplewidget\_\-button\_\-show} (\hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} swb, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} sws)
\begin{CompactList}\small\item\em Show the button on the screen. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_900642d7939690cd871336b5aab3a77c}{simplewidget\_\-button\_\-hide} (\hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} swb, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} sws)
\begin{CompactList}\small\item\em Hide a button (un-show it). \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_9d3603ca64d22cd55a4b17c58f9bcfc2}{simplewidget\_\-button\_\-press} (\hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} swb, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} sws)
\begin{CompactList}\small\item\em Press the button. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_f5de3aaeba7d26538ccd53918d34ba95}{simplewidget\_\-button\_\-release} (\hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} swb, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} sws)
\begin{CompactList}\small\item\em Release the button from being pressed. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_b3ae204b41fcabc38735f2003f918edc}{simplewidget\_\-button\_\-delete} (\hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} swb)
\begin{CompactList}\small\item\em Delete the button and resources associated with it. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_14144807d83b8d95e14b15a349771353}{simplewidget\_\-text\_\-create} (int x, int y, int height, char $\ast$txt, \hyperlink{simplewidget_8h_86cf1f72d96896eccf3f45a681ca7d09}{simplewidget\_\-text} $\ast$swtp)
\begin{CompactList}\small\item\em Creates a line of text. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_61d4ab480afa2e6bfb495886d6176d29}{simplewidget\_\-text\_\-show} (\hyperlink{simplewidget_8h_86cf1f72d96896eccf3f45a681ca7d09}{simplewidget\_\-text} swt, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} sws)
\begin{CompactList}\small\item\em Show the line of text on the screen. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_a860feca3d43818f910ed54fd75c9116}{simplewidget\_\-text\_\-delete} (\hyperlink{simplewidget_8h_86cf1f72d96896eccf3f45a681ca7d09}{simplewidget\_\-text} swt)
\begin{CompactList}\small\item\em Delete the line of text and resources associated with it. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_f012a5947ead080c9a27b55cdf55d663}{simplewidget\_\-jpeg\_\-create} (char $\ast$filename, \hyperlink{simplewidget_8h_085b4b145460dde59f0a47e45e45fe52}{simplewidget\_\-jpeg} $\ast$swjp)
\begin{CompactList}\small\item\em Creates a jpeg image in memory from a file. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_90ed31b436776a281105af3e6c90f519}{simplewidget\_\-jpeg\_\-show} (\hyperlink{simplewidget_8h_085b4b145460dde59f0a47e45e45fe52}{simplewidget\_\-jpeg} swj, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} sws, int x, int y)
\begin{CompactList}\small\item\em Shows a previously created jpeg image on screen. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_83a92421a053a3c40a228f1e991cafa9}{simplewidget\_\-jpeg\_\-delete} (\hyperlink{simplewidget_8h_085b4b145460dde59f0a47e45e45fe52}{simplewidget\_\-jpeg} swj)
\begin{CompactList}\small\item\em Free up resources associated with a previously created jpeg image. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_d44a3633bce78acf8f4081c5631cdc55}{simplewidget\_\-png\_\-create} (char $\ast$filename, \hyperlink{simplewidget_8h_6d5d0d3a49e3a6bd055cb1c583c438c0}{simplewidget\_\-png} $\ast$swpp)
\begin{CompactList}\small\item\em Creates a jpeg image in memory from a file. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_83cd1b5a3a720be5d9aedf110573a0e7}{simplewidget\_\-png\_\-show} (\hyperlink{simplewidget_8h_6d5d0d3a49e3a6bd055cb1c583c438c0}{simplewidget\_\-png} swp, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} sws, int x, int y)
\begin{CompactList}\small\item\em Shows a previously created png image on screen. \item\end{CompactList}\item 
int \hyperlink{simplewidget_8h_1605a5a575ea3c8c73569676129e4f2c}{simplewidget\_\-png\_\-delete} (\hyperlink{simplewidget_8h_6d5d0d3a49e3a6bd055cb1c583c438c0}{simplewidget\_\-png} swp)
\begin{CompactList}\small\item\em Free up resources associated with a previously created png image. \item\end{CompactList}\end{CompactItemize}


\subsubsection{Define Documentation}
\hypertarget{simplewidget_8h_fa892bd520d0eadbc417961a609d38c5}{
\index{simplewidget.h@{simplewidget.h}!BYTES_PER_PIXEL@{BYTES\_\-PER\_\-PIXEL}}
\index{BYTES_PER_PIXEL@{BYTES\_\-PER\_\-PIXEL}!simplewidget.h@{simplewidget.h}}
\paragraph[BYTES\_\-PER\_\-PIXEL]{\setlength{\rightskip}{0pt plus 5cm}\#define BYTES\_\-PER\_\-PIXEL~2}\hfill}
\label{simplewidget_8h_fa892bd520d0eadbc417961a609d38c5}


Only 16 bit color supported. 

\hypertarget{simplewidget_8h_3d6b3908442ada378cec5139e1153899}{
\index{simplewidget.h@{simplewidget.h}!SIMPLEWIDGET_SUCCESS@{SIMPLEWIDGET\_\-SUCCESS}}
\index{SIMPLEWIDGET_SUCCESS@{SIMPLEWIDGET\_\-SUCCESS}!simplewidget.h@{simplewidget.h}}
\paragraph[SIMPLEWIDGET\_\-SUCCESS]{\setlength{\rightskip}{0pt plus 5cm}\#define SIMPLEWIDGET\_\-SUCCESS~0}\hfill}
\label{simplewidget_8h_3d6b3908442ada378cec5139e1153899}


Success return code. 

\hypertarget{simplewidget_8h_d49730e9e4b8811d379c9285089cd2b1}{
\index{simplewidget.h@{simplewidget.h}!SIMPLEWIDGET_FAILURE@{SIMPLEWIDGET\_\-FAILURE}}
\index{SIMPLEWIDGET_FAILURE@{SIMPLEWIDGET\_\-FAILURE}!simplewidget.h@{simplewidget.h}}
\paragraph[SIMPLEWIDGET\_\-FAILURE]{\setlength{\rightskip}{0pt plus 5cm}\#define SIMPLEWIDGET\_\-FAILURE~-1}\hfill}
\label{simplewidget_8h_d49730e9e4b8811d379c9285089cd2b1}


Failure return code. 



\subsubsection{Typedef Documentation}
\hypertarget{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_button@{simplewidget\_\-button}}
\index{simplewidget_button@{simplewidget\_\-button}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-button]{\setlength{\rightskip}{0pt plus 5cm}typedef void$\ast$ \hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button}}\hfill}
\label{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}


Opaque handle to a button. 

\hypertarget{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_screen@{simplewidget\_\-screen}}
\index{simplewidget_screen@{simplewidget\_\-screen}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-screen]{\setlength{\rightskip}{0pt plus 5cm}typedef void$\ast$ \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen}}\hfill}
\label{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}


Opaque handle to a screen. 

\hypertarget{simplewidget_8h_86cf1f72d96896eccf3f45a681ca7d09}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_text@{simplewidget\_\-text}}
\index{simplewidget_text@{simplewidget\_\-text}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-text]{\setlength{\rightskip}{0pt plus 5cm}typedef void$\ast$ \hyperlink{simplewidget_8h_86cf1f72d96896eccf3f45a681ca7d09}{simplewidget\_\-text}}\hfill}
\label{simplewidget_8h_86cf1f72d96896eccf3f45a681ca7d09}


Opaque handle to a line of text. 

\hypertarget{simplewidget_8h_085b4b145460dde59f0a47e45e45fe52}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_jpeg@{simplewidget\_\-jpeg}}
\index{simplewidget_jpeg@{simplewidget\_\-jpeg}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-jpeg]{\setlength{\rightskip}{0pt plus 5cm}typedef void$\ast$ \hyperlink{simplewidget_8h_085b4b145460dde59f0a47e45e45fe52}{simplewidget\_\-jpeg}}\hfill}
\label{simplewidget_8h_085b4b145460dde59f0a47e45e45fe52}


Opaque handle to a jpeg image. 

\hypertarget{simplewidget_8h_6d5d0d3a49e3a6bd055cb1c583c438c0}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_png@{simplewidget\_\-png}}
\index{simplewidget_png@{simplewidget\_\-png}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-png]{\setlength{\rightskip}{0pt plus 5cm}typedef void$\ast$ \hyperlink{simplewidget_8h_6d5d0d3a49e3a6bd055cb1c583c438c0}{simplewidget\_\-png}}\hfill}
\label{simplewidget_8h_6d5d0d3a49e3a6bd055cb1c583c438c0}


Opaque handle to a png image. 



\subsubsection{Function Documentation}
\hypertarget{simplewidget_8h_4735b7b1acdb19065ee74a9c7dd1d39a}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_screen_init@{simplewidget\_\-screen\_\-init}}
\index{simplewidget_screen_init@{simplewidget\_\-screen\_\-init}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-screen\_\-init]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-screen\_\-init (void $\ast$ {\em fbp}, int {\em fbw}, int {\em fbh}, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} $\ast$ {\em swsp})}\hfill}
\label{simplewidget_8h_4735b7b1acdb19065ee74a9c7dd1d39a}


Initializes a simplewidget screen. Must be called before any other simplewidget API call on this screen. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em fbp}]The pointer to the framebuffer. \item[{\em fbw}]The width of the framebuffer. \item[{\em fbh}]The height of the framebuffer. \item[{\em swsp}]Screen pointer returned. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_bc24fedc5436467d58203fe9dd20da91}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_screen_clear@{simplewidget\_\-screen\_\-clear}}
\index{simplewidget_screen_clear@{simplewidget\_\-screen\_\-clear}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-screen\_\-clear]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-screen\_\-clear (\hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} {\em sws}, int {\em x}, int {\em y}, int {\em w}, int {\em h})}\hfill}
\label{simplewidget_8h_bc24fedc5436467d58203fe9dd20da91}


Clear an area of the screen. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em sws}]Simplewidget screen to clear on. \item[{\em x}]X coordinate of area to clear. \item[{\em y}]Y coordinate of area to clear. \item[{\em w}]Width of area to clear. \item[{\em h}]Height of area to clear. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_d4c9748aa8edf78232b2238e1b3990ac}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_screen_draw_rectangle@{simplewidget\_\-screen\_\-draw\_\-rectangle}}
\index{simplewidget_screen_draw_rectangle@{simplewidget\_\-screen\_\-draw\_\-rectangle}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-screen\_\-draw\_\-rectangle]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-screen\_\-draw\_\-rectangle (\hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} {\em sws}, int {\em x}, int {\em y}, int {\em w}, int {\em h}, int {\em r}, int {\em g}, int {\em b})}\hfill}
\label{simplewidget_8h_d4c9748aa8edf78232b2238e1b3990ac}


Draw a rectangle on the screen. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em sws}]Simplewidget screen to draw rectangle on. \item[{\em x}]X coordinate of the rectangle. \item[{\em y}]Y coordinate of the rectangle. \item[{\em w}]Width of the rectangle. \item[{\em h}]Height of the rectangle. \item[{\em r}]Red component of rectangle color. \item[{\em g}]Green component of rectangle color. \item[{\em b}]Blue component of rectangle color. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_070e4c841bb69aea329a768a7f53d9fe}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_screen_exit@{simplewidget\_\-screen\_\-exit}}
\index{simplewidget_screen_exit@{simplewidget\_\-screen\_\-exit}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-screen\_\-exit]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-screen\_\-exit (\hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} {\em sws})}\hfill}
\label{simplewidget_8h_070e4c841bb69aea329a768a7f53d9fe}


Deinitalize the simplewidget screen and free up associated resources. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em sws}]Simplewidget screen to deinitalize. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_b0d13e0d7667915f730379b912a4acec}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_button_create@{simplewidget\_\-button\_\-create}}
\index{simplewidget_button_create@{simplewidget\_\-button\_\-create}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-button\_\-create]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-button\_\-create (int {\em x}, int {\em y}, int {\em w}, int {\em h}, int {\em r}, int {\em g}, int {\em b}, int {\em font\_\-height}, int {\em border}, char $\ast$ {\em txt}, \hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} $\ast$ {\em swbp})}\hfill}
\label{simplewidget_8h_b0d13e0d7667915f730379b912a4acec}


Creates a button, but does not show it on screen. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em x}]X position of the button on screen. \item[{\em y}]Y position of the button on screen. \item[{\em w}]Width of button. \item[{\em h}]Height of button. \item[{\em r}]Red component of button color. \item[{\em g}]Green component of button color. \item[{\em b}]Blue component of button color. \item[{\em font\_\-height}]Height of the button font. \item[{\em border}]Size of button border. \item[{\em txt}]Text to render inside button. \item[{\em swbp}]Simplewidget handle returned. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_3cf333a7e5969b6c04770c508dd0d8f5}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_button_show@{simplewidget\_\-button\_\-show}}
\index{simplewidget_button_show@{simplewidget\_\-button\_\-show}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-button\_\-show]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-button\_\-show (\hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} {\em swb}, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} {\em sws})}\hfill}
\label{simplewidget_8h_3cf333a7e5969b6c04770c508dd0d8f5}


Show the button on the screen. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swb}]Simplewidget handle of the button to show. \item[{\em sws}]Simplewidget screen to show button on. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_900642d7939690cd871336b5aab3a77c}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_button_hide@{simplewidget\_\-button\_\-hide}}
\index{simplewidget_button_hide@{simplewidget\_\-button\_\-hide}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-button\_\-hide]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-button\_\-hide (\hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} {\em swb}, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} {\em sws})}\hfill}
\label{simplewidget_8h_900642d7939690cd871336b5aab3a77c}


Hide a button (un-show it). 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swb}]Simplewidget handle of the button to hide. \item[{\em sws}]Simplewidget screen to hide button on. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_9d3603ca64d22cd55a4b17c58f9bcfc2}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_button_press@{simplewidget\_\-button\_\-press}}
\index{simplewidget_button_press@{simplewidget\_\-button\_\-press}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-button\_\-press]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-button\_\-press (\hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} {\em swb}, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} {\em sws})}\hfill}
\label{simplewidget_8h_9d3603ca64d22cd55a4b17c58f9bcfc2}


Press the button. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swb}]Simplewidget handle of the button to press. \item[{\em sws}]Simplewidget screen to fade in button on. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_f5de3aaeba7d26538ccd53918d34ba95}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_button_release@{simplewidget\_\-button\_\-release}}
\index{simplewidget_button_release@{simplewidget\_\-button\_\-release}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-button\_\-release]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-button\_\-release (\hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} {\em swb}, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} {\em sws})}\hfill}
\label{simplewidget_8h_f5de3aaeba7d26538ccd53918d34ba95}


Release the button from being pressed. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swb}]Simplewidget handle of the button to release from being pressed. \item[{\em sws}]Simplewidget screen to fade in button on. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_b3ae204b41fcabc38735f2003f918edc}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_button_delete@{simplewidget\_\-button\_\-delete}}
\index{simplewidget_button_delete@{simplewidget\_\-button\_\-delete}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-button\_\-delete]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-button\_\-delete (\hyperlink{simplewidget_8h_8c3fe5ebb8d3d723716e5136639a4a8b}{simplewidget\_\-button} {\em swb})}\hfill}
\label{simplewidget_8h_b3ae204b41fcabc38735f2003f918edc}


Delete the button and resources associated with it. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swb}]Simplewidget handle of the button to delete. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_14144807d83b8d95e14b15a349771353}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_text_create@{simplewidget\_\-text\_\-create}}
\index{simplewidget_text_create@{simplewidget\_\-text\_\-create}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-text\_\-create]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-text\_\-create (int {\em x}, int {\em y}, int {\em height}, char $\ast$ {\em txt}, \hyperlink{simplewidget_8h_86cf1f72d96896eccf3f45a681ca7d09}{simplewidget\_\-text} $\ast$ {\em swtp})}\hfill}
\label{simplewidget_8h_14144807d83b8d95e14b15a349771353}


Creates a line of text. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em x}]Starting X position of the line of text. \item[{\em y}]Starting Y position of the line of text. \item[{\em height}]Height of font to render text with. \item[{\em txt}]Text to render inside button. \item[{\em swtp}]Simplewidget handle returned. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_61d4ab480afa2e6bfb495886d6176d29}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_text_show@{simplewidget\_\-text\_\-show}}
\index{simplewidget_text_show@{simplewidget\_\-text\_\-show}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-text\_\-show]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-text\_\-show (\hyperlink{simplewidget_8h_86cf1f72d96896eccf3f45a681ca7d09}{simplewidget\_\-text} {\em swt}, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} {\em sws})}\hfill}
\label{simplewidget_8h_61d4ab480afa2e6bfb495886d6176d29}


Show the line of text on the screen. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swt}]Simplewidget handle of the text line to show. \item[{\em sws}]Simplewidget screen to show text line on. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_a860feca3d43818f910ed54fd75c9116}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_text_delete@{simplewidget\_\-text\_\-delete}}
\index{simplewidget_text_delete@{simplewidget\_\-text\_\-delete}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-text\_\-delete]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-text\_\-delete (\hyperlink{simplewidget_8h_86cf1f72d96896eccf3f45a681ca7d09}{simplewidget\_\-text} {\em swt})}\hfill}
\label{simplewidget_8h_a860feca3d43818f910ed54fd75c9116}


Delete the line of text and resources associated with it. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swt}]Simplewidget handle of the text line to delete. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_f012a5947ead080c9a27b55cdf55d663}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_jpeg_create@{simplewidget\_\-jpeg\_\-create}}
\index{simplewidget_jpeg_create@{simplewidget\_\-jpeg\_\-create}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-jpeg\_\-create]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-jpeg\_\-create (char $\ast$ {\em filename}, \hyperlink{simplewidget_8h_085b4b145460dde59f0a47e45e45fe52}{simplewidget\_\-jpeg} $\ast$ {\em swjp})}\hfill}
\label{simplewidget_8h_f012a5947ead080c9a27b55cdf55d663}


Creates a jpeg image in memory from a file. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em filename}]The full path and filename of the jpeg file. \item[{\em swjp}]Simplewidget handle returned. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_90ed31b436776a281105af3e6c90f519}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_jpeg_show@{simplewidget\_\-jpeg\_\-show}}
\index{simplewidget_jpeg_show@{simplewidget\_\-jpeg\_\-show}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-jpeg\_\-show]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-jpeg\_\-show (\hyperlink{simplewidget_8h_085b4b145460dde59f0a47e45e45fe52}{simplewidget\_\-jpeg} {\em swj}, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} {\em sws}, int {\em x}, int {\em y})}\hfill}
\label{simplewidget_8h_90ed31b436776a281105af3e6c90f519}


Shows a previously created jpeg image on screen. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swj}]Simplewidget handle to the jpeg image previously created. \item[{\em sws}]Simplewidget screen to show jpeg image on. \item[{\em x}]Starting X position on screen of the jpeg image. \item[{\em y}]Starting Y position on screen of the jpeg image. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_83a92421a053a3c40a228f1e991cafa9}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_jpeg_delete@{simplewidget\_\-jpeg\_\-delete}}
\index{simplewidget_jpeg_delete@{simplewidget\_\-jpeg\_\-delete}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-jpeg\_\-delete]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-jpeg\_\-delete (\hyperlink{simplewidget_8h_085b4b145460dde59f0a47e45e45fe52}{simplewidget\_\-jpeg} {\em swj})}\hfill}
\label{simplewidget_8h_83a92421a053a3c40a228f1e991cafa9}


Free up resources associated with a previously created jpeg image. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swj}]Simplewidget handle to the jpeg image previously created. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_d44a3633bce78acf8f4081c5631cdc55}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_png_create@{simplewidget\_\-png\_\-create}}
\index{simplewidget_png_create@{simplewidget\_\-png\_\-create}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-png\_\-create]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-png\_\-create (char $\ast$ {\em filename}, \hyperlink{simplewidget_8h_6d5d0d3a49e3a6bd055cb1c583c438c0}{simplewidget\_\-png} $\ast$ {\em swpp})}\hfill}
\label{simplewidget_8h_d44a3633bce78acf8f4081c5631cdc55}


Creates a jpeg image in memory from a file. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em filename}]The full path and filename of the png file. \item[{\em swpp}]Simplewidget handle returned. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_83cd1b5a3a720be5d9aedf110573a0e7}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_png_show@{simplewidget\_\-png\_\-show}}
\index{simplewidget_png_show@{simplewidget\_\-png\_\-show}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-png\_\-show]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-png\_\-show (\hyperlink{simplewidget_8h_6d5d0d3a49e3a6bd055cb1c583c438c0}{simplewidget\_\-png} {\em swp}, \hyperlink{simplewidget_8h_67f3468f0160efa9c2521c55bfe9b879}{simplewidget\_\-screen} {\em sws}, int {\em x}, int {\em y})}\hfill}
\label{simplewidget_8h_83cd1b5a3a720be5d9aedf110573a0e7}


Shows a previously created png image on screen. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swp}]Simplewidget handle to the png image previously created. \item[{\em sws}]Simplewidget screen to show png image on. \item[{\em x}]Starting X position on screen of the png image. \item[{\em y}]Starting Y position on screen of the png image. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
\hypertarget{simplewidget_8h_1605a5a575ea3c8c73569676129e4f2c}{
\index{simplewidget.h@{simplewidget.h}!simplewidget_png_delete@{simplewidget\_\-png\_\-delete}}
\index{simplewidget_png_delete@{simplewidget\_\-png\_\-delete}!simplewidget.h@{simplewidget.h}}
\paragraph[simplewidget\_\-png\_\-delete]{\setlength{\rightskip}{0pt plus 5cm}int simplewidget\_\-png\_\-delete (\hyperlink{simplewidget_8h_6d5d0d3a49e3a6bd055cb1c583c438c0}{simplewidget\_\-png} {\em swp})}\hfill}
\label{simplewidget_8h_1605a5a575ea3c8c73569676129e4f2c}


Free up resources associated with a previously created png image. 

\begin{Desc}
\item[Parameters:]
\begin{description}
\item[{\em swp}]Simplewidget handle to the png image previously created. \end{description}
\end{Desc}
\begin{Desc}
\item[Returns:]SIMPLEWIDGET\_\-SUCCESS on success and SIMPLEWIDGET\_\-FAILURE on failure. \end{Desc}
