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 >