IG_tile_count

IG_tile_count_get

In This Topic

This function gets the number of tiles constituting a page for file formats that support tiled pages.

Declaration:

	Copy Code
AT_ERRCOUNT ACCUAPI IG_tile_count_get( const LPSTR lpszFileName, UINT nPageNum, LPUINT lpTileCountH, LPUINT lpTileCountV );

Arguments:

Name	Type	Description
lpszFileName	const LPSTR	Path and name of the file for which to get the tile count. The path can be absolute or relative.
nPageNum	UINT	Page number for which to get the count of tiles.
lpTileCountH	LPUINT	Pointer to a UINT variable to receive the number of tiles horizontally (number of tiles in a row).
lpTileCountV	LPUINT	Pointer to a UINT variable to receive the number of tiles vertically (number of tiles in a column).

Return Value:

Returns 0 if successful. Otherwise, returns the number of ImageGear errors that occurred during this function call.

Supported Raster Image Formats:

All pixel formats supported by ImageGear for C and C++.

Sample:

Memory IO, Filters

Example:

	Copy Code
UINT nTileRows; // Will receive number of tile rows UINT nTileCols; // Will receive number of tile cols AT_ERRCOUNT nErrcount; // Returned count of errors // Get number of tiles, first page of file: nErrcount = IG_tile_count_get("picture_tiled.tif", 1, &nTileRows, &nTileCols );

Copy Code

UINT nTileRows;            // Will receive number of tile rows
UINT nTileCols;            // Will receive number of tile cols
AT_ERRCOUNT nErrcount;  // Returned count of errors
// Get number of tiles, first page of file: 
nErrcount = IG_tile_count_get("picture_tiled.tif", 1, &nTileRows, &nTileCols );

Remarks:

The function returns 0 for both lpTileCountH and lpTileCountV if the image file format does not support tiled images.

See IG_tile_count_get_W for a Unicode version of this function.

Get Product Support