GopherProxy

	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] >