CD Actual 9

home *** CD-ROM | disk | FTP | other *** search

/ CD Actual 9 / CDACTUAL9.iso / share / W31 / VARIOS / DCMWIN / README.TXT < prev next >

Wrap

Text File | 1996-10-21 | 32.4 KB | 698 lines

Document Conversion Manager for Windows v4.0 ============================================ LIMITED USE VERSION =================== Authors : Pembroke International Ltd 15 Edmund Road Hastings East Sussex U.K. TN35 5JY Telephone / fax : +44 (0)1424-460803 E-mail : frank@pembroke-int.com Web : http://www.ftech.net/~pembroke Contact : Frank Sheldon Please report any errors by e-mail. Problem documents can be sent to the same address as either UUENCODED or MIME mail. Please contact us if you have any problems at all. Thank you. ==================================================================== Software files provided (62) : ---------------------------- INSTALL.EXE DCMWFWW.DLL DCM650S.DLL 450FONT.INI DCM.EXE DCMWP5W.DLL DCMVUES.DLL 650FONT.INI DCM2.EXE DCMASCW.DLL DCMCDFS.DLL WFWFONT.INI DCMVIEW.EXE DCMUPXW.DLL DCMRFTS.DLL ASCPRINT.INI DCMKERN.DLL DCMVUEW.DLL DDEML.DLL RFTPRINT.INI DCMSETUP.DLL DCMACTW.DLL OLECLI.DLL 650PRINT.INI DCMDOCR.DLL DCMRFTW.DLL OLESVR.DLL CDFFONT.INI DCMAMPR.DLL DCM650W.DLL SHELL.DLL PCAP.INI DCMRTFR.DLL DCMAMPW.DLL DCM.HLP SETUP.INI DCM650R.DLL DCMCDFW.DLL AMPLANG.INI LICENCE.TXT DCMUPXR.DLL DCMAMPS.DLL RTFFONT.INI INSTALL.TXT DCMWFWR.DLL DCMUPXS.DLL DOCFONT.INI README.TXT DCM450R.DLL DCMWP5S.DLL AMPFONT.INI ORDER.TXT DCM700R.DLL DCMWFWS.DLL 700FONT.INI NOTE-V40.TXT DCMWP5R.DLL DCMACTS.DLL WP5FONT.INI DCMCDFR.DLL DCMASCS.DLL UPXFONT.INI =========================================================== OVERVIEW ======== Document Conversion Manager works on the basis that there is a preferred work-station WP, and that the work-station may be receiving documents created by other applications, which need to be converted dynamically as they are needed for editing or viewing. If the work-station WP is a Windows application that supports DDE, and will act as a server to Document Conversion Manager, then the application may be activated, and the converted document loaded, ready for viewing, printing and editing. Launching documents is controlled through the Document Conversion Manager file selection screen. To access this screen, click on the Document Conversion Manager icon. The resulting screen provides directory browse and file selection, and displays the current path, the output path for converted documents, the work-station WP, and a check box indicating launch or non-launch of converted documents. Document Conversion Manager is seamlessly integrated with Windows, and does not need to be run from its icon, for conversion to be effected. Use File Manager Using File-Manager to select an "Associated" document will automatically convert and load the document. E-Mail attachments. Documents attached to E-Mail notes can be Works with MS-Mail converted in the same way, provided the and CC:Mail. file extension is "Associated" with Document Conversion Manager. Click on the attachment to automatically convert and launch the converted document. Use DCM. Click on the Document Conversion Manager icon, and use the standard file selection procedure to locate, convert and launch documents. Document Conversion Manager running from its icon is not dependent on any file/application associations being setup. Document Conversion Manager will automatically determine the document type, convert it to the work-station WP, and if required, activate the application and launch the document. COMMAND LINE USEAGE =================== Conversion can also be enabled through a command line, using DCM2.EXE DCM2.EXE takes parameters : <input path and filename> : <output path> : <document format> : < /S > Document format is a three character mnemonic : : amp Ami Pro : wfw Word.Windows : rft DCA-RFT : upx Uniplex : opw Officepower : wp5 WordPerfect 5.x : cdf Notes CDF : asc ASCII < /S > suppresses any messages that might be generated during conversion. eg : dcm2.exe c:\docs\testdoc.rft c:\convert amp /s ....converts a DCA-RFT document to Ami Pro format with no messages. The document name is preserved but the extension will be replaced by whatever is defined through SETUP for the pairing. ==================================================================== SETTING UP DOCUMENT CONVERSION MANAGER for WINDOWS v4.0 ======================================================= From the front screen press SETUP These controls determine how converted text looks, and where on the paper the text is to be presented. Which controls are available will be determined by the pairing of READER and WRITER. System controls --------------- Output file extension No change Fixed as Numeric incrementing from Display units Inches Centimeters Points Printer controls ---------------- Printer The choice of printer may dictate available fonts and form sizes/orientations. Different font and paper mapping may be done for each printer. Output paper Source form or any other paper size available. Selecting a paper size will force all READER input pages to convert to that paper size. Paper orientation will not be affected. Top crop area Initial values will be obtained from the Bottom crop area selected printer. If text margins infringe Left crop area these values, text will be repositioned at Right crop area the crop area. Any value up to a total of 1/3 of the paper width may be input. The DisplayWrite, Uniplex, OfficePower printers may not be attached to the Windows system where conversion is being effected. Values for target printers must be entered manually. The default values are 0.2" Text presentation controls -------------------------- Linedraw action Replace linedraw characters with spaces (ie strip); with bar characters, or with a font containing the linedraw character set. Linedraw font Select the linedraw font. Use tables only Translates multi-column text as tables. Sub/superscript These controls can be converted as a base- line change or as a font change, depending on the target application. Maintain formatted text Causes DCA-RFT text generated by controls to be converted as body text. The control generating the text is stripped. If documents are paginated, and text is not resolved into the document, then the control and the text will be stripped. Set prompted stops Translates Ami Pro bookmarks as single and multibyte controls to maintain the comment portion into DW370. The dual control is picked up by the DisplayWrite READER as a single control on the round-trip to re-create the bookmark with comment. Use space above/below Translates space above/below to DCA-RFT as either RCR or sub/superscript controls, or ignores any value. Stops for bullets Translates all Ami Pro bullet characters to DCA periods. Use counter controls Translates Ami Pro numeric bullets to DCA counter controls, or the text equivalent of the control. Sonoran width scaling Allows the average character width to be scaled accurately relative to the effective pitch. Map Extended Character If your DW370, environment does not Set support graphics/extended character set, then any character that would have had a match in that set can be mapped to a default character. Text scaling Horizontal Scale - Select this option if text infringes the right-most print position, and you want to maintain the horizontal layout of your document. Text will be auto-scaled in percentage increments until it will fit on the paper. Scale to paper - Select this option to auto-scale documents in both axes to maintain text on the selected paper size. A3 documents can be scaled to A4 paper. Ignore Right Indents This control causes any right indention to be ignored when converting to DCA-RFT, to reduce the number of LineFormatChanges. Fix output typestyle Converts documents constructed with multiple fonts/sizes to DCA/RFT as a single typestyle. The DCA/RFT document is fully reformatted between the column margins defined by the Fix Output Margins control. This control over-rides any font-map settings. FixRFTFont=86 will produce Prestige Elite throughout the converted document. Any valid fixed pitch or PSM typestyle number may be used. Fix Output Margins Sets the column margins for the DCA/RFT document. This control is actioned only when Fix Output typestyle is non-zero. Used together these controls enable graphically created documents to be displayed on a dumb terminal and edited by DW370. FixOutput Margins=12,72 when used with Fix Output Typestyle = 86 will produce a DCA/RFT document with left and right margins of columns 12 and 72 respectively formatted as 12pitch throughout. The document will be reformatted horizontally maintaining indentation; and will be correctly re-paginated Hyphenation Sets hyphenation on or off when converting documents into Ami Pro. AutoLineHeight Prevents AutoLineHeight and enables spacing as Fixed / AtLeast. Vertical metrics vary by application. Word has tight metrics, so source documents created with "Auto" line spacing may convert to Word with incorrect pagination. Output headers/footers For target applications that do not support header/footer controls this feature converts header/footer as text. Define bookmark OfficePower utilises non-printing characters as placemark controls to enable fast navigation around a document. This control allows the non-printing characters to be identified and marked for conversion as either a space code, the original character, or a true book mark in the target application. Text positioning controls ------------------------- Set margins This will fix the document margins at the values set in the crop areas. Maintain text position Causes text positioned by required backspace and ZICR controls to be positioned within a frame. Target applications that do not support this function will be presented with sequential text. Body text adjustment Enables the last typing line in a DCA/RFT document to be increased in 1/100" increments, which can stop Ami Pro breaking pages too early. Page breaks Forces all pages to be terminated with a required page break. The Officepower v450 & v650 READERS take a second parameter "Page length", which sets the document maximum vertical print position at the page length value (typically 66 lines / 11" )set in the Officepower document. Soft page breaks will be stripped, allowing the document to paginate naturally in the target application. Without this parameter the Officepower footer will be positioned with respect to the bottom edge of the page, allowing the body text depth to increase by the difference between the paper size and the page length setting. Set absolute tabs Sets tabs with respect to the page edge rather than to the left margin. Strip Non-Text Objects If you are not using protocol driven printers, graphics may cause printing problems. Use this control to strip graphics from your documents when converting to DCA-RFT. ========================================================================= Application defaults -------------------- Uniplex, WordPerfect and OfficePower documents do not always contain page layout or font information. This information can be stored externally from the document. This information needs to be provided to the conversion process to enable correct conversion. Controls are provided through SETUP. The default settings are : Source document : UNIPLEX ------------------------- Font name FX-Normal Font size 12pt 10 pitch This value is used where a font size is not defined within your documents, or a font size is not defined within UPXFONT.INI Paper size A4, portrait orientation Print margins Printer crop areas. These values are set at the default printer crop areas at install time. These values do not change if a new printer is selected. These values can be changed to conform to the Uniplex system print defaults. Default ruler Document Conversion Manager will use a default ruler that contains sufficient increments to span the printable width at the default font. Printer instructions If your Uniplex documents contain printer control strings to enable font changes, these control strings must be setup in UPXFONT.INI. If they are not mapped, they will be ignored, which may lead to incorrect formatting and pagination. N.B. We recommend that Uniplex document print margins be set at, or close to, the printer crop margins when converting documents containing graphic line-draw. Source document : WORDPERFECT ----------------------------- Font name Courier Font size 12pt 10 pitch This value is used where a font size is not defined within your documents, or a font size is not defined within WP5FONT.INI Paper size A4, portrait orientation Default ruler WordPerfect default ruler. Extra large 200% Font size is automatically Very large 150% adjusted by these percentages Large 120% Small 80% Fine 60% Superscript factor 60% Subscript factor 60% Source document : OFFICEPOWER ----------------------------- Font name Auto Select / Courier Font size 12pt 10 pitch This value is used where a font size is not defined within your documents, or a font size is not defined within 450FONT.INI/650FONT.INI Paper size Auto Select / A4 portrait DCM uses its paper-size definitions as a preference list. This means that, with "paper-size = Auto Select" and "font = Auto Select", DCM will attempt to fit text on to the first paper-size defined in the list using the first font definition in the font list. If text will not fit using the first font, DCM moves down the list in sequence looking for a fit. If all fonts fail to produce a fit DCM repeats this process with the next paper-size in the list. If no fit is found DCM defaults to the default Windows form size and system font, or A4 12 pitch if no printer has been defined. If your OfficePower documents always conform to a standard layout, select the correct paper-size and font defintion. ==================================================================== SETTING UP DOCUMENT CONVERSION MANAGER for WINDOWS v4.0 ======================================================= USING THE ???FONT.INI FILES =========================== All READERS have an associated ???FONT.INI file. These files are ASCII format and provide the conversion programs with information about READER Fonts, font sizes, font attributes and line-spacing values, and allows READER text enhancement codes to be defined or re-defined for conversion purposes. These files are UPXFONT.INI Uniplex source document DOCFONT.INI DisplayWrite " " WP5FONT.INI WordPerfect " " WFWFONT.INI Word for Windows " " 450FONT.INI OfficePower v450 " " 650FONT.INI OfficePower v650 " " AMPFONT.INI Ami Pro " " CDFFONT.INI Lotus Notes CDF " " Correct use of these files enables complex documents to be sent to editors with limited font resources or printing capabilities so that they can be edited and returned to the originating application intact. Eg A TimesRoman face at various point sizes can be mapped to a variety of fixed pitch fonts/faces. The reverse conversion simply maps these fonts/faces back, by defining each font/face at a specific size, and through the FONT MAP SCREEN each font/face can be mapped to a typographic face. The following text describes the use of UPXFONT.INI. ie where Uniplex is the READER and documents are to be converted to any of the WRITERS ================================================================ SETTING UP DOCUMENT CONVERSION MANAGER for WINDOWS v4.0 ======================================================= USING THE ???FONT.INI FILES =========================== UPXFONT.INI enables you to decide how your Uniplex fonts convert into WRITER fonts. If you have decided on different layouts for letters, memos, manuals etc, then you will be able to automate a substantial amount of edit work by affecting the font size, spacing and attributes for typographical faces that you wish to appear within your converted documents. UPXFONT.INI may be edited in a text editor, such as Windows notepad. Do not use a word-processor. All measurements are in points (1/72"). Any value will be accepted. UPXFONT.INI provides default font information, where there is no font size or attribute description within the Uniplex document. UPXFONT.INI enables font size settings within your documents to be over-ridden. UPXFONT.INI enables printer control strings that cause a printer font change to be defined. The font descriptions are displayed within Document Conversion Manager at the Font Map screen. Each line is a complete font description comprising: Font descriptions : The name of the font. Font Number : is used by Document Conversion Manager to differentiate font types ie fixed pitch, serif and sans-serif. There are three number ranges : 01 - 400 fixed pitch courier 401 - 32767 proportional serif / Times Roman 32768 - 65535 proportional sans serif / Helvetic Font Size : '0' means use the font size detailed in the document, or if no size is specified, use the default size setting from the SETUP screen. Any other value in points means convert this font at this point size regardless of the size specified in the document. Spacing : '0' means use the active document spacing value for this font. Any other value in points means, convert this font at this spacing value regardless of the document setting. Attributes : sets the conversion attribute(s) for this font. Text enhancement This section allows the alphabetic attribute letters definition to be defined. Effects This section details font definitions that contain either bold or italic enhancement. In UPXFONT.INI you will see : field no. 1 2 3 4 5 11, FX-Normal 0, 0, 0 Changing the '0' in field 3 (font size) to 10, instructs Document Conversion Manager to replace the definition within the Uniplex document with this new value. In this case, FX-Normal, would convert as a 10pt 12 pitch font with line-spacing per the active definition, and with a plain non-enhanced face. The face will depend on mapping. Changing field 4 to 24 tells Document Conversion Manager to force line-spacing to three lines per inch for all occurances of FX-Normal. Changing field 5 to 'AI' tells Document Conversion Manager to convert all occurances of FX-Normal with Bold and Italic enhancements. Any legal Uniplex attribute, as defined in the Attribute section of UPXFONT.INI may be added. Adding printer control strings. - Select a font number that reflects the face that your printer control string is intended to produce. - In the font description field, type the printer control string exactly as it should appear in the document. - Add the required point size, line-spacing values and any attributes. e.g. 86, .sn xxxxxxxx, 14, 0, A "xxxxxxxx" = the font change escape sequence. "14" = the required font height. " 0" = maintain document spacing values. "A" = add bold enhancement. Default mapping UPXFONT. INI defaults to the following values. Uniplex Writer Pitch FX-Normal 10pt FX-Large 16pt FX-Small 8pt PS-Normal 10pt PS-Large 16pt PS-Small 8pt Scalable fonts As defined Linespacing As defined Attributes As defined Things to remember If you edit font sizes be sure that your system has that font and size available, and that your printer can print at that size. ===================================================================== SETTING UP DOCUMENT CONVERSION MANAGER for WINDOWS v4.0 ======================================================= FONT MAP ======== From the SETUP screen, select the pairing for which you want to create a font map, and press FONT MAP. This feature enables READER and WRITER typestyles and fonts to be interchangeable by face name and size. Printer This is the printer currently selected through the SETUP Controls for the currently displayed pairing. Mapping is system and printer dependent. Make sure that you have selected the correct pairing and printer before mapping your fonts. Target typeface This is the typeface to which you will map source document fonts. Fonts already mapped to this face will be displayed in the Mapped Typestyles box. A default typestyle mapping is done by the Install program, based on the Windows default printer. Unmapped typestyles This box displays source application fonts, listed in ???FONT.INI, that have not been mapped to a Target Typeface. If your source documents contain fonts, listed in ???FONT.INI, that have not been mapped, then those typestyles will convert according to their font number at the appropriate point size. To map source document typestyles : - First make sure that ???FONT.INI contains correct font descriptions. (See "Using UPXFONT.INI"). - Make sure that you have selected the correct Target application and printer. - Select your Target Typeface. - Highlight the Uniplex fonts that you want to map. - Press the ADD button. Your source fonts will be placed in the "Mapped typestyles" box. Mapped typestyles This box displays those source fonts that are mapped to the currently selected Target Typeface. To unmap source fonts : - First make sure that you have selected the correct pairing and printer. - Select your Target Typeface. - Highlight the source fonts that you want to unmap. - Press the REMOVE button. Your source fonts will be added to the "Unmapped typestyles" list. If your source application supports scaleable fonts (TruType or Adobe etc), and your target application does not (DisplayWrite / Officepower v450), then the "Target Typeface" box will be described as "Reader Font", and will contain all fonts available to the READER. The Unmapped typestyle box will contain all WRITER typestyles/fonts which are to be mapped to the READER font. Multiple WRITER typestyles can be tied to a READER font family. A READER font - TimesRoman - will be mapped to one of the mapped typestyles that most closely matches the READER font size. If your WRITER is DisplayWrite you may decide to map typestyles 10, 85 and 223 to font Courier. A READER font size 12 pt will map to typestyle 10, 10pt will map to typestyle 85 and 8pt will map to typestyle 223 Unmapped Word for Windows/OfficePower/WordPerfect fonts will convert as either Courier, TimesRoman or Helvetic faces depending on the numbering set in ???FONT.INI. Unmapped DisplayWrite typestyles will convert as : Fixed pitch typestyles = Courier. PSM typestyles = Courier. Scalable typestyles = TimesNewRoman/Helvetic ================================================================ TROUBLESHOOTING =============== Check the file DCMLOG.TXT which will be found in your DCM installed directory, if there were errors detected by the conversion process. eg unrecognised font description, unknown control, non-supported controls. NB. DCMLOG.TXT is reset each time DCM.EXE is run. Error logging is valid for each session; it is not cumulative. Text wraps incorrectly. Have you set the correct default font and /or point size ? Are your READER fonts correctly mapped ? Are the document print margins correct ? Have you increased the printer crop areas in the WRITER Controls ? Text is too wide. Try reducing the default point size. Do you have this font/size available ? Pagination is wrong. Have you set top and bottom margins correctly ? Have you reduced the printable width, by setting large left and right print margins ? Is text in the right font ? Have you selected to convert text onto a different paper size, and not scaled the document ? Is hyphenation handled in the same manner by the source and target applications ? Is hyphenation set on or off in DCM.INI ? Fonts don't map Any font not listed in ???FONT.INI will correctly. default to either Courier or TimesRoman at 10pt. Each time DCM is run and unlisted fonts are found in the source documents, a log file DCMLOG.TXT is created in your DCM directory. These font names must be entered in the READER ???FONT.INI file EXACTLY as they are in the log file, and then mapped via the FONT MAP setup screen. This problem is most likely to occur with the WordPerfect READER, as WordPerfect provides explicit font names. Word for Windows gives Increase the "Minimum Margins" settings a "Document Margins set by a few 1/100". This message is peculiar ourside printable area" to Word for Windows. error message. END