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 Professional.
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 ); |
|
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.