summaryrefslogtreecommitdiffstats
path: root/tkimg/doc/img-ico.man
blob: aced403422925ff46c9c0a51f8c72caf4a8d5d6e (plain)
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
[comment {-*- tcl -*- doctools}]
[vset FORMATNAME ico]
[vset FORMATFULLNAME {Windows Icon Format}]

[include format-header.inc]

This handler provides new additional configuration options. See
section [sectref {ICO OPTIONS}] for more detailed explanations.


[include format-middle.inc]

In addition the value for the option is treated as list and may
contain any of the special options listed in section

[sectref {ICO OPTIONS}].

[list_end]


[section {SUPPORTED ICO TYPES}]

[example_begin]
  1-bit pixels: Black and White.
  4-bit pixels: Grayscale or indexed.
  8-bit pixels: True-color (RGB, each channel 8 bit).

 List of currently supported features:

 Type   |     Read      |     Write     |
        | -file | -data | -file | -data |
 ----------------------------------------
  1-bit | Yes   | Yes   | No    | No    |
  4-bit | Yes   | Yes   | No    | No    |
  8-bit | Yes   | Yes   | Yes   | Yes   |
[example_end]


[section {ICO OPTIONS}]

The handler provides the following options:

[list_begin definitions]

[lst_item "[option -verbose] [arg bool]"]

This option is supported for reading and writing.
[nl]
If set to [const true], additional information about the loaded/stored image
is printed to stdout. Default is [const false].

[lst_item "[option -index] [arg n]"]

This option is supported for reading only.
[nl]
Read the [arg n]'th image. The first image is at index [const 0].
Default is [const 0].

[list_end]


[list_begin definitions]
[include format-footer.inc]