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 < maandree@kth.se >