The base name of an image file contains two components. The first part contains up to six characters which match the name of the application. The last two characters of the base name contain the language code. The extension for all resource images is .RI. Applications should call the appropriate International Configuration service to determine the current system-wide language setting.
An application must construct the appropriate image file name in preparation for a call to map_resource_file(), which should be made during initialization. This service will map the image into a fixed location in the system address, which will remain constant whenever the application is active.
To obtain a pointer to an individual item, an application must call get_resource_ptr(). The argument to this function is a unique two-byte handle. The Resource Editor provides a means of generating header files (for both C and Assembly Languages) used to maintain manifest constants for these handles.
Most of these services are implemented only for the built-in applications. They operate on certain data structures built by the ROM Image Builder (RIB) and are found only in primary ROM.
Label representations are entered into the JQBTAUS.RS file, in an order corresponding to the scancode table in KSCANDAT.ASM. Labels for the shifted states and for the base labels are entered separately.