This version of this document is no longer maintained. For the latest documentation, see http://www.qnx.com/developers/docs.

PhGetTile()

Retrieve a tile from the internal tile pool

Synopsis:

PhTile_t *PhGetTile( void );

Library:

ph

Description:

Photon maintains an internal pool of tiles because tiles are frequently used, and using the pool reduces the amount of time allocating and freeing the tiles. This function retrieves a tile from the internal tile pool. The tile isn't initialized.

Don't free() the tile; instead, use PhFreeTiles() to return the tile to the pool.

Returns:

A pointer to the new tile, or NULL if an error occurred.

Classification:

Photon

See also:

PhAddMergeTiles(), PhClipTilings(), PhCoalesceTiles(), PhCopyTiles(), PhDeTranslateTiles(), PhFreeTiles(), PhIntersectTilings(), PhMergeTiles(), PhRectsToTiles(), PhSortTiles(), PhTile_t, PhTilesToRects(), PhTranslateTiles()

"Using damage tiles" in the Raw Drawing and Animation chapter of the Photon Programmer's Guide