| Manual | Y. Kusimi, Senshu, Togashi |
| Integration into Ver. 2.34 | sempa |
| PC-9801 High-Resolution Mode | OkI |
| DOS/V | SOLITON, hero.h |
| AX | Akiii |
| J-3100 | sempa, hero.h, Senshu |
| HP100LX | HARUYA |
| ESC/Page | Tomiie, OkI |
| LIPS III ESC/Page Integration | OkI |
| tpic specials | Oh-Yeah? |
| New size option | Yoshizawa |
| pTeX | Naochan! |
| NTTJTeX | Yakumo |
| Shotai Kurabu Font | Hideki Yoshida, Minagawa, Mukauchi |
| JG Font | Naochan! |
| TrueType Font | Matsuda |
| FLI Format Font | Hideyasu Yoshizaki |
| Reducing and Enlarging the System Font | Naochan!, Yoshizawa, Matsuda |
| Function to automatically generated a missing font | Yakumo |
| PostScript | Takanori Uchiyama |
| PBM Image Data | Yakumo |
| GIF Image Data | Asayama |
| Page description language embedding | Sadayuki Iwai |
| Windows 95 Version | Otobe |
| Raw mode printer output in Windows | Matsuda |
| Virtual Fonts | Matsuda |
| Source for VC++ | Kenji Yorimoto |
| Help in English | Scientific Software Department, Application Software Division, NEC Corporation, Haruhiko Okumura and Hiroo Hongo |
c:\tex\texmf\fonts\pk\cmbx10.300pkand the jfm file Japanese font in c:\tex\texmf\fonts\public\ptex\tfm, for example, for min8 as in
c:\tex\texmf\fonts\public\ptex\tfm\min8.tfmthen the specification in -TEXROOT: and -TEXPK: would be
c:\tex\fonts\cm\300\cmbx10.pk(cmbx100 of 300 dpi font and lcirclie10 of 360 dpi font), and the Japanese text jfm file is in the same manner as the first Example 1, then the description for -TEXROOT: and -TEXPK: would be
c:\tex\fonts\latex\360\lcircle1.pk
c:\tex\fonts\pk\msbm10.300pkthen TrueType Fonts are specified in Property Sheets->[WinJFont] and the corresponding tfm files are indicated by -TEXPK: But any tfm file which is not corresponding to a TrueType font can not be matched in -TEXPK:
c:\tex\fonts\jfm\min8.tfmThen -TEXPK: would be
| version | Version number of dviout such as 3.03.2. |
| dvifile | The full pathname of the dvi file being previewed. It is NULL string if there exists no such file. |
| current_page | The current page of the dvi file. The return value is as 10(6), which shows "physical page(logical page)". |
| total_page | The last page number of the current dvi file. The return vale is in the same format as above. |
| time_stamp | The timestamp of the current dvi file. |
ddeinitiate "dviout", "dviout";The c:\document\foo.dvi file is opened and the Print dialog appears. When printing ends, the DDE connection ends, and dviout exits.
ddeexecute "[FileExit]";
ddeexecute "[FileOpen(c:\\document\\foo.dvi)]";
ddeexecute "[FilePrint]";
ddeterminate;
| [Reverse] | [Blank TopTop] | [right to left] | |
| (1,2) -> (3,4) -> (5,6) -> (7, ) | |||
| X | (7, ) -> (5,6) -> (3,4) -> (1,2) | ||
| X | ( ,1) -> (2,3) -> (4,5) -> (6,7) | ||
| X | (2,1) -> (4,3) -> (6,5) -> ( ,7) | ||
| X | X | (6,7) -> (4,5) -> (2,3) -> ( ,1) | |
| X | X | ( ,7) -> (6,5) -> (4,3) -> (2,1) | |
| X | X | (1, ) -> (3,2) -> (5,4) -> (7,6) | |
| A | B | C | D | E | F | ||||||
| 95 | cmcsc10 | (240) | * | c:\tex\fonts\pk\dpi300.gth cmcsc10.pk | PK | ||||||
| 53 | min8 | (300) | c:\wintex\jfms\min8.tfm MS Mincho(30x29) | WinAPI | |||||||
| A: | Font number written in the dvi file (usually from 1 to 255) |
| B: | Font name |
| C: | Value of the required dpi |
| D: | * use the substitute font for the missing font |
| ! put a space for the missing font | |
| # draw a black box for the missing font | |
| + use the substitute font with scaling for the missing font | |
| t refer the tfm file and put space for the missing font | |
| ^ no information available (although no substitution) | |
| E: | Path name of the font actually used |
| F: | Font type (? means that the font has not been employed, so no information available with its font type.) |
| no part | No truncation (lcircle10) |
| last part | Truncate end (lcircle1) |
| middle part | Cut middle (lcirle10) |
Click \href{#foo}{here}
......
Jump to \name{foo}{here}
Obtain the latest version of dviout for Windows from
\href{http://akagi.ms.u-tokyo.ac.jp/ftp-j.html#TeX}{here}
dviout corresponds to
moving to \href{file:.\hypertex\hyper2.dvi#jump}{other dvi file}
where is based on the directory containing the displayed document,
displaying \href{file:\index.html}{HTML file}
and accessing other resource, for example, \href{file:MyMovie.avi}{AVI file}
[Loupe]
<- Property Sheets
The functions of Loupe are specified which appears when the right button of the mouse is pressed. The setting here is [Save]d to the common position for the modes in Registry.
If you press the right mouse button with CTRL key, an another Loupe appears. You can specify its setting in the area shown by the frame "Option(+CTRL)".
Size: specifies the length of one side of the loupe or the diameter of a round loupe in pixel (dot) units.
Scale: specifies the reduction ratio with the original dpi. For example, if the original dpi is displayed by the gray scale compressed to one sixth and the Scale: is set to 2, the portion expanded by three times is displayed by the loupe.
Speed: Increase this number if the loupe afterimage remains and makes viewing difficult. The lower the value would result in smoother motion.
Shape: selects the loupe shape -- circle or square. The square shape would work faster.
Back: specifies the background color. Set the color to white when the display is not reversed or black when reversed, then the flickering while the loupe moves would be reduced.
[Graphic]
<- Property Sheets
-tpic: specifies whether to enable tpic specials, and when enabled, to use Bezier curves (default) or spline curves when drawing curves.
-GS: You can select the processing for PostScript specials or Image data files such as PS/EPS files, PBM files, or GIF files.
-gbox: If you check this box, an outer frame of an imported image is displayed. This option is enabled even if the image file import function is turned off by -GS:.
-gfit: specifies whether to use the reduced size of an intermediate color BMP file when handling a PostScript color image in a reduced display using the gray scale.
-gsize: specifies the size of the imported EPS/PS image by PostScript specials with/without magnification value when the specification of magnification for the dvi file is not 1000.
-GIF: selects the format of the image file generated using Ghostscript. The default is raw PBM. When this is set to BMP (256 colors), the file is treated as a color image.
The file name of the image data created from a PostScript file is one whose extension is changed to .pbm, .gif, or .bmp.
-gdat: With this parameter, you can specify the directory having PBM, GIF or BMP files. The default is the Current Directory.
-gsx: With this parameter, you can specify the path for Ghostscript program. In most of the case, gswin32.exe might be on your path.
You can also specify some parameters for Ghostscript with -gsx:.
In this case, replace spaces with "^" as the delimiters to set, like following:
-gsx:c:\bin\gswin.exe^-dNOKANJI
-gow: If you check this box, the overlapped image data with other image data or characters is overwritten on them.
-gclip: If you check this box, the image date generated by EPSF is clipped by BoundingBox.
-spi: This parameter shows the directory where Susie plug-in exists. Under Susie plug-in dviout can handle grahic files in various formats.
-color: enables coloring the characters or the lines by \special.
-cmode: The mode (auto, merge, replace) is set when the color assignments are superimposed by color specials.
tpic specials
tpic is based on the Troff figure preprocessor, tpic, by Brian Kernighan and is the name of the TeX figure preprocessor written by Tim Morgan and the special command set output by it. The LaTeX macros include eepic. (For details, see the included documents.)
dviout supports the usual tpic specials commands (tpic 2.2).
pn, pa, fp, ip, da, dt, sp, ar, ia, sh, wh, bk
In addition to expanding the da command in dviout, the new rt and Bz commands are provided to expand original tpic specials(tpic specials extensions).
Note: Since dviout processes every page, when a page is skipped while displaying or Printing, the line width of the previous page is not generated and the default line width is used. If you employ a line width other than the default in a series of pages, it would be better to insert pn command on each page or before a series of tpic specials.
Note: Erasing by painting over with white when shading is not supported for color images.
When printed on an LBP using a built-in driver, erasing is not supported for built-in LBP Japanese fonts or downloaded fonts.
Note: In dviout, reading specials from a file is possible. This is useful when revising complex tpic specials.
tpic specials commands
The origin of the position of each graphical element is the page position maintained by TeX. The direction to the right is the positive direction of the X axis. The downward direction is the positive direction of the Y axis. The coordinates are represented by integers in milli-inch (0.254 mm) units.
An angle is measured in radian units clockwise from the positive direction of the X axis and has a value from 0 to "2 times pi". By the command for drawing arcs, with setting the starting angle to zero and the final angle to "2 times pi" or more, a full circle or an ellipse can be drawn.
- \special{pn s}%
- The line width is set to s milli-inches.
- \special{pa x y}%
- The point (x, y) is added to the path.
- \special{fp}%
- The path defined previously is drawn with the current line width. If shading is set and the path is closed, the interior of the path is painted. The number of points in the path is reset to zero.
- \special{ip}%
- This is similar to \special{fp}, but the path is not drawn. If specified, there is shading.
- \special{da f}%
- This is similar to \special{fp}, but the path is drawn with dashed line. f is a real number that specifies the length of each dash in inches (cf. tpic specials extensions).
- \special{dt f}%
- This is similar to \special{fp}, but the path is drawn with a dotted line. f is a real number that specifies the gap between dots in inches.
- \special{sp d}%
- This is similar to \special{fp}, but the path is drawn with spline curves. d is a real number that specifies the type of curve
- If d = 0 or is omitted, solid lines are drawn.
- If d > 0, dashed lines are drawn. d is the length of a dash.
- If d < 0, dotted lines are drawn. -d is the gap between each dot.- \special{ar x y u v s e}%
- draws an arc centered on (x, y). s is the starting angle. e is the final angle. These real numbers are in radian units.
For a complete circle or ellipse, u and v represent the x and y radii, respectively. Otherwise, u=v, and an arc is drawn from s to e. If specified, there is shading.- \special{ia x y u v s e}%
- is similar to \special{ar x y u v s e}, but does not draw the arc. If specified, there is shading.
- \special{sh s}%
- specifies shading. The interior of the closed figure (three or more pa's followed by fp or ip, or ar or ia) defined after this command is painted.
s is a real number between zero and one. Zero means paint over in white. Anything below the figure, including text, is complete erased. A value other than zero means gray. Anything below the figure is not erased but is painted gray.
The default is 0.5 and is gray. One means black. If s is not specified, the value 0.5 is used. Only the interior of a figure is shaded. The boundary lines are independent on this specification and have the current line width.- \special{wh}%
- Same as \special{sh 0}.
- \special{bk}%
- Same as \special{sh 1}.
tpic specials extensions
The dviout tpic specials has the following extensions over the original tpic specials. Be aware that since they are only supported by dviout, dvi files containing them have compatibility problems.
da command extension
To make it useful in drawing graphs with tools such as gnuplot, the da command is extended and takes multiple arguments.
The arguments alternately specify the lengths of the solid lines and the spaces in real numbers in units of inches. Thus, a dashed line is drawn by repeating the specified pattern. Each point in the path is passed through successively. In other words, each point is not limited to being on a solid line portion. For example,
\special{da 0.1}% o___ ___ ___o___ ___
\special{da 0.1 0.1}% o___ ___ ___ o ___ ___
\special{da 0.1 0.01 0.01 0.01} % one-point chain line
\special{da 0.1 0.01 0.01 0.01 0.01 0.01}% two-point chain line
rt command extension
This command has several functions relating to rotation, enlargement, and inversion. It takes variable number of parameters.
When used as rt p where p is an integer, the command has the following meanings:
- If p = 1, it puts the current state of linear transformation on top of the stack. If p is -1, it pops and returns the transformation from top of the stack, or returns the identity transformation when the stack is empty. The stack can grow as deep as 16 levels. The stack gets emptied at the start of each page.
- If p is 2, included images are drawn without erasing whatever is currently on the canvas (-gow:-). If p is 3, images are drawn after erasing the regions (-gow:+). If p is 4, the graphics overwrite mode (-gow:) is restored to the one just before executing the previous rt 2 or rt 3.
- rt 0 is the same as rt 0 0 0.
The command rt h v scales all subsequent text and graphic outputs horizontally by a factor of h and vertically by v around the current point. The scaling factors may be negative.
All of the text and graphics output after rt x y f are only rotated by the angle f about (x, y).
As with other tpic commands, x and y are integers in units of milli-inches, and f is in positive radian units in the clockwise rotation.
The rotation is not relative, but is always with respect to the absolute coordinates of the bitmap. Setting f=0 resets.
For example,
\begin{picture}(500,500)
\put(100,250){\special{rt 0 0 4.71239}\makebox(0,0){Leftside}%
\special{rt 0 0 0}}
\put(250,250){\special{rt 0 0 3.14159}\makebox(0,0){Upsidedown}%
\special{rt 0 0 0}}
\put(400,250){\special{rt 0 0 1.57080}\makebox(0,0){Rightside}%
\special{rt 0 0 0}}
\end{picture}
All the text and graphics output after the command rt h v w z are linearly transformed around the current point by
(X,Y) -> (h*X + w*Y, z*X + v*Y)
The above transformations are similarly resumed by \special{rt 1 1}, \special{rt x y 0} or \special{rt 1 1 0 0}.
The transformation changes into the composition with the transformation at the top of the stack (which is the identity if there exist nothing there). This implies that the transformation is replaced by the defined one if the stack is empty. For example,
\special{rt 0 0 -.5236}%
\special{rt 1}%
\special{rt 1 2}%
text
\special{rt -1}%
\special{rt -1}%
means that the string "text" is scaled by 2 only vertically and then the result is rotated by the angle of 15 degree in the counter clockwise direction.
Bz command extension
This command switches from a spline curve to a Bezier curve or the reverse for drawing curves with the sp command.
The \special{sp} after \special{Bz 1} switches to Bezier.
The \special{sp} after \special{Bz 0} switches to spline.
The default is to use Bezier curves. The -tpic=2 option can switch to spline curves.
reading specials from a file
tpic specials or any number of consecutive \special can be written to a file and read. The TeX format is
\special{file=file_name}
\special is written in file_name.
The search path for the file is identical to the one for a BMP file so the Current Directory and the directory indicated by -gdat: are searched.
If % appears in the file, everything until the 0x0a newline code is ignored.
Only the parts enclosed by {...} in \special{...} in the file are interpreted. Other parts are ignored.
Even if there is { } nesting in this {...}, the processing is correct. In addition, all of the character codes below 0x20 in {...} are replaced by spaces.
One {...} is allowed to contain a maximum of 4000 bytes.
BMP file
A BMP file is the standard image file supported by MS Windows. (dviout can read them in as Image data files and save the displayed view as a BMP file.)
In dviout, each page is expanded into a BMP file for displaying or Printing. The data in a color image file are composed when displaying or printing. The common uses are
- Monochrome (black-and-white) BMP file that is not enlarged or reduced, or is printed
- 16-color BMP file for a gray scale display
- 256-color BMP file for searching or when colored by HyperTeX
In addition, an uncompressed BMP file of 65,535 colors or 16.77 million colors can be read.
Example In one A4 page, the standards for the BMP file sizes for dpi = 300 are as follows.
1:1 monochrome BMP: about 1 Mbyte
1:1 256-color BMP: about 8 Mbytes
1:1 full color BMP: about 24 Mbytes
16-level gray scale BMP compressed by 1/4 (75 dpi): about 256 kbytes
256-color BMP compressed by 1/4 (75 dpi): about 500 kbytes
Image data file
dviout can read image data files in the PS/EPS, monochrome GIF, raw PBM, BMP (monochrome, 16 colors, 256 colors, 60,000 colors, full color) formats and many other formats. (The files must be placed in either the directory containing the dvi file or the directory specified by -gdat:.)
See "Image data file specials".
For viewing these Image data files, checks the item Ghostscript under "Property Sheets->[Graphic]" as On (-GS:).
If you want to handle PostScript files, you need Ghostscript which supports the raw PBM or monochrome GIF specified by -GIF: or the BMP output (corresponding to multiple colors). Then, specify the full path name in -gsx: (or press the button to open the executable file).
Image data file specials
dviout can read Image data files in the PS/EPS, monochrome GIF, raw PBM, and monochrome and color BMP formats. Using Susie plug-in(cf. spi:), dviout can read other formats(GIF/JPEG/TIFF/PCD/PPM etc). The images can also be printed by Including printer control codes into TeX file.
For an encapsulated PostScript file (EPSF), Ghostscript can be used to import images. The \specials supported by dviout are
epsfile=epsf_file [parameters]
which is used by (ecl)spsf.sty or epsfig.sty, or
PSfile=epsf_file [parameters]
which is used to output graphicx.sty in the LaTex2e graphics package to dvips.
epsf_file is the name of the EPS file. The name can be enclosed by double quotes ("") as in "foo.ps" or not as in foo.ps. Of course, these specifications can be directly written in the TeX text as \special{...}.
In addition,
postscriptbox{widthpt}{heightpt}{epsf_file}
that is output by epsbox.sty is also supported.
For information about [parameters], see "PostScript special parameters" or "Examples using PostScript specials".
The following \specials are supported respectively for PostScript files not containing %%BoundingBox:, raw PBM files (can omit the .pbm extension), monochrome GIF files (can omit the .gif extension), monochrome or color BMP files (can omit the .bmp extension) or files handled by Susie plug-in:
psfile=ps_file [parameters]
pbmfile=pbm_file [parameters]
giffile=gif_file [parameters]
bmpfile=bmp_file [parameters]
(The raw PBM style file called pbmf.sty is provided with dviout.) [parameters] can be hsize, vsize, hscale, vscale, scale, truesize and reverse (cf. PostScript special parameters).
ps: PS code
or
" PS code
can be processed (in the latter, one space is required after the double quote ") if PS code is a complete PostScript code to draw a picture.
When the graphicx.sty of the LaTeX2e graphics package is used in dvips output, all the key words in the package can be handled with the following limitations.
1. The image written by PostScript can be rotated
by the angle of interger multiple of 90 degree. The rotations by other angle is not supported. The rotations of the colored image in any other file format are not supported, neither.
2. Scalings of colored images not written in the PostScript are ignored.
3. The last parameter of \DeclareGraphicRules should not be a command.
4. \pagecolor is only valid in the page where is is declared.
5. dviout makes files in BMC format to handle Postscript files but BMC files can be handled by dviout as if they are BMP files. When BMP files are requested, dviout first searches the corresponding BMC files and uses them if they exist.
The following are examples.
\includegraphics[<key val list>]{file}
\includegraphics*[<key val list>]{file}
\rotatebox[<key val list>]{angle}{text}
\scalebox{<h scale>}[<v scale>]{text}
\textcolor{<name>}{text}
PostScript special parameters
hsize=width vsize=height : These represent the width and height of the imported image, respectively. %%BoundingBox: in the EPS is read and the scale is changed to the specified size (if only hsize or vsize was specified, the vertical-to-horizontal ratio is kept).
If the width and height represent lengths and units (possibly, cm, inch, or mm) are not given, they are interpreted as point values (72 pt = 1 inch) in PostScript.
hscale=w vscale=h : The horizontal and vertical scale conversion factors are specified in real numbers. If only one is specified, a similarity transformation is performed.
scale=s : The similarity transformation is done s times.
llx=x1 lly=y1 urx=x2 ury=y2 : These have the same meaning as the %%BoundingBox: specification and indicate a rectangular image slice where (x1,y1) and (x2,y2) are the vertices of a diagonal. The unit is the PostScript pt and is the value before scale conversion.
rwi=ww rhi=hh : Although they have the same meanings as the hsize= and vsize= specifications (only one can be specified), the values of ww and hh are 10 times the pt in PostScript.
hoffset=h_off v_offset=v_off : The positions when taken from an EPS file are shifted in the horizontal and vertical directions. Similar to width, h_off and v_off are given as lengths.
truesize : The size is not affected by the magnification in the dvi file or by -mag:, -e:, etc.
clip : When taken from EPS, the image protruding into the border is cut off. By default, the border is 1 inch wide.
reverse : Black and white reversal (This is ignored if the image is handled as color.)
Examples using PostScript specials
- when using graphicx.sty in the LaTeX2e graphics package
\usepackage{graphicx, color}
\includegraphics*[width=8cm, height=12cm, keepaspectratio]{golfer.ps}
\includegraphics[bb=0 0 2in 2in]{figure.bmp}
\rotatebox[origine=c]{180}{...Like This...}
{\color{red}This is red.}
In this case, the four added files of dviout.def, graphics.cfg, graphicx.cfg, and color.cfg, or graphics.cfg and color.cfg containing only the line shown below are placed in the same directory as the graphics package.
\ExecuteOption{dvips}
- when using graphics.sty in place of graphicx.sty, then
\includegraphics[8cm,6cm]{figer.bmp}
In this case options such as keepaspectratio cannot be specified.
- when using Susie plug-in to handle graphic files in other formats, then, for example, {figer.bmp} in the above is replaced by {figer.jpg}. In this case, the attached dviout.def should be used.
- when using LaTeX2.09 with epsf.sty
\documentstyle[epsf]{article}
\begin{center}
\leavevmode
\epsfsize=87mm
\epsfbox{golfer.ps}
\end{center}
- examples of using special commands
\special{epsfile=golfer.ps hsize=5.2cm vsize=7.5cm}
\vspace{9cm}
\special{pbmfle=tiger vsize=5cm}
\vspace{6cm}
\special{epsfile=golfer.ps scale=0.5}
-GS: specifies the processing of the \special related to importing an Image data file.(For details, see "Property Sheets->[Graphic]")
Ghostscript
This program is needed for dviout to interpret PostScript code. At this writing,
gswin32.exe/gswin32c.exe Ver.5.03
for Windows 95 can be patched to use Windows 95 TrueType Japanese fonts. Note that this program does not support monochrome GIF format (cf. Q_E4).
Current Directory
dviout for Windows sets the drive and directory where the currently displayed dvi file exists to the current drive and the current directory.
However, this is not the case if the dvi file is on the network or the dvi file is not displayed.
The current directory becomes the first search path for the image file imported by specials.
[Printer]
<- Property Sheets
On this sheet, you can set the characteristic properties for the printer or its driver.
The adjustments are saved in the Registry by [Save] and are applied to the current session by [Apply].
When the values saved in the [REGISTRY] become the defaults at start-up, all of the corresponding options are checked by [Auto Load] in the [REGISTRY] sheet and [Save]d on the [REGISTRY] sheet. (By default, all of the saved options are loaded as the defaults at
start-up.)
-area:(Use default area for system driver) When a Windows printer driver is used, this driver's defaults are used and the following settings for the widths of the unprintable areas are ignored.
-LM: Width of the unprintable area on the left side of the paper
-TM: Width of the unprintable area at the top of the paper
The origin in a TeX dvi file is located one inch to the right from the left end of the paper and one inch from the top. Usually, the printer cannot print from the top left edge of the page. If these unprintable areas are not corrected, the origin on pages might be offset to right downward.
If the Windows defaults is not proper, remove the check for -area:, then adjust -LM: and -TM:. The dvi file for printing position adjustment is provided with dviout. The origin of this dvi file should be correctly positioned (cf. Adjusting the Print Position).
If these values are increased, the printing position on the paper is shifted to left or upward. (These parameters are used to correct the position difference between in Printing and in Preview.)
Note: If a built-in dviout driver is used, the -LM: and -TM: settings are always enabled.
Note: If you want to temporarily shift the printing position, use -OX: and -OY: and not -LM: and -TM:.
-RM: Width of the unprintable area on the right side of the paper
-BM: Width of the unprintable area at the bottom of the paper
Note 1: Since -RM: and -BM: are processed in Windows 95 (by the printer driver), usually they do not have to be set. These values do not affect the printing positions.
Note 2: If landscape is selected by [Paper], since the images rotated 90 degrees clockwise are printed, the TeX dvi origin is adjusted by -TM: and -RM:.
(When returning to the correct orientation (rotating the paper 90 degrees counterclockwise, specifically placing the TeX dvi origin at the top left), increasing -TM:, moves the origin to left, while increasing -RM:, moves the origin up.)
Only when the built-in dviout LIPS III/IV and ESC/Page drivers are employed, the positon is adjusted by -LM: and \f-TM: with landscape being the same as portrait.
--- Printing without Windows printer drivers (-dviprt: setting) ---
dviprt is default: The default is to follow the -dviprt: setting and not use the Windows printer driver in the printing dialog (corresponding to a checked dviprt in the printing dialog).
follow default dpi: When the specified built-in dviout printer driver is used, the default dpi of the built-in driver is used and not the dpi set by dviout.
[CFG file]: This button specifies the configuration file when printing uses an external printer configuration file in the built-in dviout printer driver.
-dviprt: This specifies the process and the parameters when the console dviprt is called to print and the built-in dviout driver (when Windows printer drivers are not used for printing).
[Paper]
<- Property Sheets
Paper size: This sets the page size of the paper. When "Defined by User" is selected, the vertical and horizontal sizes are specified.
dviout creates the BMP file of the image of each page based on this size.
Orientation: Sets whether the paper is set to portrait (default vertical orientation) or landscape (horizontal orientation).
Note: The Paper size: and Orientation: settings are independently set in the printer and its driver in the printing dialog. Usually, the same settings must be made when actually printing.
-OX: Setting of the correction of the output position in the horizontal direction
-OY: Setting of the correction of the output position in the vertical direction
Note: In the dvi file, the top left corner of the paper is the reference and the origin is positioned at (1 inch, 1 inch) = (25.4mm, 25.4mm).
(If -LM: and -TM: have valid settings) Normally, this origin is printed to be located at (1 inch, 1 inch) on the actual paper. However, if the origin is shifted for some reason, set the -OX: and -OY: options.
-HC: The text width read from the dvi file is considered to be the horizontal width of the document. Based on the horizontal width of the paper that is set, this option can specify the centering in the horizontal direction of the document.
-VC: The height of the text read from the dvi file is considered to be the vertical width of the document. Based on the vertical width of the paper that is set, this option can specify the centering in the vertical direction of the document.
-HS: When centering in the horizontal direction is set, this option can define the shift in the horizontal direction after centering.
-VS: When centering in the vertical direction is set, this option can define the shift in the vertical direction after centering.
Note: The text size written in a dvi file might be not relevant to the actual paper size. Usually, it would be better to uncheck options like -HC: and -VC:.
[System]
<- Property Sheets
-br: specifies the size of the cache buffer that saves the bitmap data of each character.
-bf: specifies the buffer size for the cache for font files, such as the PK font. At least the same size as the maximum size of the PK font is required.
-bb: specifies the maximum allowable size of the buffer for expanding the image of a page. Since the required size must be allocated, a sufficiently large buffer size should be specified. (When dpi=300 for the A4 size, the required buffer is of about 1 Mbytes. If the dpi is doubled, a buffer that is four times larger, around
4 Mbytes, is required.)
-multi: specifies how many dviout's can run at the same time.
-log: specifies the path name of the log file recording information such as dviout errors or warnings. If only + is specified, the log file is created with the name dviout.log in the directory containing dviout.exe. If - is set, the log file is not created. This setting can be changed from the Menu Bar.
-renew: When you are using dviout, you might visit other window from the dviout window and then return again to that dviout window. If this parameter is checked, dviout will check whether the displayed dvi file has been modified or not, and if modified, the display will be updated automatically.
-button: The tool button setting, such as "Backward/Forward history," is changed to the default.
-base: The base line of each character is displayed. This is used for checking while proofreading.
-box: Instead of each character, a box whose size is of the character is displayed. This is used for proofreading.
-Wshow: A child window is opened in the case of Automatic Font Generation or execution of Ghostscript.
Reverse page_up/down This switches the direction of incrementing or decrementing of page number when press the arrow for page jump in the tool bar. (This is applied by ([OK] and [Apply] and enabled the next time. This specification is common with all modes in Registory.)
-file: specifies the Parameter file.
Property Sheets->[System]->Reverse page_up/down
The incrementing or decrementing of Page Number when pressing the arrows for page jumps of the tool bar are reversed. (This is applied by [OK] and [Apply] and enabled the next time. There is no distinction by mode.)
[REGISTRY]
<- Property Sheets
This sheet specifies which parameter is read or not read from the Registry when start-up. (cf. Parameters.)
When this sheet is selected first in the property sheets, the parameters marked with + in the list box are automatically read in mode at present. (In default, all the parameters is read automatically when start-up.)
[Auto Load] Adds + mark to the selected parameter in the list box in [REGISTRY]. Marked parameters will be read from Registory when start-up.
[Ignore] Removes + mark from the selected parameter in the list box. Unmarked parameters will not be read from Registory when start-up.
[All Set] in [REGISTRY] Adds + to all the parameters in the list box.
[All Clear] in [REGISTRY] Removes + from all the parameters in the list box.
Note: The automatic reading of the parameters set here become effective after the [Save] button on this sheet is pressed. Pressing the [Restore] button on this sheet shows the list of parameters to be read automatically with +.
[Save] in [REGISTRY] The settings are saved at the locations for the current mode of the Registry. The values of the parameters marked by + are automatically read when the start-up mode is the current mode.
[Restore] in [REGISTRY] The list of parameters to be read at start-up is obtained based on the current mode of the Registry and indicated with + set to the parameters displayed in the list box.
When the current setting is changed, the current settings are first obtained by this button. They can be corrected and saved.
Note: The [Apply] and [OK] buttons are unrelated to the settings in the [REGISTRY] sheet.
-------- Selected mode ----------
Default mode: specifies the start-up mode. The parameters specified for automatic reading for this mode are read in from the Registry at start-up. (The settings become effective after the [Save] button is pressed.)
Current mode: changes the current mode. This is reflected to the current dviout (you don't need to press the [Apply] or [OK] button.). [Save] and [Restore] to the Registry of the various parameter values on each page of the property sheets are applied to the
current mode in the Registry.
Current Print: When dviout is in the current mode set above, the mode can change to the mode set here only when Printing. (This becomes effective after the [Save] button is pressed.)
For example, you might want to employ different dpi when printing from when previewing (cf. Q_P6) or invoke Ghostscript to interpret PostScript \specials only when printing. By specifying a mode in Current Print, such a temporal switching of mode is possible. However, when invoking an external application program such as dviprt,
this setting is ignored.
Current Name: You can give a name to the current mode and this would make it easy to remember which mode has which specification. The name is displayed in the dialog for changing the mode by "Option -> Mode".
Registry
The Registry is supported by Win32 to save information about each type of parameter in the Win32 system or program. This information is actually recorded in a format such as a database on the disk.
dviout saves the information in HKEY_CURRENT_USER\Software\SHIMA\dviout in the Registry. Many parameters are saved at 10 different locations for each mode. They correspond to the locations of para0,..., para9 under ...\SHIMA\dviout.
para0,...,para9 : Each parameter of mode0,..., mode9 is stored by the key of the parameter name and its value (as integer or character type data).
FILE : This is the history of file names employed by dviout. There are 16 keys, from 0 to 15. The oldest one is 0.
In Font key, packed data of frequently used fonts and their font files on the hard disk is stored.
In Freq key, information which has frequency of usage of each font is stored. First 1 byte represents version number, the next 1 byte denotes how many times the Font key is not renewed, the next 2 bytes stores size of Font key value, and last 2 bytes shows data number.
FIND : This is the history of the strings employed in String Searches. They are 0, 1, 2..., where 0 is first.
KeyTable : The definitions of the key functions are stored in the binary format.
Settings : The size or position of the dviout window and loupe properties are stored.
Selected mode
Specify the mode at start-up, the current mode, and the mode for Printing. You can give a name to the current mode.
For details, see Property Sheets->[REGISTRY].
Current Name:
You can give a name to the current mode and this would make it easy to remember which mode has which specification. The name is displayed in the dialog for changing the mode by "Option -> Mode".
Current mode:
The current mode is changed in the [REGISTRY] of Property Sheets. This is immediately reflected to the current dviout. (The settings of the Parameters are not read.)
[Save] and [Restore] to the Registry of the values of the parameters on each page of the property sheets are performed for the Registry in this mode.
Default mode:
Default mode: specifies the start-up mode. The parameters specified for automatic reading for this mode are read in from the Registry when start-up. (The settings become effective after the [Save] button is pressed.)
In the command line, if the parameter -mode: is specified such as
dviout -mode=2
then the mode is changed to the specified mode above after initialization in the default mode.
Current Print:
When dviout is in the current mode, the mode can change to the mode set here only when Printing. (This becomes effective after the [Save] button is pressed.)
For example, you might want to employ different dpi when printing from when previewing (cf. Q_P6) or invoke Ghostscript to interpret PostScript \specials only when printing. By specifying a mode in Current Print, such a temporal switching of mode is possible.
[Auto Load]
Adds + mark to the selected parameter in the list box in [REGISTRY]. Marked parameters will be read from Registory when start-up.
[Ignore]
Removes + mark from the selected parameter in the list box of the [REGISTRY] of Property Sheets. Unmarked parameters will not be read from Registory when start-up.
[Save] in [REGISTRY]
The settings in the [REGISTRY] of Property Sheets are saved at the locations for the current mode of the Registry. The values of the parameters marked by + are automatically read when the start-up mode is the current mode.
[Restore] in [REGISTRY]
The list of parameters to be read at start-up is obtained based on the current mode of the Registry and indicated with + set to the parameters displayed in the list box.
When the current setting is changed, the current settings are first obtained by this button. They can be corrected and saved.
[All Set] in [REGISTRY]
Adds + to all the parameters in the list box in [REGISTRY] of Property Sheets.
[All Clear] in [REGISTRY]
Removes + from all the parameters in the list box of the [REGISTRY] of Property Sheets.
list box in [REGISTRY]
The parameters marked with + in the parameter list of the [REGISTRY] list box are set to the default values when start-up (by pressing the [Save] in [REGISTRY] sheet ).
- The current setting states are obtained by [Restore] in [REGISTRY].
- Setting or clearing + is performed by [All Clear] in [REGISTRY], [All Set] in [REGISTRY], [Ignore], and [Auto Load].
- The mode at start-up is set by Selected mode.
- Preview (Q_V)
- Font (Q_F)
- Print (Q_P)
- Parameter (Q_S)
- Image data (Q_G)
- Error message (Q_E)
- Operations on Windows95/NT (Q_W)
- Other problems (Q_T)
- Other questions (Q_O)
- Slow display of the first page (Q_V1).
- Slow page move (Q_V2).
- I want to reverse the direction of the page motion by the arrow of the tool bar (Rev_arrow).
- I want to move among pages with a toolbar button (Q_V10).
- Too large or too small display scale (Q_V3).
- Blurred or faint characters in the preview view (Q_V4).
- I want to guarantee a preview view that is as large as possible (Q_V5).
- Check for the update of the dvi file and update the preview automatically (Q_V6).
- An afterimage remains when the Loupe moves or flickeres (Q_V7).
- The display background is too bright (-bright:).
- Landscape pages are displayed in portrait (Q_O22).
- When magnified, the string found by the "Search" (-sdpi:) cannot be highlighted.
- The colors of the strings found by the "String Search" are unclear or do not change. (Q_V8).
- Strings copied to the clipboard including symbols are strange (-sFont:).
- Faint colors appear on the outlines of colored characters and the positions are offset (Q_V9).
- I want to view the whole page (Q_V11).
- Using mouse buttons for preview (Q_V12).
When dviout starts up, dviout determines which font file on the disk to use for all of the fonts used by this dvi file (read -TEXPK:, etc.) and creates the position mapping between the page and the dvi file.
A larger dvi file will take longer time to display the first page. If the display of the first page is extraordinary slower than page moves or jump, this might be due to too much time for font searching by dviout..
Font search will take a long time when // or \\ is specified in -TEXPK: invoking kpathsea with -Fkeep: OFF. It is better not use // nor \\ for close to the root directory.
You might have fonts of different resolutions in separated directories, like ^d\^s.^dpk. Then you might specify more than one directory in -TEXPK:. If so, specify first the most frequently used font.
By default, all of the Parameters saved in the Registry are loaded at start-up. By changing the [REGISTRY] property sheet to load only the necessary ones might be good for quick start-up.
There are some cases when Moving between pages is slow, particularly for page 1 -> page 2 -> page 1, the final page 2 -> page 1 is slower.
The reason for this might be due to a long time to expand a page by dviout. When a high-resolution font is used, the process data becomes large, and it takes time. Even for a gray scale display, a 400 dpi or smaller font would be better. For a particularly slow PC, use a 118 dpi font instead of using gray scale.
Also the printing slows down when the font cache buffer is too small because of frequent flushing. See "Help -> Buffer info" (Buffer Information). The size of this buffer is defined by -bf:.
The magnification and reduction scales of the display can be changed by "Display -> Magnify or Reduce," or by H-scale and V-scale in "Property Sheets -> [Display]".
When [Save] is pressed in [Display], the current state becomes the default. (Based on the case, checking and [Save] are required in [REGISTRY].)
This is for the gray scale display. In "Property Sheet -> [Display]", adjust the contrast. When "High", the character becomes darker.
View -> Tool Bar, Status Bar, Page Slider, or Scroll Bar can erase the tool bar, status bar, page slider, or scroll bar.
Therefore, preview view portion becomes somewhat wide for the dviout window.
Specifying the parameter -NULL: in the command line, the whole display of CRT is used for Preview (cf. Start and Exit).
If the dvi file is updated when the TeX source file is created or corrected while previewing, the preview view can be automatically updated (-renew:).
This update is checked only when the main dviout window is changed into active.
In a model that is slow to rewrite the screen, you may worry about the status. In particular, when the loupe is round or color image data is included, rewriting becomes slow.
If the loupe is square and the value of Speed: is increased, the status improves. In addition, the background color is identical or close to the paper's color, so flickering is reduced (Property Sheets -> [Loupe]).
The string searched is displayed in red by default. In a gray scale display, strings are displayed with 16 red intensity levels. However, in a Windows screen with 256-color mode or lower modes, the colors cannot be accurately represented.
The measures against this are setting the screen to "High color" or "Full color", changing the color assignment to the box shape (Property Sheets->[Search]), or changing the gray scale.
If characters already colored by color specials are found, the colors are not changed. This can be indicated by underlines, boxes, or cursor movements.
When -color: is set to "ON", a \special can assign colors to characters and lines.
Antialiasing is used instead of the gray scale when compressing, but faint colors occur on the outlines by the painting over by REPLACE (cf. -cmode:).
Since the characters are displayed after antialiasing each character, the position is offset by a maximum of one dot.
For a 1:1 display by the loupe, the appearance can be normal.
The six buttons on the right-hand column of the Second Tool Buttons (left/right arrows, smiley face, etc; cf. View->View Menu) can be freely redefined with Property Sheet->[Key].
For example, to define the lefthand arrow button the function to move to the previous page, choose Option->Setup Parameters->[Key], and set Function: to Previous Page, Key: to User2, then press [Define]. Continue with other definitions if necessary. Then press [Save] and lastly [OK]. The toolchips will be changed appropriately.
If these buttons are not displayed, toggle View->Change Tool Buttons.
To display the whole page, do one of the following:
- Use Display->Fit on the toolbar (the default key is set to 5).
- Set appropriate scale with Display->View4, say (the default key is 4)
- Set appropriate scale to the Loupe option (Ctrl + right-click on the mouse).
Here's a summary of functions of the mouse buttons while Previewing.
1. Click on the left button stands for a HyperTeX jump. If the Ctrl key is pressed while clicking, the jump location is displayed, prompting the user for the confirmation.
2. When the mouse pointer is shaped of hand and is placed on a position which is not a HyperTeX hotspot, move the mouse while pressing the left button to scroll the page.
3. Press SHIFT key while clicking the left mouse button to acquire the character string under the mouse pointer for copying to clipboard. If Ctrl key is also pressed, information on the character is displayed.
4. The right hand button on the mouse is for the Loupe function. Use Ctrl key for another Loupe. Move the mouse while pressing the right button to move the Loupe.
5. Turn the central wheel of IntelliMouse to scroll up/down. Press the wheel or Shift key at the same time to Move to another page. Press the Ctrl key to magnify/reduce the screen.
- Font Metric File and Font Glyph File
- Automatic font location setting ([Guess])
- Size adjustment of the Japanese font (Q_F1).
- Adjustments of the base line positions of the European language fonts and Japanese fonts(Q_F2).
- What is the precedence of the Japanese fonts? (Q_F11)
- Using slanted, flat, and long Japanese fonts.(Q_F3)
- Uses the color characters color specials.
- The font with a long name such as lcircle10 or lcirclew10 is not found (Q_F4).
- The Automatic Font Generation of a nonexistent European language font (Q_F6).
- Handling Nonexistent Fonts.
- Employing Windows Japanese fonts for NTTjTeX dvi files(Q_O3).
- The Windows TrueType Japanese font settings were erased (Q_F9).
- Want to use TrueType Japanese fonts with fonts in a format of "the Shotai-Club"(Q_F10).
- Will TrueType Japanese fonts be used in the Windows that is not the Japanese version? (Q_F12)
- The European language TrueType display looks odd (Q_F5).
- High-resolution, large fonts will be used (Q_F8).
- I want to use rotated strings (Q_F7).
The sizes of the Japanese fonts are adjusted together by -S:. Individual adjustments to Windows TrueType Japanese fonts are done by [WinJFont].
-J: is used to adjust the base line position of a Japanese font. For horizontal writing, this is used to shift the Japanese text up or down.
For TrueType fonts using WinAPI, each font can be adjusted by V position and H position of "Property Sheets->[WinJFont]".
For Windows TrueType Japanese fonts, the settings can be made by [WinJFont]. If the size or the horizontal and vertical positions are not adjusted in major changes, the balance with other characters may worsen. These settings can be made by [WinJFont], but there is no automatic adjustment of the vertical-to-horizontal ratio of the characters matching jfm.
When a built-in LBP Japanese font is used in Printing, the length and flatness can be specified by the -dviprt: parameters. The length and flatness matching jfm can be automatically adjusted.
Because of the length restrictions on file names in MS-DOS, one technique truncates a font name longer than eight characters, such as lcircle10 and lcirclew10, to eight characters. This uses names like lcircle1.pk and lcirclew.pk for PK font files and lcircle1.tfm and lcirclew.tfm for Font Metric Files. (Another technique cuts out the middle
as with lcirle10 and lcirew10.)
Note: This writes lcircle10 and lcirclew10 in the dvi file only for the file names of fonts and is no different than a dvi file created on UNIX for example.
Since long file names can be used in Windows 95 and NT, the correct, the full names can be used.
The font files and various utilities provided by MS-DOS are usually truncated to eight characters. Therefore, caution is necessary if they will also be used.(Change to a correct font file name or use -L: or -F:.)
Don't use the old way indicating European Language TrueType Fonts in -TEXPK:. Specify the correspondence of TeX fonts and TrueType fonts in Property sheets->[WinJFont] and the place of the corresponding tfm files in -TEXPK:.
If some characters are replaced by wrong ones, please use Virtual fonts.
If you have mktexpk.exe or MakeTeXPK.exe, you can employ Automatic Font Generation for European language fonts by using a file template.pks provided with dviout. Specifically,
1. Pass the path to mktexpk.exe or MakeTeXPK.exe.
2. Make sure that mktexpk.exe or MakeTeXPK works correctly by executing in a command line.
If the location of the fonts created by mktexpk.exe or MakeTeXPK (for example, c:\usr\local\share\texmf\fonts\pk\^s.^dpk) is not included in -TEXPK:, add it.
3. If the printer in "mode_name=" of template.pks is different from yours, you should change this option. If you use mktexpk.exe, you should replace MakeTeXPK in template.pks by mktexpk.
4. template.pks is set in -gen: in "Option -> Setup Parameters -> Font2" by its full path name. For example, set
-gen:c:\dviout\utility\template.pks
and press the [Save] and [Apply] buttons.
The direct specification can also be made by the setting starting with ` such as
-gen:`mktexpk -dpi ^d --bdpi ^D --mag ^d/^D ^s
-gen:`c:\ptex\bin\MakeTeXPK ^s ^d ^D ^d/^D CanonCX
Note: If the location of the fonts generated by mktexpk or MakeTeXPK is not given in -TEXPK:, dviout cannot find the generated fonts and an error occurs.
By using the rt tpic specials extensions command, strings and monochrome images can be rotated and drawn, as in
\special{rt 0 0 1.57080}RightSide\special{rt 0 0 0}
In addition, when the LaTex2e graphicx.sty is used for dvips output, the rotations and drawings such as the following are possible.
\rotatebox[origin=c]{270}{RightSide}
If many large, high-resolution fonts are used, the font cache buffer should be significantly large (-br: specification).
If data are read from a large font file on the disk, the cache buffer for the font file should also be large (-bf: specification).
The states for using these buffers are found in the buffer information in "Help -> Buffer Information".
When, for example, the settings such as substituting the NTTjTeX Japanese font by a Windows font (Q_O3) are made on the [JFont2] property sheet and saved by [Save], there is the -vfn: setting on this sheet. If this is not blank, register it on the Registry.
-vfn: above can select either reading an external file containing the Japanese font settings or Japanese TrueType settings by [WinJFont] (this also corresponds to -vfn:).
If errors are set in -vfn: in the Registry, the Japanese font settings become invalid.
The original state is recovered by setting empty in -vfn: in [JFont2] and [Save]ing it. Moreover [Default] button in [WinJFont] makes the setting there in the default state, which is again saved by [Save].
Complex Japanese fonts settings such as shared use of Windows TrueType Japanese fonts and Japanese fonts in the Typeface Group's format must be written and set in a file.
Refer to utility\dviout.vf0, which is included, and modify it to create the settings file. Then specify with the -vfn: in the [JFont2] property sheet. This disables the [WinJFont] specification.
The precedence of the Japanese fonts when actually using dviout for the Japanese fonts in pTeX is given below. If not found in each stage, the next lower level is searched, the types of Japanese fonts used by pTeX can coexist.
1. When a jxl4 format font was specified by -TEXPK:, it is used. When a jfm file was specified, the following results.
2. When Printing by LIPS III/IV or ESC/Page using a built-in printer driver, a font installed in the printer is used (according to the specifications of Subparameter f of -dviprt:).
3. If -vfn: of the [JFont2] property sheet is specified, a scalable font is used in accordance with this setting. If not, the Windows TrueType font is used in accordance with the [WinJFont] setting.
4. The fixed-size bitmapped fonts specified by -TEXKNJ: are used.
color specials
If -color: in the [Graphic] property sheet is checked, assigning colors to characters and lines is handled by the special command (cf. -color:).
Colors are handled only when printing by a Windows driver. Black and white results by a built-in driver.
68 colors
Black, White, Gray, Red, Green, Blue, Cyan, Magenta, Yellow,
Orange, Brown, Purple, Violet, Sepia, Tan,
RedViolet, VioletRed, YellowGreen, Goldenrod,
Dandelion, Apricot, Peach, Melon, YellowOrange,
BurntOrange, Bittersweet, RedOrange, Mahogany,
BlueGreen, BrickRed, OrangeRed, RubineRed,
WildStrawberry, Salmon, CarnationPink, Rhodamine,
Mulberry, Fuchsia, Lavender, Thistle, Orchid,
DarkOrchid, Plum, RoyalPurple, BlueViolet,
Periwinkle, CadetBlue, CornflowerBlue, MidnightBlue,
NavyBlue, RoyalBlue, Cerulean, ProcessBlue,
SkyBlue, Turquoise, TealBlue, Aquamarine,
Emerald, Maroon, JungleGreen, SeaGreen,
ForestGreen, PineGreen, LimeGreen, GreenYellow,
SpringGreen, OliveGreen, RawSienna
Since dviout for Windows has an expansion function for TrueType Japanese fonts, it can be used in the English version of Windows so that ASCII's Japanese TeX can use TrueType Japanese fonts.
1. ttindex.exe creates the index file of the TrueType Japanese fonts to be used.
2. The Japanese font definition file is specified by -vfn: in [JFont2] and not by [WinJFont]. The Japanese font definition file defines how to use the Japanese fonts.
Note: The TrueType font expansion routine in dviout for Windows produces poorer quality, especially for small characters, compared to the Windows system.
- I want to adjust the irregular printing positions ([Printer])
- The printed sizes are irregular (Q_P1).
- Printing takes too much time (Q_P2).
- I want to use different parameters when printing than those used during the preview(Q_P6).
- I want to print the page or the range checked in Preview (Q_P4).
- "Copies:" in Number of Copies Specification in the print dialog is disabled.
- What are the differences with the types of possible printing methods? (Q_P7)
- I want to print by using the console version for dviprt Printing or by using another program
- I want to use TrueType Japanese fonts in printing by dviout's LBP Driver. (Q_P5)
- What is the paper size when enlarging or reducing and printing by an LBP? (Q_P8)
- Taking in printer control codes for the built-in driver.
- The printing by the built-in dviout driver is poor(Q_P9).
- Send the dviout file document by fax(Q_P3).
- When sending a fax, each page is send in separately (Unite Print Jobs).
For example, to print on A4 size paper, the following is required.
1. The original TeX document is created in the A4 size.
2. Set A4 as the paper size in the [Paper] property sheet.
3. Set A4 as the paper size in [Setup] in the print dialog.
When the sizes of the printed characters are irregular or the sizes do not fit even with the A4 setting, the dpi used by dviout and the printer resolution may not match (cf. Setting the Resolution).
For some laser printers such as LIPS III and ESC/Page, dviprt for MS-DOS tried to optimize such as data transfer by downloading fonts. When printing is done by a Windows system driver in Windows 95 or NT, there is no optimization and printing might be slow.
The Windows 95 and NT printer drivers are improved by the printer manufacturers, and new versions of the drivers might be available. Printing speed may be improved by changing the driver settings or updating the driver.
Printing speed may improve if -cmode: is set to patch in the Property Sheets->[Graphic] page. This remedy is appropriate only for printing not for preview. Use automatic mode changing function for printing (cf. Current mode:). Also, this remedy does not support printing by dviprt.
Note: Even if the page printer's advertised resolution is 600 dpi, printing may be done in 300 dpi when the printer has insufficient memory, resulting in very slow printing.
If needed, use a built-in dviout for Windows driver, a standard DOS version of dviprt, or a 32-bit version of dviprt. In this case, -LM: and -TM: adjustments may be necessary. An external printing program can be used from dviout for Windows (dviprt Printing).
When a fax modem is registered as a Windows printer, documents can be transmitted by fax by selecting the fax modem in [Setup...] in the print dialog.
In order to send more than one page once through a telephone connection, make sure that the [Unite job] parameter in the print dialog is checked.
If only the page previewed immediately before entering the print dialog will be printed, press the [Selection] button in the print dialog.
When a page is marked, either that page is printed or the pages in the specified range while previewing can be printed. In the latter case, if the page slider is displayed, the range is marked in the slider.
Refer to the Page Selection item.
When printing uses a built-in LBP driver in dviout following to the -dviprt: settings, the default is to use built-in LBP Japanese fonts. For example, when the following is set for LIPS III, Windows TrueType Japanese font can be used as the Gothic font.
-dviprt:`lgoth=81;0;k
The "k" above means the TrueType Japanese font is downloaded and used. The "81" is a dummy. Which font to use for Gothic conforms to the settings on the [WinJFont] of property sheet.
When the printer's built-in Japanese fonts are not used at all, as in
-dviprt:`lv0
For more details, see the information about Subparameter f, Subparameter k for the LBP Driver.
The [REGISTRY] of property sheet is opened. Suppose Default mode: and Current mode: are both 0. The following setting example uses 300 dpi in Preview and 600 dpi in mode 2 when printing.
(If [Save] on the [Resolution] sheet was not pressed, execute the save and return.) First, if Current Name: is blank, write in "Default". Set 2 in Current Print: and press [Save] (setting in mode 0).
Next, set both "Current mode:" and "Default mode:" to 2, write "Default Printer" in "Current Name:". Since only -dpi: is changed, press [All Clear]. Then select -dpi:, press [Auto Load], assign "+" only to -dpi:, and press [Save]
(setting in mode 2).
Then move to the [Resolution] sheet. Set 600 in -dpi: and press [Save] (set in mode 2). Return to [REGISTRY]. Set "Current mode:" to 0 (return to mode 0). Leave by either [OK] or [Cancel].
In the typical mode 0 state, when using a Windows print driver to print, the data are automatically converted from 300 dpi to 600 dpi (mode 2) and output. After printing ends, 300 dpi is restored.
The "Default Printer" in mode 2 can be selected in "Option -> Mode" in the Menu Bar and returned to 600 dpi.
1. Printing using a Windows print driver
The default state with the check removed from dviprt in the print dialog
- Handles color specials, color images (Q_O2), fax transmission ((Q_P3)
- Pause at Each Page function
- Cancel During Print Data Output
- Compatible with various printer when the printer manufacturer's driver is used.
2. Printing using the built-in dviout driver
Applies when the beginning of -dviprt: is +` or ` , and dviprt in the print dialog is checked
- The output codes are optimized; high-speed printing by an LBP, particularly, LIPS III/IV and ESC/Page, is possible; the printer's built-in Japanese font can be used.
- Taking in printer control codes is possible
- Printer configuration files (CFG File) can be defined. Thus each printer model can be handled, and the output can be in any format, such as an image format like PBM or EPSF.
3. Printing by calling an external printer driver
The calling method of the external program is set in -dviprt:. The case where dviprt in the print dialog is checked is handled.
- The printing can be done by the console version of dviout or the dvips for PostScript printers.
If there is enlarging or reduction in the print dialog, press the [Setup...] button in the print dialog to set the paper size and orientation, or confirm.
Whether a Windows driver is used, or a built-in dviout driver is used, the [Setup...] dialog appears.
When the [Setup...] button was not pressed(or was canceled by [Cancel] after being pressed)
- For a Windows driver, the defaults set in the printer driver are followed. If the error in the paper size actually output is large (vertical or horizontal error exceeds 5%), the confirm message appears.
- When a built-in dviout printer driver is used, enlarging or reducing is tried and the paper size is guessed. The commands are sent to the LBP to print on that paper.
For example, if the Preview was for the B4 size, and the B4 -> A4 reduction (81.6%) was checked in the print dialog, the commands for using A4 paper are sent to the LBP. (Actually, if errors are taken into account, the reduction actually ranges from 77.6% to 85.6%.) If the paper cannot be guessed, the printing is for the paper size used in the preview.
If dviprt was checked in the print dialog, the built-in dviout driver converts the image data to print control codes and prints.
If the printer does not operate according to its specifications because a different printer model is used or there are bugs in the printer, correct printing may not also be possible.
Change the Parameters and test. For example, for LIPS IV, try
+`lD600;d0
+`lD600;v0
+`lD600;d0;c;u-10
If none of them works well, switch to printing using a Windows driver or create a printer configuration file.
- The defaults are the Parameters changed on the property sheet. (Q_S1).
- I want to use parameters during printing that differ from the parameters during previewing ([REGISTRY]).
- Output of Parameter Setting
- Example of Parameter Setting
- I want to start without reading in the settings written in the Registry (cf. Start and Exit)
- I want to choose different mode at startup (cf. -mode:).
- I want to delete the contents of the Registry and reinstall (Q_S8).
- I want to copy the parameter settings to another computer (Q_S2).
- Format of the parameters settings to read by dviout (Q_S3).
- I want to read parameters from the file (Q_S4).
- Edit function when setting or saving parameters (Q_S5).
- Setting the parameters shared by different machines (Q_S6).
- I want to appropriately use multiple parameter settings (Q_S7).
- The parameters were changed, but did not act as expected (Q_S9).
- The default parameter file is ignored (Q_S10).
- Automatic Parameter Installation Function
When the Parameters on the property sheet are changed and are enabled at the next start-up, press [Save] on this sheet to save to the Registry.
If this parameter is not changed so that there is no reading in at start-up, this is acceptable. If not, the settings must be restored so that there is a read at start-up based on the [REGISTRY] sheet. (Select in the list box on the left side of the [REGISTRY] sheet, press [Auto Load] to add. Then press [Save] in [REGISTRY]
to make the actual setting.)
In the list box on the left side of the [REGISTRY] sheet, only the parameters marked by + are read in at start-up.
If the top buttons are used ([All Set] in [REGISTRY] marks all of the parameters with +) and [Save] is pressed, the types of parameters read during start-up can be changed. Since the parameters whose settings are not saved in the Registry are ignored even if the settings are read at start-up, there are no problems.
By pressing [Restore] in [REGISTRY], the current state can be determined.
The Output of Parameter Setting is used to put the settings in the dviout.par file which is placed in the directory containing dviout.exe. When dviout starts, the parameter settings are read in.
If the "-NULL" is specified in a command line, added and dviout starts, the Registry settings can not overwritten nor changed.
Furthermore, if [Save] is pressed on each property sheet, the read parameters are saved in the Registry.
The setting format for Parameters to be read by dviout is given by "Option -> All parameters".
Generally, a specification has a form of <parameter>=<setting>, and more than one specifications must be delimited by spaces or new lines. A - may be added before <parameter>. Also, instead of =, : can be used. Dviout interprets the specifications in the order of them. If the same parameters are set, they are overwritten.
There are four kinds of parameter format:
1. Parameters specifying integers such as -dpi: and -br:
2. Parameters specifying lengths such as -LM: and -OX:
3. Parameters specifying strings such as -TEXPK: and -gsx:
4. Parameters specifying ON or OFF such as -gbox: and -varf:
For details, see the parameter list or use the ? button on each property sheet to get information of each parameter.
Note: Sometimes parameters specifying integers are set by selecting buttons assigned meanings and not by numbers on the property sheet.
If an integer is specified, in addition to decimal numbers, octal and hexadecimal numbers can be used. For example, when lengths are specified as in
dpi=300
ttf=1000
br=0x64000
the units of mm, cm, in (inch, 1 inch = 25.4 mm), and pt (point, 1 in = 72.27 pt), dot/<number>dpi. For example, when the string
LM=4.56mm
RM=54dot/300dpi
is set, if special characters such as spaces or new lines are included, the string is enclosed by single quotes (') or double quotes (") (however, the string may not contain single quotes or double quotes). The ^$ string represents the null string.
When the parameter represents ON or OFF, on is specified by "+" and off by "-". If the settings are not specified, ON and OFF are reversed (toggle switch).
The file containing the Parameter settings in the format output by "Option -> All parameters" is read by the following methods.
1. dviout -=<parameter_file>
is read in at start-up. (If -NULL is added, reading the parameters from the Registry is skipped.)
Note: The -= is equivalent to -file=. Another parameter file is read from a parameter file being read. The nesting can reach seven levels.
2.The parameter file is selected from the "Option -> Read Parameters" in the menu bar.
3.In "Property Sheets->[System]", write the file name directly in -file: and press [OK]. (When [Save] is pressed, automatic reading at start-up is set.)
The window opened in the Property Sheets input box, "Help -> Information" or "Option -> All Parameters" has editing functions almost identical to those in Notepad.
In particular, by clicking the right button of the mouse after specifying the range, copying between another editor (or a small editor opened from Menu Bar->View Menu) and a window is possible.
There are some cases when many people are sharing one machine such as under Windows NT.
1. Create a dviout.par file in the directory containing dviout (or a Windows directory) and specify default Parameters in that file. (After set various parameters in the property sheet, then edit them in "Option -> Non-default parameters" and finally output them to a file by output of parameter setting.)
2. Some of the users might want to change parameters from the default. In such a case, change the parameters in "Option -> Setup parameters," and save in the Registry. Then select the [REGISTRY] sheet, mark the + to the parameters he wants to change (at first, all the item on the table might be marked with +'s. Then press
the [All clear] button to clear all the +'s. After that, mark the items +'s he wants to change.), and press the save button.
dviout first reads the parameter file, followed by reading the Registry settings. Then the parameter values are overwritten with values in the Registry.
The following methods replace the Parameter values by the several settings made beforehand.
1. The [REGISTRY] of Property Sheets is used to set the parameters to a different mode. This can be switched by "Option -> Mode" in the Menu Bar.
2.Several parameter files are prepared and selected from "Option -> Read Parameters" in the menu bar. (The parameter file can be created with an easy-to-understand file name with the par extension in the directory containing dviout.exe. Refer to "Output of Parameter Setting".)
The contents of the Registry related to dviout are all erased by "Option -> Uninstall."
When there is a version upgrade, since the uninstall of the new dviout also acts on the older dviout, the new dviout.exe, dviout.hlp, and dviout.cnt overwrite and are installed. Execute uninstall and then the Install procedure can begin.
Refer to the "Uninstall" item.
Pressing ? in the property sheet and clicking the left button of the mouse on the appropriate Parameter often displays the description of that parameter, so refer to the description.
When the [Help] button on a property sheet of the relevant parameters is pressed, the displayed description may be checked.
If there is a file named dviout.par in the dviout directory, dviout reads the parameters from the file when start-up.
If the corresponding Parameters are set "Read" (a "+" mark) in the Property Sheet->[REGISTRY] page, then the parameters are also read from the Windows Registry and overwritten. (If the default is null, then a null value is written.)
To have the parameter file take precedence over the Registry, cancel the aforementioned "Read from Registry" setting, or set the -file: parameter (Property Sheet->[System] page) to the parameter file.
- Read in the Image data file.
- The size read in of the image data file is incorrect (Q_O1).
- Image data file specials
- Failure in the image display using PostScript (Q_O9).
- Handling color image data (Q_O2).
- The colored display for color image data is wrong (Q_O17).
- Displaying color images is extremely slow (cf. -gfit:).
- Parts of the lines in the image being Previewed disappear (Q_O16).
- Want to also use color Ghostscript images in black and white (Q_O14)
- LaTeX2e graphic packages are used (Q_O18).
- tpic specials are used.
- The displayed page is saved as a BMP file (Q_O7)
Be careful when using the -gsize: option or parameters like clip in PostScript \specials that may be affected by magnification by magstep or -mag:.
Note that there may be problems when the size of the imported image is specified by using graphics.sty in the LaTex2e graphic package. So use graphicx.sty instead of that.
Even in PostScript files, some Encapsulated PostScript Files (EPSF) do not have proper format (such as %%BoundingBox: specifications at the beginning of the file).
In this case, the size specification in a PostScript \special does not work properly.
If a BMP format with 16 or more colors is specified in (Property Sheets->[Graphic]->) -GIF: for PostScript color image files, the Preview can be in color. However, displaying and scrolling become slow.
A 256-color BMP format would be suitable for previews. Note that you should select a mode with over 60,000 colors in the Windows display settings if possible. Since many colors are used in a gray scale display in parts outside of the image (cf. Q_V8), much many colors are required for both of text and images.
The size of a color BMP file is very large. The memory and hard disk must have sufficient room. For a preview using a high-resolution font such as 600 dpi, check -gfit: to on.
When you use a color printer for Windows, the above images are printed in color by a Windows driver (remove the dviout check in the Printing dialog).
When -GIF: is set to monochrome, color differences are represented in gradations. A non-color printer will express them with in differences of dot density. If you send the color image to a non-color printer, the printed result depends on the option settings of the employed Windows driver.
Uncompressed color BMP image files are also handled.
When "Save as image" in File Menu in the Menu Bar is selected, the currently displayed page is saved to a file in BMP format. The saved page gray scale when antialiasing is in effect, and colors as in HyperTeX documents or after string search.
However, color images which has more than black and white are not properly handled, nor colored or reversed (in black/white) characters generated by LaTeX2e graphics package.
1. Is On checked in Ghostscript in "Property Sheets->[Graphic]" ?
2. When Unknown special:... is displayed
Use a \special that is supported by dviout (cf. "Image data files").
3. When unable to open foo.ps(PS) is displayed
The PostScript file that should be read is not found (be careful when setting -gdat:).
4. When a display appears like Ghostscript cannot be executed such as "Cannot execute gswin32(2)"
Check the -gsx: specification.
5. When Failed to make foo.pbm ... or foo.bmp ... is displayed
Use Ghostscript to indicate that the image data files cannot be created from a PostScript file. The causes are
- An invalid library path for Ghostscript was set. (Refer to the Ghostscript manual and check the setting of environment variables.)
- There were parameters that cannot be processed by Ghostscript or there were bad PostScript files (Many graphic software and Windows PostScript drivers output wrong EPSF files).
- A Ghostscript is used that does not support the output of raw PBM files (or BMP files) specified by -GIF: (Q_E4), or there was an error in a file write (be careful with the current directory or -gdat: settings).
- in -gsx: specification of Ghostscript's path, space character can not be used.
For example, when "parameter file:" is tmp$.@@@ and the executable file is c:\gstools\gs4.03\gswin32c.exe, open the MS-DOS window, move to the directory containing the dvi files, and execute the following. The displayed messages may be useful in understanding the causes of errors.
c:\gstools\gs4.03\gswin32c @tmp$.@@@
When monochrome PBM or monochrome BMP is specified in (Property Sheets->[Graphic]->) -GIF: for PostScript color image files, the Preview is in black and white using gray scale even if the original image is colored.
When monochrome PBM is specified for monochrome in the [Graphic] of Property Sheet, the file name created by Ghostscript is different than the one for color. Therefore, both files can remain without overwriting.
Although more space in the hard disk is required, it would be useful to use both monochrome and color appropriately depending on the situation.
When Previewing, sometimes some parts of the lines in the read in PostScript image disappear. This is because the color BMP image created by Ghostscript is compressed by a function provided by Windows and displayed (this is due to the Windows specifications).
A displayed image enlarged with 1:1 magnification, such as loupe, does not produce these kinds of problems. In addition, since monochrome images are compressed in the gray scale and displayed on the dviout side without relying on Windows, the lines may not disappear even if reduced.
Set -gfit: to ON.
Select 256 colors of BMP or higher in -GIF: of "Property Sheets->[Graphic]".
Usually, even when the Windows display setting is in 256 colors, a 256-color image is not displayed properly in dviout. The reason is the following.
The Windows system itself is using colors for other process already, and dviout also uses a maximum of 112 colors (of 16.77 million colors) with a 16-level gray scale displaying (each level has 7 colors). Therefore, the rest of the 256-color resource is not sufficient for another process of displaying with 256-color images.
If the image data has 256 colors, select more than 65,535 colors in the Windows view setting.
When graphicx.sty or graphics.sty or color.sty in LaTeX2e graphics package is used, dviout can understand the dvi file output for dvips. You can employ colored character strings, rotating and scaling (colored) character strings or images, and include color image data of EPS files.
Rotating colored images is only possible in 90, 180, and 270 degrees. Scaling fonts created or downloaded by LBP under dviprt Printing is not supported.
If the dviout.def driver for the included graphics package is used, importing PBM, BMP and monochrome GIF images (and many other graphic files with Susie plug-in) can also be handled. This driver is compatible to dvips.def, so PostScript files can be handled as with dvips.def.
Refer to "Examples using PostScript specials" (or more precisely, grfguide.tex in graphics package or the document of dviout.dtx typeset by LaTeX2e in the package of dviout).
dviout does not smooth figures in rotating by graphics packages in LaTeX2e or scaling character strings and figures not in PostScript.
If you want a better print output, use PostScript printer with a dvi driver specially for PostScript.
- Registering dviout on the desktop (Q_O5).
- I don't want run more than one dviout. (-multi:).
- How to assign proper icons to dvi files and run dviout by double-clicking on them (i.e., Associating dvi files with dviout).
- I want to make dviout to Link to Other Programs such as editors.
- What are the external files and environment variables referenced by dviout (Q_O19)?
- What is the Current Directory for dviout for Windows?
- Want to specify the dviout location as the reference in each file specification(Q_O21).
- How to change the directory (folder) where dviout for Windows is installed (Q_O26).
In the Explorer, open the directory containing dviout.exe. Press the right button of the mouse on the dviout.exe icon, drag to the desired desktop position, and release the button. Then click "Make shortcut".
Shortcuts to dviout.exe can be created, and comments can be edited and changed by clicking the left button of the mouse.
dviout.hlp : dviout on-line help file.
dviout.cnt : contents file for on-line help.
dviout.par : When this is in the directory containing dviout or in the Windows system directory, it is interpreted as the parameter file and read in. It can also be called dviout.ini.
dviout.vfn : This is the name of the default Japanese font definition file. It is not needed when only the Windows TrueType Japanese fonts are usually used.
dviout.gss : When this is in the directory containing dviout, it is referenced when [Guess] guesses the location of the font.
***.cfg : Printer definition file (normally not used)
template :File defining the font creation method. The file name is valid when specified by -gen:.
The TEXPK, TEXFONTS, TEXKNJ, and TEXFLI Parameters can be defined by environment variables.
If the TEXCFG environment variable is present, dviout.par is searched even in that directory. If the TEMP or TMP environment variable is present, this is interpreted as the directory for creating the temporary files.
When files like -vfn: or -TEXPK: are specified, the directory where dviout is installed can be specified as the standard.
If "^x" is added at the beginning of the path name, it is replaced by the dviout installation directory. For example, if dviout.exe was installed in c:\dviout, the setting
-gen:^x\utility\template
is identical to the
-gen:c:\dviout\utility\template
setting.
The directory (folder) for dviout for Windows can be renamed or moved.
If the files referenced by dviout (fonts etc.) are moved, however, the setting in the Property sheets must be changed accordingly.
Filenames relative from the dviout directory need not be changed if dviout is moved in the same manner (Q_O21).
- NO_FONT: *** (Q_E1)
- Unpack_Error: Illegal font ID: - c:/font/pk/300/cmr10.tfm(..) (Q_E2)
- Warning: Cannot find cmr10.tfm for TT Font (Q_E3)
- Ghostscript is started, but "Unknown device" is displayed. The images of PostScript files are not imported (Q_E4).
- TEXPK corresponds..., which is not a jfm file! TEXPK maybe wrong(Q_E5).
- Not enough memory(Q_E8).
- Since this program performs illegal processing, it is forcibly terminated (Q_E7).
- The warning message window is complicated (Q_E9).
The fonts used by the dvi file are not found.
The information about the font that was searched for will be displayed. Check the settings such as -TEXPK:.
Even if the fonts really do not exist, by using -F: to specify a substitute font, displaying or printing is still possible (Handling Missing Fonts).
The best solution is creating fonts or revising -TEXPK:. For European language fonts, the Automatic Font Generation function for nonexistent fonts can be used (METAFONT starts and the generated font is stored by the procedure set by -gen:).
Note: The displayed path names are the path name searched by dviout based on -TEXPK:. They are not only for required file names.
You can examine the font information by "Help -> Font Information"
The Japanese font jfm file is specified in -TEXPK:. But if the tfm files for European language fonts appear, an error will result.
European language tfm files should not appear, like cmr10.tfm, in the display message.
A European language TrueType font is used, but the corresponding tfm file (in this example, cmr10) was not found.
The character alignment information is obtained only from *.ttf, there might be some offsets in the character positions. Set the correct directory for the *.tfm tfm files in -TEXFONTS: (unlike -TEXPK:, the font names should not be included).
The output format (Device), such as pbmraw, gifmono, bmpraw, bmp16, bmp256, and bmp16m, in Ghostscript is supported. This must correspond to the -GIF: setting.
Note that due to the patent issue, version 2.6.2 and later versions of Ghostscript does not support the output in the GIF format.
The Japanese font jfm file is specified in -TEXPK:, but an error occurs when another European language font tfm file is also specified.
Specify the directory only containing the Japanese font jfm file in -TEXPK: (create if needed). Be careful when \\ is used.
A String Search only examines the dvi files. Expecting 100% accuracy is impossible and the results are incorrect.
For English words, rather short words are avoided in a word unit search. This reduces the possibility of incorrect searches.
For dvi files by NTTjTeX, Japanese string searches are not supported.
This error has a high probability of being a problem in dviout for Windows.
If there seem to be problems in dviout, notify the developers or the dviout Users Group with information about the start-up state and how to reproduce the problem.
The memory required to operate dviout cannot be allocated. The font resolutions, the paper size, etc. affect greatly the required memory size.
For example, when Printing by a 600 dpi printer on the A3 paper size, a minimum 8 Mbyte memory is needed for the page expansion buffer, and a minimum 8 Mbyte memory is needed for transferring BMP format data.
It is desirable to use a computer that has sufficient usable memory. Memory consumption by other application programs also affects the performance of dviout.
When "View -> Warning" in the tool bar is selected and the check is removed, the window for a warning message display no longer opens.
Since the message is recorded, when this window is opened by "Help -> Information," for example, going back and looking at the message is possible. Even is the above check is removed, if this window remains open, its message is displayed.
The ON and OFF states of this check are not inherited in the next dviout after dviout ends.
- The result of a String Search is incorrect.
- "Help Topics" is only displayed by keywords, and a table of contents is not output.
- dviout freezes when trying Automatic Font Generation or starting Ghostscript (Q_O23).
- dviout reports errors and does not start up normally
- Known Problems
- The settings conformed to the description, but the operation was poor.
The state capable of displaying and printing in dviout is entered (Install).
The device drivers used in TeX for Windows by Impress becomes executable files with names like windvi.exe, windvi32.exe, wdvipro.exe, and wdvip32.exe. When dviout replaces these files by ones with the same names, dviout can be used in an integrated environment for TeX for Windows.
For example, when wdvipro.exe is used, the dviout.exe file name changes to wdvipro.exe and is only copied to the directory containing wdvipro.exe (wdvipro.exe is set to another name like wdviprold.exe to prevent overwriting and deletion).
If the dviout.hlp, dviout.cnt, wdvipro.hlp, and wdvipro.cnt names are changed and placed in the same directory, help can also be used.
Each type of editor macro developed using TeX for Windows can also be used.
If you have result which is different from the description in the help file, you might have made some mistakes. The possibilities are followings:
1. Misreading of the description
2. Mistakes in the description
3. dviout bugs
4. Windows 95 or NT bugs
Cases for 3 and 4 might only occur under special settings of dviout or the environment in Windows 95 or NT.
If you can specify your problem is due to 2, 3 or 4, please report them to the dviout Users Group or the developers. In this case, please describe details about the states so that they can be reproduced by the developers. This would make it easier to find the problem, then the problem might be solved in a rather short time.
Dviout uses various low-level processing functions supported by the Windows system. During the development, the developers have already encountered some of such low-level bugs or problems. Most of them has been already solved by dviout's functions.
The Source Code of dviout is publicly available. So, when you think that your problem is due to item 3, it would be extremely helpful if you can fix the source.
When only the keywords and not the table of contents appear in "Help -> Help Topics," the Windows help system might not be able to find the dviout.cnt file.
The information in the dviout.gid hidden file (file created automatically by Windows) in the directory containing dviout.exe might be in error.
When the directory is c:\dviout and
attrib c:\dviout\dviout.*
is specified in the DOS window, the existence of that file can be verified.
This can be handled by deleting
attrib -H c:\dviout\dviout.gid
del c:\dviout\dviout.gid
In the Explorer, switching the radio button "display all files(S)" ON in a tag appeared by "display menu bar(V) -> Option(O)", the above deletion is also possible.
On some Windows systems/machines, dviout seems to be freezed when launching METAFONT or Ghostscript.
Not that this is not dviout is hanging; it's just waiting for the launched program to return.
This problem, probably due to the Windows system, can be solved in one of the following ways.
1. Click the METAFONT or Ghostscript icon on the Windows task bar to open the window.
2. Set -Wshow: to ON.
3. If mktexpk or MakeTeXPK is indicated in -gen:, set its full pathname with the extension .exe and some parameters following after `.
4. Kill the launched program (seen on the task bar).
If the Windows Registry becomes inconsistent for some reason, dviout may report errors on startup and deny further operation including modification of Parameters. In this case, invoke dviout from the command line thus:
dviout -NULL
This should start dviout without reading parameters from the Registry. You may need to type the full path of the dviout if it is not in the command search path.
- I want to define a function such as the page jump to a key.
- What buttons on the tool bar are displayed for the user?
- Erase the name of an old dvi file in the list of files.
- In the TeX for Windows by Impress, dviout is used when previewing or printing.
- What is HyperTeX?
- A dvi file on the Internet is displayed by dviout.
- In a preview window, consult words or sentences by a dictionary or execute URL.
- I want to display more information when adjusting the Parameters.
- Why doesn't dviout recognize paper size?
- I want to expand the function.
- Source Code of dviout
If "Option -> Install" has already been executed, making the initial settings of the Parameters by "Option->Install" again and registering the dviout to the start-up menu do not interfere.
When different settings are made, only the previous settings are rewritten. "Option -> Uninstall" is not needed.
If the directory (folder) containing dviout for Windows was changed, "Option -> Install" should probably be executed again.
When the Japanese font in NTTjTeX is replaced by the Windows TrueType font, specify the Font Metric File of a Japanese font of ASCII pTeX, such as min10.tfm, in -TEXPK:, and set -ntt: to on. The -L: setting does not truncate the file name or the middle must be cut out.
To define a new Japanese font in NTTjTeX use the -nttF: option.
This button allows the user to redefine a function. Since the last "Button" of Key: in "Property Sheets->[Key]]" handles this, the left Function: can be selected and the function defined.
Note that the user can also redefine functions on the other 5 buttons (User1,...,User5) adjacent to this button. There are 6 buttons in Tool Bar on which the user can redefine functions.
[Save] can be used to register in the Registry, "-key:" can be added to [Auto Load] in [REGISTRY], and then the settings can become the defaults by using [Save] in [REGISTRY] (cf. Q_S1).
Associating dvi files with dviout, if the Internet Explorer reads a dvi file with the dvi extension, dviout is automatically started and Preview or Print it.
When the jump destination in the HyperTeX displayed in dviout is a dviout file on the Internet, click the left button of the mouse to automatically display by dviout.
For example, when the "B" key is pressed, returning to the previous page is done as follows.
1. Select "Option -> Setup Parameters... -> Key".
2. Select "Previous Page" in the Function: box. Selection "B" in the Key: box. Press [Define].
3. Press [Apply] to adapt to the current session.
4. Press [Save] to save to the Registry. The definitions become the defaults in subsequent uses.
In the [REGISTRY] sheet, check the parameters with + added at the beginning of the key items in the list box. (If they are not marked, use the [Auto Load] key to add + and press the [Save] in [REGISTRY] key.)
Note: Since the keys are distinguished by uppercase and lowercase letters, to assign the same function to "b" after performing 2 above, select "b" in the Key: box and press "Define."
In 3 and 4 above, defining or changing all of the key functions may be executed only once.
\special commands are being planned to be functions that can be fairly freely defined and used by the user.
In addition, various functions may be demanded. The Source Code is publicly available. Based on this, users can freely add functions.
If you believe that including useful functions and making improvements to the public version of dviout would be beneficial, do not hesitate to contact "the developer" or "the dviout Users Group".
The dviout source code is publicly available along with the executables.
Borland C 5.01J was used to create the executable file dviout.exe in the current version of dviout for Windows. If this C compiler is properly installed, dviout.exe can be created as follows (VC++ can also be used).
1. Extract the dviout source files in an appropriate directory.
2. At the beginning of the makefile is
BC5=C:\BC5
Change this to where Borland C is installed.
3. The directory where the source is expanded in the MS-DOS prompt window is set as the current directory. When make is executed, dviout.exe is created.
The help file is generated using MakeHelP from dviout.mhp. Use hcw.exe for the help compiler. (hc31.exe generates errors.)
Note 1. The file dviout.cnt in the distribution package is a hand-modified version of what MakeHelP generates. Be aware that when MakeHelP is executed, dviout.cnt is overwritten.
Note 2. If you distribute a modified version of dviout.exe, make sure to state clearly that it is not the original Distribution. If the definition of the VERSION_NO of version.h is rewritten, the display by "Help -> About dviout" also changes. The strings in the dialog of IDD_ABOUTDIALOG in dviout.rc can be appropriately modified.
Note 3. VC++ (versions 4 or 5) can also be used. Use makefile.vc.
If dviout for Windows is started from a command line with the "-wait=0" option, the following results are useful when adjusting the Parameters.
- A warning is often displayed at each problem location.
- The temporary parameter file that is passed when starting Ghostscript is not deleted and remains.
Dvi files, which TeX outputs, do not contain information on paper size (such as A4, B5) or orientation (such as landscape). On the other hand, in dvi files by LaTeX, these information are specified.
Sometimes even if a dvi file does have a size entry, it may not be the actual paper size. (It may even be zero!) This is why dviout does not set the paper size automatically from the dvi file. It is up to the user to specify the paper size and orientation in the Property Sheet->[Paper] page.
To delete a dvi filename from the File menu in Menu Bar and the history (File->History), select the file from File->History, press [Hide], then quit dviout. The next invocation of dviout does not show the filename on the File menu.
If dviout is killed by File->Quit, the dvi history record is not updated.
These techniques are useful after reading dvi files from floppy disks and other removable media.
By clinking the left mouse button while pushing SHIFT key, a word or sentence pointed by the mouse cursor is picked up.
In an edit window appeared, by pushing [Clipboad], the word or sentence is copied to Windows' clipboard and then you can consult its meaning by a suitable dictionary or paste it to an editor.
If the word or sentence has a special meaning defined by Windows such as URL, an executable file or a graphic file etc., pushing [Execute] makes Windows handle it suitably. For example,
http://akagi.ms.u-tokyo.ac.jp/dvioutML.html
means to jump there by WWW browser,
mailto:dviout-admin@akagi.ms.u-tokyo.ac.jp
means to execute a program to write a mail and
c:\\tmp\\picture.jpg
means to display this picture if it exists.
Parameters
Various parameters when starting dviout are read in the order given below. If the settings conflict within those files, the latest read one will become effective.
1. dviout.par parameter file in the directory where dviout.exe exists.
If this is not found, the Windows directory is also searched.
2. Setting items written in the Registry specified to be read automatically.
3. Settings in the environment variables
4. Specifications on the command line
When the parameter file name in -file: in the parameters is specifically written, that parameter file is read when the file name is interpreted.
See Q_S3 for the parameter file format.
If the -NULL option parameter is specified on the command line, reading from the Registry will be skipped.
List of all the parameters can be shown in the Parameter List.
-A:
The search range for the fonts handling the required resolutions is enlarged (cf. Property Sheets->[Font2]).Zero or a positive integer is specified.
The resolution of the font calculated by dviout and the font name are used to obtain the required font based on the -TEXPK: specification. The resolution value is rounded off to an integer and substituted in ^d or ^l in -TEXPK: Since there are problems with the difference, a total of the three closest values above and below are searched
for. This search range is expanded only by the number specified in "-A:".
Example -A:4
The above setting expands the search range up to seven values above and below.
-area:
When printing uses a Windows printer driver, the driver's default value is used for the width of the unprintable region (Property Sheets->[Printer]). If this does not properly adjust the print positions, uncheck the box and adjust with -LM: or -TM:.
When a built-in dviout driver is used, this parameter is ignored and the -LM: and -TM: settings are followed.
This parameter is set ON or OFF.
-base:
The base line of each character is displayed (Property Sheets->[System]). This parameter switches only ON/OFF.
This can be used for checks such as proofreading.
-bb:
This is the maximum allowable size of the buffer for enlarging the image of a page (Property Sheets->[System]). This is specified by a positive integer.
-bf:
This is the cache buffer size for a font file such as the PK font (Property Sheets->[System]). This is specified by a positive integer.
-BM:
This represents the width of the unprintable area at the bottom of the paper. This parameter is specified as a length.
Usually, this setting would not be necessary (cf. Property Sheets-> [Printer]).
-BMP:
"-BMP:" is the option specified on the command line or in the parameter file. The setting is made in the [Display] of Property Sheets.
When "-BMP:<x>:<y>:<z>" is set, the gray scale display is compressed by 1/<x> in the horizontal direction and 1/<y> in the vertical direction. The <z>/1000 performs gamma correction.
If -<z> is set instead of <z>, the screen is displayed in reverse the black/white.
If ":<z>" is omitted, the interpretation is "<z>=800". If ":<y>:<z>" is omitted, the interpretation is <y>=<x>. The default is
-BMP:4:4:800
-box:
The range occupied by the characters is changed to a box to replace the characters (Property Sheets->[System]). This parameter takes a value ON or OFF.
It would be useful for checks such as proofreading.
-br:
This is the cache buffer size holding the bitmaps of each character (Property Sheets->[System]). This is specified by a positive integer.
-bright:
This adjusts the brightness of the paper surface in the Preview. The maximum brightness of 255 is the default (Property Sheets->[Display]). A positive integer of 255 or less is specified.
-Browser:
When there is an external reference by HyperTeX, or when using a browser not supported by default by the Windows system (when Property Sheets->[HyperTeX]->non-default Browser is checked), the path name should be specified.
-button:
This links the default of a tool bar button to a jump such as "Forward/Backward History" (Property Sheets->[System]). This parameter has a value ON or OFF.
-c:
When the "-c:" option is turned ON, the match of the font written in the dvi file to the font actually loaded is examined by using the checksum data (Property Sheets->[Font2]). This parameter takes a value ON or OFF.
If there is no match, a message like
check sum doesn't match in Font 35:
is displayed.
The number after "Font" is the font number in the dvi file (cf. Information display -> Font Information).
This error means that the tfm file used by TeX does not match the data in the loaded font that was actually loaded. This error occurs when the versions of the two files are not the same.
-cmode:
This parameter determines how the colors of characters and lines are superimposed. It takes an integer parameter with the values of 0, 1, 2, or 3 (Property Sheets->[Graphic]). Corresponds to -gow: for images.
0 (auto mode): Normal operation is to REPLACE (hide the bottom color when painting over). However, if it is guessed that erasing the lower color is not needed, it is painted over and not erased.
1 (merge) : When painting over, the colors mix (when the r suboption is not included in color specials). When mixed, the color gets closer to the normal character color (black when not the reverse screen).
2 (replace(def)): Always process by REPLACE. Antialiasing is performed with respect to the default background (paper) color.
3 (replace(bak)): Always process by REPLACE. The color before the previous push is considered to be the background color and antialiasing is performed.
4 (patch) : Replace by Windows API. This is slow in display but may be faster in Printing. dviprt Printing is not valid.
Note: Colored characters undergo antialiasing (gray scale when black and white). The blurring of color characters on the reduced Preview view is eliminated. Since some problems cannot be handled by REPLACE, the character outline becomes a faint color.
When Printing, always process by REPLACE for "auto mode".
-color:
When -color: is set to on, colors can be assigned to characters and lines by \specials given below(Property Sheets->[Graphic]).
color push gray x
color push rgb x y z
color push cmyk x y z n
color push hsb x y z
color push color
color pop
background <col>
are supported. "x", "y", "z", and "n" are real numbers between 0 and 1. "color" is assigned any one of 68 colors, such as black, white, red, green, blue, cyan, magenta, yellow. In "<col>", the color specification after the "push" above it is used.Spaces and commas delimit the color specifications.
If colors are painted over by the AND operator, for example, yellow on top of green is not visible, but turns to black when red is drawn. If the "r" suboption is added at the end of each special, replace is used to make replacements. However, white is always replaced (cf. -cmode:).
The color specifications for dvips are handled by graphicx.sty in LaTeX2e. When "Display -> Color replace" is checked in the tool bar, the default is replaced.
Note: These definitions are considered to be independent on each page.
-dpi:
This sets the dpi value for the resolution in the horizontal direction of the font used (Property Sheets->[Resolution]).This is specified by a positive integer.
If the resolution in the vertical direction (-dpiv:) is not set, the vertical resolution is regarded as the same resolution as the horizontal direction.
-dpiv:
This sets the resolution in the vertical direction. If it is not set, the horizontal resolution specified by -dpi: is regarded as same as the vertical resolution (Property Sheets->[Resolution]).
-dviprt:
If this parameter is specified, the dviout printer driver are invoked instead of the Windows driver for printing. Or it specifies command for calling another program such as the console version of dviprt for printing.
Changing the defaults of printing
The leading "+" is removed in the display when reading [Setup...] from the print dialog. Do not add it, in usual case. Although this can be changed, the change is considered to be a temporary one-time change and is not registered.
- +
- If a plus sign (+) is added to the beginning of -dviprt: in the [Printer] of Property Sheets, the default becomes printing based on the dviprt settings.
Using built-in dviout print drivers
- `
- When the beginning is ` or +` , printing is done by the built-in drivers. The function is determined by the following characters (based on the specification following the -p= in the MS-DOS version).
If "e", "p", "n", "l", "m", and "o" above are uppercase letters, they are not dviout settings, but use the default resolution (dpi) defined for each one.
- `e
- ESC/P compatible output (default of 180 dpi).
- `p
- PC-PR compatible output (default of 160 dpi).
- `n
- NM compatible output (default of 300 dpi).
- `l
- LIPS III/IV compatible output (default of 300 dpi) Subsequent suboptions can be specified..
- `lD600
- LIPS IV compatible output (default of 600 dpi) A semicolon (;) is inserted and subsequent suboptions can be specified.
- `m
- ESC/Page compatible output (default of 300 dpi) Subsequent suboptions can be specified.
- `o
- A specification for an external configuration file follows.
The suboptions can be specified for LIPS III/IV and ESC/Page LBP Drivers.
Controlling external programs
If the beginning is not ` or +` , the execution command is indicated. Specifically, a batch file is created and is responsible for processing.
However, when this is not multiple statements, but is only one line and the end of the first command, excluding the command's parameters, is ".exe", the batch file is not created and the command is directly executed.
The following keywords can be used.If -dviprt: is a space or only a plus sign (+), the defaults are set. Refer to "Example of dviprt Settings" and the manual for the dviprt being used.
- ;
- Represents the newline in multiple statements.
- ^t
- Full path name of the temporary files that can be freely used (If the environment variable TMP or TEMP is set, this is the directory. If they are not set, the path name is the "dvitmp.$$$" directory containing dviout.)
- ^q
- Full path name of the target dvi file
- ^p
- Printing range in the dviprt format (For dual page printing, macros are also included.)
- ^P
- This represents dviout.exe^-=^f^^q^^p.
- ^f
- File writing out the option parameters (Determines the parameters required by dviout from -harf:, -mag:, -lc:, -Z:, -OX:, -OY:, -varf:, -e:, -o:, -y:, and -nf:. For example, -OX: judged to be required when it is not zero. However, -y: is always included.)
- Specifically, this is the dvitmp.par file in the same directory as ^t.
- ^s
- Represents space. If the next character is not a letter, the "s" can be omitted.
- ^A
- Start page (logical page)
- ^B
- Stop page (logical page)
- ^a
- Start page (physical page)
- ^b
- Stop page (physical page) )
- ^c
- Number of copies (corresponds to -lc:)
- ^e
- Reduction/magnification ratio(corresponds to -e:)
- ^m
- Displays the selections by "Option for Paging" in the print dialog (number from 0 to 5)
- ^n
- Indicates the position of the right page in dual page printing (corresponds to W: in the print dialog, width represented in cm like 14.85 cm)
- ^y
- Paper size and orientation (corresponds to -y:, "A4P", etc.)
- ^h
- Horizontal position adjustment (corresponds to -OX:, cm format such as 1.25cm)
- ^v
- Vertical position adjustment (corresponds to -OY:, cm format)
- ^o
- Page printing order (corresponds to -o:, any of the six choices "r", "o", "e", "re", "ro" or space)
- ^x
- Directory containing the dviout to be started
-e:
The vertical and horizontal sizes are magnified or reduced. A variable-size font like a Windows TrueType font is magnified and reduced accordingly. The vertical and horizontal sizes are converted to 1/1000 of the set value (Property Sheets->[Resolution]). This parameter takes a positive integer.
When magnifying or reducing to match "-e:" for all of the fonts, -varf: is specified.
-F:
The -F: specification specifies how to make a substitution, to blank out or skip when the required font are missing (in a search based on -TEXPK:) (Property Sheets->[Font]). This is specified in a string.
-FB:
In relation to font substitution by -F:, this specifies whether to use a substitute font, correct the size if the substitute font has a different size, or replace with spaces or black boxes (Property Sheets->[Font]).
This is an integer type variable and is specified by a number in the parameter file.
0(replace): Use the substitute font specified by -F.
1(blank): Blank out with spaces based on the substitute font specified by -F.
2(black box): Draw a black box based on the substitute font specified by -F.
3(adjust size): Adjusts the size when a substitute font specified by -F is used, but the size is magnified or reduced for a different resolution (dpi).
-file:
This specifies the parameter file read by dviout (cf. Q_S3).
When specified in the [System] of Property Sheets and set to be read at start-up, after the parameters are read from the Registry, this parameter file is read and overwritten.
When ^x is added at the beginning of the path name, it is replaced by the directory where dviout is installed. Likewise, ^w is replaced by the Windows directory.
When started, dviout looks for dviout.par or dviout.ini in the directory containing the dviout.exe. Failing that, it then searches the Windows directory.
The parameter file can include other files; the nesting can be up to seven levels.
-Fkeep:
If this option is set to ON, dviout saves locations of often-used fonts to make dviout start quicker (Property Sheets->[Font2]).
This option is especially useful when the -TEXPK: entry contains a \\ or // construct (for recursive directory search). To erase the record, press [Flush] button.
If one of the following conditions is met, the font information is not recorded.
1. When the font filename matches an -TEXPK: entry with two or more \\ or // constructs. (-TEXPK: entries as a whole may contain several of such constructs.)
2. When the -TEXROOT: or -TEXPK: parameter is altered after startup.
3. When the font is substituted by the -F: option.
Dviout maintains a score for each fontname-resolution pair. The score is a nonnegative integer not greater than 255. Up to 250 fonts with high scores are recorded. Whether a font is used is examined when dviout quits. If several fonts have the same current score, dviout steps backward in the history of font usage, until the scores becomes inequal.
The score is calculated by the following rules:
1. The score of 64 is given if the font is used for the first time in the record.
2. If the font in the record is not used this time, the new score will be the last score (at the time of previous quit) times 15, divided by 16, plus 16, rounded down to the nearest integer.
3. If the font is in the record but not used this time, the score will be the last value times 15 divided by 16, rounded down to the nearest integer.
-g:
The Japanese font for horizontal writing is also substituted for vertical writing(Property Sheets->[JFont2]). This parameter takes value of ON or OFF.
When a Windows TrueType Japanese font for vertical writing uses the API (set in the default [WinJfont]), checking is not used.
-gbox:
When importing a graphic image, the frame of the image can be displayed (Property Sheets->[Graphic]). This parameter takes a vlue of ON or OFF.
-gdat:
The directory where PBM (produced by Ghostscript)or GIF files viewed by dviout can be specified explicitly by "-gdat:" (Property Sheets->[Graphic]).
The default directory where dviout searches for these image files is the Current Directory (directory containing the dvi file).
This is also referenced as the search path for files such as EPSF, PS, PBM, GIF, or BMP files read by dviout. More than one directory can be specified with separator ;. The one first specified becomes the directory for storage of the PBM (temporarily created by dviout), GIF, or BMP files .
-gen:
When the template file written to set the methods for creating and storing fonts (Template for Font Creation) is specified by the gen=<template_file> option, and dviout could not find the font, METAFONT starts and Automatic Font Generation is possible for missing fonts(Property Sheets->[Font2]
).
The basic font creation process and environment must be described in the template file. dviout creates the batch file containing data such as the required font name and size conforming to the template file settings, then dviout executes it. Fot these processes, METAFONT is necessary and you should check if it runs properly.
If a command in one line executes this font generation as in the case of using MakeTeXPK, the command line with adding the letter ` at the head can be directly set in -gen: and it is not necessary to prepare a template file.
If the METAFONT source cannot be found or there are mistakes in the setting parameters, the needed routines are collected and output to another batch file. Then, by executing this batch file, you can create required fonts manually even if the fonts are not created automatically.
-gfit:
The PostScript color image is converted into a BMP file by Ghostscript. Whether to set generation in the reduced size to on when previewing in the reduced size and using the gray scale is specified (Property Sheet -> [Graphic]).
This parameter can be set to ON or OFF.
OFF defects: When the dpi of the used font is large, and if the size of the color BMP file becomes large and some limit is exceeded, it takes an extremely long time to display (this might be due to the Windows specifications).
Since reduction while displaying is performed by Windows, sometimes lines disappear or blur.
A lot of the memory and the disk workspace are used.
ON defects: An image viewed by loupe is actually enlarged and is not clean. If the number of dpi is large, the Windows API may fail to enlarge a colored figure.
When the preview scale changes or in the case of printing, color BMP is recreated.
-GIF:
This specifies the format of the image file created and used by dviout using Ghostscript. Since it is an integer variable, an integer from 0 to 5 is specified in the parameter file.
0(raw PBM) : For printer output that is not color or only for black-and-white images.
1(monochrome GIF): Not supported by the most recent Ghostscript.
2(monochrome BMP)
3(16 color BMP)
4(256 color BMP): For Previews for both color and black-and-white images.
5(full color BMP): For color Printing using subtle colors.
The above are started with pbmraw, gifmono, bmpmono, bmp16, bmp256, or bmp16m, respectively, in the -sDEVICE= option in Ghostscript.
Only the settings supported by the Ghostscript being used can be set. (When the "-help" option is added and Ghostscript is started, the supported image formats are determined.)
Note: If BMP for many colors is used to handle color images, the available space in the memory and the hard disk must be large (particularly, as the image gets larger).
Note: When the -sDEVICE=bmp16 option is added and Ghostscript is started, the 16-color BMP format is not used, but only 16 colors in the 256-color BMP format (or something similar) are used.
In this case, even if there is switching between the 16-color mode and the 256-color mode, dviout does not update BMP files and uses them as 16-color BMP.
If 16-color BMP is switched to 256-color BMP, delete the 16-color BMP files, or convert from 16-color BMP -> monochrome BMP -> 256-color BMP.
-gow:
If this option is set to ON, each image is drawn after erasing the previous content of the canvas area. The default behavior is to keep the previous content (Property Sheets->[Graphic]).
Note that if the option is ON, included EPSF images are always clipped. (cf. PostScript special parameters).
For characters, set -cmode: to replace for the similar behavior.
-gclip:
If this option is set to ON, the image generated by EPSF is clipped by its BoundingBox. If -gow: is on, this clipping is always valid in spite of the value of -gclip:.
-GS:
This specifies the processing for PostScript specials, PS/EPS files, PBM files, GIF files, or BMP files.
The following specifications are possible. (Since this is an integer parameter, the following numbers are specified in the parameter file.)
0(Off): Ignore
1(On): Handles EPS/PS files, PS codes, PBM files, GIF files, and the special commands related to PBM files. Ghostscript must be called. If it is not found, the process ends.
2(verbose): Handles EPS/PS files, PS codes, PBM files, GIF files, and the special commands related to PBM files.
3(PBM): Ghostscript is not started.
If the corresponding PBM (or GIF) file is present, use that file. If it does not exist, skip.
In this case, the scale is changed by appropriate magnification or reduction even if the required Image data file and dot size differ.
The horizontal size is considered to be equal if the value rounded up to the byte width (8-dot unit) is the same.
4(exact PBM): Ghostscript will not be invoked.
If the PBM (or GIF) file containing the size exists, use it. If it does not exist, skip.
5(gssub): Ghostscript is not started.
As in 4, if the required image data file does not exist, the gs_exec.bat batch file that converts the EPS/PS file to a PBM or GIF file (read in by dviout) and the gs_exec$.ps PS file are created. The additional program ofgssub.exe is required.
If gs_exec.bat and gs_exec$.ps already exist, delete gs_exec.bat and gs_exec$.ps before starting when needed since the end of existing contents will be added to.
Since this batch file that is created converts only files that do not exist from among the required PBM files (or GIF files), if this batch file is started, starting with the next dviout, the PBM files (GIF files) can be directly read.
However, if images with different sizes are created multiple times from the same EPS file or direct PostScript codes are written in \special, they cannot be handled by the batch file that is created previously.
-gsize:
The size for reading in an EPS/PS image is set by the PostScript specials parameter. If the magnification of the dvi file is not 1000 (i.e., when
\mag=\magstep1
is in the TeX source), when the read-in size written in the PostScript specials is set to the size after magnification, the "-gsize:" switch is turned on (parameter set to ON or OFF, Property Sheets->[Graphic]).
In particular, if images are read in using epsbox.sty in a dvi file with a magnification other than 1000, specify "-gsize:".
If epsbox.sty is used, the PostScript specials having the scale conversion for the magnification are created. This can prevent the loss of the correct size by the two scale conversions of this conversion and the scale conversion in dviout.
-gsx:
The Ghostscript used when dviout interprets PostScript has the file name of gswin32.exe. The default is the file in the directory in the path. However, the start-up command for this program with the path can be specified explicitly by -gsx: (Property Sheets->[Graphic]).
If the long path name has a space character, use the short path name. The path name obtained by pushing [gsx:] button is the short one.
Parameters of Ghostscript can be specified also. for this, replace the spaces with ^ as the delimiters when specifying. For example,
-gsx:c:\gstools\gs4.03\gswin32c.exe^-dNOKANJI
-hbuf:
This is the size of the string buffer for storing the jump destination or label name in the cache when handling HyperTeX (Property Sheets->[HyperTeX]). This parameter is specified by a positive integer.
-hname:
This is the number of labels of the jump destination in the cache size when handling HyperTeX (Property Sheets->[HyperTeX]). This is specified by a positive integer.
-HC:
The text width read from a dvi file is regarded as the horizontal width of the text. This parameter can specify the centering in the horizontal direction of the text based on the horizontal width that is set for the paper (Property Sheets->[Paper]). This parameter is specified as a length.
-href:
This is the number of HyperJumps in the cache size when handling HyperTeX (Property Sheets->[HyperTeX]). This is specified by a positive integer.
-HS:
When the centering in the horizontal direction -HC: was specified, this option can define the movement in the horizontal direction after centering (Property Sheets->[Paper]). This parameter is set to ON or OFF.
-hyper:
This specifies the display format of the string indicating HyperJump in HyperTeX ([HyperTeX]). This specified by an integer in the parameter file. (Hexadecimal specifications are useful.)
The display format of "-hyper:mode" is the same as the -search:. Refer the description there. However, the value of "mode & 0xf00" is ignored.
-hyperoff:
This sets the handling of HyperTeX specials (Property Sheets->[HyperTeX]).
0: Default
1: Ignore HyperTeX specials (disable HyperJump)
2: Do not display the dialog box even if the HyperJump is to the outside (direct outerjump).
The above numbers are specified in the parameter file.
-J:
If the <num> number is specified as in "-j:<num>", the position is adjusted so that the base line is lowered only for <num>/1000 times the height of the font from the value calculated from the jfm file (cf. Property Sheets->[JFont2]).
The default is zero. The specification allows a negative value for the integer.
-JC:
This sets the substitute for Japanese font characters (Property Sheets->[JFont2]).
-JC:<number>:<new_code>=old_code[y|t]:...:new_code=old_code[y|t]
In \system<number>, the total number (of definitions) of a converted character is given by a decimal number. \system<new_code> and \system<old_code> are four-digit hexadecimal numbers. JIS codes are converted from the \system<old_code> characters to the \system<new_code> characters.
By default, both the vertical characters and horizontal characters are converted.
If "y" is specified, only the horizontal characters are converted. If "t" is specified, only the vertical characters are converted.
The search starts from the beginning, only the first conversion found is valid.
-L:
This sets the way to truncate a font name longer than eight characters. Since there are restrictions on the length of a file name, this is used in MS-DOS (Property Sheets->[Font]).
In Windows 95 or NT, the default is no truncation. For lcircle10,
2(Cut no part): lcircle10 -> lcircle10
0(Cut last part): lcircle10 -> lcircle1
1(Cut middle part): lcircle10 -> lcirle10
This is an integer variable. The above numbers are specified in the parameter file.
-LM:
This represents the width of the unprintable area on the left side of the paper.This parameter is specified as a length.
Therefore, the horizontal directions of the print positions in the printer and its dedicated driver are corrected. A temporary adjustment is made by -OX:. (Property Sheets -> [Printer])
-log:
This parameter specifies the path name of the log file recording information such as the dviout errors and warnings (Property Sheets->[System]).
When there is only +, the log file is created with the file name dviout.log in the directory containing dviout.exe. On the other hand, if there is -, the log file is not created. This setting can be changed from the Menu Bar.
-mag:
When the vertical and horizontal sizes are converted and this is not specified, the value of \magstep written in the dvi file is used (Property Sheets->[Resolution]).
If \magstep is m, the size is 1.2^m times. A font resolution is searched for as a conversion that corresponds to this value.
The magstep values of 0, 1,..., 9 can be specified in the parameter file. A "-1" indicates the default. The "magstep half" specifies "-half=+".
Regardless of the current state, the default is always displayed on the [Resolution] in Property Sheets. (Erroneously setting a special magstep at start-up is prevented.) The current mag value can be found by "Help -> Information".
-mode:
This option alters the current mode, which is specified by a number from 0 to 9. The parameters for that mode are then read from the Windows Registry.
This option has the same effect as modifying the Option->Mode... settings from the toolbar, but is effective at the next Open or ReNew.
This parameter can be set at startup as a command-line parameter, or DDE communication. It can be used to start dviout with a mode different from the default which is set on the Property Sheets->[REGISTRY] page.
-multi:
This is the maximum number of dviouts that can run at the same time (Property Sheets->[System]). This is specified by a positive integer.
-ntt:
Setting ON -ntt: specification, the Japanese font for pTeX supported by dviout can be used from a dvi file typeset by NTT JTeX (Property Sheets->[JFont2]).
-nttF:
When a NTT JTeX Japanese font is replaced by a pTeX (by ASCII Corp.) Japanese font by the -ntt: option, when a new Japanese font is added and defined by \jfont, the added Japanese font name must be taught to the dviout.
The following option "-nttF:" is used here (Property Sheets->[JFont2]).
-nttF:<jfm_file_1>=<added_font_1>;<jfm_file_2>=<added_font_2>;...
Note that in this option, a name not containing the point number (10, 12, etc.) or the resolution (118, 360, etc.) is specified.
-OX:
This sets the correction of the output position in the horizontal direction (Property Sheets->[Paper]). This parameter is specified as a length and can be a negative value.
-OY:
This sets the correction of the output position in the vertical direction (Property Sheets->[Paper]). This parameter is specified as a length and can be a negative value.
-renew:
This can set the function that checks whether the displayed dvi file has been changed, and if so, automatically updates the display when returning again to the dviout window after moving to other windows (Property Sheets->[System]). This parameter is set to ON or OFF.
-RM:
This specifies the width of the unprintable area on the right side of the paper (top in the landscape orientation). This parameter is specified as a length. (cf. Property Sheets -> [Printer])
-S:
This adjusts the size, if a Japanese font other than JXL4, such as Windows 95 TrueType Japanese font, is used.
The default is to adjust to the size proportional to the value set by 1000 (cf. Property Sheets->[JFont2]). For example, if 950, there is a 5% reduction. This is specified by a positive integer.
-scale:
This sets the display mode of the four views of "Display -> View1,..., View4".This can be set by "Property Sheets -> [Display]".
-scale:<x1>:<y1>:<z1>:<x2>:...:<y4>;<z4>
can be set (same specification as in the parameter file).<x1>:<y1>:<z1> corresponds to View1, and the others are the same. Similar to -BMP:, these three numbers represent the reduction in the horizontal direction, the reduction in the vertical direction, and the gamma correction (+screen reverse).
-sdpi:
This sets the maximum resolution (dpi in gray scale) that allows coloring the strings by HyperTeX or in a string search (Property Sheets->[Search]). This is specified by a positive integer.
To save the memory, the default is set to 150.
An image seen in a loupe cannot be colored these highlight.
-search:
This specifies the display format of the strings found by a string search ([Search]).
When -search:mode,
mode & 0x8000 = 0: box The whole box or the character inside or the frame is colored.
mode & 0x8000 = 0x8000 : This draws a colored line (usually, mode & 0x80 = 0x80)
In addition,
(mode & 0x4000)?: In vertical writing, is the line on the right side?
(mode & 0x2000)?: In horizontal writing, are there overbars and no underlining?
(mode & 0x1000)?: In horizontal writing, is the underlining at the bottom?
mode & 0x02 = 0 : fill box
2 : draw boundary
mode & 0x0c = 0 : or color
4 : set color
8 : reverse (ignore : mode & 0xf0)
mode & 0x80 = 0 : background
0x80 : foreground
mode & 0xf0 =
color box (with gray characters in black)
0x00: original 0x10: yellow box 0x20: magenta box
0x30: red box 0x40: cyan box 0x50: blue box
0x60: green box 0x70: black box
color characters (gray scaled with a white background)
0x80: black char 0x90: blue char 0xa0: green char
0xb0: cyan char 0xc0: red char 0xd0: magenta char
0xe0: yellow char 0xf0: while char
mode & 1 is ignored.
mode = 0xf0 means the string is erased.
The colors in the reverse mode become complementary colors.
The above is the same for -hyper:.
mode & 0x100 = 0: The coloring of the searched string is individual.
!= 0: The entire string found on that page is colored.
mode & 0x200 = 0: The mouse cursor does not move.
!= 0: The mouse cursor points to the searched string.
-sFont:
This parameter specifies which fonts (usually symbols fonts) to be ignored in String Search or String Copy contexts (Property Sheets->[Search]).
List fonts to be ignored, delimited by semicolons (; ), followed by a space character, followed by fonts that have only uppercase letters (A to Z), also delimited by semicolons. For the latter, lowercase and other characters are ignored.
The tail part of the font name may be omitted by appending an asterisk (* ). In this case, the delimiting semicolon (; ) is can also be omitted. Thus, lasy* stands for lasy8, lasy10, etc. Here's an example:
-sFont:cmex*lasy*line*lcircle* cmsy*cmbsy*
-spi:
There is a image viewer software named Susie freely available. Some DLL's of Susie plug_in are developed for some image format.
By employing Susie, dviout for Windows can import various file formats of image. Parameter -spi: specifies the directory where Susie exists. The default is the directory where dviout exists.
Dviout will search for JPEG/TIFF/GIF/PCD image files in the directory where -spi: specifies, where dviout.exe exists, Windows directory and whatever on your PATH.
-t:
This sets the number of dots in one scroll (Property Sheets->[Display]).
The larger this value, the faster the scrolling, but the scrolling is no longer smooth. This is specified by a positive integer.
-TEXFLI:
When the FLI Font Library is used, the variable part of the font library name in -TEXPK: is represented by ^f and set. The variable parts are listed in -TEXFLI: (Property Sheets->[Font2]).
-TEXFONTS:
This specifies the name of the directory containing the tfm files and the jfm files when using European Language TrueType Fonts in an old way, or PK fonts do not exist, but correctly sized spaces replace them if the tfm files exist (Property Sheets->[Font]).
^r, ;, and \\ can be used and have the same meanings as with -TEXPK:.
-TEXKNJ:
When using a bitmapped Japanese font on the disk used by the MS-DOS version of dviout, as in the MS-DOS version, that font is specified by -TEXKNJ: (Property Sheets->[JFont2]). The number of horizontal dots in each font must be included in the file name.
In "-TEXKNJ:", that number of dots is specified by ^d.
For example, the specification can be
-TEXKNJ:c:\font\jfont\^s^d.pk;c:\font\jfont\kanji.^d
The ^s in TEXKNJ: is replaced by the string without the numbers at the end of the corresponding jfm file name without the extension (.tfm).
For example, for goth5.tfm or goth10.tfm, goth is substituted in ^s. The last part in the above example specifies the presence of Japanese fonts such as goth.24, kanji.24, kanji.32, or kanji.48 in the c:\font\jfont directory.
-TEXPK:
This specifies the presence of Font Glyph Files such European language PK fonts.When ASCII pTeX is used, this also specifies the presence of Japanese jfm files (Font Metric Files) (Property Sheets->[Font], Examples of TEXPK Settings)
In this specification, ^ or % is grouped with the next character. They are replaced by special values. ^ can be changed to %.
- ^r
- String specified by -TEXROOT:
- ^s
- Font name(cmr10, min10, etc.)
- ^d
- dpi(dots per inch) value
- ^l
- Five times the dpi value
- ^g
- Indicates a GTH Font Library or FAR Font Library
- ^t
- Indicates the variable part of the FLI Font Library
- ^x
- Directory where dviout was installed
- ^w
- Windows system directory
- \\
- Line of any directory names (kpathsea function)
- ;
- Delimiter for multiple specifications. Precedence given to specification written earlier
-TEXPKD:
This creates the index file recording the location of each character raster (using pktopkd) for the PK font. It can be specified by -TEXPK: and used.
"-TEXPKD:" specifies the location of the actual font in a part of the path from the root and is used with the relative directory path written in the index file (Property Sheets->[Font2]).
The following are used in MS-DOS.
- When using a PK font larger than 64K bytes
- When handling a dvi file that uses many PK files (for example, a file typeset by NTT's version of JTeX)
-TEXROOT:
If -TEXPK: or -TEXFONTS: are strings containing ^r or %r, the string set in -TEXROOT: is substituted (Property Sheets->[Font]).
Path names from a shared root can be set.
-TM:
This represents the width of the unprintable area at the top of the paper. This parameter is specified as a length.
Therefore, the vertical directions of the print positions in the printer and its dedicated driver are corrected. A temporary adjustment is made by -OY:. (cf. Property Sheets -> [Printer])
-tpic:
This specifies whether tpic specials commands are enabled; or if enabled, whether to use the Bezier curves when drawing curves (default) or to use spline curves (Property Sheets->[Graphic]).
This is an integer parameter. The above three choices are labeled as 0, 1, 2.
-ttf:
This controls the use of European Language TrueType Fonts (Property Sheets->[Font2]). A non-negative number is specified.
-ttf:0 Prohibits the use of European language TrueType fonts.
-ttf: <num> When <num> is a positive integer, the use of Europian Language TrueType Fonts is prohibited for a fonts smaller than <num> dpi(the value used in -TEXPK: by ^d).
The TrueType font is only used for a TeX font which satisfies the conditions
- -ttf:is positive and the size of the font is not small than this value
- the tfm file of the font is searched by -TEXPK:
- the correspondence of a TrueType font with this font is defined in Property Sheets->[WinJFont]
To validitate the change of the value of this parameter for all fonts, push [Flush] button in [Font2]. Otherwise this is applied only to the fonts that have never been used by dviout.
-varf:
When "-varf:" option is set to ON, fixed-size Japanese fonts are enlarged or reduced in continuous magnification, they can be used as a scalable font.
In addition, when the entire font is enlarged or reduced by the -e: option, the same adjustments are also made for fixed-size European language fonts. This parameter is set to ON or OFF (Property Sheets->[Font2]).
Since the jfm file is read for a Japanese font and the vertical and horizontal directions are individually enlarged or reduced to obtain the appropriate vertical and horizontal sizes, flat types or long types can be handled.
If the size differs in the substitute font set by -F:, -FB: is used to adjust the size.
-VC:
If this parameter is specified, the height of the text read from a dvi file is regarded as the vertical height of the document. Then, the document can be in centering in vertical direction on the sheet. (Property Sheets->[Paper]). A length value is set to this parameter.
-VS:
When the centering in the vertical direction is specified, the movement in the vertical direction after centering can be defined (Property Sheets->[Paper]).This parameter can be set to ON or OFF.
-vfn:
When Windows TrueType fonts or the Shotai-Club fonts are used, the configuration file (default file name of dviout.vfn) is specified by the full path name (Property Sheets->[JFont2]).
This cannot be used with the specification by [WinJFont]. Specify only when using Shotai-Club fonts but not Windows TrueType Japanese fonts.
-Wshow:
Dviout invokes METAFONTS for font generation and Ghostscript for PostScript interpretation. These external programs are run in an iconified state (hidden in the Windows task bar, not as an open window) by default.
If the -Wshow: switch is ON, external programs are run as a separate window, which is open until the program ends (Property Sheets->[System]). This switch should be set ON if the program stalls when iconified state.
-y:
The paper size and orientation are specified in "Property Sheets->[Paper]". In the parameters in dviout.par, from the
-y:<papersize>[P:L].
<papersize> = A3, A4, A5, B4, B5, H, Legal, Letter
These are the sizes for A3, A4, A5, B4, B5, postcard, legal, and letter, respectively.
By setting <papersize> = F<width>:<Height>, the vertical and horizontal lengths can be set independently. (The <width> length is written as 12.5cm, 123mm, for example.)
The P and L after <papersize> represent the portrait and landscape orientations of the paper.
-virtual:
This parameter switches enabling or disabling the use of Virtual Fonts.
The followings are not supported at now and there may exist some bugs,
- Tate mode in Japanese TeX
- specials
- depth of local stack is at most 16
Notes for non-japanese Windows95/NT users
You can run dviout for Windows on non-Japanese Windows95/NT (There are some reports of running on U.S.A. and German version of Windows95/NT).
- If you want to use japanese True Type fonts on non-japanese Windows95/NT, see Q_F12
- If dviout indicates a warning with fonts when start up, just ignore the warning and press "NO".
Even on non-Japanese Windows95/NT dviout can treat pTeX(Japanized TeX developed by ASCII corp.) and NTT JTeX if you have jfm files and TrueType or bitmapped Japanese fonts. Some of them can be obtained freely.
Terminology
dviout
Contents
Supported Functions
Distribution
dviout Users Group
Known Problems
MakeHelP
Supplement
Uninstall
Preview
Parameter List
Example of Parameter Setting
Property Sheets
HyperTeX
String Search
String Copy
Move
Another file
Page Number
Start and Exit
no more dviout
Link to Other Programs
Example Using DDE
Installation
Setting the Resolution
Setting the Font Path
Examples of TEXPK Settings
Adjusting the Display Scale
Adjusting the Print Position
Associating dvi files with dviout
Automatic Parameter Installation Function
Printing
Page Selection
Reduce/Magnify Printing Function
Pause at Each Page
Page Printing Order
Examples Using the Print Options
Page Printing Order
Cancel During Print Data Output
Unite Print Jobs
dviprt Printing
Examples of dviprt Settings
CFG File
LBP Driver
Including printer control codes into TeX file
User Interface
Menu Bar
File Menu
Jump Menu
Search Menu
Display Menu
View Menu
Option Menu
Help Menu
Information Display
Information related to files and views
Font Information
Buffer Information
Key Function Table
Parameter List
Output of Parameter Setting
Property Sheets
[CONTENTS]
[Save]
[Restore]
[OK]
[Cancel]
[Apply]
[Help]
[Default]
current mode
[Display]
gamma correction
gray scale
HVscale
reverse Display
[Resolution]
dpi
[Font]
[Guess]
[Guess] Specifications
Handling Missing Fonts
Font Glyph File
Font Metric File
tfm file
jfm file
FLI Font Library
European Language TrueType Font
inch
GTH Font Library
FAR Font Library
Font Check
cmr10
line10
msam10
lcircle10
eufm10
min10
tmin10
-F: specification
[Font2]
Automatic Font Generation
Template for Font Creation
[WinJFont]
TrueType Font List
H scale in [WinJFont]
V scale in [WinJFont]
[Define] in [WinJFont]
[Remove] in [WinJFont]
[Change Font]
[Add Font]
jfm/tfm in [WinJFont]
Flat font in [WinJFont]
Slanted font in [WinJFont]
Orientation in [WinJFont]
H position in [WinJFont]
V position in [WinJFont]
[JFont2]
-ntt specification
[Key]
Define in [Key]
Clear in [Key]
Search in [Key]
All Clear in [Key]
Function in [Key]
Key in [Key]
[Search]
[HyperTeX]
HyperTeX specials
[Loupe]
[Graphic]
BMP file
tpic specials
tpic specials commands
tpic specials extensions
Image data file
Image data file specials
PostScript special parameters
Examples using PostScript specials
Ghostscript
Current Directory
[Printer]
[Paper]
[System]
[REGISTRY]
Registry
Selected mode
Current Name:
Current mode:
Default mode:
Current Print:
[Auto Load]
[Ignore]
[Save] in [REGISTRY]
[Restore] in [REGISTRY]
[All Set] in [REGISTRY]
[All Clear] in [REGISTRY]
list box in [REGISTRY]
Q&A
Parameters
-A:
-area:
-base:
-bb:
-bf:
-BM:
-BMP:
-box:
-br:
-bright:
-Browser:
-button:
-c:
-cmode:
-color:
-dpi:
-dpiv:
-dviprt:
-e:
-F:
-FB:
-file:
-Fkeep:
-g:
-gbox:
-gdat:
-gen:
-gfit:
-GIF:
-gow:
-gclip:
-GS:
-gsize:
-gsx:
-hbuf:
-HC:
-hname:
-href:
-HS:
-hyper:
-hyperoff:
-J:
-JC:
-L:
-LM:
-log:
-mag:
-mode:
-multi:
-ntt:
-nttF:
-OX:
-OY:
-renew:
-RM:
-S:
-scale:
-sdpi:
-search:
-sFont:
-spi:
-t:
-TEXFLI:
-TEXFONTS:
-TEXKNJ:
-TEXPK:
-TEXPKD:
-TEXROOT:
-TM:
-tpic:
-ttf:
-varf:
-virtual:
-VC:
-VS:
-vfn:
-Wshow:
-y: