home *** CD-ROM | disk | FTP | other *** search
- # This is a sample font mapping file for use with the beta WordPerfect
- # converter for Microsoft Word for Windows 2.0. It can be used to
- # override some or all of the font mappings performed automatically by
- # the converter when converting from WordPerfect to Word.
- #
- # In order for this file to be used by the converter, it must be
- # renamed to WP5_RTF.DAT, must be a plain ASCII text file, and must
- # reside in either the same directory as the document being converted
- # or in the directory containing the converter itself. The converter
- # searches for this file first in the document directory, and then in
- # the converter directory. Therefore, a font mapping file located in
- # the document directory will override one located in the converter
- # directory.
- #
- # Each line of the file is either a comment line or a mapping line
- # that describes how a particular WordPerfect font/attribute
- # combination should map to a Word for Windows font during conversion.
- # There is no set limit to the number of comment or mapping lines a
- # font mapping file can contain.
- #
- # The syntax of a comment line is
- #
- # #<CommentText>
- #
- # The pound (#) symbol denotes a comment and must be included at the
- # beginning of each comment line. <CommentText> represents the text of
- # the comment.
- #
- # The syntax of a mapping line is:
- #
- # <WPFontName>; <WinFontName> [,<Attribute>]
- #
- # Each line in the file must be terminated with a <newline> (carriage
- # return/linefeed), and the (#) symbol must be removed from the
- # beginning of the line for the mapping line to become active.
- #
- # <WPFontName> is a WordPerfect font name exactly as it appears in the
- # Base Font menu in WordPerfect. <WinFontName> is a Windows font name
- # exactly as it appears in the Format Character menu in Word for
- # Windows. <WinFontName> is separated from <WPFontName> by a
- # semicolon. <Attribute> affects any of the attributes that can be
- # included with a WordPerfect base font definition. The <Attribute> is
- # optional and is separated from the <WinFontName> by a comma.
- # Possible <Attribute> values include:
- #
- # bold
- # italic
- # light
- # roman
- # <integer> point
- #
- # <integer> is any base 10 integer used to specify base font point
- # size.
- #
- # For example, a font mapping file containing the line
- #
- # Courier 10cpi; Arial, bold, italic, 14
- #
- # will map the WordPerfect font Courier 10cpi (characters per inch or
- # pitch) font to the Windows Arial TrueType font with bold and italic
- # attributes applied, and a change in font size from 10cpi (12 point)
- # to 14 point.
- #
- # More Information:
- #
- # The converter uses the font-mapping file as follows. For each
- # WordPerfect font name, the converter searches the WordPerfect file
- # for the longest match between the font name and a <WPFontName>
- # specified in the font mapping file. Matching is not case sensitive.
- #
- # If any match exists between a particular font name in the
- # WordPerfect document and a <WPFontName> in the font mapping file,
- # the longest such match determines the mapping line to be applied.
- # The purpose of this functionality is to allow you to map entire
- # groups of fonts at once.
- #
- # For example, suppose the document you wish to convert was originally
- # formatted in WordPerfect for the Hewlett Packard LaserJet IIIsi. In
- # this case, a font mapping file containing only the mapping line
- #
- # Courier; Courier New
- #
- # will map all WordPerfect Courier fonts, including Courier 10cpi,
- # Courier 10cpi Bold, Courier 12cpi Bold, etc. to Courier New in Word
- # for Windows.
- #
- # In comparison, the mapping line
- #
- # Courier 10cpi Bold; Courier New
- #
- # will map Courier 10cpi Bold to Courier New, but will not affect
- # the conversion of Courier 10cpi, Courier 10cpi Italic, or Courier
- # 12 cpi.
- #
- # As the example above suggests, because the converter chooses the
- # longest <WPFontName> that matches a particular WordPerfect font
- # name, specific mappings override general ones. Therefore, whereas
- # you might choose to map Courier to Courier New, and Courier 10cpi to
- # Arial, if you also choose to map Courier 10cpi Bold to Times New
- # Roman, only the latter mapping will apply to Courier 10cpi Bold
- # because it more specifically matches the original WordPerfect font
- # definition.
- #
- # You can specify an <Attribute> as part of any mapping line. The
- # "bold" attribute directs that the resulting Word for Windows font
- # should always have the bold format applied. The "italic" attribute
- # directs that the resulting Word for Windows font should always have
- # the italic format applied.
- #
- # The attributes "light" and "roman are the opposites of "bold" and
- # "italic" respectively. The "light" attribute directs that the Word
- # for Windows font should specifically not have the bold format
- # applied even if the source WordPerfect font included this attribute
- # (for example, Courier 12cpi Bold). The "roman" attribute similarly
- # negates the italic attribute from a font that originally included
- # that attribute.
- #
- # The use of "light" or "roman" in a mapping line only negates bold or
- # italic attributes that were originally an inherent part of a
- # particular WordPerfect font. Bold and/or italic attributes applied
- # separately from the font definition itself (e.g. bold applied via
- # the WordPerfect F6 command) are retained.
- #
- # An additional font attribute that can be mapped is font size. You
- # can specify a point size <Attribute> on any mapping line. If the
- # point size <Attribute> exists, it overrides the point size the
- # converter would normally apply. This option is most useful for
- # non-scalable fonts (for example, if you wish to map Courier 10cpi to
- # Courier New 14), but can also be applied to scalable fonts (e.g. CG
- # Times Scalable). The effect on scalable fonts is to change the base
- # size of any variation of the source scalable font to the size you
- # specify in the font mapping file. The only item that need be
- # included in the point size <Attribute> is the size number. any text
- # following the number (e.g. "cpi") is ignored.
- #
- # Once again, as in the case of bold and/or italic attributes applied
- # separately from the font definition in WordPerfect, Size commands
- # (e.g. Fine, Small, Large, Extra Large, Superscript, etc.) will
- # override either the default or user defined font size mapping.
-