'\" t
.\"     Title: gifbuild
.\"    Author: [see the "Author" section]
.\" Generator: DocBook XSL Stylesheets vsnapshot <http://docbook.sf.net>
.\"      Date: 2 May 2012
.\"    Manual: GIFLIB Documentation
.\"    Source: GIFLIB
.\"  Language: Persian
.\"
.TH "GIFBUILD" "1" "2 May 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)"
gifbuild \- استخراج داده‌های GIF در قالب متنی، یا بازتولید آن به فایل GIF
.SH "خلاصه دستور (SYNOPSIS)"
.HP \w'\fBgifbuild\fR\ 'u
\fBgifbuild\fR [\-v] [\-a] [\-d] [\-t\ \fItranslation\-table\fR] [\-h] [\fIgif\-file\fR]
.SH "توضیحات (DESCRIPTION)"
.PP
برنامه‌ای برای تبدیل مجموعه‌ای از مشخصات متنی و قابل ویرایش آیکون GIF و فایل‌های نام‌گذاری‌شده GIF به یک GIF چندتصویری، قابل استفاده به عنوان یک فایل منبع گرافیکی\&. این ابزار همچنین می‌تواند فایل‌های GIF موجود را در این قالب استخراج کند\&. هر دو جهت تبدیل بدون اتلاف (lossless) و معکوس یکدیگر هستند\&.
.PP
هنگام استخراج یک فایل GIF، بررسی‌های اعتبارسنجی خاصی انجام می‌شود که ممکن است منجر به صدور هشدار در خروجی خطای استاندارد (stderr) شود\&.
.PP
اگر هیچ فایل GIF مشخص نشود، gifbuild تلاش می‌کند ورودی متنی را از ورودی استاندارد (stdin) بخواند\&.
.SH "نحو مشخصات (SPECIFICATION SYNTAX)"
.PP
در اینجا خلاصه‌ای از نحو به صورت فرم غیررسمی BNF آورده شده است\&. نشانه `NL\*(Aq نشان‌دهنده شکستن خط الزامی (newline) است\&.
.sp
.if n \{\
.RS 4
.\}
.nf
<gif\-spec> ::= <header\-block> <image\-block>\&.\&.\&.

<header\-block> ::= <header\-declaration>\&.\&.\&.

<header\-declaration ::=
		| screen width <digits> NL
		| screen height <digits> NL
		| screen colors <digits> NL
		| screen background <digits> NL
		| pixel aspect byte <digits> NL
		| screen map <color\-table> NL

<color\-table> ::= <color\-declaration>\&.\&.\&. end NL

<color\-declaration> ::= rgb <digits> <digits> <digits> [ is <key>] NL
                | sort flag {on|off} NL

<image\-block> ::= include <file\-name> NL
		| image NL
			<image\-declaration>\&.\&.\&.
			<raster\-picture>
			[ <extension> ]

<image\-declarations> ::= image top <digits> NL
			| image left <digits> NL
			| image interlaced NL
			| image map <color\-table> NL
			| image bits <digits> by <digits> [hex|ascii] NL <raster\-block>

<extension> := <comment> NL <extension\-block> NL end NL
		| <plaintext> NL <extension\-block> NL end NL
                | graphics control NL <GCB\-part> NL end NL
                | netscape loop  <digits> NL
		| extension <hex\-digits> NL <extension\-block> NL end NL

<GCB\-part> ::= disposal mode <digits> NL
                | user input flag {on|off} NL
                | delay <digits> NL
                | transparent index <digits> NL

.fi
.if n \{\
.RE
.\}
.PP
اگر نوع داده‌های اعلانات
\(lqscreen height\(rq،
\(lqscreen width\(rq،
\(lqscreen background\(rq،
\(lqimage top\(rq و
\(lqimage left\(rq
برای شما واضح نیست، واقعاً با این نرم‌افزار چه کار می‌کنید؟
.PP
اعلان
\(lqpixel aspect byte\(rq
یک مخرج عدد صحیح برای کسری که بیانگر نسبت ابعاد پیکسل است تنظیم می‌کند\&. برای جزئیات به استاندارد GIF مراجعه کنید؛ این فیلد در واقع از مدت‌ها پیش منسوخ شده است\&.
.PP
یک جدول رنگ، شاخص‌های رنگ را (به ترتیب صعودی از ۰) اعلام می‌کند و ممکن است آن‌ها را به کلیدواژه‌های کاراکتری مرتبط سازد (این ارتباط‌ها زمانی که جدول بیش از ۹۴ رنگ باشد وجود ندارند و بلوک‌های شطرنجی که از آن استفاده می‌کنند باید از جفت‌نویسه‌های هگز استفاده کنند)\&. این نویسه‌ها بعداً می‌توانند در بلوک‌های شطرنجی استفاده شوند\&. از آنجا که این نویسه‌ها باید قابل چاپ و غیرفاصله باشند، در هر آیکون فقط می‌توانید ۹۴ رنگ را مشخص کنید\&. زندگی گاهی همین‌طور است\&.
.PP
اعلان جدول رنگ همچنین می‌تواند پرچم مرتب‌سازی جدول را با "sort flag on" یا "sort flag off" در هر خطی پیش از پایان (end) تنظیم کند\&.
.PP
یک بلوک شطرنجی
\(lqascii\(rq
تنها بلوکی از نویسه‌های کلیدی است (برای جدول رنگ با ۹۴ رنگ یا کمتر استفاده می‌شود)\&. یک بلوک شطرنجی
\(lqhex\(rq
در عوض از جفت‌رقم‌های هگزادسیمال استفاده می‌کند (برای جدول رنگ با بیش از ۹۴ رنگ به‌کار می‌رود)\&. مقدار پیش‌فرض ASCII است\&. اندازه آن باید متناسب با اعلان
\(lqimage bits\(rq
پیش از خود تنظیم شده باشد\&. بلوک‌های شطرنجی فایل‌های GIF درهم‌بافته (interlaced) با خطوطی به ترتیب غیردرهم‌بافته استخراج می‌شوند\&.
.PP
کلمات کلیدی
\(lqcomment\(rq،
\(lqplaintext\(rq
یا
\(lqgraphics control\(rq
داده‌های رکورد پسوند تعریف‌شده GIF89 را هدایت می‌کنند\&. نوع نهایی GIF89، یعنی بلوک کنترل گرافیکی و برنامه، هنوز پشتیبانی نمی‌شود، اما کد یک بلوک حلقه نت‌اسکیپ (Netscape loop block) را تشخیص می‌دهد\&. شما همچنین می‌توانید عبارت
\(lqextension\(rq
را به همراه نوع رکورد در قالب هگزادسیمال درج کنید\&. تمامی این اعلانات پسوند باید با یک بلوک پسوند دنبال شوند که با کلمه کلیدی
\(lqend\(rq
در یک خط مستقل خاتمه می‌یابد\&.
.PP
یک بلوک پسوند مجموعه‌ای از خطوط متنی است که هر کدام به عنوان رشته‌ای از بایت‌ها برای پر کردن بلوک پسوند تفسیر می‌شوند (نویسه خط جدید انتهایی حذف می‌شود)\&. متن ممکن است شامل کدهای گریز استاندارد هشت‌هشتی و هگزادسیمال به سبک زبان C باشد که با بک‌اسلش آغاز می‌شوند\&.
.PP
اعلان بلوک کنترل گرافیکی یک بلوک پسوند کنترل گرافیک ایجاد می‌کند؛ برای معناشناسی فیلدها به بخش ۲۳ استاندارد GIF89 مراجعه کنید\&.
.PP
اعلان حلقه نت‌اسکیپ (netscape loop) یک بلوک پسوند برنامه شامل کنترل حلقه انیمیشن NETSCAPE 2\&.0 با تعداد تکرار مشخص ایجاد می‌کند (تکرار ۰ به معنای تکرار نامحدود است)\&. این اعلان باید بلافاصله پس از اعلان سرآیند (header) قرار گیرد\&. این بلوک‌های حلقه توسط مرورگرهای خانواده Netscape/Mozilla/Firefox تفسیر می‌شوند\&.
.PP
تمامی نشانه‌های <digits> به عنوان اعداد ده‌دهی تفسیر می‌شوند؛ نشانه‌های <hex\-digits> به عنوان دو رقم هگزادسیمال (یک بایت) در نظر گرفته می‌شوند\&. تمامی مختصات با مبدأ صفر بوده و گوشه بالا سمت چپ (0,0) است\&. بررسی محدوده ضعیف بوده و بررسی علامت‌دار بودن وجود ندارد؛ مراقب باشید هکرها!
.PP
به‌طور کلی، مقدار فاصله‌های خالی و ترتیب اعلانات در داخل یک بلوک سرآیند یا تصویر اهمیتی ندارد، مگر اینکه یک تصویر شطرنجی باید بلافاصله پس از اعلان
\(lqimage bits\(rq
مربوط به خود قرار گیرد\&.
.PP
اعلان
\(lqinclude\(rq
یک فایل GIF نام‌گذاری‌شده را به عنوان تصویر بعدی اضافه می‌کند\&. جدول‌های رنگ سراسری GIFهای گنجانده‌شده با جدول پایه‌ای که توسط هر اعلان
\(lqscreen color\(rq
تعریف شده باشد ادغام می‌گردند\&. تمام تصاویر یک GIF چندتصویری گنجانده‌شده به ترتیب اضافه خواهند شد\&.
.PP
کامنت‌ها (که با
\(lq#\(rq
شروع می‌شوند) نادیده گرفته خواهند شد\&.
.SH "گزینه‌ها (OPTIONS)"
.PP
\-v
.RS 4
حالت پرگو (نمایش روند پیشرفت)\&. چاپ خطوط اسکن در حال پردازش را فعال می‌کند\&.
.RE
.PP
\-d
.RS 4
استخراج فایل(های) GIF ورودی به قالب متنی شرح داده شده در بالا\&.
.RE
.PP
\-t
.RS 4
مشخص کردن نویسه‌های نام مورد استفاده هنگام استخراج بلوک‌های شطرنجی\&. تنها با گزینه \-d معتبر است\&.
.RE
.PP
\-h
.RS 4
چاپ یک خط راهنمای خط فرمان، مشابه خلاصه دستور بالا\&.
.RE
.SH "اشکالات (BUGS)"
.PP
بررسی خطا ابتدایی و مقدماتی است\&.
.SH "مثال‌ها (EXAMPLES)"
.PP
یک فایل آیکون نمونه با نام
sample\&.ico
در دایرکتوری pic از توزیع سورس GIFLIB گنجانده شده است\&.
.SH "نویسندگان (AUTHORS)"
.PP
Eric S\&. Raymond
<esr@thyrsus\&.com>