Skip site navigation (1)Skip section navigation (2)

  
 
  

home | help
VISGREP(1)		     General Commands Manual		      VISGREP(1)

NAME
     visgrep - Visual grep, greps for images in another image

SYNOPSIS
     visgrep [options] image.png detect.png match.png ...

DESCRIPTION
     visgrep is a program that greps for image in another image.

     The detect.png and match.png files can also be .pat files.

     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 de-
     tect.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 visgrep prints	the  x,y
     and index of the item.

     For example, image.png is a screenshot and match1.pat .. match5.pat are im-
     ages 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)

Want to link to this manual page? Use this URL:
<https://man.freebsd.org/cgi/man.cgi?query=visgrep&sektion=1&manpath=FreeBSD+Ports+15.1.quarterly>

home | help