Table of Contents

tile_SetLock

Description

Depending on the function arguments, this function:

Function prototype

bool CExtAPI::tile_SetLock(void* hTile, bool LockState);

Arguments

Name Type Comment
hTile void* The mosiac tile to be locked/unlocked.
LockState bool The desired lock state. true = locked, false = unlocked.

Return value

False if an error occurred, and true otherwise.

Comments

Infinite loops

Do not call SetLock in a file format plugin when loading/saving a mosaic tile, as SetLock may load/save the tile in question, which calls your function again, and we have a recursive infinite loop.

Unlocking tiles

Tiles are not automatically unloaded when SetLock is called with a LockState argument of false, as different threads/plugins may have locks on the same tile. Calling SetLock with a LockState of false will not release these other locks.

Only unlock tiles that you have locked

Title says it all.