summaryrefslogtreecommitdiff
path: root/dviware/dtl/dtl.doc
blob: 3817e91c1c4606899e0c1fb4317867a3b5c45293 (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
77
78
79
80
81
82
This file is public domain.
Originally written 1995, Geoffrey Tobin.
The author has expressed the hope that any modification will retain enough content to remain useful. He would also appreciate being acknowledged as the original author in the documentation.
This declaration added 2008/11/14 by Clea F. Rees with the permission of Geoffrey Tobin.

``dtl.doc''
Wed 8 March 1995
Geoffrey Tobin

Correspondence between DTL and DVI files.
-----------------------------------------

DTL variety sequences-6, version 0.6.0
--------------------------------------

Note:  `DTL' stands for `Device-Independent Text Language', and is an
ASCII text representation of a DVI file.

References for DVI file structure:
----------------------------------
 
In this distribution:

        dvi.doc

In the TeX archives:

        CTAN:  dviware/driv-standard/level-0/dvistd0.tex
 
    "The DVI Driver Standard, Level 0",
    by  The TUG DVI Driver Standards Committee  (now defunct)
    chaired by Joachim Schrod.
    Appendix A, "Device-Independent File Format",
    section A.2, "Summary of DVI commands".

DTL Commands
------------

    variety <variety-name>  Specifies name of DTL file type.

Naturally, `variety' has no DVI equivalent.

The other DTL commands correspond one-to-one with DVI commands, but I
have used briefer names (except for `special') than those used in the
DVI standards document.

    DTL  :  DVI 

    (text)  :  series of set_char commands, for printable ASCII text
    \(   :  literal ASCII left parenthesis in (text)
    \)   :  literal ASCII right parenthesis in (text)
    \\   :  literal ASCII backslash in (text)
    \"   :  literal ASCII double quote in (text)
    \XY  :  set_char for character with hexadecimal code XY,
            not in parentheses, but by itself for readability
    s1, s2, s2, s3  :  set, with (1,2,3,4)-byte charcodes
    sr   :  set_rule
    p1, p2, p2, p3  :  put, with (1,2,3,4)-byte charcodes
    pr   :  put_rule
    nop  :  nop (do nothing)
    bop  :  bop (beginning of page)
    eop  :  eop (end of page)
    [    :  push
    ]    :  pop
    r1, r2, r3, r4   :  right, with (1,2,3,4)-byte argument
    w0, w1, w2, w3, w4  :  as in DVI
    x0, x1, x2, x3, x4  :  as in DVI
    d1, d2, d3, d4   :  down, with (1,2,3,4)-byte argument
    y0, y1, y2, y3, y4  :  as in DVI
    z0, z1, z2, z3, z4  :  as in DVI
    fn  :  fnt_num (set current font to font number in 0 to 63)
    f1, f2, f3, f4  :  fnt (set current font to (1,2,3,4)-byte font number)
    special  :  xxx (special commands with (1,2,3,4)-byte string length)
    fd  :  fnt_def (assign a number to a named font)
    pre  :  preamble
    post  :  post (begin postamble)
    post_post  :  post_post (end postamble)
    opcode  :  undefined DVI command (250 to 255)

---------------
EOF ``dtl.doc''
---------------