home *** CD-ROM | disk | FTP | other *** search
/ Crawly Crypt Collection 2 / crawlyvol2.bin / program / misc / rs2l_v2 / rs2l_v2.eng < prev    next >
Encoding:
Text File  |  1995-01-15  |  6.8 KB  |  163 lines
  1.  +----------------------------------------------------------------------+
  2.  |      RS2L_V2.PRG :  Programme for converting resource files.         |
  3.  |                           Version 2                                  |
  4.  |________________  THIS PROGRAMME IS PUPLIC DOMAIN  ___________________|
  5.  |                                                                      |
  6.  |    Snail mail      :  M. SARO   20 rue G. MAEDER                     |
  7.  |                       38170 Seyssinet-Pariset     FRANCE             |
  8.  |       Email        :  saro@dmel.ceng.cea.fr                          |
  9.  +----------------------------------------------------------------------+
  10.  
  11.  Guarantee Impossible:                  (Replace Phelps by your own name)
  12.   Dear Mr. Phelps, if you use this program it is entirely your own resp-
  13.   onsibility. If you or any of your friends have any problems the author
  14.   and the State Department will deny any knowledge of your actions, and
  15.   will accept no responsibility for you or your team. Good Luck.
  16.         This text will not auto-destruct in 5 seconds.
  17.  
  18.  
  19.  _1) THE PROGRAMME
  20.      RS2L converts .RSC resource files to source files in C or Assembler.
  21.  Other programs exist, such as RSC2C or RSC2ASM, which are capable of this
  22.  type of conversion. However RS2L possesses some special features:
  23.         1) converts to C or Assembler with 'object fixation' routine
  24.         2) converts to C or Assembler with multiple strings thus allowing
  25.            multi-lingual resources. The routines for changing language are
  26.            included.
  27.         3) while editing a resource, objects that are not to be translated
  28.            can be selected by setting a flag or an extended type.
  29.  
  30.  
  31.  _2) THE COMMANDS
  32.  
  33.  DISPLAY 1 ___________
  34.  
  35.   _buttons outside the boxes:
  36.  
  37.         INFO            move to display 2, info on RS2L
  38.         OPTIONS         move to display 3, conversion options
  39.         SAVE            saves the resulting source file
  40.         END             back to gemdos
  41.  
  42.   _middle box:
  43.  
  44.       resource file:
  45.         LOAD            load the resource file to be converted
  46.         INFO            move to display 4, info on the loaded file
  47.  
  48.       conversion to:
  49.         .C              xxxxxx.C file
  50.         .S              Assembler source file
  51.         .?              for adding another language (ask me for details)
  52.  
  53.  
  54.  DISPLAY 2 ____________
  55.  
  56.     This display contains an information notice, the address where you
  57.     can contact me and the following three buttons:
  58.  
  59.     FRANCAIS            clicking here selects the working language for RS2L
  60.                         (FRANCAIS,ENGLISH).
  61.     SAVE DEFAULTS       saves ALL the current parameters into the program
  62.                         file itself.
  63.     RETURN              return to display 1
  64.  
  65.  
  66.  DISPLAY 3 ____________
  67.  
  68.     This display shows the conversion options. A selected option will be
  69.     checked. Some options are mutually exclusive.
  70.  
  71.   _buttons outside the boxes:
  72.  
  73.     ONE NUL ONLY            Only one nul string for all objects
  74.     SAVE DEFAULTS           same as in display 2
  75.     .TX                     not implemented in this version
  76.     RETURN                  back to display 1
  77.  
  78.   _'number of languages' box:   (valid for both C and Assembler)
  79.  
  80.     NUMBER OF LANGUAGES x   x must be between 1 and 9. Each string is dup-
  81.                             licated x times. It's up to you to do the trans-
  82.                             lation.
  83.     FLAG NUMBER        xx   9 <= xx <= 15. If the FLAG NUMBER option is
  84.                             checked objects whose bit xx (in ob_flag) is set
  85.                             will be considered untranslatable.
  86.     EXTENDED TYPE    sxxx   s is one of > < =, xxx lies between 0 and 255.
  87.                             If this option is checked objects whose MSB in
  88.                             ob_type satisfies the formula will be considered
  89.                             untranslatable.
  90.  
  91.   _assembler box:           (only valid for Assembler)
  92.  
  93.      ..                     reserved - no action
  94.     MACRO                   If this option is checked then the assembler
  95.                             files use Bitblk, Iconblk, Tedi and Object MACROS
  96.                             whose definitions are in the file MACRO.S
  97.     POINT                   if checked, this option causes certain opcodes
  98.                             to be written with a preceeding point. E.g.
  99.                             .dc.l       .globl
  100.     GLOBL/XDEF/IMPORT       defines the type of pseudo-opcode to be used for
  101.                             external references.
  102.  
  103.   _reserved box:            Reserved for future developments.
  104.  
  105.  
  106.  DISPLAY 4 ______________
  107.  
  108.     This display gives a summary of the objects loaded from the resource
  109.     file.
  110.  
  111.     RETURN                  back to display 1
  112.  
  113.  _3) NOTES:
  114.  
  115.         The converted files are compatible with SOZOBON and DEVPACK2.
  116.         USERDEF objects or those whose UNDIRECT bit is set will have their
  117.     "ob_spec" set to zero.  It should be noted that most resource editors
  118.     handle this type of object very badly.
  119.         Some example resource files are provided containing objects with
  120.     flag10 set or with an extended type of 128. A complete example of a
  121.     multi-lingual programme is also provided.
  122.  
  123.         My thanks to Paul DAGLEISH for his translation into English and
  124.     for some testing of the program.
  125.  
  126.     Miguel SARO, Grenoble, December 1994
  127.  
  128.  ** eof **
  129.  
  130. --------------------------------------------------------------------------
  131.  
  132. What's new in version 2:
  133.  
  134.  _1  Output to .RSH files has been removed.
  135.  _2  Recognition of colour icons and images. Type 0, 1, 3, et 4 .RSC files
  136.      are recognised.
  137.  _3  All dialogue windows are non-blocking (handled using event-multi).
  138.  _4  ALERT boxes remain blocking.
  139.  _5  Clicking the close box of any window causes an exit from the programme.
  140.  _6  A menu bar has been added ( just for the principle).
  141.  _7  Tests have been carried out under Tos 1.2, 1.4, 1.6, 2.05, 2.06,
  142.      3.01 and 4.04  as well as Multitos and MultiGEm.
  143.  
  144.         ---------------------------------------------
  145.  
  146. Proposals for the next version (3):
  147.  
  148.  I have never come accross a type 2 resource file. If you know of a resource
  149.  editor that produces such files please let me know.
  150.  
  151.  I intend to add:
  152.  _ Keyboard short-cuts.
  153.  _ The ability to create .TX files containing the text to be translated.
  154.  _ The ability to create a new resource file having the same structure as
  155.    the original, but containing the translated text.
  156.  _ The ability of placing all objects in the main programme but having all
  157.    the text in a separate file.
  158.  
  159.         ---------------------------------------------
  160.  
  161. !!!!  If you use this programme be a sport and let me Know  !!!!
  162. !!!!         it would be must appreciated                   !!!!
  163.