Instruction set reference
Send this instruction to the display server to free server resources associated with a hipe_loc location handle the client application no longer needs.
- location: The location reference to be discarded.
- no arguments.
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.