Instruction set reference
HIPE_OP_FREE_LOCATION
Send this instruction to the display server to free server resources
associated with a hipe_loc location handle the client application no longer needs.
Usually a location that has been deleted. After this operation, the tag may still exist on
the screen but no longer has a location value connected to it.
- location: The location reference to be discarded.
- no arguments.
Notes
Do not free a location that still exists, if you have requested to receive events from that location and not cancelled those requests. Otherwise your application will receive events from undefined locations.
Location handle resources held by the display server are freed automatically when your application terminates. However, it is still polite to free unneeded location handles from time to time, especially if your application uses a lot of them.
Discard any local copies of hipe_loc values whenever you free them, since they are no longer valid for use in Hipe instructions.