Documentation

Searches through the list of loaded feature files looking for one for the specified URL. If this is found, then its reference count is decreased. If the reference count for an object reaches zero, then it is unloaded from memory and removed from the global list of features. The ID of the removed feature is returned as the result of this function. The calling routine must make sure that this ID is removed from the ThreeDWidget's list of feature IDs. If the feature URL was not found, then nothing is performed and the function returns a result of -1. If you pass NULL for the threeDWidget, then we do not attempt to refresh the display.

Returns:

The ID of the feature that was unloaded, or -1 if no feature

Parameters:

threeD - handle to rendering state.
url - lookup key in search

Author:

Martin Reddy

Version:

9 April, 1999