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