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>. |
---|