LoadResource

Make sure that a purgeable resource is in memory

#include <Resources.h> Resource Manager

void LoadResource(rHandle );

Handle rHandle ; existing, valid handle to a resource

Given an existing resource handle, this checks to see if it is still in memory,

and if not, the resource is loaded. You only need to use this for resources

tagged as purgeable OR after getting a NIL handle after previously calling

rHandle is a handle leading to some variable length resource data. This

should be a valid handle obtained via GetResource,

Returns: none (if rHandle is not a handle to a resource, ResError will

return an error).

Notes: When a resource's resPurgeable attribute is set, the resource data may be

dumped in case of a memory shortage (see SetResAttrs). In that case, the

handle's master pointer is set to NIL and the resource data is gone from

memory.

If you are using any such purgeable resources, you must call

LoadResource before each time you use the resource; e.g.:

myHandle=GetResource( 'danR', MY_PURGEABLE_ID );

. (may get purged at any time)

LoadResource( myHandle );

myStuff = ** myHandle; [TOKEN:12074] get some resource data */

If you modify such a resource and it gets purged, LoadResource reads in

the original data and your changes are lost. Refer to ChangedResource

and SetResPurge for details.

Another case where you may need this function is after calling

SetResLoad(FALSE) followed by GetResource (et al.). After examining

the resource map and deciding that you do want the data, use

SetResLoad(TRUE) and pass the empty handle to LoadResource.

Referenced by (19):