ImageGear Professional DLL v17.1 for Windows Accusoft
IG_tile_count_get
Send Feedback  
ImageGear Professional DLL v17.1 for Windows > API Reference Guide > Core Component API Reference > Core Component Functions Reference > Info Functions > IG_tile_count_get

Glossary Item Box

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:

lpszFileName Path and name of the file to get the tile count for. The path can be absolute or relative.
nPageNum Page number for which to get the count of tiles.
lpTileCountH Pointer to a UINT variable to receive the number of tiles horizontally (number of tiles in a row).
lpTileCountV 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.

©2012. Accusoft Corporation. All Rights Reserved.