home *** CD-ROM | disk | FTP | other *** search
/ RISC DISC 1 / RISC_DISC_1.iso / pd_share / code / gcc / !GCC / patches / DeskLib / h / Resource < prev    next >
Encoding:
C/C++ Source or Header  |  1994-10-03  |  2.7 KB  |  75 lines
  1. /*
  2.     ####             #    #     # #
  3.     #   #            #    #       #          The FreeWare C library for
  4.     #   #  ##   ###  #  # #     # ###             RISC OS machines
  5.     #   # #  # #     # #  #     # #  #   ___________________________________
  6.     #   # ####  ###  ##   #     # #  #
  7.     #   # #        # # #  #     # #  #    Please refer to the accompanying
  8.     ####   ### ####  #  # ##### # ###    documentation for conditions of use
  9.     ________________________________________________________________________
  10.  
  11.     File:    Resource.h
  12.     Author:  Copyright © 1992, 1993 Jason Williams
  13.     Version: 1.01 (15 Jul 1993)
  14.     Purpose: Resource file (files within user application directory)
  15.              management functions
  16. */
  17.  
  18.  
  19. #ifndef __dl_resource_h
  20. #define __dl_resource_h
  21.  
  22. #ifdef __cplusplus
  23. extern "C" {
  24. #endif
  25.  
  26. /* resource_pathname
  27.  * This string is used as a prefix for all pathnames in DSEdit that load
  28.  * resource files. It is set up by either of the following calls, to be either
  29.  *   "<Name$Dir>."
  30.  * or
  31.  *   "Name:"
  32.  * It is prepended to a leafname (e.g. <Floob$Dir>.Sprites or Floob:Sprites)
  33.  * by some Desklib modules in order to find the resources.
  34.  * (See Misc.c.ResInit, Misc.c.ResInitPth to see exactly what these very
  35.  * simple functions do)
  36.  */
  37.  
  38. extern char resource_pathname[32];
  39.  
  40.  
  41.   /* Resource_Initialise --------------------------------------------------
  42.    * Initialises the resource manager. Pass in the name of your application
  43.    * (e.g. if you have set <appname$Dir>, pass in "appname")
  44.    * This tells all DeskLib modules where to look for your resources
  45.    * by setting resource_pathname to "<Appname$Dir>." - this is prepended
  46.    * to all leafnames to create full resource pathnames.
  47.    * This pathname is used by various DeskLib modules (Template, Msgs, etc)
  48.    * -it adds very little code size to your program, and saves you the
  49.    * work of doing the pathname yourself. It also makes changing the
  50.    * resource directory at a later development stage far easier.
  51.    *
  52.    * See also the ALTERNATIVE call, Resource_InitialisePath()
  53.    */
  54. extern void Resource_Initialise(char *respath);
  55.  
  56.  
  57.   /* Resource_InitialisePath ----------------------------------------------
  58.    * Initialises the resource manager.
  59.    *
  60.    * If you prefer to use a path variable for your resources (for easier
  61.    * setting of language resources), then you can initialise the resources
  62.    * by calling this function.
  63.    * (Instead of setting the resource prefix to "<AppName$Dir>.", it will
  64.    *  set it to "AppName:", where "AppName" is the 'respath' parameter)
  65.    *
  66.    * See also the ALTERNATIVE call, Resource_Initialise()
  67.    */
  68. extern void Resource_InitialisePath(char *respath);
  69.  
  70. #ifdef __cplusplus
  71.            }
  72. #endif
  73.  
  74. #endif
  75.