summaryrefslogtreecommitdiff
path: root/systems/msdos/dviware/xdvi-dos/read_dvx.txt
blob: a0e076fd542eb7253d2e7899edf1d4b5b227c26a (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
                       XDVI for PC under DV/X
                       ----------------------


This program is re-compiled using DJGPP.  As a result, it expects 386 and
up CPU with FPU as well as GO32.  Original XDVI source is obtained from
export.lcs.mit.edu:/contrib.
==============================================================================

Modifications
-------------

There are not many modifications done to the original xdvi except that
fonts not available can now be substituted by specifying them in a file.
The environmental variable "TEXFONTSUB" points to this file. For example,
"TEXFONTSUB=c:\xdvi\texfonts.sub".  The filename texfonts.sub is arbitrary.
One can rename it to some other name as long as the environmental variable
TEXFONTSUB points to it.


Format of the font substitute (ASCII) file:

amr10 -> cmr10
src2 -> dest2
      :
      :

where src2 is the unavailable font and dest2 is the font we intended to
substitute.  It is exactly as the font substitution machcanism found in
DVIVGA.

For those interested in the image processing features provided by XDVI,
please browse through the source and see if I did anything wrong
in choosing suitable image quality since I do not know anything about
image processing.

Default TeX font directory is "c:\tex\fonts."  However, this can be overridden
by specifying another directory through some environmental variable.  Please
look at the file "readme" for details.

Finally, I have tested only the "pk" font version of XDVI,
therefore the performance of using "gf" and "pxl" is unknown.  These two
versions of XDVI are however also modified to look up font substitute file.
To obtain the other two versions one must re-compile XDVI with appropiate
switches set.
===============================================================================

Optimizing the program
----------------------

Opening and searching text file using DJGPP will add significant overhead
to the execution due to mode switching.  Also, I found most of substitutions
are converting AM font to CM font (I only have cm font at home).  Therefore,
I also modified the program to convert amxxxx to cmxxxx internally to speed
up execution.  To choose this option one should recompile the source without
defining FONTSUB (i.e., take out  -DFONTSUB in the makefile).  Finally,
the makefile enclosed is compatible with both NDMAKE45 and Borland's MAKE
utility.
===============================================================================

Bugs
----

I have not yet found any bugs afte I have performed some testings.  However,
I conducted the test without mouse attaching to my system (because I do not
 have one).  Accordingly, I have no idea how XDVI will behave with mouse
connected.  Finally, I have tested only the "pk" font version of XDVI,
therefore the performance of using "gf" and "pxl" is unknown.  These two
versions of XDVI are however also modified to look up font substitute file.
===============================================================================

Acknowledgment
--------------

I wish to thank DJ, et. al. for their excellent compiler.  Also thank all
authors of the original XDVI for their contribution.