home *** CD-ROM | disk | FTP | other *** search
/ APDL Public Domain 1 / APDL_PD1A.iso / fontutils / fontmgr2 / !FontMGR2 / TechText / Scripts < prev    next >
Encoding:
Text File  |  1995-03-30  |  4.0 KB  |  173 lines
  1. !FontManager release two script format.
  2. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  3.  
  4.  !Note! -> FILETYPE : &3f8.
  5.  
  6. -----------------------------------------------
  7.  
  8. The new scripts
  9. ~~~~~~~~~~~~~~~
  10.  
  11. This document describes the format for the
  12. current release and version of !FontMGR.
  13. Previous to release 2 the format was rather
  14. messy, and I have decided to make those files
  15. void now because of the huge improvement.
  16.  
  17. The new format is a script one, so you can
  18. edit in a text editor or wordprocessor.  This
  19. *WILL* make it easier for you to edit files,
  20. and create files.  The current format will be
  21. added to if required - THIS MEANS THIS IS
  22. MOST LIKELY PERMANENT -.  Also third parties
  23. are welcome to have their applications export
  24. font manager scripts.
  25.  
  26. Please use the supplied icon however.
  27.  
  28. -----------------------------------------------
  29.  
  30. Below is an example file generated by !FontMGR2
  31. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  32.  
  33. FMGR
  34.  
  35. # This file is a script for Font Manager release two version 0.050
  36. # Generated by !FontMGR2 version 0.050.
  37. # Date stamp : Sun Jul 31 15:52:50 1994
  38. *FILE_VERSION* : 0.01
  39.  
  40. *FLAGS*
  41. {
  42.  FONTINSTALL               : NO
  43.  ALL_ACTIVE                : NO
  44.  IMMEDIATE_CHANGES         : YES
  45.  SAVE_STATUS_ON_QUIT       : YES
  46.  UNLIMITED_PATHS           : YES
  47.  
  48.  OVERWRITE_FILES           : YES
  49.  EXPORT_AS_FILER_DIRECTORY : NO
  50.  EXPORT_AS_FONT_DIRECTORY  : YES
  51.  INSTALL_ON_VIEWING        : YES
  52. }
  53.  
  54. *GROUPS*
  55. {
  56.  Script
  57.  JustTestin
  58.  MuttonBird
  59.  Unique
  60.  Wail
  61.  General
  62. }
  63.  
  64. *SELECT* : Script
  65.  
  66.  
  67. *GROUP_ORDER*
  68. {
  69.  Wail
  70.  General
  71.  Script
  72.  JustTestin
  73.  MuttonBird
  74.  Unique
  75. }
  76.  
  77. *END*
  78.  
  79. -----------------------------------------------
  80.  
  81. Discussion on the above file.
  82. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  83.  
  84. The initial 'FMGR' signifies that a FontMGR2
  85. file is being considered - it is therefore
  86. essential!
  87.  
  88. Any comments come next preceeded by a '#'
  89.  
  90. The file version is set at 0.01 for now. This
  91. most likely won't change.
  92.  
  93. Next is the configuration flags.  If you have
  94. used !FontMGR2 then this will be obvious.
  95.  
  96. The next item, '*GROUPS*' is to describe which
  97. groups are active.
  98.  
  99. The '*SELECT*' item is to describe which group
  100. is the selected one.
  101.  
  102. The last item, with the exception of the '*END*'
  103. marker is the '*GROUP_ORDER*' one.  This is
  104. obviously used to define the order that groups
  105. should be in.
  106.  
  107. At the end it is imperitive that you include the
  108. '*END*' marker or else...
  109.  
  110. One important thing to note is the indentations,
  111. because they are *NOT* optional!  They are one
  112. space where required.  Please refer to the
  113. above example to see this important feature of
  114. Font Manager files.
  115.  
  116. -----------------------------------------------
  117.  
  118. Using the File Format - can I?
  119. ~~~~~~~~~~~~~~~~~~~~~
  120.  
  121. By giving you, the public a full description of
  122. this very very simple file format I hope that
  123. you will feel free to include the exporting of
  124. Font Manager scripts from your applications.
  125.  
  126. --==> PLEASE USE THIS FILE FORMAT !!! <==--
  127.  
  128. Also, it is essential that you maintain the
  129. file's iconsprite, and keep it attached to the
  130. filetype.  DO NOT CREATE YOUR OWN!!!!
  131.  
  132. I am aware of third-parties writing commerical
  133. font managers and I would be only too happy for
  134. them to also use this file format, and the
  135. font hunter feature below.  However please do
  136. not 'add' features to the file format without
  137. discussing the change with me first.
  138.  
  139. -----------------------------------------------
  140.  
  141. The Font Hunter
  142. ~~~~~~~~~~~~~~~~
  143.  
  144. The 'font hunter' feature is primarily designed
  145. to help programmers get their applications to
  146. integrate with FontMGR2.  Below is an example
  147. of how it might appear in a file.
  148.  
  149. *FONTS*
  150. {
  151.  NewYorker
  152.  Folio
  153.  Futura1
  154.  Olivia
  155. }
  156.  
  157. It's layout is similar to the "*GROUPS*" item.
  158. When the script is being 'read' by !FontMGR2,
  159. any groups that contain the listed fonts are
  160. turned on.
  161.  
  162. This is the 'engine' of application support
  163. of !FontMGR2 and also is the means by which
  164. DocScan works.
  165.  
  166. This may also be useful for people moving files
  167. from computer to computer.  Saving a "*FONTS*"
  168. version of a script is now supported via the
  169. Font Manager 2 interface.
  170.  
  171. -----------------------------------------------
  172.  
  173.