diff options
author | William Joye <wjoye@cfa.harvard.edu> | 2016-10-27 20:28:26 (GMT) |
---|---|---|
committer | William Joye <wjoye@cfa.harvard.edu> | 2016-10-27 20:28:26 (GMT) |
commit | b184baa1234c2143e488d1796ae98afab118b891 (patch) | |
tree | 686b0a47b272296205c7fa2bc789f62a03d20df6 /tkimg/doc/formats.htm | |
parent | f7560d0a451a793441216d76eb4d9475aab61740 (diff) | |
parent | 5aad878400425d3af44433a47c13824385689e1d (diff) | |
download | blt-b184baa1234c2143e488d1796ae98afab118b891.zip blt-b184baa1234c2143e488d1796ae98afab118b891.tar.gz blt-b184baa1234c2143e488d1796ae98afab118b891.tar.bz2 |
Merge commit '5aad878400425d3af44433a47c13824385689e1d' as 'tkimg'
Diffstat (limited to 'tkimg/doc/formats.htm')
-rw-r--r-- | tkimg/doc/formats.htm | 212 |
1 files changed, 212 insertions, 0 deletions
diff --git a/tkimg/doc/formats.htm b/tkimg/doc/formats.htm new file mode 100644 index 0000000..b1f9d9a --- /dev/null +++ b/tkimg/doc/formats.htm @@ -0,0 +1,212 @@ +<?xml version="1.0" encoding="iso-8859-1"?> +<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" + "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd"> +<html xmlns="http://www.w3.org/1999/xhtml"> +<head> + <title>Img Documentation</title> + <meta http-equiv="Content-Type" content="text/html" /> +</head> + +<body> +<h1>Img Manual</h1> + +<table width="100%"> + <tbody> + <tr> + <td><a href="index.htm">Introduction</a></td> + <td><a href="install.htm">Installation</a></td> + <td><a href="formats.htm">Format handlers</a></td> + <td><a href="library.htm">External libraries</a></td> + </tr> + </tbody> +</table> + +<h3>Format handlers</h3> +<dl> + <dt>The pixmap image type can be used as follows:</dt> + <dd>image create pixmap -file </dd> + <dt>or</dt> + <dd>image create pixmap -data ;#(in XPM format)</dd> +</dl> +<dl> + <dt>The photo image type works the same:</dt> + <dd>image create photo -file </dd> + <dt>or</dt> + <dd>image create photo -data ;#(base-64 encoding required with Tk8.2 and lower)</dd> +</dl> + +<p>Valid format specifiers for reading photo's:</p> + +<table width="100%"> + <tbody> + <tr> + <td width="10%"> </td> + <td>"bmp"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"gif -index <n>"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"jpeg -fast -grayscale"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"png"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"tiff"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"xbm"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"xpm"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"postscript -index <n> -zoom <x> <y>"</td> + <td>(-index not yet implemented) <!--<tr><td> <td>"pdf -index <n> -zoom <x> <y>"<td>(-index not yet implemented)--> + </td> + </tr> + <tr> + <td> </td> + <td>"window"</td> + <td>(works only with "-data", not "-file")</td> + </tr> + </tbody> +</table> + +<p>Valid format specifiers for writing photo's:</p> + +<table width="100%"> + <tbody> + <tr> + <td width="10%"> </td> + <td>"bmp"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"gif -interlaced <bool>"</td> + <td>(-interlaced not yet implemented)</td> + </tr> + <tr> + <td> </td> + <td>"jpeg -quality <n> -smooth <n> -grayscale -optimize + -progressive"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"png Author <name> Title <title> Description ....."<br /> + Each pair of arguments will add a named text chunk to the file.</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"tiff -compression <compression> -byteorder <byteorder>"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"xbm"</td> + <td></td> + </tr> + <tr> + <td> </td> + <td>"xpm"</td> + <td></td> + </tr> + </tbody> +</table> + +<p>The format options have the following meaning:</p> + +<table width="100%"> + <tbody> + <tr> + <td width="10%"> </td> + <td>-background C:</td> + <td>use color C as background color for transparent parts of the + image.</td> + </tr> + <tr> + <td> </td> + <td>-byteorder:</td> + <td>Byteorder for TIFF file. Should be one of bigendian, littleendian, + network, smallendian or {}. Default: {}</td> + </tr> + <tr> + <td> </td> + <td>-compression:</td> + <td>Compression for TIFF file. Should be one of none, jpeg, packbits or + deflate. Default: none.</td> + </tr> + <tr> + <td> </td> + <td>-fast:</td> + <td>Fast, low-quality processing.</td> + </tr> + <tr> + <td> </td> + <td>-grayscale:</td> + <td>Force incoming image to grayscale/ Create monochrome file.</td> + </tr> + <tr> + <td> </td> + <td>-index N:</td> + <td>Select one of the sub-images (GIF and postscript only, not yet + implemented for postscript). Default value: 0</td> + </tr> + <tr> + <td> </td> + <td>-interlaced N:</td> + <td>N=1: interlaced. N=0: non-interlaced (not yet implemented).</td> + </tr> + <tr> + <td> </td> + <td>-optimize:</td> + <td>Optimize Huffman table.</td> + </tr> + <tr> + <td> </td> + <td>-progressive:</td> + <td>Create progressive file (JPEG only).</td> + </tr> + <tr> + <td> </td> + <td>-quality N:</td> + <td>Compression quality (0..100; 5-95 is useful range). Default value: + 75</td> + </tr> + <tr> + <td> </td> + <td>-smooth N:</td> + <td>Perform smoothing (10-30 is enough for most GIF's). Default value: + 0</td> + </tr> + <tr> + <td> </td> + <td>-zoom X Y:</td> + <td>Multiply image size by given scale factors. If Y is missing, the + default is the same as X. X and Y are allowed to be in floating point + format, but they are rounded to the nearest practically possible + value. For postscript this means the zoom factors should be multiples + of 1/72.</td> + </tr> + </tbody> +</table> +</body> +</html> |