diff options
| author | William Joye <wjoye@cfa.harvard.edu> | 2017-01-03 21:52:18 (GMT) |
|---|---|---|
| committer | William Joye <wjoye@cfa.harvard.edu> | 2017-01-03 21:52:18 (GMT) |
| commit | 4302a869f0212a3e4878e66a7260b434f6584476 (patch) | |
| tree | e6976e66edf648406e32b092395121e045301692 /tkimg/doc/img-png.man | |
| parent | a780057cc1b51dd3a557549c3cf2431f09136c0d (diff) | |
| parent | 60d692811c12788ed4468d5ff680633304e8f641 (diff) | |
| download | blt-4302a869f0212a3e4878e66a7260b434f6584476.zip blt-4302a869f0212a3e4878e66a7260b434f6584476.tar.gz blt-4302a869f0212a3e4878e66a7260b434f6584476.tar.bz2 | |
Merge commit '60d692811c12788ed4468d5ff680633304e8f641' as 'tkimg'
Diffstat (limited to 'tkimg/doc/img-png.man')
| -rwxr-xr-x | tkimg/doc/img-png.man | 89 |
1 files changed, 89 insertions, 0 deletions
diff --git a/tkimg/doc/img-png.man b/tkimg/doc/img-png.man new file mode 100755 index 0000000..4489885 --- /dev/null +++ b/tkimg/doc/img-png.man @@ -0,0 +1,89 @@ +[comment {-*- tcl -*- doctools}]
+[vset FORMATNAME png]
+[vset FORMATFULLNAME {Portable Network Graphics format}]
+
+[include format-header.inc]
+
+This handler provides new additional configuration options. See
+section [sectref {PNG 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 {PNG OPTIONS}].
+
+[list_end]
+
+
+
+[section {PNG OPTIONS}]
+
+The handler provides the following options:
+
+[list_begin definitions]
+
+[lst_item "[option -verbose] [arg bool]"]
+
+This option is supported for reading only.
+[nl]
+If set to [const true], additional information about the file format
+is printed to stdout. Default is [const false].
+
+[lst_item "[option -gamma] [arg float]"]
+
+This option is supported for reading only.
+[nl]
+Use the specified gamma value when reading an image.
+This option overwrites gamma values specified in the file.
+If this option is not specified and no gamma value is in the file,
+a default value of 1.0 is used.
+
+[lst_item "[option -matte] [arg bool]"]
+
+This option is supported for reading only.
+[nl]
+If set to [const false], a matte (alpha) channel is ignored
+during reading or writing. Default is [const true].
+
+
+[lst_item "[option -alpha] [arg float]"]
+
+This option is supported for reading only.
+[nl]
+An additional alpha filtering for the overall image, which
+allows the background on which the image is displayed to show through.
+This usually also has the effect of desaturating the image.
+The alphaValue must be between 0.0 and 1.0.
+Specifying an alpha value, overrides the setting of the matte flag,
+i.e. reading a file which has no alpha channel (Greyscale, RGB) will
+add an alpha channel to the image independent of the matte flag setting.
+
+[list_end]
+
+The handler provides no true write options at all, but accepts pairs of keys
+and values when writing a PNG file. Each pair will be written as a
+named text chunk where the key provides the name of the chunk and the
+value its contents.
+
+For example
+
+[example {
+ png Author <name> Title <title> Description ...
+}]
+
+
+[section TRANSPARENCY]
+
+If you want to write images to disk which contain transparency
+information (e.g. PNG with alpha channel) you need at least
+
+[package Tk] 8.3.
+
+
+
+[list_begin definitions]
+[include format-footer.inc]
|