'\" t
.\"     Title: giftool
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 3 June 2012
.\"    Manual: GIFLIB Documentation
.\"    Source: GIFLIB
.\"  Language: English
.\"
.TH "GIFTOOL" "1" "3 June 2012" "GIFLIB" "GIFLIB Documentation"
.\" -----------------------------------------------------------------
.\" * Define some portability stuff
.\" -----------------------------------------------------------------
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.\" http://bugs.debian.org/507673
.\" http://lists.gnu.org/archive/html/groff/2009-02/msg00013.html
.\" ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.\" -----------------------------------------------------------------
.\" * set default formatting
.\" -----------------------------------------------------------------
.\" disable hyphenation
.nh
.\" disable justification (adjust text to left margin only)
.ad l
.\" -----------------------------------------------------------------
.\" * MAIN CONTENT STARTS HERE *
.\" -----------------------------------------------------------------
.SH "نام (NAME)"
giftool \- ابزار تبدیل و دستکاری GIF
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBgiftool\fR\ 'u
\fBgiftool\fR [\-a\ \fIaspect\fR] [\-b\ \fIbgcolor\fR] [\-d\ \fIdelaytime\fR] [\-i\ \fIinterlacing\fR] [\-n\ \fIimagelist\fR] [\-p\ \fIleft,top\fR] [\-s\ \fIwidth,height\fR] [\-t\ \fItranscolor\fR] [\-u\ \fIsort\-flag\fR] [\-x\ \fIdisposal\fR] [\-z\ \fIsort\-flag\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
فیلتری برای دگرگون‌سازی و تبدیل فایل‌های GIF\&. بدون هیچ گزینه‌ای، این ابزار صرفاً یک رونوشت پرهزینه از تصویر GIF در ورودی استاندارد به خروجی استاندارد تهیه می‌کند\&. گزینه‌ها عملیات پالایش (فیلتر کردن) را مشخص می‌کنند و به همان ترتیبی که در خط فرمان تعیین شده‌اند، اعمال می‌شوند\&.
.PP
گزینهٔ \-n تصاویر را انتخاب می‌کند و به این ابزار امکان می‌دهد روی زیرمجموعه‌ای از تصاویر درون یک GIF چندتصویری عمل کند\&. این گزینه فهرستی از اعداد صحیح ده‌دهی جداشده با کاما را دریافت می‌کند که به عنوان اندیس‌های تصویر با مبنای ۱ (1\-origin) تفسیر می‌شوند؛ این‌ها تصاویری هستند که تغییرات روی آن‌ها اعمال خواهد شد\&. در صورتی که گزینهٔ \-n مشخص نشود، این ابزار همهٔ تصاویر را انتخاب و دگرگون می‌کند\&.
.PP
گزینهٔ \-b یک آرگومان عدد صحیح ده‌دهی می‌گیرد و از آن برای تنظیم اندیس رنگ پس‌زمینهٔ صفحه نمایش (با مبنای ۰) استفاده می‌کند\&.
.PP
گزینهٔ \-f یک رشتهٔ قالب‌بندی به سبک printf می‌پذیرد و مقادیر فیلدهای توصیف‌گر تصویر (image\-descriptor) و کنترل گرافیکی (graphics\-control) را در آن جایگزین می‌کند\&. رشته برای هر تصویر انتخاب‌شده قالب‌بندی شده و یک بار در خروجی چاپ می‌شود\&. نویسه‌های گریز معمول به سبک C شامل \eb، \ef، \en، \er، \et، \ev و \exNN تفسیر می‌شوند؛ همچنین \ee نویسهٔ ESC (کد اسکی 0x1b) را تولید می‌کند\&. نشانگرهای قالب‌بندی زیر جایگزین می‌شوند:
.PP
%a
.RS 4
بایت نسبت ابعاد (aspect ratio) پیکسل\&.
.RE
.PP
%b
.RS 4
رنگ پس‌زمینهٔ صفحه نمایش\&.
.RE
.PP
%d
.RS 4
زمان تاخیر تصویر\&.
.RE
.PP
%h
.RS 4
ارتفاع تصویر (بُعد y)\&.
.RE
.PP
%n
.RS 4
اندیس تصویر\&.
.RE
.PP
%p
.RS 4
موقعیت تصویر (به صورت یک جفت x,y)\&.
.RE
.PP
%s
.RS 4
اندازهٔ صفحه نمایش (به صورت یک جفت x,y)\&.
.RE
.PP
%t
.RS 4
اندیس رنگ شفاف (transparency color) تصویر\&.
.RE
.PP
%u
.RS 4
پرچم ورودی کاربر تصویر (بولی)\&.
.RE
.PP
%v
.RS 4
رشتهٔ نگارش GIF\&.
.RE
.PP
%w
.RS 4
عرض تصویر (بُعد x)\&.
.RE
.PP
%x
.RS 4
حالت دور انداختن (disposal mode) برای GIF89 در تصویر\&.
.RE
.PP
%z
.RS 4
پرچم مرتب‌سازی جدول رنگ تصویر (بولی، در صورت نبود جدول رنگ محلی برابر false است)\&.
.RE
.PP
جایگزین‌های بولی می‌توانند پیشوندی دریافت کنند تا نحوهٔ نمایش آن‌ها تغییر کند:
.PP
1
.RS 4
"1" یا "0"
.RE
.PP
o
.RS 4
"on" یا "off"
.RE
.PP
t
.RS 4
"t" یا "f"
.RE
.PP
y
.RS 4
"yes" یا "no"
.RE
.PP
بنابراین، برای نمونه، "%oz" پرچم‌های مرتب‌سازی تصویر را با استفاده از رشته‌های "on" و "off" نمایش می‌دهد\&. حالت پیش‌فرض بدون پیشوند عددی است\&.
.PP
گزینهٔ \-a یک آرگومان عدد صحیح ده‌دهی بدون علامت دریافت کرده و از آن برای تنظیم بایت نسبت ابعاد (aspect\-ratio) در بلوک توصیف‌گر صفحه نمایش منطقی (logical screen descriptor) استفاده می‌کند\&.
.PP
گزینهٔ \-b یک آرگومان عدد صحیح ده‌دهی بدون علامت دریافت کرده و از آن برای تنظیم اندیس رنگ پس‌زمینه در بلوک توصیف‌گر صفحه نمایش منطقی استفاده می‌کند\&.
.PP
گزینهٔ \-d یک آرگومان عدد صحیح ده‌دهی دریافت کرده و از آن برای تنظیم زمان تاخیر، بر حسب صدم ثانیه، روی تصاویر انتخاب‌شده استفاده می‌کند\&.
.PP
گزینهٔ \-i حالت درهم‌بافی (interlacing) را در تصاویر انتخاب‌شده فعال یا غیرفعال می‌کند\&. آرگومان‌های مجاز عبارتند از: "1"، "0"، "yes"، "no"، "on"، "off"، "t"، "f"\&.
.PP
گزینهٔ \-p یک جفت‌مختصات x,y (با مبنای ۰) می‌گیرد و آن را به عنوان مختصات ترجیحی گوشهٔ بالا و سمت چپ تصاویر انتخاب‌شده تنظیم می‌کند\&.
.PP
گزینهٔ \-s یک جفت‌مختصات x,y (با مبنای ۰) می‌گیرد و آن را به عنوان اندازهٔ مورد انتظار صفحه نمایش تنظیم می‌کند\&.
.PP
گزینهٔ \-t یک آرگومان عدد صحیح ده‌دهی می‌گیرد و از آن برای تنظیم اندیس (با مبنای ۰) رنگ شفاف در تصاویر انتخاب‌شده استفاده می‌کند\&.
.PP
گزینهٔ \-u پرچم ورودی کاربر (user\-input) را در تصاویر انتخاب‌شده فعال یا غیرفعال می‌کند\&. آرگومان‌های مجاز عبارتند از: "1"، "0"، "yes"، "no"، "on"، "off"، "t"، "f"\&.
.PP
گزینهٔ \-x یک آرگومان عدد صحیح ده‌دهی می‌گیرد و از آن برای تنظیم حالت دور انداختن (disposal mode) برای GIF89 در تصاویر انتخاب‌شده استفاده می‌کند\&.
.PP
گزینهٔ \-z پرچم مرتب‌سازی جدول رنگ را در تصاویر انتخاب‌شده فعال یا غیرفعال می‌کند\&. آرگومان‌های مجاز عبارتند از: "1"، "0"، "yes"، "no"، "on"، "off"، "t"، "f"\&.
.PP
توجه داشته باشید که گزینه‌های \-a، \-b، \-p، \-s و \-z به منظور تکمیل توانایی ویرایش تمام فیلدهای تعریف‌شده در استاندارد GIF گنجانده شده‌اند، اما بر نحوهٔ نمایش تصویر در مرورگرها یا نمایشگرهای امروزی اثری ندارند\&.
.SH "نویسندگان (AUTHORS)"
.PP
Eric S\&. Raymond\&.