نام (NAME)

visgrep - ابزار grep بصری، جستجوی تصاویر درون تصویری دیگر

خلاصه دستور (SYNOPSIS)

visgrep [گزینه‌ها] image.png detect.png match.png ...

توضیحات (DESCRIPTION)

visgrep برنامه‌ای است که تصویری را درون تصویری دیگر جستجو می‌کند.

فایل‌های detect.png و match.png همچنین می‌توانند فایل‌های .pat باشند.

همه فایل‌های .pat با استفاده از png2pat(1) یا rgb2pat(1) ساخته می‌شوند. تصویر image.png برای یافتن detect.pat با شروع از مختصات X,Y ارائه‌شده در پارامترها پویش می‌شود. هنگامی که detect.pat پیدا شد، تمامی فایل‌های match.pat با آفست x,y ارائه‌شده در پارامترها پویش می‌شوند. در صورت پیدا شدن تطابق، visgrep مختصات x,y و ایندکس (شاخص) آن مورد را چاپ می‌کند.

برای مثال، فرض کنید image.png یک تصویر از صفحه (اسکرین‌شات) است و match1.pat تا match5.pat تصاویری از حروف a تا e هستند. هر یک از این حروف درون یک کادر آبی محصور شده‌اند، بنابراین detect.pat تصویری از گوشه بالا سمت چپ این کادر است. این کادر در فایل‌های match*.pat گنجانده نشده است، بنابراین آن‌ها در واقع ۵ پیکسل به سمت پایین و ۴ پیکسل به سمت چپ آفست دارند. در این حالت می‌توانید دستور را بدین صورت اجرا کنید:

visgrep -x-4 -y5 image.png match_corner.pat match_a.pat match_b.bat ...

و غیره، همراه با فهرست کردن تمام تطابق‌ها. حال فرض کنید صفحه عبارت ace را نمایش می‌دهد؛ در این صورت visgrep ممکن است چنین خروجی دهد:

10,10 0
50,10 2
90,10 4

این خروجی نشان می‌دهد که match_a.pat (ایندکس 0) در موقعیت 10,10 صفحه قرار دارد. اگر با وجود پیدا شدن تصویر تشخیص (detection image)، هیچ تطابقی پیدا نشود، ایندکس -1 خواهد بود.

گزینه‌ها (OPTIONS)

خلاصه‌ای از گزینه‌ها در ادامه آمده است.

-h

نمایش خلاصه‌ای از گزینه‌ها.

-x

تنظیم آفست x برای تطبیق تشخیص.

-y

تنظیم آفست y برای تطبیق تشخیص.

-X

شروع پویش از مختصات X.

-Y

شروع پویش از مختصات Y.

-t

تنظیم میزان تحمل خطا برای تطابق‌های مبهم (fuzzy)؛ اعداد بزرگ‌تر انعطاف‌پذیری بیشتری دارند.

وضعیت خروج (EXIT STATUS)

0

حداقل یک تطابق پیدا شد.

1

هیچ تطابقی پیدا نشد.

2

خطایی رخ داد.

همچنین ببینید (SEE ALSO)

pat2ppm(1), patextract(1), png2pat(1), rgb2pat(1), xte(1).

نویسندگان (AUTHORS)

visgrep توسط Steve Slaven <bpk@hoopajoo.net> نوشته شده است.

این صفحه راهنما توسط Aurelien Jarno <aurel32@debian.org> برای پروژه دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).