blind-to-text.1 - blind - suckless command-line video editing utility
 (HTM) git clone git://git.suckless.org/blind
 (DIR) Log
 (DIR) Files
 (DIR) Refs
 (DIR) README
 (DIR) 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 < maandree@kth.se >