summaryrefslogtreecommitdiff
path: root/Master/texmf-dist/doc/support/dosepsbin/dosepsbin.txt
blob: c1467a38d4f4266d341b114e1c05ca80829bf062 (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
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
NAME

    dosepsbin -- Extract PS/WMF/TIFF sections from DOS EPS binary files

VERSION

    2012-03-22 v1.2

SYNOPSIS

    The progam dosepsbin analyses an EPS file that is not a plain ASCII
    PostScript file but given as DOS EPS binary file.

        dosepsbin [options] <input file>

    First it analyzes the *input file*, validates its header and summarizes
    the available sections. Depending on the given options, the sections are
    then written to files.

    Options:

        --eps-file <file>      Write PS section to <file>.
        --wmf-file <file>      Write WMF section to <file>.
        --tiff-file <file>      Write TIFF section to <file>.
        --inputfile <file>     The name of the input file.
        --verbose              Verbose output.
        --quiet                Only errors and warnings are printed.
        --help                 Brief help message.
        --man                  Full documentation.
        --version              Print version identification.

    The files for output must be different from the input file.

DESCRIPTION

  DOS EPS Binary File Format

    A Encapsulated PostScript (EPS) file can also given in a special binary
    format to support the inclusion of a thumbnail. The file format starts
    with a binary header that contains the positions of the possible
    sections:

    * Postscript (PS)
    * Windows Metafile Format (WMF)
    * Tag Image File Format (TIFF)

    The PS section must be present and either the WMF file or the TIFF file
    should be given.

OPTIONS

    --eps-file=<*file*>
        The PS section is written to <*file*>. The output file must be
        different from the input file.

    --wmf-file=<*file*>
        The WMF section is written to <*file*> if present. The output file
        must be different from the input file.

    --tiff-file=<*file*>
        The TIFF section is written to <*file*> if present. The output file
        must be different from the input file.

    --inputfile=<*file*>
        The input file can also be given directly on the command line. If
        the file does not exist, then the file with extension `.eps' is
        tried.

    --verbose
        Verbose messages.

    --quiet
        No messages are printed except for errors and warnings.

    --help
        Display help screen.

    --man
        Prints manual page.

    --version
        Print version identification and exit.

EXAMPLES

    The following command extracts the PS section from file test.eps and
    stores the result in file test-ps.eps:

        dosepsbin --eps-file test-ps.eps test.eps

AUTHOR

    Heiko Oberdiek, email: heiko.oberdiek at googlemail.com

COPYRIGHT AND LICENSE

    Copyright 2011-2012 by Heiko Oberdiek.

    This library is free software; you may redistribute it and/or modify it
    under the same terms as Perl itself (Perl Artistic License/GNU General
    Public License, version 2).

SEE ALSO

    The DOS EPS binary file format is described in section "5.2 Windows
    Metafile or TIFF":

        Adobe Developer Support,
        Encapsulated PostScript File Format Specification,
        Version 3.0,
        1992-05-01,
        http://partners.adobe.com/public/developer/en/ps/5002.EPSF_Spec.pdf

HISTORY

    2011/11/10 v1.0

      * First version.

    2011/12/05 v1.1

      * Typo fixed in help text (thanks Peter Breitenlohner).

    2012/03/22 v1.2

      * Fix in validation test for offset of PS section.