home *** CD-ROM | disk | FTP | other *** search
/ Ray Tracing Box / RAY_CD.mdf / raytrace / fss / fs.doc < prev    next >
Text File  |  1993-11-21  |  15KB  |  377 lines
  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.  
  10.  
  11.  
  12.  
  13.  
  14.                     Manual for Fonts to Shapes (FS)
  15.           A font & bitmap conversion program for MS-Windows 3.x
  16.                             Version 1.1r2
  17.                             November 1993
  18.  
  19.  
  20.  
  21.  
  22.  
  23.                  Copyright (c) 1993 Mark E. Peterson
  24.                          All rights reserved.
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.  
  36.  
  37.  
  38.                       Epitaph BBS: 507-947-3174
  39.                       VirtualNet:  1@1507005
  40.                       CIS:         72147,2174
  41.                       Internet:    72147.2174@Compuserve.Com
  42.                       US Mail:     Rt 2  PO Box 135
  43.                                    Lake Crystal, MN  56055
  44.  
  45. Description =======================================================
  46.  
  47. FS is a font and bitmap conversion program. Specifically, it converts 
  48. MS-Windows fonts and bitmaps into a format compatible with the Persistence 
  49. of Vision (POV) ray tracing program.  FS allows you virtually eliminate 
  50. the drudgery of creating text in your POV scenes.
  51.  
  52. Other graphics to POV conversion programs typically convert each graphic 
  53. pixel to a cube. In contrast, FS uses a sophisticated shape analysis 
  54. algorithm to minimize the number of geometric shapes required to make up
  55. an object.  This provides two benefits, less time required to trace the 
  56. object and it also makes the objects infinitely scalable.
  57.  
  58. In addition to accurate conversion, FS supports special effects.
  59. You can use FS to create characters and bitmaps made of spheres, blobs, 
  60. or cylinders.
  61.  
  62. FS is a versatile tool that will make an excellent addition to your ray
  63. tracing toolbox.
  64.  
  65. Limited License ===================================================
  66.  
  67. This software is made available under the shareware concept.  If you 
  68. continue to find it of use after the 30 day trial period, you are required
  69. to register it or your license to use it will expire.  
  70.  
  71. See order.doc in this archive for registration details.  After 
  72. registration, your copy is no longer shareware.  Please distribute the 
  73. shareware version of FS to any friends or online services you may desire.
  74.  
  75. Disclaimer ========================================================
  76.  
  77. THIS SOFTWARE IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND. 
  78.  
  79. BY USING THIS SOFTWARE YOU AGREE NOT TO HOLD THE AUTHOR OR ANY OF HIS
  80. AFFILIATES OR OTHER RELATED PARTIES LIABLE FOR ANY DAMAGES CAUSED DIRECTLY
  81. OR INDIRECTLY THROUGH USE OR INABILITY TO USE THIS PRODUCT.  THIS APPLIES
  82. EVEN IF I HAVE BEEN WARNED OF SUCH DAMAGES IN ADVANCE.
  83.  
  84. THIS AGREEMENT IS GOVERNED BY THE LAWS OF THE STATE OF MINNESOTA.
  85.  
  86. Trademarks/Copyrights =============================================
  87.  
  88. MS-DOS and Microsoft Windows are trademarks of Microsoft Corp.
  89. POV and Persistence of Vision are property of the POV-Team.
  90.  
  91. Installation ======================================================
  92.  
  93. Upgrade note: If you are a registered FS user and are upgrading, you
  94. need to replace replace ALL your existing FS files.  This will require you
  95. to reenter your registration number, sorry for the inconvenience.
  96.  
  97. The archive you received should contain the following files:
  98.  
  99. F2PVCFGW.DAT - FS configuration file.
  100. FS.EXE       - FS executable.
  101. BWCC.DLL     - FS controls library.
  102. FS.DOC       - This document.
  103. GLOBPALT.DAT - Logo palette
  104. FSLOGO.MEP   - FS Logo
  105. ORDER.DOC    - Instructions on how to register this product.
  106. FILE_ID.DIZ  - BBS long description file
  107. DESC.SDI     - BBS short description file
  108. WHATS.NEW    - Description of what's new in this release.
  109. UPGRADE.TXT  - Instructions for upgrading from previous versions.
  110. HISTORY.TXT  - Release history for FS.
  111.  
  112. To install FS, merely copy/unzip the files into a convenient subdirectory
  113. on your hard disk.  All files, except the .doc files, MUST be in the same 
  114. directory for the program to function properly.
  115.  
  116. To install FS in the Windows Program Manager use the Program->New menu 
  117. items as usual. Note, be sure the working directory for FS in Windows 3.1
  118. is the same as the directory path for the executable.
  119.  
  120. Note: If you are running under Win-OS2 (Windows under OS/2). Add the switch
  121. -OS2 to the command line.  FS will NOT run under Win-OS2 without it.
  122.  
  123. FS Main Menu ======================================================
  124.  
  125. Below is the menu structure for FS:
  126.  
  127.  App                Font               Bitmap
  128.  ───┐               ───┐               ───┐            
  129.     │                  │                  │            
  130. ┌───┴───────────┐  ┌───┴───────────┐  ┌───┴──────┐
  131. │ Exit    Alt-X │  │ Text    Alt-T │  │ Select   │
  132. ├───────────────┤  │ Select  Alt-S │  │ Convert  │
  133. │ About         │  │ Texture Alt-E │  └──────────┘
  134. │ Register      │  │ Convert Alt-C │
  135. └───────────────┘  └───────────────┘
  136.  
  137. Menu Item                Accelerator
  138. ----------               -----------
  139. App->Exit                  Alt-X
  140.  
  141. Exit FS.
  142.  
  143. Menu Item                Accelerator
  144. ----------               -----------
  145. App->About                  None
  146.  
  147. Selecting this item displays the copyright and registration info for your
  148. copy of FS.  The about dialog also displays a logo created with FS and POV.
  149.  
  150. Menu Item                Accelerator
  151. ----------               -----------
  152. App->Register               None
  153.  
  154. This menu item is only used when you have registered your copy of FS and 
  155. have obtained a registration number. After you have your registration 
  156. number, select this menu item and type the number into the dialog box.
  157. Your customer ID will now be shown in the about dialog in place of the text
  158. 'Unregistered', also, FS will produce POV files for 'R', 'E', 'G' and process
  159. bitmaps greater than 200 pixels in height. (See application notes.)
  160.  
  161. Menu Item                Accelerator
  162. ----------               -----------
  163. Font->Text                  Alt-T
  164.  
  165. Selecting this menu item will present you with a dialog box in which you may
  166. type a string of characters to convert.  Also within this dialog the 'All
  167. Chars' button allows you to quickly specify the complete character set, 
  168. codes 33 to 255.
  169.  
  170. When entering the string to convert you need not worry about entering 
  171. duplicates, FS only processes the unique characters in each string.
  172.  
  173. Once you have entered a string of characters, these characters are displayed
  174. in the currently selected font in the main window.
  175.  
  176. The 'string' POV output file will faithfully duplicate the string that you 
  177. enter here, including whitespace (see application notes).
  178.  
  179. Menu Item                Accelerator
  180. ----------               -----------
  181. Font->Select                Alt-S
  182.  
  183. This selection allows you to specify the font to be used for the conversion.
  184. Selecting this item brings up a font selection dialog box.  Highlighting  
  185. different fonts in this dialog causes the font to change in the main window.
  186. To select a given font for conversion either double click on the font name 
  187. or highlight it and click the OK button.
  188.  
  189. Menu Item                Accelerator
  190. ----------               -----------
  191. Font->Texture               Alt-E
  192.  
  193. This item allows you to specify the texture block to be used with the
  194. selected font.  Selecting this item starts the notepad application with a
  195. file name based on the selected font.  For example, if you have selected 
  196. the font 'courier', notepad will be opened with the file name 'courier.ptx'.
  197. Don't alter the file name within notepad, FS will not be able to find the 
  198. texture file if the name is altered.
  199.  
  200. Within notepad enter the texture block as you would in any POV file, e.g.
  201.  
  202.       texture
  203.       {
  204.         Chrome_Texture
  205.         pigment { color Red }
  206.       }
  207.  
  208. If you do not specify a texture for the selected font, the following 
  209. texture block will be used:
  210.  
  211.       texture
  212.       {
  213.         pigment { color White }
  214.       }
  215.  
  216. Menu Item                Accelerator
  217. ----------               -----------
  218. Font->Convert               Alt-C
  219.  
  220. This selection initiates the conversion process with the text and font
  221. specified under the previous two menu items.  The following dialog allows you
  222. to specify the type of conversion you wish to perform.
  223.  
  224. ┌────────────────────────────────────────────────────────────────┐
  225. │                                                                │
  226. │  [X] Accurate    [ ] Blobs    [ ] Spheres     [ ] Cylinders    │
  227. │                                                                │
  228. │  [ 1.00 ]  Shape Depth    [ 1.00 ]  Blob Strength              │
  229. │  [ 0.00 ]  Shape Overlap  [ 0.60 ]  Blob Threshold             │
  230. │                                                                │
  231. │  [X] POV 2.0 Format       [INC ] File extension                │
  232. │  [String  ] String name   [5.0 ] Intercharacter spacing        │
  233. │                                                                │
  234. │  (OK)   (Cancel)                                               │
  235. │                                                                │
  236. └────────────────────────────────────────────────────────────────┘
  237.  
  238. Specifying accurate tells FS to produce POV source that will reproduce the 
  239. Windows object as closely as possible.  Selecting Blobs, Spheres or Cylinders
  240. will produce objects made up of different size Blobs, Spheres or Cylinders.  
  241.  
  242. Shape depth applies only to accurate and cylinder conversions, it is the 
  243. depth of the character along the Z axis.
  244.  
  245. Shape overlap is used on all conversions except accurate.  Overlap specifies
  246. the percentage that each adjacent shape should overlap, this number may be
  247. negative to force shapes apart rather than together.
  248.  
  249. The next two entries apply only to blobs.  Blob strength is the first 
  250. number on each blob component. (See POV docs.)   Blob threshold is the 
  251. POV blob threshold (See POV docs.)
  252.  
  253. The POV 2.0 format check box controls the output format of FS.  Check the 
  254. box to generate POV 2.0 compatible files.
  255.  
  256. The file extension edit box lets you customize the extension FS puts on 
  257. the end of all of its output files.  This must be three characters or less.
  258.  
  259. The String name edit box allows you to change the base name of the composite
  260. string file.  This entry must be eight characters or less.
  261.  
  262. The intercharacter spacing field allows you to change the amount of space
  263. inserted between characters in the composite string file.  This number is 
  264. a percentage calculated from the width of a 'B' in the font you are 
  265. converting.  This number may be negative to overlap characters rather than
  266. force them apart.
  267.  
  268. Menu Item                Accelerator
  269. ----------               -----------
  270. Bitmap->Select              None
  271.  
  272. This selection allows you to specify a bitmap to be used for the conversion.
  273. Selecting this item brings up a standard file selection dialog box.  
  274. Highlight the bitmap you want to convert and select the OK button.
  275.  
  276. Menu Item                Accelerator
  277. ----------               -----------
  278. Bitmap->Convert             None
  279.  
  280. This selection initiates the conversion process with the bitmap you have
  281. selected. (See Font->Convert)
  282.  
  283. Application Notes =================================================
  284.  
  285. When tracing FS output with POV, you will occasionally notice lines
  286. or dots that don't belong in the image.  These are due to calculation errors
  287. in POV.  The only known way to fix the problem is to translate the objects
  288. or move the camera slightly in one direction or another.
  289.  
  290. FS generates all output files in the same directory where fs.exe resides.
  291.  
  292. The composite string file contains a union of all the processed characters 
  293. translated to their appropriate position with respect to one another. It also
  294. '#includes' the source for each character. You may include spaces in text to
  295. be converted to obtain a blank in the composite string file.  The string will
  296. be centered at <0 0 0>.
  297.  
  298. Font objects generated under Win-OS2 will be smaller in size than those
  299. generated under straight Windows.  
  300.  
  301. Unregistered versions of the software will not produce valid POV files for
  302. the letters 'R', 'E', and 'G' in upper or lower case.  Also bitmaps greater
  303. than 200 pixels in height will be truncated.  In any case bitmaps are 
  304. currently limited to what will fit in FSs window area.
  305.  
  306. While FS will convert color bitmaps, all colors will be treated as 
  307. background.  The only areas that will be processed are the black areas of
  308. the bitmap.
  309.  
  310. Conversions other than accurate work well with some fonts/bitmaps and not 
  311. so well with others.
  312.  
  313. Each converted object is placed in a seperate POV source file.  Also 
  314. the shape is centered at <0 0 0> so that it may be easily rotated.  
  315.  
  316. Objects are generated 'facing' the Z axis, e.g. the face of the object can 
  317. be viewed by looking at <0 0 0> from a point on the + or - Z axis.
  318.  
  319. Font files are named with the first five characters of the font name
  320. followed by _case,character or character code.  A courier '!' would be placed
  321. in couri033.pov while an acclamation 'A' would be placed in accla_UA.pov (UA 
  322. for upper case A)
  323.  
  324. Each character is declared in POV source form as an object.  The name of the
  325. object is the [Name of the font]_Char_[Character or Character Code].  Using
  326. the courier example above the '!' would have an object name of 
  327. Courier_Char_33 and the 'A' would have the name Courier_Char_A.
  328.  
  329. The texture block for bitmap conversions is texture { [bmp_name]_Texture }
  330. where bmp_name is the eight character base name of the bitmap being 
  331. converted.  e.g. if you are converting fred.bmp the texture would be 
  332. 'fred_Texture'.  This allows you to #declare the texture to whatever you
  333. desire in your main .POV file.  The name of the bitmap object is generated
  334. similarly [bmp_name]_Bitmap.  In the fred example the object name would be
  335. 'fred_Bitmap'.
  336.  
  337. During a lengthy conversion process, you may minimize FS and do other 
  338. things.  The conversion process will continue in the background.
  339.  
  340. Fonts or bitmaps that contain thin filaments, tend to lose detail rather 
  341. quickly when scaled with POV. For example, the Windows script font when 
  342. reduced slightly or moved to a distant location tends to disappear 
  343. completely.  If your objective is to produce small characters in a scene, 
  344. find a fat font.
  345.  
  346. Tip: To select individual 'high bit' characters (codes 128 to 255) for 
  347. conversion, use the character map applet that comes with Windows 3.1.
  348. Heres how:
  349.   1. Open the character map applet (normally found in the accessories group)
  350.   2. Select the character you desire and copy it.
  351.   3. Open the FS select text dialog and press shift-Ins. (The character
  352.      may appear differently than you expect in the edit box.) 
  353.   4. Close the dialog with 'Ok', the character you desire should appear 
  354.      in the main window.
  355.  
  356.  
  357. Appendix A - Accelerator Table
  358. ------------------------------
  359.  
  360. This table contains a summary of all of the FS shortcut keys and what 
  361. they do.
  362.  
  363. Alt-T   - Activate the 'text to convert' dialog.
  364. Alt-S   - Activate the 'select font' dialog.
  365. Alt-E   - Activate the notepad application to enter a texture block.
  366. Alt-C   - Start the conversion process. 
  367. Alt-A   - App main menu item.
  368. Alt-F   - Font main menu item.
  369. Alt-B   - Bitmap main menu item.
  370. Alt-X   - Exit FS.
  371. Alt--   - Main window control box.
  372. Alt-=   - Memory statistics (Used for debugging.)
  373. Alt-F4  - Exit FS.
  374. Alt-F6  - Change window focus.
  375. Ctrl-F4 - Kill the current window.
  376.  
  377.