", Hyphenation = on, Consecutive Hyphens = 2, Vert. Just. = off> ", Level 1 Show = no, Level 2 Suffix = , Level 2 Starting Value = 0, Level 2 Show = no> ", Level 1 Show = no, Level 2 Suffix = "<#04>"> ", Level 1 Show = no, Level 2 Suffix = > ", Level 1 Show = no, Level 2 Suffix = "<#04>"> Images ) (E10,0,0,0,1,0,0.053333,1,15,0,0,1,0,0,0,0,1,0,1,0.066667,0.066667,6,6,0,0.066 667,6))> Images ) (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066 667,6))> <|,"7<#1e>81"> IMAGES ) (E10,0,0,0,1,0,0.053333,1,15,0,0,1,0,0,0,0,1,0,1,0.066667,0.066667,6,6,0,0.066 667,6))> ) (T8,2,12,0.026667,0.733333,0,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,10 2,1101,3, <"table"> ) (T8,3,12,0.066667,0.6,0,1,0.333333,0,516,0,17,0,0,0,0,0,0,1,1,2048,512,102,110 1,3, ) (g9,5,0 (p7,5,8,19 (g9,5,0 (g9,5,0 (v4,5,0,0.266667,0,1.6,0,17,1,0) (v4,6,0,1.6,0,1.6,0.933333,17,1,0) (v4,7,0,1.6,0.933333,0.266667,0.933333,17,1,0) (v4,8,0,0.266667,0.933333,0.266667,0,17,1,0)))) (g9,10,8 (p7,10,1032,13 (g9,10,0 (g9,10,0 (v4,10,0,1.183159,0.934816,1.497546,0.296785,17,1,0) (v4,11,0,1.497546,0.296785,1.497546,0.146666,17,1,0) (v4,12,0,1.497546,0.146666,0.846316,0.146666,17,1,0) (v4,13,0,0.846316,0.146666,0.846316,0.371849,17,1,0) (v4,14,0,0.846316,0.371849,1.04842,0.371849,17,1,0) (v4,15,0,1.04842,0.371849,1.04842,0.296785,17,1,0) (v4,16,0,1.04842,0.296785,1.29544,0.296785,17,1,0) (v4,17,0,1.29544,0.296785,0.981051,0.934816,17,1,0) (v4,18,0,0.981051,0.934816,1.183159,0.934816,17,1,0)))) (g9,19,2048 (v4,19,33,0.846316,0.146666,0.846316,0.146666,17,0,0) (v4,20,33,0.846316,1.16,0.846316,1.16,17,0,0) (v4,21,33,1.52,1.16,1.52,1.16,17,0,0) (v4,22,33,1.52,0.146666,1.52,0.146666,17,0,0)))) (E10,0,0,0,1,1,0.053333,1,15,0,0,1,0,0,0,0,1,1,1,0.066667,0.066667,6,6,0,0.066 667,6))> Introduction7.1<#04>The X protocol provides for the transfer of images (two<#1e>dimensional arraysof pixel data) between a client program and a drawable. The format forimage data can vary considerably. In order to present a uniform datarepresentatio n for the manipulation of a variety of images, CLX defines aspecial im age data type. Additional image subtypes <#1f> image<#1e>xy and image<#1e>z<#1f> allow for the representation of an image either as a sequence of bitplanes or as an array of pixels. CLX includes functions for accessing imageobjects; for transferring image data between image objects, drawables , andfiles; and also for direct transfer of raw image data. Image Types7.2<#04>The image data type is the base type for all image objects. image<#1e>xy and image<#1e>z are subtypes of the image type which furnish accessors specialized for different image representations. Basic Images7.2.1<#04>The following paragraphs describe the CLX functions that can be used to access all types of image objects. image<#1e>blue<#1e>mask imageFunctionblue<#1e>mask", Sort String = "image<#1e>blue<#1e>mask"> Returns:
mask <#1f> Type pixel or null. Returns (and with setf) changes the mask that selects the pixel subfieldfor blue intensity values. The mask is non<#1e>nil only for images for:direct<#1e>color or :true<#1e>color visual types. image <#1f> An image object. image<#1e>depth imageFunctiondepth", Sort String = "image<#1e>depth"> Returns:
depth <#1f> Type card8. Returns the depth (that is, the number of bits per pixel) for the image. image <#1f> An image object. image<#1e>green<#1e>mask imageFunctiongreen<#1e>mask", Sort String = "image<#1e>green<#1e>mask"> Returns:
mask <#1f> Type pixel or null. Returns (and with setf) changes the mask that selects the pixel subfieldfor green intensity values. The mask is non<#1e>nil only for images for:direct<#1e>color or :true<#1e>colo r visual types. image <#1f> An image object. <|,"7<#1e>82">image<#1e>height imageFunctionheight", Sort String = "image<#1e>height"> Returns:
height <#1f> Type card16. Returns the height of the image in pixels. image <#1f> An image object. image<#1e>name imageFunctionname", Sort String = "image<#1e>name"> Returns:
name <#1f> Type stringable or null. Returns and (with setf) changes the name string optionally associated withthe image. image <#1f> An image object. image<#1e>plist imageFunctionplist", Sort String = "image<#1e>plist"> Returns:
plist <#1f> Type list. Returns and (with setf) changes the image property list. The property listis a hook for added application extensions. image <#1f> An image object. image<#1e>red<#1e>mask imageFunctionred<#1e>mask", Sort String = "image<#1e>red<#1e>mask"> Returns:
mask <#1f> Type pixel or null. Returns (and with setf) changes the mask which selects the pixel subfieldfor red intensity values. The mask is non<#1e>nil only for images for:direct<#1e>color or :true<#1e>color visual types. image <#1f> An image object. image<#1e>width imageFunctionwidth", Sort String = "image<#1e>width"> Returns:
width <#1f> Type card16. Returns the width of the image in pixels. image <#1f> An image object. image<#1e>x<#1e>hot imageFunctionx<#1e>hot", Sort String = "image<#1e>x<#1e>hot"> Returns:
x<#1e>position <#1f> Type card16 or null. Returns and (with setf) changes the x position of the hot spot for an imageused as a cursor glyph. The hot spot position is specified relative to theupper<#1e>left origin of the image. image <#1f> An image object. image<#1e>y<#1e>hot imageFunctiony<#1e>hot", Sort String = "image<#1e>y<#1e>hot"> Returns:
y<#1e>position <#1f> Type card16 or null. Returns and (with setf) changes the y position of the hot spot for an imageused as a cursor glyph. The hot spot position is specified relative to theupper<#1e>left origin of the image. image <#1f> An image object. <|,"7<#1e>83"> XY<#1e>Format7.2.2<#04>The image<#1e>xy subtype represents an image as a sequence of bitmaps, Imagesone foreach plane of the image, in most<#1e>signi ficant to least<#1e>significant bit order.The following paragraphs describe the additional CLX functions that can be used toaccess image<#1e> xy objects. image<#1e>xy<#1e>bitmap<#1e>list imageFunctionxy<#1e>bitmap<#1e>list", Sort String = "image<#1e>xy<#1e>bitmap<#1e>list"> Returns:
bitmaps <#1f> Type list of bitmap. Returns and (with setf) changes the list of bitmap planes for the image. image <#1f> An image<#1e>xy object. Z<#1e>Format7.2.3<#04>The image<#1e>z subtype represents an image as a two<#1e>dimensional array Imagesofpixels, in scanline order. The following paragraphs describe the additional CLXfunctions that can be used to access image<#1e>z objects. image<#1e>z<#1e>bits<#1e>per<#1e>pixel imageFunctionz<#1e>bits<#1e>per<#1e>pixel", Sort String = "image<#1e>z<#1e>bits<#1e>per<#1e>pixel"> Returns:
pixel<#1e>data<#1e>size <#1f> One of 1, 4, 8, 16, 24, or 32. Returns and (with setf) changes the number of bits per data unit used tocontain a pixel value for the image. Depending on the storage format forimage data, this value can be larger than the actual image depth. image <#1f> An image<#1e>z object. image<#1e>z<#1e>pixarray imageFunctionz<#1e>pixarray", Sort String = "image<#1e>z<#1e>pixarray"> Returns:
pixarray <#1f> Type pixarray. Returns and (with setf) changes the two<#1e>dimensional array of pixel data forthe image. image <#1f> An image<#1e>z object. Image Functions7.3<#04>The following paragraphs describe the CLX functions used to: wCreate an image object. wCopy an image or a subimage. wRead an image from a drawable. wDisplay an image to a drawable. create<#1e>image &key :bit<#1e>lsb<#1e>first<#1e>p :bits<#1e>per<#1e> pixel :blue<#1e>mask Functionimage", Sort String = "create<#1e>image", To Next>
:byte<#1e>lsb<#1e>first<#1e>p :bytes<#1e>per<#1e>line :data :depth :format
:green<#1e>mask :height :name :plist :red<#1e>mask :width
:x<#1e>hot :y<#1e>hot Returns:
image <#1f> Type image. Creates an image object from the given :data and returns either an image,image<#1e>xy, or an image<#1e> z, depending on the type of image :data. If the :data is a list, it is assumed to be a list of bitmaps and an image<#1e>xy iscreated. If the :data is a pixarray, an image<#1e>z is created.Otherwise, the :data must be an array of bytes (card8), in which case abasic image object is created. <|,"7<#1e>84">If the :data is a list, each element must be a bitmap of equal size.:width and :height default to the bitmap width <#1f> (array<#1e>dimension bitmap1 ) <#1f> and the bitmap height <#1f> (array<#1e>dimension bitmap 0) <#1f> respectively. :depth defaults to the number of bitmaps. If the :data is a pixarray, :width and :heig ht default to the pixarray width <#1f> (array<#1e>dimension pixarray 1), and the pixarray height <#1f> (array<#1e>dimension pixarray 0), respectively. :depth defaults to (pixarray<#1e>depth :data). The :bits<#1e>per<#1e>pi xel is rounded to a valid size, ifnecessary. By default, the :bits<#1e>per<#1e>pixel is equal to the :depth. If the :data is an array of card8, the :width and :height are requiredto interpret the image data correctly. The :bits<#1e>per<#1e>pixel defaults to the:depth , and the :depth defaults to 1. :bytes<#1e>per<#1e>line defaults to: (floor(length :data) (* :bits<#1e>per<#1e>pixel :height)) The :format defines the storageformat of image data bytes and can be one of the following values: w:xy<#1e>pixmap <#1f> The :data is organized as a set of bitmaps representingimage bit planes, appearing in most<#1e>significant to least<#1e>significant bit order. w:z<#1e>pixmap <#1f> The :data is organized as a set of pixel values inscanline order. w:bitmap <#1f> Similar to :xy<#1e>pixmap, except that the :depth must be 1, and 1 and 0 bits represent the foreground and background pixels, respectively. By default, the :format is :bitmap if :depth is 1; otherwise, :z<#1e>pixmap. :bit<#1e>lsb<#1e>first<#1e>p <#1f> For a returned image, true if the order of bits in each :data byte is least<#1e>significant bit first. :bits<#1e>per<#1e>pixel <#1f> One of 1, 4, 8, 16, 24, or 32. :blue<#1e>mask <#1f> For :true<#1e>color or :direct<#1e> color images, a pixel mask. :byte<#1e>lsb<#1e>first<#1e>p <#1f> For a returned image, true if the :data byte order isleast<#1e>significant byte first. :bytes<#1e>per<#1e>line <#1f> For a returned image, the number of :data bytes perscanline. :data <#1f> Either a list of bitmaps, a pixarray, or an array ofcard8 bytes. :depth <#1f> The number of bits per displayed pixel. :format <#1f> One of :bitmap, :xy<#1e>format, or :z<#1e>format. :green<#1e>mask <#1f> For :true<#1e>color or :direct<#1e> color images, a pixel mask. :height <#1f> A card16 for the image height in pixels. :name <#1f> An optional stringable for the image name. :plist <#1f> An optional image property list. :red<#1e>mask <#1f> For :true<#1e>color or :direct<#1e> color images, a pixel mask. :width <#1f> A card16 for the image width in pixels. :x<#1e>hot <#1f> For a cursor image, the x position of the hot spot. :y<#1e>hot <#1f> For a cursor image, the y position of the hot spot. <|,"7<#1e>85">copy<#1e>image image &key (:x 0) (:y 0) :width :height :result<#1e>type Functionimage", Sort String = "copy<#1e>image"> Returns:
new<#1e>image <#1f> Type image. Returns a new image, of the given :result<#1e>type, containing a copy of theportion of the image defined by :x, : y, :width, and :height. By default,:width is: (- (image<#1e>width image) :x) and :height is: (- (image<#1e>height image):y) If necessary, the new image is converted to the :result<#1e>type, that can be one of the following values: w'image<#1e>x <#1f> A basic image object is returned. w'image<#1e>xy <#1f> An image<#1e>xy is returned. w'image<#1e>z <#1f> An image<#1e>z is returned. image <#1f> An image object. :x, :y <#1f> card16 values defining the position of the upper<#1e>left corner of the subimage copied. :width, :height <#1f> card16 values defining the size of subimage copied. :result<#1e>type <#1f> One of 'image<#1e>x, 'image<#1e> xy, or 'image<#1e>z. get<#1e>image drawable &key :x :y :widt h :height :plane<#1e>mask Functionimage", Sort String = "get<#1e>image", To Next>
(:format :z<#1e>format) :result<#1e>type Returns:
image <#1f> Type image. Returns an image containing pixel values from the region of the drawable givenby :x, :y, :width , and :height. The bits for all planes selected by 1 bitsin the :plane<#1e>mask are returned as zero; the default :plane<#1e>mask is all 1bits. The :format of the returned pixel values may be either :xy<#1e>format or:z<#1e>format. <|,"7<#1e>86">The :result<#1e>type defines the type of image object returned: w'image<#1e>x <#1f> A basic image object is returned. w'image<#1e>xy <#1f> An image<#1e>xy is returned. w'image<#1e>z <#1f> An image<#1e>z is returned. By default, :result<#1e>type is 'image<#1e>z if :forma t is :z<#1e>format and 'image<#1e>xy if :format is :xy<#1e>format. drawable <#1f> A drawable. :x, :y <#1f> card16 values defining the upper<#1e>left drawable pixel returned. These arguments are required. :width, :height <#1f> card16 values defining the size of the image returned. These arguments are required. :plane<#1e>mask <#1f> A pixel mask. :format <#1f> Either :xy<#1e>pixmap or :z<#1e>pixmap . :result<#1e>type <#1f> One of 'image<#1e>x, 'image<#1e> xy, or 'image<#1e>z. put<#1e>image drawable gcontext image &key (:src<#1e>x 0) (:src<#1e>y 0) :x :y Func tionimage", Sort String = "put<#1e>image">
:width :height :bitmap<#1e>p Displays a region of the image defined by :src<#1e>x, :src<#1e>y, :width, and:height on the destination drawable, with the upper<#1e>left pixel of the imageregion displayed at the drawable position given by :x and :y. By default,:width is: (- (image<#1e>width image) :src<#1e>x) and :height is: (- (image<#1e>heightimage) :src<#1e>y) The following attributes of the gcontext are used to display the image:clip<#1e>mask, clip<#1e>x, clip<#1e>y, function, plane<#1e>mask, and subwindow<#1e>mode. The :bitmap<#1e>p argument applies only to images of depth 1. In this case, if:bitmap<#1e>p is true or if the image is a basic image object created with:format :bitmap, the image is combined with the foreground andbackground pixels of the gcontext. 1 bits of the image are displayed in theforeground pixel and 0 bits are displayed in the background pixel. drawable <#1f> The destination drawable. gcontext <#1f> The graphics context used to display the image. image <#1f> An image object. :src<#1e>x, :src<#1e>y <#1f> card16 values defining the upper<#1e>left position of the image region to display. :x, :y <#1f> The position in the drawable where the image region is displayed. These arguments are required. :width, :height <#1f> card16 values defining the size of the image region displayed. :bitmap<#1e>p <#1f> If image is depth 1, then if true, foreground and background pixels are used to display 1 and 0 bits of the image. <|,"7<#1e>87"> Image Files7.4<#04>CLX provides functions that allow images to be written to a file in a standard X format. The following paragraphs describe the CLX functions used to: wRead an image from a file. wWrite an image to a file. read<#1e>bitmap<#1e>file pathname Functionbitmap<#1e>file", Sort String = "read<#1e>bitmap<#1e>file"> Returns:
image <#1f> Type image. Reads an image file in standard X format and returns an image object. The returned image can have depth greater than one. pathname <#1f> An image file pathname. write<#1e>bitmap<#1e>file pathname image &optional name Functionbitmap<#1e>file", Sort String = "write<#1e>bitmap<#1e>file"> Writes the image to an image file in standard X format. The image can have depth greater than one. The name is an image identifier written to the file; the default name is (or (image<#1e>name image) 'image). pathname <#1f> An image file pathname. image <#1f> An image object. name <#1f> A stringable image name. Direct Image 7.5<#04>For cases where the image representation is not needed, CLX provides Transferfunctions to read and display image data directly. get<#1e>raw<#1e>image drawable &key :data (:start 0) :x :y :width :heightFunctionraw<#1e>image", Sort String = "get<#1e>raw<#1e>image", To Next>
:plane<#1e>mask (:format :z<#1e>format) (:result<#1e>type '(vector card8)) Returns:
data <#1f> Type sequence or card8.
depth <#1f> Type card8.
visual <#1f> Type card29. Returns a sequence of image data from the region of the drawable given by:x, :y, :width, and :height . If :data is given, it is modifiedbeginning with the element at the :start index and returned. The depth andvisual type ID of the drawable are also returned. The bits for all planes selected by 1 bits in the :plane<#1e>mask are returnedas zero; the default :plane<#1e>mask is all 1 bits. The :format of the returnedpixel values may be either :xy<#1e>format or :z<#1e>format. The :result<#1e>type defines the type of image data returned. The calling program is responsible for handling the byte<#1e>order and bit<#1e>orderreturned by the server for the drawable's display (see display<#1e>byte<#1e>orderand display<#1e>image <#1e>lsb<#1e>first<#1e>p). drawable <#1f> A drawable. :data <#1f> An optional sequence of card8. :start <#1f> The index of the first :data element modified. :x, :y <#1f> card16 values defining the size of the image returned. These arguments are required. <|,"7<#1e>88">:width, :height <#1f> card16 values defining the size of the image returned.These arguments are required. :plane<#1e>mask <#1f> A pixel mask. :format <#1f> Either :xy-pixmap or :z-pixmap. This argument is required. :result<#1e>type <#1f> The type of image data sequence to return. put<#1e>raw<#1e>image drawable gcontext data &key (:start 0) :depth :x :y Functionraw<#1e>image", Sort String = "put<#1e>raw<#1e>image">
:width :height (:left<#1e>pad 0) :format Displays a region of the image data defined by :start, :left<#1e> pad, :width,and :height on the destination dr awable, with the upper<#1e>left pixel of theimage region displayed at the drawable position given by :x and :y. The :format can be either :xy<#1e>pixmap, :z<#1e>pixma p, or :bitmap. If :xy<#1e>pixmapor :z<#1e>pix map formats are used, :depth must match the depth of thedestination drawable. For :xy<#1e>pixmap, the data must be in XY format. For:z<#1e>pixmap, the data must be in Z format for the given :depth. If the :format is :bitmap, the :depth must be 1. In this case, theimage is combined with the foreground and background pixels of the gcontext. 1 bits of the image are displayed in the foreground pixel and 0 bits aredisplayed in the background pixel. The :left<#1e>pad must be zero for :z<#1e>pixmap format. For :bitmap and :xy<#1e>pixmapformats, the :left<#1e>pad must be less than the bitmap<#1e>scanline<#1e>pad for thedrawable's display (see display<#1e>bitmap<#1e>format ). The first :left<#1e>pad bits inevery scanline are to be ignored by the server; the actual image begins thatmany bits into the data. The following attributes of the gcontext are used to display the image:clip<#1e>mask, clip<#1e>x, clip<#1e>y, function, plane<#1e>mask, and subwindow<#1e>mode. The calling program is responsible for handling the byte<#1e>order and bit<#1e>orderrequired by the server for the drawable's display (see display<#1e>byte<#1e>orderand display<#1e>image <#1e>lsb<#1e>first<#1e>p). drawable <#1f> The destination drawable. gcontext <#1f> The graphics context used to display the image. data <#1f> A sequence of integers. :start <#1f> The index of the first element of data displayed. :depth <#1f> The number of bits per pixel displayed. This argument is required. :x, :y <#1f> The position in the drawable where the image region is displayed. These arguments are required. :width, :height <#1f> card16 values defining the size of the image region displayed. These arguments are required. :left<#1e>pad <#1f> A card8 specifying the number of leading bits to discard for each image scanline. :format <#1f> One of :bitmap, :xy<#1e>pixmap, or :z<#1e>pixmap. .