pixmap->initialise

pixmap ->initialise: source=[image|file]*, width=[int], height=[int]

The initialisation of a pixmap can take three forms:

pixmap(@nil, foreground, background, width, height): Creates a read-write pixmap of specified dimensions with specified colours.
pixmap(image, [foreground], [background]): Creates a pixmap with specified colours of the same dimensions as the image and copies the image to the pixmap, where each 1 maps to a foreground and each 0 to a background pixel.
After doing so, it will establish a hyper object with names pixmap and image that relates the original image and the new pixmap. See also pixmap<-lookup and pixmap<-source.
pixmap(file, [foreground], [background]): Load the pixmap from a file. If the file is an image file, the colour will be used to map the 1's and 0's.