summaryrefslogtreecommitdiff
path: root/documentation/Fl_Image.html
diff options
context:
space:
mode:
authorMichael R Sweet <michael.r.sweet@gmail.com>2001-11-27 04:55:48 +0000
committerMichael R Sweet <michael.r.sweet@gmail.com>2001-11-27 04:55:48 +0000
commit4dc5732a3e0f376786d1d6b788e5cf601439e890 (patch)
tree2aab2bfb14b58f41f28f327b734f1a775f2a4376 /documentation/Fl_Image.html
parent772f94ca1ac8aec25aa4ccc337454cf76c5ea700 (diff)
Image class docos.
Start of text buffer docos. git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@1754 ea41ed52-d2ee-0310-a9c1-e6b18d33e121
Diffstat (limited to 'documentation/Fl_Image.html')
-rw-r--r--documentation/Fl_Image.html517
1 files changed, 190 insertions, 327 deletions
diff --git a/documentation/Fl_Image.html b/documentation/Fl_Image.html
index e0b27db16..16d95687a 100644
--- a/documentation/Fl_Image.html
+++ b/documentation/Fl_Image.html
@@ -1,336 +1,199 @@
-<HTML><BODY>
-<HR break>
-<H2><A name=Fl_Input>class Fl_Input</A></H2>
+<HTML>
+<BODY>
+
+<!-- NEW PAGE -->
+
+<H2><A name="Fl_Image">class Fl_Image</A></H2>
+
<HR>
+
<H3>Class Hierarchy</H3>
-<UL>
-<PRE>
-<A href=Fl_Input_.html#Fl_Input_>Fl_Input_</A>
- |
- +----<B>Fl_Input</B>
- |
- +----<A href=Fl_Float_Input.html#Fl_Float_Input>Fl_Float_Input</A>, <A href=Fl_Int_Input.html#Fl_Int_Input>Fl_Int_Input</A>,
- <A href=Fl_Multiline_Input.html#Fl_Multiline_Input>Fl_Multiline_Input</A>, <A href=Fl_Secret_Input.html#Fl_Secret_Input>Fl_Secret_Input</A>
-</PRE>
-</UL>
+
+<UL><PRE>
+<B>Fl_Image</B>
+ |
+ +----<A href="Fl_Bitmap.html">Fl_Bitmap</A>,
+ <A href="Fl_Pixmap.html">Fl_Pixmap</A>,
+ <A href="Fl_RGB_Image.html">Fl_RGB_Image</A>,
+ <A href="Fl_Shared_Image.html">Fl_Shared_Image</A>,
+ <A href="Fl_Tiled_Image.html">Fl_Tiled_Image</A>
+</PRE></UL>
+
<H3>Include Files</H3>
-<UL>
-<PRE>
-#include &lt;FL/Fl_Input.H&gt;
-</PRE>
-</UL>
+
+<UL><PRE>
+#include &lt;FL/Fl_Image.H&gt;
+</PRE></UL>
+
<H3>Description</H3>
-<P>This is the FLTK text input widget. It displays a single line of text
-and lets the user edit it. Normally it is drawn with an inset box and
-a white background. The text may contain any characters (even 0), and
-will correctly display anything, using ^X notation for unprintable
-control characters and \nnn notation for unprintable characters with
-the high bit set. It assumes the font can draw any characters in the
-ISO-8859-1 character set.
-
-<CENTER><TABLE border=1 WIDTH=90% summary="Fl_Input keyboard and mouse bindings.">
-
-<TR><TD WIDTH=200><B>Mouse button 1</B></TD><TD>Moves the cursor to
- this point. Drag selects characters. Double click selects words.
- Triple click selects all text. Shift+click extends the selection.
- When you select text it is automatically copied to the clipboard.
-</TD></TR>
-
-<TR><TD><B>Mouse button 2</B></TD><TD>Insert the clipboard at
-the point clicked. You can also select a region and replace it with the
-clipboard by selecting the region with mouse button 2.
-</TD></TR>
-
-<TR><TD><B>Mouse button 3</B></TD><TD>Currently acts like button 1.</TD></TR>
-
-<TR><TD><B>Backspace</B></TD><TD>Deletes one character to the left, or
-deletes the selected region.</TD></TR>
-<TR><TD><B>Enter</B></TD><TD>May cause the callback, see when().</TD></TR>
-<TR><TD><B>^A or Home</B></TD><TD>Go to start of line.</TD></TR>
-<TR><TD><B>^B or Left</B></TD><TD>Move left</TD></TR>
-<TR><TD><B>^C</B></TD><TD>Copy the selection to the clipboard</TD></TR>
-<TR><TD><B>^D or Delete</B></TD><TD>Deletes one character to the right
-or deletes the selected region.</TD></TR>
-<TR><TD><B>^E or End</B></TD><TD>Go to the end of line.</TD></TR>
-<TR><TD><B>^F or Right</B></TD><TD>Move right</TD></TR>
-<TR><TD><B>^K</B></TD><TD>Delete to the end of line (next \n character)
-or deletes a single \n character. These deletions are all concatenated
-into the clipboard.</TD></TR>
-<TR><TD><B>^N or Down</B></TD><TD>Move down (for Fl_Multiline_Input
-only, otherwise it moves to the next input field).</TD></TR>
-<TR><TD><B>^P or Up</B></TD><TD>Move up (for Fl_Multiline_Input only,
-otherwise it moves to the previous input field).</TD></TR>
-<TR><TD><B>^U</B></TD><TD>Delete everything.</TD></TR>
-<TR><TD><B>^V or ^Y</B></TD><TD>Paste the clipboard</TD></TR>
-<TR><TD><B>^X or ^W</B></TD><TD>Copy the region to the clipboard and
-delete it.</TD></TR>
-<TR><TD><B>^Z or ^_</B></TD><TD>Undo. This is a single-level undo
-mechanism, but all adjacent deletions and insertions are concatenated
-into a single &quot;undo&quot;. Often this will undo a lot more than you
-expected.</TD></TR>
-<TR><TD><B>Shift+move</B></TD><TD>Move the cursor but also extend the
-selection.</TD></TR>
-
-<TR><TD><B>RightCtrl or
-<BR>Compose</B></TD><TD><a name=compose>Start</A>
-a <A href="events.html#compose">compose-character</A>
-sequence. The next one or two keys typed define the character to
-insert (see table that follows.)
-
-<p>For instance, to type "á" type [compose][a]['] or [compose]['][a].
-
-<P>The character "nbsp" (non-breaking space) is typed by using
-[compose][space].
-
-<P>The single-character sequences may be followed by a space if
-necessary to remove ambiguity. For instance, if you really want to
-type "ª~" rather than "ã" you must type [compose][a][space][~].
-
-<p>The same key may be used to "quote" control characters into the
-text. If you need a <tt>^Q</tt> character you can get one by typing
-[compose][Control+Q].
-
-<p>X may have a key on the keyboard
-defined as <tt>XK_Multi_key</tt>. If so this key may be used as well
-as the right-hand control key. You can set this up with the program
-<tt>xmodmap</tt>.
-
-<p>If your keyboard is set to support a foreign language you should
-also be able to type "dead key" prefix characters. On X you will
-actually be able to see what dead key you typed, and if you then move
-the cursor without completing the sequence the accent will remain
-inserted.
-</TABLE></CENTER>
-<!-- NEW PAGE -->
-<center><table border=1 summary="Character Composition Table">
-<caption align="top">Character Composition Table</caption>
-<tr>
- <th>Keys</th><th>Char</th>
- <th>Keys</th><th>Char</th>
- <th>Keys</th><th>Char</th>
- <th>Keys</th><th>Char</th>
- <th>Keys</th><th>Char</th>
- <th>Keys</th><th>Char</th>
-
-</tr><tr>
- <td align=center><TT>sp</TT></td><td align=center><small>nbsp</small></td>
- <td align=center><TT>*</tt></td><td align=center>°</td>
- <td align=center><TT>` A</tt></td><td align=center>À</td>
- <td align=center><TT>D -</tt></td><td align=center>Ð</td>
- <td align=center><TT>` a</tt></td><td align=center>à</td>
- <td align=center><TT>d -</tt></td><td align=center>ð
-</tr><tr>
- <td align=center><TT>!</tt></td><td align=center>¡</td>
- <td align=center><TT>+ -</tt></td><td align=center>±</td>
- <td align=center><TT>' A</tt></td><td align=center>Á</td>
- <td align=center><TT>~ N</tt></td><td align=center>Ñ</td>
- <td align=center><TT>' a</tt></td><td align=center>á</td>
- <td align=center><TT>~ n</tt></td><td align=center>ñ
-</tr><tr>
- <td align=center><TT>%</tt></td><td align=center>¢</td>
- <td align=center><TT>2</tt></td><td align=center>²</td>
- <td align=center><TT>A ^</tt></td><td align=center>Â</td>
- <td align=center><TT>` O</tt></td><td align=center>Ò</td>
- <td align=center><TT>^ a</tt></td><td align=center>â</td>
- <td align=center><TT>` o</tt></td><td align=center>ò
-</tr><tr>
- <td align=center><TT>#</tt></td><td align=center>£</td>
- <td align=center><TT>3</tt></td><td align=center>³</td>
- <td align=center><TT>~ A</tt></td><td align=center>Ã</td>
- <td align=center><TT>' O</tt></td><td align=center>Ó</td>
- <td align=center><TT>~ a</tt></td><td align=center>ã</td>
- <td align=center><TT>' o</tt></td><td align=center>ó
-</tr><tr>
- <td align=center><TT>$</tt></td><td align=center>¤</td>
- <td align=center><TT>'</tt></td><td align=center>´</td>
- <td align=center><TT>: A</tt></td><td align=center>Ä</td>
- <td align=center><TT>^ O</tt></td><td align=center>Ô</td>
- <td align=center><TT>: a</tt></td><td align=center>ä</td>
- <td align=center><TT>^ o</tt></td><td align=center>ô
-</tr><tr>
- <td align=center><TT>y =</tt></td><td align=center>¥</td>
- <td align=center><TT>u</tt></td><td align=center>µ</td>
- <td align=center><TT>* A</tt></td><td align=center>Å</td>
- <td align=center><TT>~ O</tt></td><td align=center>Õ</td>
- <td align=center><TT>* a</tt></td><td align=center>å</td>
- <td align=center><TT>~ o</tt></td><td align=center>õ
-</tr><tr>
- <td align=center><TT>|</tt></td><td align=center>¦</td>
- <td align=center><TT>p</tt></td><td align=center>¶</td>
- <td align=center><TT>A E</tt></td><td align=center>Æ</td>
- <td align=center><TT>: O</tt></td><td align=center>Ö</td>
- <td align=center><TT>a e</tt></td><td align=center>æ</td>
- <td align=center><TT>: o</tt></td><td align=center>ö
-</tr><tr>
- <td align=center><TT>&amp;</tt></td><td align=center>§</td>
- <td align=center><TT>.</tt></td><td align=center>·</td>
- <td align=center><TT>, C</tt></td><td align=center>Ç</td>
- <td align=center><TT>x</tt></td><td align=center>×</td>
- <td align=center><TT>, c</tt></td><td align=center>ç</td>
- <td align=center><TT>- :</tt></td><td align=center>÷
-</tr><tr>
- <td align=center><TT>:</tt></td><td align=center>¨</td>
- <td align=center><TT>,</tt></td><td align=center>¸</td>
- <td align=center><TT>E `</tt></td><td align=center>È</td>
- <td align=center><TT>O /</tt></td><td align=center>Ø</td>
- <td align=center><TT>` e</tt></td><td align=center>è</td>
- <td align=center><TT>o /</tt></td><td align=center>ø
-</tr><tr>
- <td align=center><TT>c</tt></td><td align=center>©</td>
- <td align=center><TT>1</tt></td><td align=center>¹</td>
- <td align=center><TT>' E</tt></td><td align=center>É</td>
- <td align=center><TT>` U</tt></td><td align=center>Ù</td>
- <td align=center><TT>' e</tt></td><td align=center>é</td>
- <td align=center><TT>` u</tt></td><td align=center>ù
-</tr><tr>
- <td align=center><TT>a</tt></td><td align=center>ª</td>
- <td align=center><TT>o</tt></td><td align=center>º</td>
- <td align=center><TT>^ E</tt></td><td align=center>Ê</td>
- <td align=center><TT>' U</tt></td><td align=center>Ú</td>
- <td align=center><TT>^ e</tt></td><td align=center>ê</td>
- <td align=center><TT>' u</tt></td><td align=center>ú
-</tr><tr>
- <td align=center><TT>&lt; &lt;</tt></td><td align=center>«</td>
- <td align=center><TT>&gt; &gt;</tt></td><td align=center>»</td>
- <td align=center><TT>: E</tt></td><td align=center>Ë</td>
- <td align=center><TT>^ U</tt></td><td align=center>Û</td>
- <td align=center><TT>: e</tt></td><td align=center>ë</td>
- <td align=center><TT>^ u</tt></td><td align=center>û
-</tr><tr>
- <td align=center><TT>~</tt></td><td align=center>¬</td>
- <td align=center><TT>1 4</tt></td><td align=center>¼</td>
- <td align=center><TT>` I</tt></td><td align=center>Ì</td>
- <td align=center><TT>: U</tt></td><td align=center>Ü</td>
- <td align=center><TT>` i</tt></td><td align=center>ì</td>
- <td align=center><TT>: u</tt></td><td align=center>ü
-</tr><tr>
- <td align=center><TT>-</tt></td><td align=center>­</td>
- <td align=center><TT>1 2</tt></td><td align=center>½</td>
- <td align=center><TT>' I</tt></td><td align=center>Í</td>
- <td align=center><TT>' Y</tt></td><td align=center>Ý</td>
- <td align=center><TT>' i</tt></td><td align=center>í</td>
- <td align=center><TT>' y</tt></td><td align=center>ý
-</tr><tr>
- <td align=center><TT>r</tt></td><td align=center>®</td>
- <td align=center><TT>3 4</tt></td><td align=center>¾</td>
- <td align=center><TT>^ I</tt></td><td align=center>Î</td>
- <td align=center><TT>T H</tt></td><td align=center>Þ</td>
- <td align=center><TT>^ i</tt></td><td align=center>î</td>
- <td align=center><TT>t h</tt></td><td align=center>þ
-</tr><tr>
- <td align=center><TT>_</tt></td><td align=center>¯</td>
- <td align=center><TT>?</tt></td><td align=center>¿</td>
- <td align=center><TT>: I</tt></td><td align=center>Ï</td>
- <td align=center><TT>s s</tt></td><td align=center>ß</td>
- <td align=center><TT>: i</tt></td><td align=center>ï</td>
- <td align=center><TT>: y</tt></td><td align=center>ÿ
-</table></center>
+<P><TT>Fl_Image</TT> is the base class used for caching and
+drawing all kinds of images in FLTK. This class keeps track of
+common image data such as the pixels, colormap, width, height,
+and depth. Virtual methods are used to provide type-specific
+image handling.</P>
+
+<P>Since the <TT>Fl_Image</TT> class does not support image
+drawing by itself, calling the <TT>draw()</TT> method results in
+a box with an X in it being drawn instead.</P>
<H3>Methods</H3>
-<CENTER>
-<TABLE width=90% summary="Fl_Input methods.">
-<TR><TD align=left valign=top>
-<UL>
-<LI><A href=#Fl_Input.Fl_Input>Fl_Input</A></LI>
-<LI><A href=#Fl_Input.~Fl_Input>~Fl_Input</A></LI>
-<LI><A href=#Fl_Input.cursor_color>cursor_color</A></LI>
-</UL>
-</TD><TD align=left valign=top>
-<UL>
-<LI><A href=#Fl_Input.index>index</A></LI>
-<LI><A href=#Fl_Input.size>size</A></LI>
-</UL>
-</TD><TD align=left valign=top>
-<UL>
-<LI><A href=#Fl_Input.static_value>static_value</A></LI>
-<LI><A href=#Fl_Input.textcolor>textcolor</A></LI>
-</UL>
-</TD><TD align=left valign=top>
-<UL>
-<LI><A href=#Fl_Input.textfont>textfont</A></LI>
-<LI><A href=#Fl_Input.textsize>textsize</A></LI>
-</UL>
-</TD><TD align=left valign=top>
-<UL>
-<LI><A href=#Fl_Input.value>value</A></LI>
-<LI><A href=#Fl_Input.when>when</A></LI>
-</UL>
-</TD></TR>
-</TABLE>
-</CENTER>
-<H4><A name=Fl_Input.Fl_Input>Fl_Input::Fl_Input(int x, int y, int w,
-int h, const char *label = 0)</A></H4>
- Creates a new <TT>Fl_Input</TT> widget using the given position, size,
-and label string. The default boxtype is <TT>FL_DOWN_BOX</TT>.
-<H4><A name=Fl_Input.~Fl_Input>virtual Fl_Input::~Fl_Input()</A></H4>
- Destroys the widget and any value associated with it.
-<H4><A name=Fl_Input.value>const char *Fl_Input::value() const
-<BR> int Fl_Input::value(const char*)
-<BR> int Fl_Input::value(const char*, int)</A></H4>
- The first form returns the current value, which is a pointer to the
-internal buffer and is valid only until the next event is handled.
-<P>The second two forms change the text and set the mark and the point
-to the end of it. The string is copied to the internal buffer. Passing <TT>
-NULL</TT> is the same as &quot;&quot;. This returns non-zero if the new value is
-different than the current one. You can use the second version to
-directly set the length if you know it already or want to put nul's in
-the text. </P>
-<H4><A name=Fl_Input.static_value>int Fl_Input::static_value(const
-char*)
-<BR> int Fl_Input::static_value(const char*, int)</A></H4>
- Change the text and set the mark and the point to the end of it. The
-string is <I>not</I> copied. If the user edits the string it is copied
-to the internal buffer then. This can save a great deal of time and
-memory if your program is rapidly changing the values of text fields,
-but this will only work if the passed string remains unchanged until
-either the <TT>Fl_Input</TT> is destroyed or <TT>value()</TT> is called
-again.
-<H4><A name=Fl_Input.size>int Fl_Input::size() const</A></H4>
- Returns the number of characters in <TT>value()</TT>. This may be
-greater than <TT>strlen(value())</TT> if there are nul characters in
-it.
-<H4><A name=Fl_Input.index>char Fl_Input::index(int) const</A></H4>
- Same as <TT>value()[n]</TT>, but may be faster in plausible
-implementations. No bounds checking is done.
-<H4><A name=Fl_Input.when>Fl_When Fl_Widget::when() const
-<BR> void Fl_Widget::when(Fl_When)</A></H4>
- Controls when callbacks are done. The following values are useful,
-the default value is <TT>FL_WHEN_RELEASE</TT>:
+
<UL>
-<LI><TT>0</TT>: The callback is not done, but <TT>changed()</TT> is
- turned on. </LI>
-<LI><TT>FL_WHEN_CHANGED</TT>: The callback is done each time the text
-is changed by the user. </LI>
-<LI><TT>FL_WHEN_RELEASE</TT>: The callback will be done when this
-widget loses the focus, including when the window is unmapped. This
-is a useful value for text fields in a panel where doing the callback
-on every change is wasteful. However the callback will also happen if
-the mouse is moved out of the window, which means it should not do
-anything visible (like pop up an error message). You might do better
-setting this to zero, and scanning all the items for <TT>changed()</TT>
- when the OK button on a panel is pressed. </LI>
-<LI><TT>FL_WHEN_ENTER_KEY</TT>: If the user types the Enter key, the
-entire text is selected, and the callback is done if the text has
-changed. Normally the Enter key will navigate to the next field (or
-insert a newline for a <TT>Fl_Mulitline_Input</TT>), this changes the
-behavior. </LI>
-<LI><TT>FL_WHEN_ENTER_KEY|FL_WHEN_NOT_CHANGED</TT>: The Enter key will
-do the callback even if the text has not changed. Useful for command
-fields. </LI>
+
+ <LI><A href="#Fl_Image.Fl_Image">Fl_Image</A></LI>
+
+ <LI><A href="#Fl_Image.~Fl_Image">~Fl_Image</A></LI>
+
+ <LI><A href="#Fl_Image.color_average">color_average</A></LI>
+
+ <LI><A href="#Fl_Image.copy">copy</A></LI>
+
+ <LI><A href="#Fl_Image.count">count</A></LI>
+
+ <LI><A href="#Fl_Image.d">d</A></LI>
+
+ <LI><A href="#Fl_Image.data">data</A></LI>
+
+ <LI><A href="#Fl_Image.desaturate">desaturate</A></LI>
+
+ <LI><A href="#Fl_Image.draw">draw</A></LI>
+
+ <LI><A href="#Fl_Image.draw_empty">draw_empty</A></LI>
+
+ <LI><A href="#Fl_Image.h">h</A></LI>
+
+ <LI><A href="#Fl_Image.inactive">inactive</A></LI>
+
+ <LI><A href="#Fl_Image.label">label</A></LI>
+
+ <LI><A href="#Fl_Image.ld">ld</A></LI>
+
+ <LI><A href="#Fl_Image.w">w</A></LI>
+
</UL>
-<H4><A name=Fl_Input.textcolor>Fl_Color Fl_Input::textcolor() const
-<BR> void Fl_Input::textcolor(Fl_Color)</A></H4>
- Gets or sets the color of the text in the input field.
-<H4><A name=Fl_Input.textfont>Fl_Font Fl_Input::textfont() const
-<BR> void Fl_Input::textfont(Fl_Font)</A></H4>
- Gets or sets the font of the text in the input field.
-<H4><A name=Fl_Input.textsize>uchar Fl_Input::textsize() const
-<BR> void Fl_Input::textsize(uchar)</A></H4>
- Gets or sets the size of the text in the input field.
-<H4><A name=Fl_Input.cursor_color>Fl_Color Fl_Input::cursor_color()
-const
-<BR> void Fl_Input::cursor_color(Fl_Color)</A></H4>
- Get or set the color of the cursor. This is black by default.
-
-</BODY></HTML>
+
+<H4><A NAME="Fl_Image.Fl_Image">Fl_Image(int W, int H, int D);</A></H4>
+
+<P>The constructor creates an empty image with the specified
+width, height, and depth. The width and height are in pixels.
+The depth is 0 for bitmaps, 1 for pixmap (colormap) images, and
+1 to 4 for color images.</P>
+
+<H4><A NAME="Fl_Image.~Fl_Image">virtual ~Fl_Image();</A></H4>
+
+<P>The destructor is a virtual method that frees all memory used
+by the image.</P>
+
+<H4><A NAME="Fl_Image.color_average">virtual void color_average(Fl_Color c, float i);</A></H4>
+
+<P>The <TT>color_average()</TT> method averages the colors in
+the image with the FLTK color value <TT>c</TT>. The <TT>i</TT>
+argument specifies the amount of the original image to combine
+with the color, so a value of 1.0 results in no color blend, and
+a value of 0.0 results in a constant image of the specified
+color. <I>The original image data is not altered by this
+method.</I></P>
+
+<H4><A NAME="Fl_Image.copy">virtual Fl_Image *copy(int W, int H);<BR>
+copy();</A></H4>
+
+<P>The <TT>copy()</TT> method creates a copy of the specified
+image. If the width and height are provided, the image is
+resized to the specified size.</P>
+
+<H4><A NAME="Fl_Image.count">int count();</A></H4>
+
+<P>The <TT>count()</TT> method returns the number of data values
+associated with the image. The value will be 0 for images with
+no associated data, 1 for bitmap and color images, and greater
+than 2 for pixmap images.</P>
+
+<H4><A NAME="Fl_Image.d">int d();<BR>
+protected void d(int D);</A></H4>
+
+<P>The first form of the <TT>d()</TT> method returns the current
+image depth. The return value will be 0 for bitmaps, 1 for
+pixmaps, and 1 to 4 for color images.</P>
+
+<P>The second form is a protected method that sets the current
+image depth.</P>
+
+<H4><A NAME="Fl_Image.data">const char * const *data();<BR>
+protected void data(const char * const *data, int count);</A></H4>
+
+<P>The first form of the <TT>data()</TT> method returns a
+pointer to the current image data array. Use the
+<TT>count()</TT> method to find the size of the data array.</P>
+
+<P>The second form is a protected method that sets the current
+array pointer and count of pointers in the array.</P>
+
+<H4><A NAME="Fl_Image.desaturate">virtual void desaturate()</A></H4>
+
+<P>The <TT>desaturate()</TT> method converts an image to
+grayscale. If the image contains an alpha channel (depth = 4),
+the alpha channel is preserved. <I>This method does not alter
+the original image data.</I></P>
+
+<H4><A NAME="Fl_Image.draw">void draw(int X, int Y);<BR>
+virtual void draw(int X, int Y, int W, int H, int cx, int cy);</A></H4>
+
+<P>The <TT>draw()</TT> methods draw the image. The first form
+specifies the upper-lefthand corner of the image. The second
+form specifies a bounding box for the image, with the origin
+(upper-lefthand corner) of the image offset by the <TT>cx</TT>
+and <TT>cy</TT> arguments.</P>
+
+<H4><A NAME="Fl_Image.draw_empty">protected void draw_empty(int X, int Y);</A></H4>
+
+<P>The protected method <TT>draw_empty()</TT> draws a box with
+an X in it. It can be used to draw any image that lacks image
+data.</P>
+
+<H4><A NAME="Fl_Image.h">int h();<BR>
+protected void h(int H);</A></H4>
+
+<P>The first form of the <TT>h()</TT> method returns the current
+image height in pixels.</P>
+
+<P>The second form is a protected method that sets the current
+image height.</P>
+
+<H4><A NAME="Fl_Image.inactive">void inactive();</A></H4>
+
+<P>The <TT>inactive()</TT> method calls
+<TT>color_average(FL_GRAY, 0.33f)</TT> to produce an image that
+appears grayed out. <I>This method does not alter the original
+image data.</I></P>
+
+<H4><A NAME="Fl_Image.label">virtual void label(Fl_Widget *w);
+virtual void label(Fl_Menu_Item *m);</A></H4>
+
+<P>The <TT>label()</TT> methods are an obsolete way to set the
+image attribute of a widget or menu item. Use the
+<TT>image()</TT> or <TT>deimage()</TT> methods of the
+<TT>Fl_Widget</TT> and <TT>Fl_Menu_Item</TT> classes
+instead.</P>
+
+<H4><A NAME="Fl_Image.ld">int ld();<BR>
+protected void ld(int LD);</A></H4>
+
+<P>The first form of the <TT>ld()</TT> method returns the current
+line data size in bytes. Line data is extra data that is included
+after each line of color image data and is normally not present.</P>
+
+<P>The second form is a protected method that sets the current
+line data size in bytes.</P>
+
+<H4><A NAME="Fl_Image.w">int w();<BR>
+protected void w(int W);</A></H4>
+
+<P>The first form of the <TT>w()</TT> method returns the current
+image width in pixels.</P>
+
+<P>The second form is a protected method that sets the current
+image width.</P>
+
+</BODY>
+</HTML>