home *** CD-ROM | disk | FTP | other *** search
/ Chip 2000 May / Chip_2000-05_cd1.bin / zkuste / Perl / ActivePerl-5.6.0.613.msi / 䆊䌷䈹䈙䏵-䞅䞆䞀㡆䞃䄦䠥 / _d57d399a46bfc679a8bb7df7bb86812b < prev    next >
Text File  |  2000-03-23  |  5KB  |  138 lines
  1.  
  2. <HTML>
  3. <HEAD>
  4. <TITLE>Tk::Bitmap - Images that display two colors</TITLE>
  5. <LINK REL="stylesheet" HREF="../../../Active.css" TYPE="text/css">
  6. <LINK REV="made" HREF="mailto:">
  7. </HEAD>
  8.  
  9. <BODY>
  10. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  11. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  12. <STRONG><P CLASS=block> Tk::Bitmap - Images that display two colors</P></STRONG>
  13. </TD></TR>
  14. </TABLE>
  15.  
  16. <A NAME="__index__"></A>
  17. <!-- INDEX BEGIN -->
  18.  
  19. <UL>
  20.  
  21.     <LI><A HREF="#name">NAME</A></LI><LI><A HREF="#supportedplatforms">SUPPORTED PLATFORMS</A></LI>
  22.  
  23.     <LI><A HREF="#synopsis">SYNOPSIS</A></LI>
  24.     <LI><A HREF="#description">DESCRIPTION</A></LI>
  25.     <LI><A HREF="#creating bitmaps">CREATING BITMAPS</A></LI>
  26.     <LI><A HREF="#image methods">IMAGE METHODS</A></LI>
  27.     <LI><A HREF="#see also">SEE ALSO</A></LI>
  28.     <LI><A HREF="#keywords">KEYWORDS</A></LI>
  29. </UL>
  30. <!-- INDEX END -->
  31.  
  32. <HR>
  33. <P>
  34. <H1><A NAME="name">NAME</A></H1>
  35. <P>Tk::Bitmap - Images that display two colors</P>
  36. <P>
  37. <HR>
  38. <H1><A NAME="supportedplatforms">SUPPORTED PLATFORMS</A></H1>
  39. <UL>
  40. <LI>Linux</LI>
  41. <LI>Solaris</LI>
  42. <LI>Windows</LI>
  43. </UL>
  44. <HR>
  45. <H1><A NAME="synopsis">SYNOPSIS</A></H1>
  46. <P>    <EM>$image</EM> = <EM>$widget</EM>-><STRONG>Bitmap</STRONG>?(<EM>name</EM>??,<EM>options</EM>?)</P>
  47. <P>
  48. <HR>
  49. <H1><A NAME="description">DESCRIPTION</A></H1>
  50. <P>A bitmap is an image whose pixels can display either of two colors
  51. or be transparent.
  52. A bitmap image is defined by four things:  a background color,
  53. a foreground color, and two bitmaps, called the <EM>source</EM>
  54. and the <EM>mask</EM>.
  55. Each of the bitmaps specifies 0/1 values for a rectangular
  56. array of pixels, and the two bitmaps must have the same
  57. dimensions.
  58. For pixels where the mask is zero, the image displays nothing,
  59. producing a transparent effect.
  60. For other pixels, the image displays the foreground color if
  61. the source data is one and the background color if the source
  62. data is zero.</P>
  63. <P>
  64. <HR>
  65. <H1><A NAME="creating bitmaps">CREATING BITMAPS</A></H1>
  66. <P>Bitmaps are created using <EM>$widget</EM>-><STRONG>Bitmap</STRONG>.
  67. Bitmaps support the following <EM>options</EM>:</P>
  68. <DL>
  69. <DT><STRONG><A NAME="item_%2Dbackground_%3D%3E_color"><STRONG>-background</STRONG> => <EM>color</EM></A></STRONG><BR>
  70. <DD>
  71. Specifies a background color for the image in any of the standard
  72. ways accepted by Tk.  If this option is set to an empty string
  73. then the background pixels will be transparent.  This effect
  74. is achieved by using the source bitmap as the mask bitmap, ignoring
  75. any <STRONG>-maskdata</STRONG> or <STRONG>-maskfile</STRONG> options.
  76. <P></P>
  77. <DT><STRONG><A NAME="item_%2Ddata_%3D%3E_string"><STRONG>-data</STRONG> => <EM>string</EM></A></STRONG><BR>
  78. <DD>
  79. Specifies the contents of the source bitmap as a string.
  80. The string must adhere to X11 bitmap format (e.g., as generated
  81. by the <STRONG>bitmap</STRONG> program).
  82. If both the <STRONG>-data</STRONG> and <STRONG>-file</STRONG> options are specified,
  83. the <STRONG>-data</STRONG> option takes precedence.
  84. <P></P>
  85. <DT><STRONG><A NAME="item_%2Dfile_%3D%3E_name"><STRONG>-file</STRONG> => <EM>name</EM></A></STRONG><BR>
  86. <DD>
  87. <EM>name</EM> gives the name of a file whose contents define the
  88. source bitmap.
  89. The file must adhere to X11 bitmap format (e.g., as generated
  90. by the <STRONG>bitmap</STRONG> program).
  91. <P></P>
  92. <DT><STRONG><A NAME="item_%2Dforeground_%3D%3E_color"><STRONG>-foreground</STRONG> => <EM>color</EM></A></STRONG><BR>
  93. <DD>
  94. Specifies a foreground color for the image in any of the standard
  95. ways accepted by Tk.
  96. <P></P>
  97. <DT><STRONG><A NAME="item_%2Dmaskdata_%3D%3E_string"><STRONG>-maskdata</STRONG> => <EM>string</EM></A></STRONG><BR>
  98. <DD>
  99. Specifies the contents of the mask as a string.
  100. The string must adhere to X11 bitmap format (e.g., as generated
  101. by the <STRONG>bitmap</STRONG> program).
  102. If both the <STRONG>-maskdata</STRONG> and <STRONG>-maskfile</STRONG> options are specified,
  103. the <STRONG>-maskdata</STRONG> option takes precedence.
  104. <P></P>
  105. <DT><STRONG><A NAME="item_%2Dmaskfile_%3D%3E_name"><STRONG>-maskfile</STRONG> => <EM>name</EM></A></STRONG><BR>
  106. <DD>
  107. <EM>name</EM> gives the name of a file whose contents define the
  108. mask.
  109. The file must adhere to X11 bitmap format (e.g., as generated
  110. by the <STRONG>bitmap</STRONG> program).
  111. <P></P></DL>
  112. <P>
  113. <HR>
  114. <H1><A NAME="image methods">IMAGE METHODS</A></H1>
  115. <P>When a bitmap image is created, Tk also creates a new object.
  116. This object supports the <STRONG>configure</STRONG> and <STRONG>cget</STRONG> methods
  117. described in <A HREF="../../../site/lib/Tk/options.html">the Tk::options manpage</A> which can be used to enquire and
  118. modify the options described above.</P>
  119. <P>
  120. <HR>
  121. <H1><A NAME="see also">SEE ALSO</A></H1>
  122. <P><A HREF="../../../site/lib/Tk/Image.html">Tk::Image</A>
  123. <A HREF="../../../site/lib/Tk/Pixmap.html">Tk::Pixmap</A>
  124. <A HREF="../../../site/lib/Tk/Photo.html">Tk::Photo</A></P>
  125. <P>
  126. <HR>
  127. <H1><A NAME="keywords">KEYWORDS</A></H1>
  128. <P>bitmap, image</P>
  129. <TABLE BORDER=0 CELLPADDING=0 CELLSPACING=0 WIDTH=100%>
  130. <TR><TD CLASS=block VALIGN=MIDDLE WIDTH=100% BGCOLOR="#cccccc">
  131. <STRONG><P CLASS=block> Tk::Bitmap - Images that display two colors</P></STRONG>
  132. </TD></TR>
  133. </TABLE>
  134.  
  135. </BODY>
  136.  
  137. </HTML>
  138.