Doco updates.

Added filename_setext() macro for FLTK_1_0_COMPAT.

Fixed copy() methods so they don't overflow the source image buffer.


git-svn-id: file:///fltk/svn/fltk/branches/branch-1.1@2881 ea41ed52-d2ee-0310-a9c1-e6b18d33e121

2 files changed, 45 insertions, 0 deletions

diff --git a/documentation/drawing.html b/documentation/drawing.html
index c3f8d7ca8..e88eed887 100644
--- a/documentation/drawing.html
+++ b/documentation/drawing.html
@@ -46,6 +46,8 @@ following types of drawing functions:
 
 <UL>
 
+	<LI><A href="#boxdraw">Boxes</A></LI>
+
 	<LI><A href="#clipping">Clipping</A></LI>
 
 	<LI><A href="#colors">Colors</A></LI>
@@ -64,6 +66,45 @@ following types of drawing functions:
 
 </UL>
 
+<H3><A name="boxdraw">Boxes</A></H3>
+
+<P>FLTK provides three functions that can be used to draw boxes
+for buttons and other UI controls. Each function uses the
+supplied upper-lefthand corner and width and height to determine
+where to draw the box.
+
+<H4><A NAME="fl_draw_box">void fl_draw_box(Fl_Boxtype b, int x, int y, int w, int h, Fl_Color c);</A></H4>
+
+<P>The first box drawing function is <CODE>fl_draw_box()</CODE>
+which draws a standard boxtype <CODE>c</CODE> in the specified
+color <CODE>c</CODE>.
+
+<H4><A NAME="fl_frame">void fl_frame(const char *s, int x, int y, int w, int h);</A></H4>
+
+<P>The <CODE>fl_frame()</CODE> function draws a series of line
+segments around the given box. The string <CODE>s</CODE> must
+contain groups of 4 letters which specify one of 24 standard
+grayscale values, where 'A' is black and 'X' is white. The order
+of each set of 4 characters is: top, left, bottom, right. The
+results of calling <CODE>fl_frame()</CODE> with a string that is
+not a multiple of 4 characters in length are undefined.
+
+<P>The only difference between this function and
+<CODE>fl_frame2()</CODE> is the order of the line segments.
+
+<H4><A NAME="fl_frame2">void fl_frame2(const char *s, int x, int y, int w, int h);</A></H4>
+
+<P>The <CODE>fl_frame2()</CODE> function draws a series of line
+segments around the given box. The string <CODE>s</CODE> must
+contain groups of 4 letters which specify one of 24 standard
+grayscale values, where 'A' is black and 'X' is white. The order
+of each set of 4 characters is: bottom, right, top, left. The
+results of calling <CODE>fl_frame2()</CODE> with a string that is
+not a multiple of 4 characters in length are undefined.
+
+<P>The only difference between this function and
+<CODE>fl_frame()</CODE> is the order of the line segments.
+
 <H3><A name="clipping">Clipping</A></H3>
 
 <P>You can limit all your drawing to a rectangular region by calling
diff --git a/documentation/migration.html b/documentation/migration.html
index 9e50b0533..be0f283a1 100644
--- a/documentation/migration.html
+++ b/documentation/migration.html
@@ -92,6 +92,10 @@ symbol on the command-line when you compile
 	<TD>fl_filename_relative()</TD>
 </TR>
 <TR>
+	<TD>filename_setext()</TD>
+	<TD>fl_filename_setext()</TD>
+</TR>
+<TR>
 	<TD>frame()</TD>
 	<TD>fl_frame()</TD>
 </TR>