visgrep(1) [debian man page]
VISGREP(1) General Commands Manual VISGREP(1) NAME
visgrep - Visual grep, greps for images in another image SYNOPSIS
visgrep [options] image.png detect.pat match.pat ... DESCRIPTION
visgrep is a program that greps for image in another image. All .pat files are created using png2pat(1) or rgb2pat(1). The image.png is scanned for detect.pat starting from X,Y given in parameters. When detect.pat is found, then all the match.pat files are scanned at an offset of x,y given in parameters. If a match is found, then vis- grep prints the x,y and index of the item. For example, image.png is a screenshot and match1.pat .. match5.pat are images of letters a to e. Each of these letters is enclosed in a blue box, so detect.pat is an image of the upper left corner of the box. This box is not included in the match*.pat files, so they are actually offset 5 pixels down and 4 pixels to the left. You might run it like this then: visgrep -x-4 -y5 image.png match_corner.pat match_a.pat match_b.bat ... Etc, with all matches listed. Now suppose the screen showed ace so visgrep might output: 10,10 0 50,10 2 90,10 4 Showing that match_a.pat (index 0) is at 10,10 on the screen. If no match is found even though the detection image is found, the index will be -1. OPTIONS
A summary of options is included below. -h Show summary of options. -x Set x offset for detection matching. -y Set y offset for detection matching. -X Start scanning at X. -Y Start scanning at Y. -t Set tolerance for 'fuzzy' matches, higher numbers are more tolerant. EXIT STATUS
0 at least one match was made. 1 no matches were made. 2 an error occured. SEE ALSO
pat2ppm(1), patextract(1), png2pat(1), rgb2pat(1), xte(1). AUTHOR
visgrep was written by Steve Slaven <bpk@hoopajoo.net>. This manual page was written by Aurelien Jarno <aurel32@debian.org>, for the Debian project (but may be used by others). April 20, 2004 VISGREP(1)
Check Out this Related Man Page
doc::lua-oocairo-pattern(3) Lua OO Cairo binding doc::lua-oocairo-pattern(3) Name lua-oocairo-pattern - Cairo pattern objects Introduction A pattern object is any one of several things that can be used as the source for a Cairo context, defining what colours and transparencies will be used for drawing. These objects can be created explicitly with the various "pattern_create_*" functions in the module table (see lua-oocairo(3) for details), or implicitly by calling methods like "cr:set_source_rgb()" on a context object (see lua-oocairo-context(3)). Pattern objects can be compared with the "==" operator. This will compare the identity of the objects, so different Lua objects which refer to the same "cairo_pattern_t" will compare as equal. Methods pat:add_color_stop_rgb (offset, r, g, b) Add a new colour stop to a gradient (either linear or radial, it doesn't matter). The offset is a number from zero (the start of the line or the first circle of the gradient) to one (the end of the line or the second circle). The colour values must also be numbers from zero to one. The alpha level is set to fully transparent. This will throw an exception if called on a pattern which isn't a gradient. pat:add_color_stop_rgba (offset, r, g, b, a) Same as "pat:add_color_stop_rgb()" above, but the alpha value can be set to less than one to give some transparency to the gradient. This can be used for gradients which fade away into nothing for example. pat:get_color_stops () Returns the color stops defined on a linear or radial gradient. Throws an exception if called on any other type of pattern. The return value will be a table, an array with one entry per color stop. Each entry will be a table containing five numbers, in the following order: offset, red, green, blue, alpha. pat:get_extend () Return the current method of extending the pattern beyond its limits. The return value will be one of the strings accepted by the "pat:set_extend()" method. pat:get_filter () Return the current filter method, which will be one of the strings accepted by the "pat:set_filter()" method. pat:get_linear_points () Return the start and end points of a linear gradient as four numbers. Throws an exception if called on any other type of pattern. pat:get_matrix () Return the current transformation matrix used for the pattern. See lua-oocairo-matrix(3). pat:get_radial_circles () Return the start and end circles of a radial gradient as six numbers. Throws an exception if called on any other type of pattern. pat:get_rgba () Return the colour value and alpha level for a solid colour pattern. Throws an exception for any other type of pattern. The return values will be four numbers, in the following order: red, green, blue, alpha. pat:get_surface () Return the surface object (see lua-oocairo-surface(3)) used for a surface pattern. Throws an exception for any other kind of pattern. pat:get_type () Returns a string indicating what kind of pattern object this is. The return value will be one of the following: linear radial solid surface pat:set_extend (extendtype) Set the way in which the pattern should be extended beyond its defined limits. The argument must be one of the following strings: none Everything outside the area defined by the pattern is fully transparent. repeat Pattern tiled by endlessly repeating it. reflect Pattern tiled by reflecting it at its edges. pad Whatever is at the edge of the pattern is extended outwards. pat:set_filter (filtertype) Set the filter method used for picking colours from the pattern when it is being used to render something. The argument must be one of the following strings: fast Fast interpolation that is likely to be low quality in some cases (but probably OK for a smooth gradient). good Reasonably good quality interpolation. best The highest quality interpolation available, but likely very slow. nearest Pick colour of nearest pixel. bilinear Interpolate between pixels. gaussian Gaussian blur, but this isn't implemented yet. pat:set_matrix (matrix) Set the transformation matrix used for the pattern, as a table of six numbers. See lua-oocairo-matrix(3). 1.4 2011-05-18 doc::lua-oocairo-pattern(3)