The London Perl and Raku Workshop takes place on 26th Oct 2024. If your company depends on Perl, please consider sponsoring and/or attending.
=pod

=head1 NAME

FLTK::Box - Define your own values for L<C<box()>|FLTK::Widget/"box"> on a
widget by making one of these

=head1 Description



=head1 Functions

=head2 C<BORDER_BOX>
X<BORDER_BOX>

=over

=item C<my $box = FLTK::BORDER_BOX( );>X<my_box_FLTK_BORDER_BOX_>

1-pixel thick gray line around rectangle.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 119

=back

=head2 C<DOWN_BOX>
X<DOWN_BOX>

=over

=item C<my $down = FLTK::DOWN_BOX( );>X<my_down_FLTK_DOWN_BOX_>

Inset box in fltk's standard theme.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 83

=back

=head2 C<EMBOSSED_BOX>
X<EMBOSSED_BOX>

=over

=item C<my $box = FLTK::EMBOSSED_BOX( );>X<my_box_FLTK_EMBOSSED_BOX_>

2-pixel thick raised line around edge.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 115

=back

=head2 C<ENGRAVED_BOX>
X<ENGRAVED_BOX>

=over

=item C<my $box = FLTK::ENGRAVED_BOX( );>X<my_box_FLTK_ENGRAVED_BOX_>

2-pixel thick engraved line around edge.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 111

=back

=head2 C<FLAT_BOX>
X<FLAT_BOX>

=over

=item C<my $flat = FLTK::FLAT_BOX( );>X<my_flat_FLTK_FLAT_BOX_>

Draws a flat rectangle of L<C<getbgcolor()>|/"getbgcolor">.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 87

=back

=head2 C<HIGHLIGHT_DOWN_BOX>
X<HIGHLIGHT_DOWN_BOX>

=over

=item C<my $box = FLTK::HIGHLIGHT_DOWN_BOX( );>X<my_box_FLTK_HIGHLIGHT_DOWN_BOX_>

Draws nothing normally, and as L<C<THIN_DOWN_BOX>|/"THIN_DOWN_BOX"> when the
mouse pointer points at it or the value of the widget is turned on.

=pod 

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 128

=back

=head2 C<HIGHLIGHT_UP_BOX>
X<HIGHLIGHT_UP_BOX>

=over

=item C<my $box = FLTK::HIGHLIGHT_UP_BOX( );>X<my_box_FLTK_HIGHLIGHT_UP_BOX_>

Draws nothing normally, and as L<C<THIN_UP_BOX>|/"THIN_UP_BOX"> when the mouse
pointer points at it or the value of the widget is turned on.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 123

=back

=head2 C<NO_BOX>
X<NO_BOX>

=over

=item C<my $none = FLTK::NO_BOX( );>X<my_none_FLTK_NO_BOX_>

Draws nothing.

Can be used as a box to make the background of a widget invisible. Also some
widgets check specifically for this and change their behavior or drawing
methods.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 91

=back

=head2 C<THIN_DOWN_BOX>
X<THIN_DOWN_BOX>

=over

=item C<my $down = FLTK::THIN_DOWN_BOX( );>X<my_down_FLTK_THIN_DOWN_BOX_>

1-pixel-thick inset box.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 103

=back

=head2 C<THIN_UP_BOX>
X<THIN_UP_BOX>

=over

=item C<my $up = FLTK::THIN_UP_BOX( );>X<my_up_FLTK_THIN_UP_BOX_>

1-pixel-thick raised box.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 107

=back

=head2 C<UP_BOX>
X<UP_BOX>

=over

=item C<my $up = FLTK::UP_BOX( );>X<my_up_FLTK_UP_BOX_>

Up button in fltk's standard theme.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 99

=back

=head2 C<_draw>
X<_draw>

=over

=item C<$box-E<gt>_draw( $rect );>X<_box_E_gt__draw_rect_>



=for hackers xs/Box.xs line 30

=back

=head2 C<drawframe>
X<drawframe>

=over

=item C<$box-E<gt>drawframe( $s, $x, $y, $w, $h );>X<_box_E_gt_drawframe_s_x_y_w_h_>

Draw a spiral, useful as a box edge, starting with the bottom edge and going
in a counter-clockwise direction, from the outside in toward the center. The
string is interpreted to get a gray shade: A is black, X is white, and all
other letters are 24 possible steps of gray shade, and R is the normal
background color of C<GRAY75>. A leading '2' makes it start with the top edge,
which will reverse exactly which pixels are drawn in the corner.

Emulates the fltk1 C<fl_frame2()> function.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 42

=back

=head2 C<drawframe2>
X<drawframe2>

=over

=item C<$box-E<gt>drawframe2( $s, $x, $y, $w, $h );>X<_box_E_gt_drawframe2_s_x_y_w_h_>

Draw a spiral similar to L<C<drawframe()>|/"drawframe">, but starts with the
top edge and goes counter-clockwise.

Emulates the fltk1 C<fl_frame()> function.

Import this function with the C<:box> tag.

=for hackers xs/Box.xs line 53

=back

=head1 Author

Sanko Robinson <sanko@cpan.org> - http://sankorobinson.com/

=head1 License and Legal

Copyright (C) 2008-2010 by Sanko Robinson <sanko@cpan.org>

This program is free software; you can redistribute it and/or modify it under
the terms of
L<The Artistic License 2.0|http://www.perlfoundation.org/artistic_license_2_0>.
See the F<LICENSE> file included with this distribution or
L<notes on the Artistic License 2.0|http://www.perlfoundation.org/artistic_2_0_notes>
for clarification.

When separated from the distribution, all original POD documentation is
covered by the
L<Creative Commons Attribution-Share Alike 3.0 License|http://creativecommons.org/licenses/by-sa/3.0/us/legalcode>.
See the
L<clarification of the CCA-SA3.0|http://creativecommons.org/licenses/by-sa/3.0/us/>.


=for git $Id: Box.xs c629eeb 2010-09-27 04:12:30Z sanko@cpan.org $

=cut