Middleware, development tools, realtime operating system
software and services for superior embedded design


Home
QNX Community Resources
QNX Documentation Library
PhAddMergeTiles

PhAddMergeTiles

QNX Software Systems
Developer Resources
Blogs
Board support packages
Foundry27 projects
Forums
Hardware support listing
Online video tutorials
Product documentation
Technical Articles

PhAddMergeTiles()

Merge two list tiles, eliminating overlap

Synopsis:

PhTile_t * PhAddMergeTiles( PhTile_t *tiles,
                            PhTile_t *add_tiles,
                            int *added );

Arguments:

tiles
A pointer to a list of tiles.
add_tiles
A pointer to a list of tiles that you want to merge into the tiles list.
added
NULL, or a pointer to a location that the function sets to:
  • 0 if tiles or add_tiles is NULL, or tiles completely covers add_tiles
  • 1 otherwise.

Library:

ph

Description:

PhAddMergeTiles() merges the list of tiles pointed to by add_tiles into the list pointed to by tiles and returns a pointer to the resulting list.

This function makes sure that the tiles in the merged list don't overlap.

Returns:

A pointer to the merged list. This isn't always the same as the tiles pointer.


Note: Don't free() the list of tiles; instead, use PhFreeTiles() to return the tiles to the internal pool.

Classification:

Photon

Safety:
Interrupt handler No
Signal handler No
Thread No

See also:

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

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