Topic       : The ATARI Compendium
Author      : Scott Sanders / JAY Software
Version     : 1.25 (20/6/2003)
Subject     : Documentation
Nodes       : 1117
Index Size  : 32614
HCP-Version : 6
Compiled on : Atari
@charset    : UTF-8
@lang       : en
@default    : 
@help       : %About
@options    : +g -i -t4 +y +z
@width      : 100
View Ref-Filersrc_saddr()
Resource Library
rsrc_gaddr()                                                            AES

Syntax

WORD rsrc_gaddr( type, index, addr )
WORD type, index;
VOIDPP addr;

Function       rsrc_gaddr() returns the address of an object loaded with
               rsrc_load().

Opcode         112 (0x70)

Availability   All AES versions.

Parameters     The pointer pointed to by addr will be filled in with the
               address of the indexth resource object of type type. Valid
               values for type are as follows:

                Name         type  Resource Object

                R_TREE        0    Object tree

                R_OBJECT      1    Individual object

                R_TEDINFO     2    TEDINFO structure

                R_ICONBLK     3    ICONBLK structure

                R_BITBLK      4    BITBLK structure

                R_STRING      5    Free String data

                R_IMAGEDATA   6    Free Image data

                R_OBSPEC      7    ob_spec field within OBJECTs

                R_TEPTEXT     8    te_ptext within TEDINFOs

                R_TEPTMPLT    9    te_ptmplt within TEDINFOs

                R_TEPVALID    10   te_pvalid within TEDINFOs

                R_IBPMASK     11   ib_pmask within ICONBLKs

                R_IBPDATA     12   ib_pdata within ICONBLKs

                R_IBPTEXT     13   ib_ptext within ICONBLKs

                R_BIPDATA     14   bi_pdata within BITBLKs

                R_FRSTR       15   Free string

                R_FRIMG       16   Free image

Binding        intin[0] = type;
               intin[1] = index;

               crys_if(0x70);

               *addr = addrout[0];

               return intout[0];

Return Value   The correct return value is 0 if an error occurred or
               non-zero if addr is valid.

Comments       This function is most often used to obtain the address of
               OBJECT trees, 'free' strings, and 'free' images after
               loading a resource file.

See Also       rsrc_saddr()

Group          Resource Library