ImageGear for C and C++ on Windows v19.4 - Updated
CUR
User Guide > File Formats and Compressions > File Formats > File Formats Reference > CUR

Full Name Windows cursor
Format ID IG_FORMAT_CUR = 96
File Extension(s) *.cur
Data Type Raster image
Data Encoding Binary
Color Profile Support No
Multi-Page Support Yes
Alpha Channel Support Single alpha channel for read/write (see Comments).
ImageGear Platforms Support WIN32, WIN64, Unix, Unix64, .NET, .NET64, MAC

ImageGear Supported Versions:

Windows 3.x

ImageGear Supported Features:

ImageGear Read Support:

ImageGear Write Support:

ImageGear Filter Control Parameters:

Filter Control Parameter Type Default Value Available Values Description
READ_AS_RGBA AT_BOOL FALSE TRUE, FALSE If TRUE, ImageGear reads CUR format as RGBA (RGB with alpha channel). See Comments for more detail.

Comments:

Cursor files consist of a file header (that is repeated several times), info headers, and cursor data. Cursor data contains an XOR mask bitmap and a monochrome AND mask bitmap. Whenever Windows draws a cursor, the AND bitmap is applied to whatever is on the screen. After that, the XOR bitmap is applied.

READ_AS_RGBA control parameter determines how ImageGear reads the 1-bit AND masks. If READ_AS_RGBA is FALSE, ImageGear reads AND mask into "Extra" channel. This mode preserves unchanged pixel values from the file. However, in this mode ImageGear displays only the XOR mask and ignores AND mask (Extra channel) during display, i.e. display is not transparent. If READ_AS_RGBA is TRUE, ImageGear reads CUR files as 32 bpp RGB + Alpha. This allows transparent display.

Files must be 255x255 pixels or less.

References Used:

A Jorn Daub EDV-Beratung - Glashutter Weg 105 - D-22889 Tangstedt

fileformats@daubnet.com