.\"                                      Hey, EMACS: -*- nroff -*-
.\"
.\" Copyright (C), 2004 Aurelien Jarno
.\"
.\" You may distribute under the terms of the GNU General Public
.\" License as specified in the file /usr/share/common-licences/GPLv2
.\" that comes with the Debian distribution.
.\"
.\" First parameter, NAME, should be all caps
.\" Second parameter, SECTION, should be 1-8, maybe w/ subsection
.\" other parameters are allowed: see man(7), man(1)
.TH VISGREP 1 "April 20, 2004"
.\" Please adjust this date whenever revising the manpage.
.\"
.\" Some roff macros, for reference:
.\" .nh        disable hyphenation
.\" .hy        enable hyphenation
.\" .ad l      left justify
.\" .ad b      justify to both left and right margins
.\" .nf        disable filling
.\" .fi        enable filling
.\" .br        insert line break
.\" .sp <n>    insert n+1 empty lines
.\" for manpage-specific macros, see man(7)
.SH "نام (NAME)"
visgrep \- ابزار grep بصری، جستجوی تصاویر درون تصویری دیگر
.SH "خلاصه دستور (SYNOPSIS)"
.B visgrep
.I "[گزینه‌ها] image.png detect.png match.png ..."
.SH "توضیحات (DESCRIPTION)"
.B visgrep
برنامه‌ای است که تصویری را درون تصویری دیگر جستجو می‌کند.
.PP
فایل‌های detect.png و match.png همچنین می‌توانند فایل‌های .pat باشند.
.PP
همه فایل‌های .pat با استفاده از
.B png2pat(1)
یا
.B rgb2pat(1)\c
\& ساخته می‌شوند. تصویر image.png برای یافتن detect.pat با شروع از مختصات X,Y ارائه‌شده در پارامترها پویش می‌شود.
هنگامی که detect.pat پیدا شد، تمامی فایل‌های match.pat با آفست
x,y ارائه‌شده در پارامترها پویش می‌شوند. در صورت پیدا شدن تطابق،
.B visgrep
مختصات x,y و ایندکس (شاخص) آن مورد را چاپ می‌کند.
.PP
برای مثال، فرض کنید image.png یک تصویر از صفحه (اسکرین‌شات) است و match1.pat تا match5.pat تصاویری از حروف a تا e هستند. هر یک از این حروف درون یک کادر آبی محصور شده‌اند، بنابراین detect.pat تصویری از گوشه بالا سمت چپ این کادر است. این کادر در فایل‌های match*.pat گنجانده نشده است، بنابراین آن‌ها در واقع ۵ پیکسل به سمت پایین و ۴ پیکسل به سمت چپ آفست دارند. در این حالت می‌توانید دستور را بدین صورت اجرا کنید:
.TP
  visgrep \-x\-4 \-y5 image.png match_corner.pat match_a.pat match_b.bat ...
.PP
و غیره، همراه با فهرست کردن تمام تطابق‌ها. حال فرض کنید صفحه عبارت ace را نمایش می‌دهد؛ در این صورت visgrep ممکن است چنین خروجی دهد:
.sp
.br
  10,10 0
.br
  50,10 2
.br
  90,10 4
.PP
این خروجی نشان می‌دهد که match_a.pat (ایندکس 0) در موقعیت 10,10 صفحه قرار دارد. اگر با وجود پیدا شدن تصویر تشخیص (detection image)، هیچ تطابقی پیدا نشود، ایندکس \-1 خواهد بود.

.SH "گزینه‌ها (OPTIONS)"
خلاصه‌ای از گزینه‌ها در ادامه آمده است.
.TP
.B \-h
نمایش خلاصه‌ای از گزینه‌ها.
.TP
.B \-x
تنظیم آفست x برای تطبیق تشخیص.
.TP
.B \-y
تنظیم آفست y برای تطبیق تشخیص.
.TP
.B \-X
شروع پویش از مختصات X.
.TP
.B \-Y
شروع پویش از مختصات Y.
.TP
.B \-t
تنظیم میزان تحمل خطا برای تطابق‌های مبهم (fuzzy)؛ اعداد بزرگ‌تر انعطاف‌پذیری بیشتری دارند.

.SH "وضعیت خروج (EXIT STATUS)"
.TP
.B 0
حداقل یک تطابق پیدا شد.
.TP
.B 1
هیچ تطابقی پیدا نشد.
.TP
.B 2
خطایی رخ داد.

.SH "همچنین ببینید (SEE ALSO)"
.BR pat2ppm (1),
.BR patextract (1),
.BR png2pat (1),
.BR rgb2pat (1),
.BR xte (1).

.SH "نویسندگان (AUTHORS)"
.B visgrep
توسط Steve Slaven <bpk@hoopajoo.net> نوشته شده است.
.PP
این صفحه راهنما توسط Aurelien Jarno <aurel32@debian.org> برای پروژه دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).