1. NAME

ImageByteOrder, BitmapBitOrder, BitmapPad, BitmapUnit, DisplayHeight, DisplayHeightMM, DisplayWidth, DisplayWidthMM, XListPixmapFormats, XPixmapFormatValues - image format functions and macros

2. SYNTAX

XPixmapFormatValues *XListPixmapFormats(Display *display, int *count_return); int ImageByteOrder(Display *display); int BitmapBitOrder(Display *display); int BitmapPad(Display *display); int BitmapUnit(Display *display); int DisplayHeight(Display *display, int screen_number); int DisplayHeightMM(Display *display, int screen_number); int DisplayWidth(Display *display, int screen_number); int DisplayWidthMM(Display *display, int screen_number);

3. ARGUMENTS

display 1i Specifies the connection to the X server.

count_return 1i Returns the number of \*(Cn.

screen_number 1i Specifies the appropriate screen number on the host server.

4. DESCRIPTION

The .ZN XListPixmapFormats function returns an array of .ZN XPixmapFormatValues structures that describe the types of Z format images supported by the specified display. If insufficient memory is available, .ZN XListPixmapFormats returns NULL. To free the allocated storage for the .ZN XPixmapFormatValues structures, use .ZN XFree .

The .ZN ImageByteOrder macro specifies the required byte order for images for each scanline unit in XY format (bitmap) or for each pixel value in Z format.

The .ZN BitmapBitOrder macro returns .ZN LSBFirst or .ZN MSBFirst to indicate whether the leftmost bit in the bitmap as displayed on the screen is the least or most significant bit in the unit.

The .ZN BitmapPad macro returns the number of bits that each scanline must be padded.

The .ZN BitmapUnit macro returns the size of a bitmap's scanline unit in bits.

The .ZN DisplayHeight macro returns the height of the specified screen in pixels.

The .ZN DisplayHeightMM macro returns the height of the specified screen in millimeters.

The .ZN DisplayWidth macro returns the width of the screen in pixels.

The .ZN DisplayWidthMM macro returns the width of the specified screen in millimeters.

5. STRUCTURES

The .ZN XPixmapFormatValues structure provides an interface to the pixmap format information that is returned at the time of a connection setup. It contains: .TA .5i 3i .5i 3i typedef struct { int depth; int bits_per_pixel; int scanline_pad; } XPixmapFormatValues; .De

6. SEE ALSO