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
|
.\" Hey, EMACS: -*- nroff -*-
.\" Please adjust this date whenever revising the manpage.
.Dd August 05, 2010
.Dt GRFCodec 1
.Sh NAME
.Nm GRFCodec
.Nd A tool to convert a GRF file into graphics files and meta data, and vice versa.
.Sh SYNOPSIS
.Nm grfcodec
.Op Fl v
.Op Fl d | e
.Op options
.Ar GRF\(hyfile
.Op Directory
.Pp
<GRF\(hyFile> denotes the .GRF file you want to work on, e.g. TRG1.GRF
.Pp
<Directory> is where the individual sprites should be saved. If omitted, they
will default to a subdirectory called sprites/.
.Sh OPTIONS
.Bl -tag
.It Fl ?
Display the help message.
.It Fl e
Encode a GRF file. The
.Ar GRF\(hyfile
to pass is the file where to encode to. The source of the GRF\(hyfile, i.e. the .nfo, will be looked for in
.Pa sprites/GRF\(hyfile.nfo .
All PCX files will be searched for relative from the location of the GRF\(hyfile.
.It Fl d
Decode a GRF file. The
.Ar GRF\(hyfile
to pass is the file to deoce. The result will be in
.Pa sprites/GRF\(hyfile.nfo
and
.Pa sprites/GRF\(hyfile.pcx .
.It Fl v
Display the version.
.El
Options for decoding:
.Bl -tag
.It Fl w Ar num
Write PCX files with the given width (default 800, minimum 16)
.It Fl h Ar num
Split PCX files when they reach this height (default no limit, minimum 16)
.It Fl b Ar num
Organize sprites in boxes of this size (default 16)
.It Fl p Ar pal
Use this palette instead of the default. See
.Fl p
? for a list.
.It Fl t
Disable decoding of plain text characters as strings.
.It Fl x
Disable production of unquoted escape sequences.
.It Fl xx
Disable production of both quoted and unquoted escape sequences.
.Pp
This has the side effect of producing a version 6 .nfo, instead
of a version 7 .nfo.
.It Fl X
List sprite numbers in the PCX file in hex.
.El
.Pp
Options for encoding:
.Bl -tag
.It Fl c
Crop extraneous transparent blue from real sprites
.It Fl u
Save uncompressed data (probably not a good idea)
.It Fl q
Suppress warning messages
.El
.Pp
Options for both encoding and decoding:
.Bl -tag
.It Fl m Ar num
Apply colour translation to all sprites except character\(hyglyphs.
.It Fl M Ar num
Apply colour translation to all sprites.
.Pp
If both of these are specified, only the last is obeyed.
.Fl m
? or
.Fl M
? for a list of colour translations.
.El
.Sh SEE ALSO
The documentation in
.Pa /usr/share/doc/grfcodec/
.Sh AUTHOR
GRFCodec was written by Josef Drexler.
.Pp
This manual page was written by Remko Bijker.
.Sh COPYRIGHT
GRFCodec is Copyright (C) 2000\(hy2005 by Josef Drexler <josef@ttdpatch.net>
|
