File: reswrap.1

package info (click to toggle)
fox 1.0.52-2
  • links: PTS
  • area: main
  • in suites: sarge
  • size: 10,788 kB
  • ctags: 13,384
  • sloc: cpp: 96,482; sh: 8,338; ansic: 1,935; makefile: 1,010; perl: 32
file content (112 lines) | stat: -rw-r--r-- 2,770 bytes parent folder | download
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
.TH reswrap 1 "July 1999" "The FOX C++ GUI Toolkit" "FOX Programmers Manual"

.SH NAME
reswrap \- wrap icon resources into C code

.SH SYNOPSIS
.B reswrap
.RB [ \-o [ a "] "
.IR outfile ]
.RB [ \-h "] [" \-v "] [" \-d "] [" \-x "] [" \-e "] [" \-i "] [" \-s ]
.RB [ \-n
.IR name ]
.RB [ \-c
.IR cols ]
.RB [ \-ppm ]
.I files

.SH DESCRIPTION
The
.B reswrap
tool is used to turn images and other resource files into embeddable C or C++ data arrays.
The output file can then be easily compiled into the application.
By default reswrap will interpret the
.I files
listed as a stream of raw bytes and output them as an initialized data array on stdout, ready
to be compiled into the application.

.SH OPTIONS
.TP
\fB\-o\fR[\fBa\fR]\fI outfile\fR
Write the result into the file
.I outfile
instead of writing to stdout. With
\fB\-o\fR
the
.I outfile
will be overwritten with the data from the input.
With the
\fB\-oa\fR
option, the resulting code is appended to the
.I output
file, allowing multiple input files to be placed into one single resource source file.

.TP
\fB\-h\fR
Print a short usage message.

.TP
\fB\-v\fR
Just print out the version number and terminate.

.TP
\fB\-d\fR
Write data as decimal numbers instead of using the default hexadecimal numbers.

.TP
\fB\-x\fR
Write data as hexadecimal numbers (default).

.TP
\fB\-e\fR
Places the storage modifier extern in front of the data array, ensuring
that the data array can be linked with other compilation units.

.TP
\fB\-i\fR
Instead of generating an array definition only write a declaration, which
can be included as a header file.

.TP
\fB\-s\fR
This option suppresses comments inserted by reswrap to indicate the
original file name from which the data statement was generated.

.TP
\fB\-n\fI name\fR
Instead of taking the filename less the extension, reswrap substitutes
.I name
for the name of the resource.

.TP
\fB\-c\fI cols\fR
Writes
.I cols
columns instead of the default 16 columns in the data statements
generated by reswrap.

.TP
\fB\-ppm\fR
Assumes the source file is a Portable Pixmap (ppm) file.  Reswrap will
output a simple rgb array.

.SH SEE ALSO
The reswrap program is a part of the FOX GUI Toolkit.  The FOX Toolkit may be found at

.B http://www.fox-toolkit.org

The FOX website has the official FOX documentation in HTML which includes
some additional information about reswrap and its use.
If you installed the libfox0.99-doc package you can find this in

.B /usr/share/doc/libfox0.99/html/fox.html

also.

.SH AUTHOR
This manpage was originally written by Torsten Landschoff (torsten@debian.org)
for the Debian distribution of the FOX Toolkit.

The main author of FOX is Jeroen van der Zijp <jeroen@fox-toolkit.org>. For a list of
contributors see /usr/share/doc/libfox0.99/AUTHORS.