| 1 | .TH img2txt 1 "2007-11-07" "libcaca" |
|---|
| 2 | .SH NAME |
|---|
| 3 | img2txt \- convert images to various text-based coloured files |
|---|
| 4 | .SH SYNOPSIS |
|---|
| 5 | .B img2txt |
|---|
| 6 | [ |
|---|
| 7 | .B \-W |
|---|
| 8 | .I width |
|---|
| 9 | ] |
|---|
| 10 | [ |
|---|
| 11 | .B \-H |
|---|
| 12 | .I height |
|---|
| 13 | ] |
|---|
| 14 | .PD 0 |
|---|
| 15 | .IP |
|---|
| 16 | .PD |
|---|
| 17 | [ |
|---|
| 18 | .B \-b |
|---|
| 19 | .I brightness |
|---|
| 20 | ] |
|---|
| 21 | [ |
|---|
| 22 | .B \-c |
|---|
| 23 | .I contrast |
|---|
| 24 | ] |
|---|
| 25 | [ |
|---|
| 26 | .B \-g |
|---|
| 27 | .I gamma |
|---|
| 28 | ] |
|---|
| 29 | .PD 0 |
|---|
| 30 | .IP |
|---|
| 31 | .PD |
|---|
| 32 | [ |
|---|
| 33 | .B \-d |
|---|
| 34 | .I dither |
|---|
| 35 | ] |
|---|
| 36 | [ |
|---|
| 37 | .B \-f |
|---|
| 38 | .I format |
|---|
| 39 | ] |
|---|
| 40 | .I FILE |
|---|
| 41 | .RI |
|---|
| 42 | .SH DESCRIPTION |
|---|
| 43 | .B img2txt |
|---|
| 44 | converts images to colour ASCII characters and outputs them to text-based |
|---|
| 45 | coloured files. |
|---|
| 46 | .PP |
|---|
| 47 | .B img2txt |
|---|
| 48 | can load the most widespread image formats: PNG, JPEG, GIF, PNG, BMP etc (see |
|---|
| 49 | .B NOTES |
|---|
| 50 | for details). |
|---|
| 51 | By default the output text is 60 columns wide, and the line count is |
|---|
| 52 | computed accordingly to respect aspect ratio of original file. |
|---|
| 53 | The default output format is standard ANSI coloured text. |
|---|
| 54 | |
|---|
| 55 | .SH OPTIONS |
|---|
| 56 | .TP |
|---|
| 57 | .B \-W, \-\-width=<width> |
|---|
| 58 | Change output column count. If not given, the default is set to 60. |
|---|
| 59 | .TP |
|---|
| 60 | .B \-H, \-\-height=<height> |
|---|
| 61 | Change output line count. If not given, the height is computed to match correct aspect ratio. |
|---|
| 62 | .TP |
|---|
| 63 | .B \-b, \-\-brightness=<brightness> |
|---|
| 64 | Change image brightness. Default to 1.0. |
|---|
| 65 | .TP |
|---|
| 66 | .B \-c, \-\-contrast=<contrast> |
|---|
| 67 | Change image contrast. Default to 1.0. |
|---|
| 68 | .TP |
|---|
| 69 | .B \-g, \-\-gamma=<gamma> |
|---|
| 70 | Change image gamma. Default to 1.0. |
|---|
| 71 | .TP |
|---|
| 72 | .B \-d, \-\-dither=<dither> |
|---|
| 73 | Change dithering algorithm. This can be one of the following (default to fstein) : |
|---|
| 74 | none : Nearest color |
|---|
| 75 | ordered2 : Ordered 2x2 |
|---|
| 76 | ordered4 : Ordered 4x4 |
|---|
| 77 | ordered8 : Ordered 8x8 |
|---|
| 78 | random : Random |
|---|
| 79 | fstein : Floyd Steinberg |
|---|
| 80 | .TP |
|---|
| 81 | .B \-f, \-\-format=<format> |
|---|
| 82 | Change output format. This can be one of the following (default to ansi) : |
|---|
| 83 | ansi : coloured ANSI |
|---|
| 84 | caca : internal libcaca format |
|---|
| 85 | utf8 : UTF8 with CR |
|---|
| 86 | utf8 : UTF8 with CRLF (MS Windows) |
|---|
| 87 | html : HTML with CSS and DIV support |
|---|
| 88 | html3 : Pure HTML3 with tables |
|---|
| 89 | irc : IRC with ctrl-k codes |
|---|
| 90 | ps : Postscript |
|---|
| 91 | svg : Scalable Vector Graphics |
|---|
| 92 | tga : Targa Image |
|---|
| 93 | |
|---|
| 94 | .SH EXAMPLES |
|---|
| 95 | img2txt hello.jpg > hello.ans |
|---|
| 96 | |
|---|
| 97 | img2txt \-\-width=40 \-\-format=svg hello.jpg > tinyhello.svg |
|---|
| 98 | |
|---|
| 99 | .SH NOTES |
|---|
| 100 | Setting both column and line count (using |
|---|
| 101 | \-\-width |
|---|
| 102 | and |
|---|
| 103 | \-\-height) will let you choose the exact output size without taking aspect ratio in account. |
|---|
| 104 | |
|---|
| 105 | You must compile libcaca package with support of |
|---|
| 106 | .I Imlib2 |
|---|
| 107 | to be able to load a wide variety of image formats. Otherwise you will only be able to load regular BMP files. |
|---|
| 108 | |
|---|
| 109 | .SH SEE ALSO |
|---|
| 110 | cacaview(1) |
|---|
| 111 | .SH AUTHOR |
|---|
| 112 | This manual page was written by Sam Hocevar <sam@zoy.org> and Jean-Yves Lamoureux <jylam@lnxscene.org>. |
|---|
