[Contents] [Index] [Help] [Retrace] [Browse <] [Browse >]


   NAME
	RL_OpenResource - open a resource (V44)

   SYNOPSIS
	resource = RL_OpenResource(resobject, screen, catalog)
	 D0                         A0         A1      A2

	RESOURCEFILE RL_OpenResource(APTR, struct Screen *, struct Catalog *);

   FUNCTION
	This routine opens a resource object.

	If you give a NULL for the parameter screen do not call RL_NewObjectA
	or RL_NewGroupA. You must first set a screen with
	RL_SetResourceScreen.

   INPUTS
	resobject -- a pointer to a resource object
	screen -- a pointer to a Screen. This may be NULL
	catalog -- a pointer to a Catalog. This may be NULL

   RESULTS
	resource -- a pointer to a resource or NULL

   EXAMPLE

	extern char RCTResource[];
	struct Screen *screen;

	screen = LockPubScreen(NULL);
	RESOURCEFILE resource = RL_OpenResource(RCTResource, screen, NULL);
	if (resource)
	{
		/* create your objects here */
	}
	RL_CloseResource(resource);
	UnlockPubScreen(NULL,screen);

   SEE ALSO
	intuition.library/LockPubScreen
	intuition.library/OpenScreenTagList
	locale.library/OpenCatalogA
	resource.library/RL_CloseResource
	resource.library/RL_SetResourceScreen