|
Name |
|
Date |
Size |
#Lines |
LOC |
| .. | | 03-May-2022 | - |
| build-aux/ | H | 07-Mar-2018 | - | 17,294 | 12,984 |
| common/ | H | 07-Mar-2018 | - | 5,476 | 4,221 |
| data/ | H | 07-Mar-2018 | - | 1,425 | 1,266 |
| extresso/ | H | 03-May-2022 | - | 2,396 | 1,944 |
| icotool/ | H | 07-Mar-2018 | - | 3,899 | 3,349 |
| lib/ | H | 07-Mar-2018 | - | 30,663 | 21,094 |
| m4/ | H | 07-Mar-2018 | - | 13,348 | 12,599 |
| po/ | H | 03-May-2022 | - | 3,235 | 2,734 |
| wrestool/ | H | 07-Mar-2018 | - | 3,207 | 2,555 |
| ABOUT-NLS | H A D | 11-Mar-2017 | 91.8 KiB | 1,380 | 1,341 |
| AUTHORS | H A D | 31-Oct-2017 | 1 KiB | 47 | 34 |
| COPYING | H A D | 03-May-2012 | 34.2 KiB | 677 | 553 |
| ChangeLog | H A D | 11-Mar-2017 | 4.9 KiB | 160 | 110 |
| INSTALL | H A D | 03-May-2012 | 9.3 KiB | 238 | 179 |
| MANIFEST.sources | H A D | 03-May-2012 | 6.1 KiB | 246 | 245 |
| Makefile.am | H A D | 03-May-2012 | 640 | 26 | 20 |
| Makefile.in | H A D | 03-May-2022 | 52.3 KiB | 1,553 | 1,455 |
| NEWS | H A D | 07-Mar-2018 | 9.2 KiB | 223 | 191 |
| README | H A D | 03-May-2012 | 5.8 KiB | 172 | 121 |
| TODO | H A D | 03-May-2012 | 1.3 KiB | 34 | 29 |
| aclocal.m4 | H A D | 07-Mar-2018 | 47.4 KiB | 1,342 | 1,229 |
| config.h.in | H A D | 07-Mar-2018 | 46.8 KiB | 1,511 | 1,115 |
| configure | H A D | 07-Mar-2018 | 608 KiB | 23,711 | 18,741 |
| configure.ac | H A D | 07-Mar-2018 | 3.5 KiB | 123 | 107 |
| icoutils.spec.in | H A D | 03-May-2012 | 4.1 KiB | 56 | 46 |
README
1icoutils - Introduction
2=======================
3
4The icoutils are a set of program for extracting and converting images in
5Microsoft Windows(R) icon and cursor files. These files usually have the
6extension .ico or .cur, but they can also be embedded in executables and
7libraries (.dll-files).
8
9The icotool program converts icon and cursor files into a set of PNG
10images. (Each icon/cursor file may contain multiple images, usually of
11different sizes and with different number of colors.) Icotool can also
12create icon/cursor files from PNG images.
13
14The wrestool program can extract both icons and cursors from 32-bit ("PE")
15and 16-bit ("NE") executables and libraries. It writes .ico and .cur files
16that can be used on Windows(R) operating systems as well. Other types of
17embedded resourced can be extracted, however only in raw form - icons and
18cursors require additional conversion before they can be saved as icon and
19cursor files.
20
21The extresso script automates the tasks of extracting and converting icons.
22This is done with the help of of special resource scripts. The purpose of
23these scripts are to give names to the icons in the executables and
24libraries.
25
26The icoutils were designed to compile and run on modern POSIX compatible
27systems such as Linux.
28
29Windows is a registered trademark of Microsoft Corporation in the United
30States and other countries.
31
32Copyright and License
33=====================
34
35The icoutils are copyright (C) 1998 Oskar Liljeblad.
36
37This program is free software: you can redistribute it and/or modify
38it under the terms of the GNU General Public License as published by
39the Free Software Foundation, either version 3 of the License, or
40(at your option) any later version.
41
42This program is distributed in the hope that it will be useful,
43but WITHOUT ANY WARRANTY; without even the implied warranty of
44MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
45GNU General Public License for more details.
46
47You should have received a copy of the GNU General Public License
48along with this program. If not, see <http://www.gnu.org/licenses/>.
49
50The source code of this project may contain files from other projects, and
51files generated by other projects, including:
52
53 * GNU Autoconf (http://www.gnu.org/software/autoconf/)
54 * GNU Automake (http://sources.redhat.com/automake/)
55 * GNU gettext (http://www.gnu.org/software/gettext/)
56 * GNU Libtool (http://www.gnu.org/software/libtool/)
57 * Gnulib (http://www.gnu.org/software/gnulib/)
58 * Autoconf Macro Archive (http://ac-archive.sourceforge.net/)
59
60Such files are licensed under the terms of the GNU General Public License
61or a license compatible with the GNU GPL (as listed on
62http://www.gnu.org/licenses/license-list.html). See each file for copyright
63details.
64
65Requirements
66============
67
68The following programs are required to build icoutils:
69
70 * GNU C Compiler (gcc), version 2.95 or later
71
72 The icoutils use some features specific to gcc 2.95 and later (such as
73 macros with variable number of arguments). The GNU C Compiler is part of
74 the GNU Compiler Collection which can be downloaded from
75 http://gcc.gnu.org/. In Debian and many other distributions the package
76 is called gcc.
77
78 * make, a modern implementation
79
80 The make program is required to build icoutils. icoutils uses Makefiles
81 generated by GNU Automake. The recommended make is GNU Make which can be
82 downloaded from http://www.gnu.org/software/make/. In Debian and many
83 other distributions the package is called make.
84
85The following libraries are required to run icoutils:
86
87 * libpng, 1.0.0 or later.
88
89 The icotool program uses libpng to read and write PNG images. Libpng can
90 be downloaded from http://www.libpng.org/pub/png/libpng.html. In Debian,
91 the libpng package is called libpng12-0 (libpng3 in stable). The
92 libpng12-dev (libpng-dev in stable) package is required when building
93 the icoutils.
94
95 Libpng is licensed under the terms of the libpng license. This license
96 is almost identical to the ZLib license, which is compatible with GNU
97 GPL according to http://www.gnu.org/philosophy/license-list.html. Libpng
98 itself depends on ZLib.
99
100The following programs and libraries are required to run the extresso and
101genresscript programs which are optional:
102
103 * Perl, probably 5.6 or later
104
105 Perl can be downloaded from http://www.perl.org/. Perl is licensed under
106 the terms of either the GNU General Public License or the Artistic
107 license (the choice is yours).
108
109 * libwww-perl, probably 5.64 or later
110
111 The extresso perl script uses libwww-perl for fetching files.
112 Libwww-perl can be downloaded from http://lwp.linpro.no/lwp/.
113 Libwww-perl is licensed under the same terms as Perl itself. This also
114 applies to all modules which libwww-perl depends on.
115
116Installation
117============
118
119The icoutils programs use GNU Autoconf and GNU Automake. This means you
120usually just have to do
121
122 ./configure
123 make
124
125to compile the program. If you want to install the necessary files, run the
126following as as root:
127
128 make install
129
130For more information regarding configure and make, see the INSTALL
131document.
132
133Usage
134=====
135
136See the manual pages or the documentation in the doc subdirectory of the
137source code tarball.
138
139Homepage
140========
141
142Web site and file area for microdc is hosted on Savannah:
143
144 http://www.nongnu.org/icoutils/
145
146Feedback
147========
148
149The maintainer of icoutils and this document, Frank Richter, can be reached
150via email:
151
152 frank.richter@gmail.com (mailto:frank.richter@gmail.com)
153
154Please send bug reports, suggestions, ideas or comments in general to me.
155
156Known Bugs
157==========
158
159 * Aside from not compiling on all systems, wrestool MAY not work on
160 non-x86 machines due to endian-ness. However, icotool should work on
161 little as well as big endian machines.
162
163 * There is no relocation support for 16-bit (NE) binaries. If you find a
164 massive deposit of such binaries, let me know.
165
166Possible things to do
167=====================
168
169Please see the TODO document.
170
171-
172