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
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
|
.TH img2txt 1 "2007-11-07" "libcaca"
.SH NAME
img2txt \- convert images to various text-based coloured files
.SH SYNOPSIS
.B img2txt
[
.B \-W
.I width
]
[
.B \-H
.I height
]
[
.B \-x
.I font-width
]
[
.B \-y
.I font-height
]
.PD 0
.IP
.PD
[
.B \-b
.I brightness
]
[
.B \-c
.I contrast
]
[
.B \-g
.I gamma
]
.PD 0
.IP
.PD
[
.B \-d
.I dither
]
[
.B \-f
.I format
]
.I FILE
.RI
.SH DESCRIPTION
.B img2txt
converts images to colour ASCII characters and outputs them to text-based
coloured files.
.PP
.B img2txt
can load the most widespread image formats: PNG, JPEG, GIF, PNG, BMP etc (see
.B NOTES
for details).
By default the output text is 60 columns wide, and the line count is
computed accordingly to respect aspect ratio of original file.
The default output format is standard ANSI coloured text.
.SH OPTIONS
.TP
.B \-W, \-\-width=<width>
Change output column count. If not given, the default is set to 60.
.TP
.B \-H, \-\-height=<height>
Change output line count. If not given, the height is computed to match correct aspect ratio.
.TP
.B \-x, \-\-font-width=<width>
Change output font width. If not given, the default is set to 6. This value will be used for computing aspect ratio.
.TP
.B \-y, \-\-font-height=<height>
Change output font height. If not given, the default is set to 10. This value will be used for computing aspect ratio.
.TP
.B \-b, \-\-brightness=<brightness>
Change image brightness. Default to 1.0.
.TP
.B \-c, \-\-contrast=<contrast>
Change image contrast. Default to 1.0.
.TP
.B \-g, \-\-gamma=<gamma>
Change image gamma. Default to 1.0.
.TP
.B \-d, \-\-dither=<dither>
Change dithering algorithm. This can be one of the following (default to fstein) :
none : Nearest color
ordered2 : Ordered 2x2
ordered4 : Ordered 4x4
ordered8 : Ordered 8x8
random : Random
fstein : Floyd Steinberg
.TP
.B \-f, \-\-format=<format>
Change output format. This can be one of the following (default to ansi) :
ansi : coloured ANSI
caca : internal libcaca format
utf8 : UTF8 with CR
utf8cr : UTF8 with CRLF (MS Windows)
html : HTML with CSS and DIV support
html3 : Pure HTML3 with tables
irc : IRC with ctrl-k codes
bbfr : BBCode (French)
ps : Postscript
svg : Scalable Vector Graphics
tga : Targa Image
.TP
.B \-h, \-\-help
Display help message and exit.
.TP
.B \-v, \-\-version
Display version of the program and exit.
.SH EXAMPLES
img2txt hello.jpg > hello.ans
img2txt \-\-width=40 \-\-format=svg hello.jpg > tinyhello.svg
.SH NOTES
Setting both column and line count (using
\-\-width
and
\-\-height) will let you choose the exact output size without taking aspect ratio in account.
You must compile libcaca package with support of
.I Imlib2
to be able to load a wide variety of image formats. Otherwise you will only be able to load regular BMP files.
.SH SEE ALSO
cacaview(1)
.SH AUTHOR
This manual page was written by Sam Hocevar <sam@hocevar.net> and Jean-Yves Lamoureux <jylam@lnxscene.org>.
|
