1Winicontoppm User Manual(0)                        Winicontoppm User Manual(0)
2
3
4

NAME

6       winicontoppm - convert a Windows .ico image into 1 or more PPM images
7
8

SYNOPSIS

10       winicontoppm  [-writeands] [-allicons|-bestqual] [-multippm] [-verbose]
11       [iconfile] [ppmdestfile]
12
13

DESCRIPTION

15       This program is part of Netpbm(1).
16
17       This program is essentially obsolete; The newer winicontopam is better.
18
19       winicontoppm reads a Microsoft Windows .ico file and converts it to one
20       or more PPMs.
21
22       A  Windows  icon  contains one or more images, at different resolutions
23       and color depths.   Each  image  has  an  'and'  mask,  which  contains
24       transparancy data.
25
26       By  default,  the  output  goes  to  Standard  Output.   If you specify
27       ppmdestfile, output goes into one or more files named as  follows.   If
28       it's  just  one  file  (i.e.  you specify the -multippm option or don't
29       specify -allicons), the file name is ppmdestfile.ppm.  If it's multiple
30       files, their file names are ppmdestfile_1.ppm, ppmdestfile_2.ppm, etc.
31
32        When you specify the -writeands option, the file names above are modi‐
33       fied to include the string xor as in  ppmdestfile_xor.ppm  or  ppmdest‐
34       file_xor_1.ppm.
35
36       winicontoppm  can  convert .ico images with 1, 4, 8, 24, or 32 bits per
37       pixel.  Before Netpbm 10.15 (April 2003), it could not  handle  24  and
38       32.
39
40

OPTIONS

42       In  addition  to  the options common to all programs based on libnetpbm
43       (most notably -quiet, see
44        Common Options ⟨index.html#commonoptions⟩ ),  winicontoppm  recognizes
45       the following command line options:
46
47
48
49       -writeands
50              For  each icon written, also write the 'and' (transparancy) mask
51              as a separate PBM file.  It's  name  is  of  the  form  ppmdest‐
52              file_and.pbm or ppmdestfile_and_1.pbm.
53
54
55       -allicons
56              Extract all images from the .ico file.
57
58              If you specify neither this nor -bestqual, winicontoppm extracts
59              the first image.
60
61
62       -bestqual
63              Extract only the best quality (largest, then highest bpp)  image
64              from the .ico file.
65
66              If you specify neither this nor -allicons, winicontoppm extracts
67              the first image.
68
69
70       -multippm
71              Write all PPMs to a single file.
72
73
74
75

SEE ALSO

77       winicontopam(1), pamtowinicon(1), bmptopnm(1), ppm(1)
78
79

AUTHOR

81       Copyright (C) 2000, 2003 by Lee Benfield.
82

DOCUMENT SOURCE

84       This manual page was generated by the Netpbm tool 'makeman'  from  HTML
85       source.  The master documentation is at
86
87              http://netpbm.sourceforge.net/doc/winicontoppm.html
88
89netpbm documentation             23 March 2003     Winicontoppm User Manual(0)