data

Returns image data in the form of a string. The following options may be specified:

• :background color If the color is specified, the data will not contain any transparency information. In all transparent pixels the color will be replaced by the specified color.

• :format format-name Specifies the name of the image file format handler to be used. Specifically, this subcommand searches for the first handler whose name matches an initial substring of format-name and which has the capability to read this image data. If this option is not given, this subcommand uses the first handler that has the capability to read the image data.

• :from [x1, y1, x2, y2] Specifies a rectangular region of imageName to be returned. If only x1 and y1 are specified, the region extends from (x1,y1) to the bottom-right corner of imageName. If all four coordinates are given, they specify diagonally opposite corners of the rectangular region, including x1,y1 and excluding x2,y2. The default, if this option is not given, is the whole image.

• :grayscale If this options is specified, the data will not contain color information. All pixel data will be transformed into grayscale.