The icoutils notes

icoutils - Introduction

The icoutils are a set of command-line programs for extracting and converting images in Microsoft Windows® icon and cursor files. These files usually have the extension .ico or .cur, but they can also be embedded in executables and libraries (.dll-files).

The icotool program converts icon and cursor files into a set of PNG images. (Each icon/cursor file may contain multiple images, usually of different sizes and with different number of colors.) Icotool can also create icon/cursor files from PNG images.

The wrestool program can extract both icons and cursors from 32-bit (“PE”) and 16-bit (“NE”) executables and libraries. It writes .ico and .cur files that can be used on Windows® operating systems as well. Other types of embedded resourced can be extracted, however only in raw form - icons and cursors require additional conversion before they can be saved as icon and cursor files.

The extresso script automates the tasks of extracting and converting icons. This is done with the help of of special resource scripts. The purpose of these scripts are to give names to the icons in the executables and libraries.

The icoutils were designed to compile and run on modern POSIX compatible systems such as Linux.

Windows is a registered trademark of Microsoft Corporation in the United States and other countries.

icoutils是一组命令行程序，用于在Microsoft Windows（R）图标和光标文件中提取和转换图像。
这些文件通常具有扩展名.CUR，但它们也可以嵌入在可执行文件和库中（.dll-files）。
icotool程序将图标和光标文件转换为一组PNG图像。
（每个图标/光标文件可能包含多个图像，通常是不同大小和不同数量的颜色。）ICotool还可以从PNG图像创建图标/光标文件。
wrestool 程序可以从32位（“PE”）和16位（“NE”）可执行文件和库中提取图标和光标。
它写入.CUR和.CUR文件也可以在Windows（R）操作系统上使用。 可以提取其他类型的嵌入资源，但只能以原始形式 -
图标和游标需要额外的转换，然后才能保存为图标和光标文件。 Extresso脚本自动化提取和转换图标的任务。
这是在特殊资源脚本的帮助下完成的。 这些脚本的目的是为可执行文件和库中的图标提供名称。
ICoutils旨在编译和运行现代POSIX兼容系统，如Linux。 Windows是美国和其他国家/地区的Microsoft
Corporation的注册商标。

icoutils - News

Release history and list of changes for icoutils can be found in the NEWS file in the source code. This file is also available online:

• News for icoutils

icoutils的发布历史和更改列表可以在源代码中的NEWS文件中找到。这个文件也可以在网上找到。

icoutils - Download

The latest version of icoutils is 0.32.3, which was released on 2018-03-07:

• Source code tarball

These files, as well as older versions, are available in the icoutils file area.
Or download it here.

icoutils - Requirements

The following programs are required to build icoutils:

• GNU C Compiler (gcc), version 2.95 or later

The icoutils use some features specific to gcc 2.95 and later (such as macros with variable number of arguments). The GNU C Compiler is part of the GNU Compiler Collection which can be downloaded from http://gcc.gnu.org/. In Debian and many other distributions the package is called gcc.

• make, a modern implementation

The make program is required to build icoutils. icoutils uses Makefiles generated by GNU Automake. The recommended make is GNU Make which can be downloaded from http://www.gnu.org/software/make/. In Debian and many other distributions the package is called make.

The following libraries are required to run icoutils:

• libpng, 1.0.0 or later.

The icotool program uses libpng to read and write PNG images. Libpng can be downloaded from http://www.libpng.org/pub/png/libpng.html. In Debian, the libpng package is called libpng12-0 (libpng3 in stable). The libpng12-dev (libpng-dev in stable) package is required when building the icoutils.

Libpng is licensed under the terms of the libpng license. This license is almost identical to the ZLib license, which is compatible with GNU GPL according to http://www.gnu.org/philosophy/license-list.html. Libpng itself depends on ZLib.

The following programs and libraries are required to run the extresso and genresscript programs which are optional:

• Perl, probably 5.6 or later

Perl can be downloaded from http://www.perl.org/. Perl is licensed under the terms of either the GNU General Public License or the Artistic license (the choice is yours).

• libwww-perl, probably 5.64 or later

The extresso perl script uses libwww-perl for fetching files. Libwww-perl can be downloaded from http://lwp.linpro.no/lwp/. Libwww-perl is licensed under the same terms as Perl itself. This also applies to all modules which libwww-perl depends on.

构建ICoutils需要以下程序：

• GNU C编译器（GCC），版本2.95或更高版本

ICoutils使用特定于GCC 2.95及更高版本的某些功能（例如具有变量参数的宏）。 GNU
C编译器是GNU编译器集合的一部分，可以从http://gcc.gnu.org/。在Debian和许多其他发行版中，包又称为GCC。

• make，一个现代实现

制作程序需要构建icoutils。 icoutils使用gnu automake生成的makefiles。
推荐的制作是GNU制作，可以从http://www.gnu.org/software/make/下载。
在Debian和许多其他发行版中，包裹称为make。

运行ICoutils需要以下库：

• libpng，1.0.0或更高版本。

icotool程序使用libpng来读写png图像。
可以从http://www.libpng.org/pub/png/libpng.html下载libpng。
在Debian中，libpng包裹称为libpng12-0（稳定的libpng3）。
在构建ICoutils时，需要Libpng12-Dev（稳定的稳定）包。

Libpng根据Libpng许可证的条款许可。
此许可证与Zlib许可证几乎相同，根据http://www.gnu.org/philosophy/license-list.html兼容GNU
GPL。 libpng本身取决于zlib。

需要以下程序和库来运行extresso和benresscript程序，这些程序是可选的：

• Perl，可能是5.6或更高版本

Perl可以从http://www.perl.org/下载。 Perl是根据GNU通用公共许可证或艺术许可的条款许可的（选择是你的）。

• libwww-perl，可能是5.64或更高版本

Extresso Perl脚本使用libww-perl来获取文件。
libwww-perl可以从http://lwp.linpro.no/lwp/下载。 libwww-perl以与perl本身相同的方式许可。
这也适用于libwww-perl取决于的所有模块。

icoutils - Installation

The icoutils programs use GNU Autoconf and GNU Automake. This means you usually just have to do

icoutils程序使用GNU Autoconf和GNU Automake。这意味着你通常只需要做

• ./configure
• make

to compile the program. If you want to install the necessary files, run the following as as root:

编译程序。如果您想安装必要的文件，请以root用户的身份运行以下命令

• make install

For more information regarding configure and make, see the INSTALL document.

有关configure和make的更多信息，请参阅INSTALL文档。

icoutils - Homepage

Web site and file area for microdc is hosted on Savannah:

http://www.nongnu.org/icoutils/