MAN page from Other perltk-800.022_5.00503-1.i386.rpm
BITMAP
Section: User Contributed Perl Documentation (1)
Updated: perl 5.005, patch 03
Index NAME
Tk::Bitmap - Images that display two colors
SYNOPSIS
$image =
$widget->
Bitmap?(
name??,
options?)
DESCRIPTION
A bitmap is an image whose pixels can display either of two colorsor be transparent.A bitmap image is defined by four things: a background color,a foreground color, and two bitmaps, called the
sourceand the
mask.Each of the bitmaps specifies 0/1 values for a rectangulararray of pixels, and the two bitmaps must have the samedimensions.For pixels where the mask is zero, the image displays nothing,producing a transparent effect.For other pixels, the image displays the foreground color ifthe source data is one and the background color if the sourcedata is zero.
CREATING BITMAPS
Bitmaps are created using
$widget->
Bitmap.Bitmaps support the following
options:
- -background => color
- Specifies a background color for the image in any of the standardways accepted by Tk. If this option is set to an empty stringthen the background pixels will be transparent. This effectis achieved by using the source bitmap as the mask bitmap, ignoringany -maskdata or -maskfile options.
- -data => string
- Specifies the contents of the source bitmap as a string.The string must adhere to X11 bitmap format (e.g., as generatedby the bitmap program).If both the -data and -file options are specified,the -data option takes precedence.
- -file => name
- name gives the name of a file whose contents define thesource bitmap.The file must adhere to X11 bitmap format (e.g., as generatedby the bitmap program).
- -foreground => color
- Specifies a foreground color for the image in any of the standardways accepted by Tk.
- -maskdata => string
- Specifies the contents of the mask as a string.The string must adhere to X11 bitmap format (e.g., as generatedby the bitmap program).If both the -maskdata and -maskfile options are specified,the -maskdata option takes precedence.
- -maskfile => name
- name gives the name of a file whose contents define themask.The file must adhere to X11 bitmap format (e.g., as generatedby the bitmap program).
IMAGE METHODS
When a bitmap image is created, Tk also creates a new object.This object supports the
configure and
cget methodsdescribed in the
Tk::options manpage which can be used to enquire andmodify the options described above.
SEE ALSO
Tk::ImageTk::PixmapTk::Photo
KEYWORDS
bitmap, image
Index
- NAME
- SYNOPSIS
- DESCRIPTION
- CREATING BITMAPS
- IMAGE METHODS
- SEE ALSO
- KEYWORDS
This document was created byman2html,using the manual pages.
