blind-find-rectangle.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-find-rectangle.1 (1668B)
       ---
            1 .TH BLIND-FIND-RECTANGLE 1 blind
            2 .SH NAME
            3 blind-find-rectangle - Locate a coloured rectangle
            4 .SH SYNOPSIS
            5 .B blind-find-rectangle
            6 [-a
            7 .IR min-area ]
            8 [-h
            9 .IR min-height ]
           10 [-w
           11 .IR min-width ]
           12 .I X
           13 .I Y
           14 .I Z
           15 .RI [ alpha ]
           16 .SH DESCRIPTION
           17 .B blind-find-rectangle
           18 reads a video from stdin, and locates the largest
           19 rectangle of a specified colour. If there are two
           20 or more maximal rectangles, one is choosen arbitrarily.
           21 The specified by the arguments
           22 .IR X ,
           23 .IR Y ,
           24 and
           25 .IR Z ,
           26 and the selected
           27 .I alpha
           28 value. The colour is specified in CIE XYZ. If
           29 .I X
           30 and
           31 .I Z
           32 are not specified, the colour will be CIE Standard Illuminant
           33 D65-grey with the luminosity
           34 .IR Y .
           35 If
           36 .I alpha
           37 is not specified, 1, which means fully opaque, will be used.
           38 .SH STDOUT
           39 The location and dimensions of the rectangle is printed stdout.
           40 Exactly one line is printed per frame. Each line has the format
           41 .nf
           42 
           43         \fB"%zu %zu %zu %zu\\n"\fP, <\fIleft\fP>, <\fItop\fP>, <\fIwidth\fP>, <\fIheight\fP>
           44 
           45 .fi
           46 where
           47 .I left
           48 is position on the X-axis (measured from the left) on the
           49 left-most pixels in the rectangle,
           50 .I top
           51 is position on the Y-axis (measured from the top) on the
           52 top-most pixels in the rectangle,
           53 .I width
           54 is the width of the rectangle, and
           55 .I height
           56 is the width of the rectangle.
           57 .SH NOTES
           58 .B blind-find-rectangle
           59 may be changed in the future to use some other colour model,
           60 therefore, it is recommended to also use
           61 .BR blind-colour-ciexyz (1)
           62 if you are specifying the colour in CIE XYZ. If however
           63 your values are colour space-agnostic, you should not. 
           64 .SH SEE ALSO
           65 .BR blind (7),
           66 .BR blind-colour-ciexyz (1),
           67 .BR blind-colour-srgb (1)
           68 .SH AUTHORS
           69 Mattias Andrée
           70 .RI < maandree@kth.se >