blind-to-text.1 - blind - suckless command-line video editing utility | |
git clone git://git.suckless.org/blind | |
Log | |
Files | |
Refs | |
README | |
LICENSE | |
--- | |
blind-to-text.1 (2058B) | |
--- | |
1 .TH BLIND-TO-TEXT 1 blind | |
2 .SH NAME | |
3 blind-to-text - Convert a video to text | |
4 .SH SYNOPSIS | |
5 .B blind-to-text | |
6 [-% | |
7 .IR format ] | |
8 .SH DESCRIPTION | |
9 .B blind-to-text | |
10 reads a video from stdin and prints it | |
11 in text format to stdout. The first line | |
12 in the output is the head. It will contain: | |
13 the number of frames, <space>, the width, | |
14 <space>, the height, <space>, and the pixel | |
15 format. The result of the lines will be | |
16 one line per pixel, each of these line will | |
17 contain the values of the pixel's colur in | |
18 textual representation of a floating-point | |
19 value, each separated by a <space>. The | |
20 order of the values are: X, Y, Z, and alpha, | |
21 where X, Y, and Z are the parameters of the | |
22 colour's CIE XYZ representation. | |
23 .P | |
24 If the width of the video is | |
25 .I w | |
26 and the height of the video is | |
27 .IR h , | |
28 the first | |
29 .I w | |
30 lines after the head are the pixels in the | |
31 first row in the first frame of the video, | |
32 the following | |
33 .I w | |
34 lines are the pixels in the second row, | |
35 and so on until the the | |
36 .IR w*h :th | |
37 line, after the head, where the second | |
38 frame begins. The pixels are printed | |
39 from left to right, from top to bottom, | |
40 and from first frame to last frame. | |
41 .SH OPTIONS | |
42 .TP | |
43 .BR -% \ \fIformat\fP | |
44 Selects in what format parameters are printed. | |
45 .I format | |
46 may include the prefix | |
47 .B + | |
48 that specified that non-negative values should be prefixed with a | |
49 .BR + . | |
50 After any prefix, there may be a positive number specifying | |
51 the percision of the output, optionally followed by either of | |
52 the letters | |
53 .BR a , | |
54 .BR e , | |
55 .BR f , | |
56 other | |
57 .B g | |
58 (other their synonymous uppercases), | |
59 or if the input is integer typed, | |
60 .B d | |
61 or | |
62 .BR i , | |
63 at most once, with the same semantics as in | |
64 .BR printf (3). | |
65 .B f | |
66 is used if this letter is omitted. | |
67 The percision must be omitted the input is integer typed. | |
68 | |
69 If ommited, | |
70 .B 25f | |
71 or | |
72 .B i | |
73 is used. These defaults are selected for ease of | |
74 interoperability with other software, however, | |
75 .B a | |
76 is recommeded to improve performance and remove | |
77 truncation error. | |
78 .SH SEE ALSO | |
79 .BR blind (7), | |
80 .BR blind-from-text (1), | |
81 .BR blind-to-portable (1) | |
82 .SH AUTHORS | |
83 Mattias Andrée | |
84 .RI < [email protected] > |