1 2 3 4 5 6 7 8 9 10 11 12 13 14 15 16 17 18 19 20 21 22 23 24 25 26 27 28 29 30 31 32 33 34 35 36 37 38 39 40 41 42 43 44 45 46 47 48 49 50 51 52 53 54 55 56 57 58 59 60 61 62 63 64 65 66 67 68 69 70
|
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 3.2 Final//EN">
<HTML>
<HEAD>
<TITLE>IMAGEPROPERTIES Image Object Properties
</TITLE>
</HEAD>
<BODY>
<H2>IMAGEPROPERTIES Image Object Properties
</H2>
<P>
Section: <A HREF=sec_handle.html> Handle-Based Graphics </A>
<H3>Usage</H3>
Below is a summary of the properties for the axis.
<UL>
<LI> <code>alphadata</code> - <code>vector</code> - This is a vector that
should contain as many elements as the image data itself <code>cdata</code>,
or a single scalar. For a single scalar, all values of the image
take on the same transparency. Otherwise, the transparency of
each pixel is determined by the corresponding value from the <code>alphadata</code>
vector.
</LI>
<LI> <code>alphadatamapping</code> - <code>{'scaled','direct','none'}</code> - For <code>none</code>
mode (the default), no transparency is applied to the data. For <code>direct</code>
mode, the vector <code>alphadata</code> contains values between @[0,M-1]| where
<code>M</code> is the length of the alpha map stored in the figure. For <code>scaled</code>
mode, the <code>alim</code> vector for the figure is used to linearly rescale the
alpha data prior to lookup in the alpha map.
</LI>
<LI> <code>cdata</code> - <code>array</code> - This is either a <code>M x N</code> array or an
<code>M x N x 3</code> array. If the data is <code>M x N</code> the image is a scalar
image (indexed mode), where the color associated with each image pixel
is computed using the colormap and the <code>cdatamapping</code> mode. If the
data is <code>M x N x 3</code> the image is assumed to be in RGB mode, and the
colorpanes are taken directly from <code>cdata</code> (the colormap is ignored).
Note that in this case, the data values must be between @[0,1]| for each
color channel and each pixel.
</LI>
<LI> <code>cdatamapping</code> - <code>{'scaled','direct'}</code> - For <code>scaled</code> (the
default), the pixel values are scaled using the <code>clim</code> vector for the
figure prior to looking up in the colormap. For <code>direct</code> mode, the
pixel values must be in the range <code>[0,N-1</code> where <code>N</code> is the number of
colors in the colormap if the data is integer type. For floating point
data types, values must be in the range <code>[1,N]</code>.
</LI>
<LI> <code>children</code> - Not used.
</LI>
<LI> <code>parent</code> - <code>handle</code> - The axis containing the image.
</LI>
<LI> <code>tag</code> - <code>string</code> - You can set this to any string you want.
</LI>
<LI> <code>type</code> - <code>string</code> - Set to the string <code>'image'</code>.
</LI>
<LI> <code>xdata</code> - <code>two vector</code> - contains the x coordinates of the
first and last column (respectively). Defaults to <code>[1,C]</code> where
<code>C</code> is the number of columns in the image.
</LI>
<LI> <code>ydata</code> - <code>two vector</code> - contains the y coordinates of the
first and last row (respectively). Defaults to <code>[1,R]</code> where
<code>R</code> is the number of rows in the image.
</LI>
<LI> <code>userdata</code> - <code>array</code> - Available to store any variable you
want in the handle object.
</LI>
<LI> <code>visible</code> - <code>{'on','off'}</code> - Controls whether the image is
visible or not.
</LI>
</UL>
</BODY>
</HTML>
|