blind

suckless command-line video editing utility
git clone git://git.suckless.org/blind
Log | Files | Refs | README | LICENSE

blind-affine-colour.1 (1663B)


      1 .TH BLIND-AFFINE-COLOUR 1 blind
      2 .SH NAME
      3 blind-affine-colour - Apply an affine transformation to the colours in a video
      4 .SH SYNOPSIS
      5 .B blind-affine-colour
      6 [-alp]
      7 .I matrix-stream
      8 .SH DESCRIPTION
      9 .B blind-affine-colour
     10 reads a video from stdin and a matrix video from
     11 .I matrix-stream
     12 and multiplies colours from stdin with matrices from
     13 .I matrix-stream
     14 and prints the resulting video to stdout.
     15 .P
     16 Each frame in
     17 .I matrix-stream
     18 is a matrix and shall have the width and height 5.
     19 Each pixel in a frame is a cell in the matrix,
     20 the pixels luma is multiples by its alpha value
     21 to determine the value of the matrix cell.
     22 .SH OPTIONS
     23 .TP
     24 .B -a
     25 The width and height of the matrix shall be 4
     26 instead of 5 (reduced by 1) and the alpha values
     27 of the pixels shall not be modified.
     28 .TP
     29 .B -l
     30 The width and height of the matrix shall be 4
     31 instead of 5 (reduced by 1) making the transformation
     32 linear instead of affine.
     33 .TP
     34 .B -p
     35 Each frame in
     36 .I matrix-stream
     37 shall contain one matrix per pixel in a frame in
     38 stdin. The video in
     39 .I matrix-stream
     40 shall be 5, 4, or 3, depending on whether
     41 .B -a
     42 and
     43 .B -l
     44 are specified, times are wide and tall as the
     45 video in stdin.
     46 .SH NOTES
     47 If both
     48 .B -a
     49 and
     50 .B -l
     51 are specified, the matrices shall have the
     52 width and height 3 instead of 5.
     53 .SH REQUIREMENTS
     54 .B blind-affine-colour
     55 requires enough free memory to load 5, 4, or 3,
     56 depending on whether
     57 .B -a
     58 and
     59 .B -l
     60 are specified, full rows from
     61 .I matrix-stream
     62 into memory. A frame requires 32 bytes per pixel
     63 it contains.
     64 .SH SEE ALSO
     65 .BR blind (7),
     66 .BR blind-arithm (1),
     67 .BR blind-invert-matrix (1),
     68 .BR blind-multiply-matrice (1)
     69 .SH AUTHORS
     70 Mattias Andrée
     71 .RI < maandree@kth.se >