blind-find-rectangle.1 - blind - suckless command-line video editing utility | |
git clone git://git.suckless.org/blind | |
Log | |
Files | |
Refs | |
README | |
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… | |
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 < [email protected] > |