

                                ttf2udo

                      Truetypeconverter Version 1.2
                             by Thomas Baier
                              December 1996
                         Compuserve: 100527,3011
                       Internet  : thbaier@ibm.net
           WWW: http://ourworld.compuserve.com/homepages/thbaier
                        Copyright by Thomas Baier



   Version 1.0 and later of ttf2udo are Shareware and may be distributed
   freely, provided that you leave this documentation file in the
   archive. Note that this program is fully functional.

   Additionally you need the DOS4GW - Extender Version 1.95/1.96/1.97.
   Add there is a Win95/NT version called ttfntudo.exe.
   
   If you enjoy this program, use it frequently, and can afford to pay
   a registration fee, then send $10 to: 
   
                        Thomas Baier 
                        Ammerseestr.9
                        85551 Kirchheim 
                        Germany
   
   Please include your name and mailing address.
   With this registration you help me improve ttf2udo. With registration you 
   can expect a prompt response on questions or bugs. Thanks. 
   

   This program converts TTF strings into UDO (Moray) and INC (POV-Ray 3.0/
   PolyRay 1.8).
   Several options control this process to enable better handling of 
   TTF-objects from within Moray. The output generated by ttf2udo requires
   Moray V2.5 or better and POV-Ray 3.0/PolyRay 1.8 or better.
   
   Usage:

        ttf2udo string [options]        (for use on MSDOS) 
   or
        ttfntudo string [options]       (for use on Windows 95 or NT)

   Example:

        ttf2udo "Hello" c:\win95\fonts\times.ttf

        This produces two files with a default name in the current
        directory: 
                .UDO: contains display informations for moray  
                .INC: contains serveral ttf-objects, used by moray 

   Options:

        command         string
        description     can be every string you like If you need spaces
                        between wordïs, place the whole string between
                        "". If you convert ttf-strings under MSDOS,
                        please watch out for special characters.
                        If you use the string in a invocation file,
                        there is a limit of 1024 characters. 
        examples        Hello or "Hello" or "Hello World"
        default         "Hello World!"

        command         @<filename>
        description     under MSDOS (not Windows 95/NT) you have a
                        limit of 128 characters on the commandline. All
                        options can be placed in an invocation file.
                        Each line contains one option. 
        examples        @myttf.ini
        default         nothing

        command         /f<filename>
        description     full filename for ttf-font-file
        examples        /fd:\windows\fonts\arial.ttf
        default         /fc:\win95\times.ttf

        command         /i<path>
        description     path were to place the resulting INC-file
        examples        /id:\moray25\povscn\ 
                        /ic:\tmp\ 
        default         nothing (current directory) 

        command         /u<path>
        description     path were to place the resulting UDO-file
        examples        /ud:\moray25\udo\
        default         nothing (current directory) 

        command         /a<filename>
        description     filename for INC/UDO-File without extension
                        the filename is limited to 8 chracters    
        examples        /amy_ttf                  
        default         /attf_obj 

        command         /m<value>
        description     Switch for RayTracer specific output
                        0 = Povray 3.0, 1 = PolyRay 1.8
        examples        /m1 (PolyRay)
        default         /m0 (Povray)

        command         /d<value>
        description     depth of ttf-extrusion. Must be greater 0.0
        examples        /d1.2                  
        default         /d1.0 

        command         /o<vector>
        description     Besides the internal kerning, additional offsets
                        in all 3 direction can be useful. The
                        X-component enlarges the space between
                        chracters. Place the vector without spaces. "-"
                        can be used.         
        examples        /o1.0,-1.0,0.0                  
        examples        /o0.0,0.0,0.0                  

        command         /r<vector>
        description     Every character can be rotated in 3 directions.
                        Place the vector without spaces. "-" can be
                        used.     
        examples        /o-90,0.0,0.0                  
                        /o0,0.0,-30.0
        examples        /o0.0,0.0,0.0                  

        command         /c 
        Description     Rotate each object about the mass center of object.          
        examples        /c
        default         Center off, Rotation about init center 

        command         /v 
        description     Gives some statistical informations.          
        examples        /v
        default         verbose is off 


     History:
        
        Version 1.2     Added support for Windows Version
                        Bug fixed with ï"ï character

        Version 1.1     Added support for PolyRay

        Version 1.0     first release

        Version 0.8:    first beta

        Version 0.1:    first alpha
                

