FL Boxtypes

FL_NO_BOX means nothing is drawn at all, so whatever is already on the screen remains. The FRAME types only draw their edges, leaving the center unchanged. In the above diagram the blue color is the area that is not drawn by the box.

It may be useful to know: FL_NO_BOX==0. "down" versions of "up" boxes can be achieved by adding 1 to the box id. "frame" versions of boxes can be achieved by adding 2 to the box id.

Many of the boxtype symbols are macros that call a function, this was done so that they are not linked in if not used. Linking in unused box types may be a problem if large numbers of them are added to FL. See Enumerations.H.

void fl_draw_box(uchar b,int x,int y,int w,int h,uchar c) ;

This function, declared in <FL/fl_draw.H>, draws boxtype b in the given bounding box and with color c.

Making your own Boxtypes

You can define your own boxtypes by making a small function that draws the box and adding a pointer to it to a table of boxtypes. Or you can replace existing boxtypes, replacing FL_UP_BOX, FL_DOWN_BOX, and FL_FLAT_BOX will allow you to completely change the appearance of your program. You can make the bevels thicker or thinner, change the colors of them, or use pixmaps or maybe GL gourand shanding to make nifty shiny buttons.

typedef void (Fl_BoxFunction)(int,int,int,int, uchar bgcolor);

This is the form of a boxtype function. It takes a bounding box and the color() of the object. You can ignore the color() if you want.

Here is the actual code for the FL_UP_FRAME and FL_UP_BOX types. See <FL/fl_draw.H> for the available drawing functions if you want your boxtype to be portable:

void fl_up_frame(int x, int y, int w, int h, uchar) {
  fl_color(FL_LIGHT3); fl_xyline(x+1, y+1, x+w-1);
  fl_color(FL_LIGHT2); fl_yxline(x+1, y+h-2, y+2, x+w-1);
  fl_color(FL_LIGHT1); fl_yxline(x+2, y+h-3, y+3, x+w-2);
  fl_color(FL_DARK1); fl_xyline(x+3, y+h-4, x+w-3, y+2);
  fl_color(FL_DARK2); fl_xyline(x+2, y+h-3, x+w-2, y+1);
  fl_color(FL_DARK3); fl_xyline(x+1, y+h-2, x+w-1);
  fl_color(FL_GRAY0); fl_rect(x,y,w,h);
}

void fl_up_box(int x, int y, int w, int h, uchar c) {
  fl_up_frame(x,y,w,h,c);
  fl_color(c); fl_rectf(x+3,y+4,w-6,h-8);
}

Fl_BoxFunction* Fl::get_boxtype(uchar);

Return the function for a boxtype.

uchar Fl::set_boxtype(uchar n, Fl_BoxFunction*);

Replace the function for boxtype n. Returns n.

uchar Fl::set_boxtype(uchar n, uchar from);

Copy one boxtype to another. This copies the deltas as well as the function. If you like thin edges this will globally replace them:

Fl::set_boxtype(FL_UP_BOX,FL_THIN_UP_BOX);
Fl::set_boxtype(FL_DOWN_BOX,FL_THIN_DOWN_BOX);
Fl::set_boxtype(FL_UP_FRAME,FL_THIN_UP_FRAME);
Fl::set_boxtype(FL_DOWN_FRAME,FL_THIN_DOWN_FRAME);

uchar Fl::set_boxtype(Fl_BoxFunction*);

FL selects an unused boxtype, sets it to the given string, and returns it.

void Fl::set_box_deltas(uchar n, uchar dx, uchar dy, uchar dw, uchar dh);

Set amounts to add to the x and y of a box, and to subtract from the width and height, to get the "inside". These values are used by some objects to draw their contents.

(back to contents)