.TH VIPSTHUMBNAIL 1 "13 May 2010"
.SH "نام (NAME)"
vipsthumbnail \- ساخت تصاویر بندانگشتی از فایل‌های تصویر
.SH "خلاصه دستور (SYNOPSIS)"
.B vipsthumbnail
[\fIگزینه‌ها\fR] \fIimagefile1\fR \fIimagefile2\fR ...
.SH "توضیحات (DESCRIPTION)"
دستور
.B vipsthumbnail(1)
هر
.B imagefile
(فایل تصویر) را به نوبت پردازش کرده و هر تصویر را کوچک می‌کند تا در یک مربع ۱۲۸ در ۱۲۸ پیکسل جای گیرد.
تصویر کوچک‌شده در یک فایل جدید به نام
.B tn_imagefile.jpg
نوشته می‌شود.
این برنامه معمولاً سریع‌تر است و نسبت به سایر برنامه‌های ایجاد بندانگشتی تصویر از حافظه کمتری استفاده می‌کند.
.PP
برای نمونه:
.PP
.nf
 $ vipsthumbnail fred.png jim.tif
.fi
.PP
فایل‌های تصویر
.B fred.png
و
.B jim.tif
را خوانده و تصاویر بندانگشتی را در فایل‌های
.B tn_fred.jpg
و
.B tn_jim.jpg
می‌نویسد.
.PP
.nf
 $ vipsthumbnail --size=64 -o thumbnails/%s.png fred.jpg
.fi
.PP
فایل تصویر
.B fred.jpg
را خوانده و یک بندانگشتی ۶۴ در ۶۴ پیکسل را در فایل
.B thumbnails/fred.png
می‌نویسد.
.SH "گزینه‌ها (OPTIONS)"
.TP
.B \-s N, \-\-size=N
تنظیم اندازه بندانگشتی خروجی بر روی
.B N
در
.B N
پیکسل.
.PP
می‌توانید از «MxN» برای تعیین یک کادر مرزی مستطیلی استفاده کنید.
تصویر به گونه‌ای کوچک می‌شود که دقیقاً در این ناحیه جای بگیرد؛ تصاویری که از این مقدار کوچک‌تر باشند بزرگ می‌شوند.
.PP
از «xN» یا «Mx» برای تغییر اندازه فقط روی یک محور استفاده کنید.
.PP
علامت «<» را اضافه کنید تا تغییر اندازه تنها در صورتی انجام شود که تصویر ورودی از اندازه هدف کوچک‌تر باشد، و علامت «>» را اضافه کنید تا تغییر اندازه تنها در صورتی انجام شود که تصویر ورودی بزرگ‌تر از اندازه هدف باشد.
.TP
.B \-\-path=FORMAT
قالب مسیر خروجی را تنظیم می‌کند. سه جایگزینی انجام می‌شود:
.B %s
با نام پایه (basename) ورودی با حذف هرگونه پسوند جایگزین می‌شود،
.B %d
با نام دایرکتوری (dirname) ورودی جایگزین می‌شود، و
.B %c
با دایرکتوری کاری جاری جایگزین می‌شود.
.PP
مقدار پیش‌فرض
.B %d/tn_%s.jpg
است که به معنی خروجی JPEG در همان دایرکتوری فایل ورودی با پیشوند
.B tn_
می‌باشد. همچنین می‌توانید گزینه‌های قالب را نیز اضافه کنید؛ برای نمونه
.B %c/%s/tn_%s.jpg[Q=20]
تصاویر JPEG را در یک ساختار درختی در دایرکتوری جاری با مقدار Q تنظیم‌شده روی ۲۰ می‌نویسد.
.TP
.B \-e PROFILE, \-\-eprofile=PROFILE
استخراج تصاویر بندانگشتی با این نمایه ICC. تبدیل رنگ تصاویر تنها در صورتی انجام می‌شود که هر دو نمایه ورودی و خروجی در دسترس باشند. نمایه ورودی می‌تواند درون فایل تصویر ورودی جاسازی شده باشد یا با گزینه
.B \-\-iprofile
ارائه شود.
.TP
.B \-i PROFILE, \-\-iprofile=PROFILE
وارد کردن تصاویر با این نمایه ICC، در صورتی که هیچ نمایه‌ای در تصویر جاسازی نشده باشد. تبدیل رنگ تصاویر تنها در صورتی انجام می‌شود که هر دو نمایه ورودی و خروجی در دسترس باشند. نمایه خروجی باید با گزینه
.B \-\-oprofile
ارائه شود.
.TP
.B \-c, \-\-crop
برش دادن (کراپ) تصویر خروجی. تصویر به اندازه‌ای کوچک می‌شود که کادر مرزی را در هر دو محور کاملاً پر کند، سپس بخش‌های اضافی برش داده و حذف می‌شوند.
.TP
.B \-d, \-\-delete
حذف نمایه خروجی از تصویر. این کار می‌تواند مقدار کمی در فضا صرفه‌جویی کند.
.TP
.B \-t, \-\-rotate
چرخش خودکار تصاویر با استفاده از برچسب‌های جهت‌گیری EXIF.
.TP
.B \-a, \-\-linear
کوچک کردن تصاویر در فضای رنگی نور خطی. این کار می‌تواند بسیار کندتر باشد.
.SH "مقدار بازگشتی (RETURN VALUE)"
در صورت موفقیت مقدار 0 و در صورت بروز خطا مقداری غیر صفر را برمی‌گرداند. خطا می‌تواند به این معنی باشد که یک یا چند تبدیل با شکست مواجه شده است.
.SH "همچنین ببینید (SEE ALSO)"
.BR vipsheader (1)