\section{Image.mui}

Image class is used to display one of MUI's standard
images or some selfmade image data.

\subsection[MUIA\_Image\_FontMatch]{MUIA\_Image\_FontMatch -- (V4) [I..], BOOL}

\subsubsection*{FUNCTION}
If TRUE, width and height of the given image will be
scaled to match the current font. Images are always
defined with a reference font of topaz/8, bigger fonts
will make the image grow (as long as its maximum size
is big enough).

\subsubsection*{EXAMPLE}
\small
\begin{verbatim}
The arrows of a scroll bar are e.g. defined with
MUIA_Image_FontMatch.

\end{verbatim}
\normalsize
\subsubsection*{SEE ALSO}
MUIA\_Image\_FontMatch, MUIA\_Image\_FontMatchWidth

\subsection[MUIA\_Image\_FontMatchHeight]{MUIA\_Image\_FontMatchHeight -- (V4) [I..], BOOL}

\subsubsection*{FUNCTION}
If TRUE, the height of the given image will be scaled
to match the current font. Images are always defined
with a reference font of topaz/8, bigger fonts will
make the image grow (as long as its maximum size
is big enough).

\subsubsection*{SEE ALSO}
MUIA\_Image\_FontMatch, MUIA\_Image\_FontMatchWidth

\subsection[MUIA\_Image\_FontMatchWidth]{MUIA\_Image\_FontMatchWidth -- (V4) [I..], BOOL}

\subsubsection*{FUNCTION}
If TRUE, the width of the given image will be scaled
to match the current font. Images are always defined
with a reference font of topaz/8, bigger fonts will
make the image grow (as long as its maximum size
is big enough).

\subsubsection*{SEE ALSO}
MUIA\_Image\_FontMatch, MUIA\_Image\_FontMatchHeight

\subsection[MUIA\_Image\_FreeHoriz]{MUIA\_Image\_FreeHoriz -- (V4) [I..], BOOL}

\subsubsection*{FUNCTION}
Tell the image if its allowed to get scaled horizontally.
Defaults to FALSE.

\subsubsection*{SEE ALSO}
MUIA\_Image\_FreeVert, MUIA\_Image\_FontMatch

\subsection[MUIA\_Image\_FreeVert]{MUIA\_Image\_FreeVert -- (V4) [I..], BOOL}

\subsubsection*{FUNCTION}
Tell the image if its allowed to get scaled vertically.
Defaults to FALSE.

\subsubsection*{SEE ALSO}
MUIA\_Image\_FreeHoriz, MUIA\_Image\_FontMatch

\subsection[MUIA\_Image\_OldImage]{MUIA\_Image\_OldImage -- (V4) [I..], struct Image $\ast$}

\subsubsection*{FUNCTION}
Allows you to use any conventional image structure
within a MUI window. The resulting object is always
as big as the image and not resizable.

\subsection[MUIA\_Image\_Spec]{MUIA\_Image\_Spec -- (V4) [I..], char $\ast$}

\subsubsection*{FUNCTION}
Specify the type of your image. Usually, you will
use one of the predefined standard images here,
(one of the MUII\_xxx definitions from mui.h),
but you also can supply a string containing
a MUI image specification. Image specifications
always starts with a digit, followed by a ':',
followed by some parameters. Currently, the
following things are defined (all numeric
parameters need to be ascii values!):

\begin{description}
\item[''0:\flq x\frq ''] where \flq x\frq\  is between MUII\_BACKGROUND and
MUII\_FILLBACK2 identifying a builtin pattern.

\item[''1:\flq x\frq ''] where \flq x\frq\  identifies a builtin standard image.
Don't use this, use ''6:\flq x\frq '' instead.

\item[''2:\flq r\frq ,\flq g\frq ,\flq b\frq ''] where \flq r\frq , \flq g\frq\  and \flq b\frq\  are 32-bit RGB
color values specified as 8-digit hex
string (e.g. 00000000 or ffffffff).
Kick 2.x users will get an empty image.

\item[''3:\flq n\frq ''] where \flq n\frq\  is the name of an external boopsi
image class.

\item[''4:\flq n\frq ''] where \flq n\frq\  is the name of an external MUI brush.

\item[''5:\flq n\frq ''] where \flq n\frq\  is the name of an external picture
file that should be loaded with datatypes.
Kick 2.x users will get an empty image.

\item[''6:\flq x\frq ''] where \flq x\frq\  is between MUII\_WindowBack and
MUII\_Count-1 identifying a preconfigured
image/background.
\end{description}

\subsubsection*{SEE ALSO}
MUIA\_Image\_OldImage

\subsection[MUIA\_Image\_State]{MUIA\_Image\_State -- (V4) [IS.], LONG}

\subsubsection*{FUNCTION}
Some MUI images offer different states, you can select
one of the by setting this attribute. Simply use
one of the IDS\_NORMAL, IDS\_SELECTED, ... values
defined in ''intuition/imageclass.h''.

\subsubsection*{NOTE}
Objects that respond to user input will
automatically toggle their state between
IDS\_NORMAL to IDS\_SELECTED depending on
their MUIA\_Selected attribute.

\subsubsection*{SEE ALSO}
MUIA\_Image\_Spec