Topic       : TOS - The Operating System
Author      : 
Version     : tos.hyp (December 19, 2008)
Subject     : Programmieren/Atari
Nodes       : 3010
Index Size  : 93790
HCP-Version : 5
Compiled on : Atari
@charset    : atarist
@lang       : 
@default    : Title
@help       : 
@options    : +g -i -s +x +zz -t4
@width      : 70
View Ref-File8.17.5  rsrc_rcfix                                                 TOS

 Name:         »Resource coordinate fix« - Fix up coordinates and 
               pointers in memory.

 Opcode:       115

 Syntax:       int16_t rsrc_rcfix ( RSHDR *rc_header );

 Description:  The function rsrc_rcfix, present in MagiC and MultiTOS, 
               fixes up resource data already loaded into memory by 
               the application. During this the coordinates are 
               converted from character- to pixel-coordinates.

               If an application has already loaded an RSC file before 
               the function is called, then it must be released with 
               rsrc_free before the rsrc_rcfix call is made. The same 
               applies at the termination of the application.

               The advantage of this function consists in the ability 
               of incorporating the resource file of the program into 
               the program code itself. It then suffices to just call 
               rsrc_rcfix, and loading with rsrc_load can then be 
               dispensed with. The following applies:

                rc_header:  Address of the RSC header in memory; the 
                            RSC data must lie after this

 Return value: This will be 0 if unsuccessful, else non-zero.

 Availability: Available only in MagiC and AES versions 4.0 and 
               greater. The presence of this call should also be 
               checked for using appl_getinfo (Opcode 4).

 Group:        Resource library

 See Also:     Binding   rsrc_load   rsrc_obfix