3 Image Library
An “image” object is a container for graphical images, typically small GUI objects such
as buttons, arrow heads, and other such graphical adornments.
3.1 new
image.new(str)
This function returns a new image object from a string input. The string consists of the
image header followed by the binary representation of the image pixels.
The header consists of 20 bytes of data arranged as presented in the following table. All
fields are little endian integers.
Table 1, Image header
Offset Width (bytes) Contents
0                     4 Pixel width of image
4                     4 Pixel height of image
8                     1 Image alignment (0)
9                     1 Flags (0)
10                   2 Pad (0)
12                   4 The number of bytes between successive raster lines
16                   2 The number of bits per pixel (16)
18                   2 Planes per bit (1)
The image pixel data immediately follows the header. Pixels are arranged in rows. Each
pixel is a little endian 16-bit integer with five bits for each color red, green, and blue. The
top bit determines if the pixel is drawn. If it is zero (0), the pixel is not drawn. If it is one
(1), the pixel is drawn in the RGB color of the remaining 15 bits.
0x8000 is black, 0x801F is blue, 0x83E0 is green, 0xFC00 is red, and 0xFFFF is white.