.TH GIMPTOOL 1 "Version 3.2.4" "GIMP Manual Pages"

.SH "نام (NAME)"
gimptool \- اسکریپتی برای انجام عملکردهای گوناگون گیمپ (GIMP)


.SH "خلاصه دستور (SYNOPSIS)"
.B gimptool
[\-\-prefix\fI[=DIR]\fP] [\-\-exec\-prefix\fI[=DIR]\fP] [\-\-version]
[\-\-help] [\-\-quiet] [\-\-silent] [\-n] [\-\-just-print] [\-\-dry-run]
[\-\-recon] [\-\-msvc-syntax]
[\-\-bindir] [\-\-sbindir] [\-\-libexecdir] [\-\-datadir]
[\-\-sysconfdir] [\-\-sharedstatedir] [\-\-localstatedir] [-\-libdir]
[\-\-infodir] [\-\-mandir] [\-\-includedir] [\-\-gimpplugindir]
[\-\-gimpdatadir] [\-\-libs] [\-\-libs-noui] [\-\-cflags] [\-\-cflags-noi]
[\-\-build \fIplug\-in.c\fP]
[\-\-build\-strip \fIplug\-in.c\fP] [\-\-install \fIplug\-in.c\fP]
[\-\-install-strip \fIplug\-in.c\fP] [\-\-install-admin \fIplug-in.c\fP] 
[\-\-install\-bin \fIplug\-in\fP]
[\-\-install\-admin\-strip \fIplug-in.c\fP]
[\-\-install\-bin\-strip \fIplug\-in\fP]
[\-\-\install\-admin\-bin \fIplug\-in\fP]
[\-\-install\-script \fIscript.scm\fP] 
[\-\-\install\-admin\-script \fIscript.scm\fP]
[\-\-uninstall\-bin \fIplug\-in\fP] [\-\-uninstall\-admin\-bin \fIplug\-in\fP]
[\-\-uninstall\-script \fIscript.scm\fP]
[\-\-uninstall\-admin\-script \fIscript.scm\fP]


.SH "توضیحات (DESCRIPTION)"
.PP
ابزار
\fIgimptool\fP
می‌تواند در میان کارهای دیگر، پلاگین‌ها یا اسکریپت‌ها را ساخته و در صورتی که در قالب یک فایل سورس تک توزیع شده باشند، آن‌ها را نصب کند.
.PP
همچنین
\fIgimptool\fP
می‌تواند توسط برنامه‌هایی استفاده شود که نیاز دارند بدانند
\fIGIMP\fP
با چه کتابخانه‌ها و مسیرهای اینکلودی (include-paths) کامپایل شده است.
\fIgimptool\fP
برای این منظور از
\fIpkg-config\fP
استفاده می‌کند. برای استفاده در Makefiles، توصیه می‌شود به جای فراخوانی
\fIgimptool\fP
مستقیماً از
\fIpkg-config\fP
استفاده کنید.


.SH "گزینه‌ها (OPTIONS)"
\fIgimptool\fP
گزینه‌های زیر را می‌پذیرد:
.TP 8
.B  \-\-version
چاپ نسخه فعلی نصب‌شده
\fIGIMP\fP
در خروجی استاندارد.
.TP 8
.B \-\-help
چاپ متن راهنما که گزینه‌های پرکاربرد خط فرمان را نمایش می‌دهد.
.TP 8
.B \-\-quiet
اجرا در حالت خاموش بدون بازتاب دادن هیچ‌یک از دستورات ساخت.
.TP 8
.B \-\-silent
اجرا در حالت کاملاً بی‌صدا بدون چاپ دستورات ساخت؛ معادل \-\-quiet.
.TP 8
.B \-n
حالت آزمایشی. دستورات را چاپ می‌کند اما در عمل آن‌ها را اجرا نمی‌کند. برای اجرای آزمایشی (dry runs) جهت تست مفید است.
.TP 8
.B \-\-just-print
حالت آزمایشی. دستورات را چاپ می‌کند ولی آن‌ها را اجرا نمی‌کند؛ معادل \-n.
.TP 8
.B \-\-dry-run
حالت آزمایشی. دستورات را چاپ می‌کند ولی آن‌ها را اجرا نمی‌کند؛ معادل \-n.
.TP 8
.B \-\-recon
حالت آزمایشی. دستورات را چاپ می‌کند ولی آن‌ها را اجرا نمی‌کند؛ معادل \-n.
.TP 8
.B \-\-msvc-syntax
کاربردی در ویندوز. فلگ‌های کامپایلر و پیونددهنده (linker) را با سینتکس مورد استفاده در ابزارهای مایکروسافت خروجی می‌دهد. این گزینه‌ها به دستور pkg-config که بخش عمده کار
\fIgimptool\fP
را انجام می‌دهد ارسال می‌شوند.
.TP 8
.B \-\-bindir
دایرکتوری bindir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-sbindir
دایرکتوری sbindir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-libexecdir
دایرکتوری libexecdir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-datadir
دایرکتوری datadir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-sysconfdir
دایرکتوری sysconfdir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-sharedstatedir
دایرکتوری sharedstatedir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-localstatedir
دایرکتوری localstatedir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-libdir
دایرکتوری libdir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-infodir
دایرکتوری infodir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-mandir
دایرکتوری mandir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-includedir
دایرکتوری includedir که برای نصب
\fIGIMP\fP
استفاده شده است را خروجی می‌دهد.
.TP 8
.B \-\-gimpdatadir
دایرکتوری واقعی که فایل‌های داده
\fIGIMP\fP
در آن نصب شده‌اند را خروجی می‌دهد.
.TP 8
.B \-\-gimpplugindir
دایرکتوری واقعی که پلاگین‌های
\fIGIMP\fP
در آن نصب شده‌اند را خروجی می‌دهد.
.TP 8
.B  \-\-build \fIplug-in.c\fP
کامپایل و پیوند (link) دادن
\fIplug-in.c\fP
به صورت یک پلاگین
\fIGIMP\fP.
.TP 8
.B  \-\-build\-strip \fIplug-in.c\fP
کامپایل، پیوند و حذف نمادها (strip) از
\fIplug-in.c\fP
به صورت یک پلاگین
\fIGIMP\fP.
.TP 8
.B  \-\-install \fIplug-in.c\fP
کامپایل، پیوند و نصب
\fIplug-in.c\fP
در دایرکتوری شخصی پلاگین‌های
\fIGIMP\fP
کاربر ($XDG_CONFIG_HOME/GIMP/3.2/plug-ins).
.TP 8
.B  \-\-install\-strip \fIplug-in.c\fP
کامپایل، پیوند، حذف نمادها (strip) و نصب
\fIplug-in.c\fP
در دایرکتوری شخصی پلاگین‌های
\fIGIMP\fP
کاربر ($XDG_CONFIG_HOME/GIMP/3.2/plug-ins).
.TP 8
.B  \-\-install\-admin \fIplug-in.c\fP
کامپایل، پیوند و نصب
\fIplug-in.c\fP
در دایرکتوری سرتاسری سیستم برای پلاگین‌های
\fIGIMP\fP
(/usr/lib/gimp/3.0/plug-ins).
.TP 8
.B  \-\-install\-bin \fIplug-in\fP
نصب باینری
\fIplug-in\fP
در دایرکتوری شخصی پلاگین‌های
\fIGIMP\fP
کاربر ($XDG_CONFIG_HOME/GIMP/3.2/plug-ins).
.TP 8
.B  \-\-install\-admin\-bin \fIplug-in\fP
نصب باینری
\fIplug-in\fP
در دایرکتوری سرتاسری سیستم برای پلاگین‌های
\fIGIMP\fP
(/usr/lib/gimp/3.0/plug-ins).
.TP 8
.B  \-\-install\-bin\-strip \fIplug-in\fP
نصب باینری بدون نماد (stripped)
\fIplug-in\fP
در دایرکتوری شخصی پلاگین‌های
\fIGIMP\fP
کاربر ($XDG_CONFIG_HOME/GIMP/3.2/plug-ins).
.TP 8
.B  \-\-install\-admin\-bin\-strip \fIplug-in\fP
نصب باینری بدون نماد (stripped)
\fIplug-in\fP
در دایرکتوری سرتاسری سیستم برای پلاگین‌های
\fIGIMP\fP
(/usr/lib/gimp/3.0/plug-ins).
.TP 8
.B  \-\-install\-script \fIscript.scm\fP
نصب
\fIscript.scm\fP
در دایرکتوری شخصی اسکریپت‌های
\fIGIMP\fP
کاربر ($XDG_CONFIG_HOME/GIMP/3.2/scripts).
.TP 8
.B  \-\-install\-admin\-script \fIscript.scm\fP
نصب
\fIscript.scm\fP
در دایرکتوری سرتاسری سیستم برای اسکریپت‌های
\fIGIMP\fP
(/usr/share/gimp/3.0/scripts).
.TP 8
.B  \-\-uninstall\-bin \fIplug-in\fP
حذف نصب
\fIplug-in\fP
از دایرکتوری شخصی پلاگین‌های
\fIGIMP\fP
کاربر ($XDG_CONFIG_HOME/GIMP/3.2/plug-ins).
.TP 8
.B  \-\-uninstall\-admin\-bin \fIplug-in\fP
حذف نصب
\fIplug-in\fP
از دایرکتوری سرتاسری سیستم برای پلاگین‌های
\fIGIMP\fP
(/usr/lib/gimp/3.0/plug-ins).
.TP 8
.B  \-\-uninstall\-script \fIscript.scm\fP
حذف نصب
\fIscript.scm\fP
از دایرکتوری شخصی اسکریپت‌های
\fIGIMP\fP
کاربر ($XDG_CONFIG_HOME/GIMP/3.2/scripts).
.TP 8
.B  \-\-uninstall\-admin\-script \fIscript.scm\fP
حذف نصب
\fIscript.scm\fP
از دایرکتوری سرتاسری سیستم برای اسکریپت‌های
\fIGIMP\fP
(/usr/share/gimp/3.0/scripts).
.TP 8
.B  \-\-libs
چاپ فلگ‌های لینکر (پیونددهنده) که برای پیوند دادن یک پلاگین
\fIGIMP\fP
لازم است.
.TP 8
.B \-\-libs-noui
چاپ فلگ‌های لینکر لازم برای پیوند یک پلاگین
\fIGIMP\fP،
برای پلاگین‌هایی که نیازی به کتابخانه‌های GTK ندارند.
.TP 8
.B  \-\-cflags
چاپ فلگ‌های کامپایلر که برای کامپایل یک پلاگین
\fIGIMP\fP
لازم است.
.TP 8
.B \-\-clags-noui
چاپ فلگ‌های کامپایلر لازم برای کامپایل یک پلاگین
\fIGIMP\fP
برای پلاگین‌هایی که به کتابخانه‌های GTK نیاز ندارند.
.TP 8
.B  \-\-prefix=PREFIX
در صورت تعیین، هنگام محاسبه خروجی برای گزینه‌های
\-\-cflags
و
\-\-libs،
به جای پیشوند نصبی که
\fIGIMP\fP
با آن ساخته شده است از PREFIX استفاده می‌کند. این گزینه همچنین برای پیشوند اجرایی (exec prefix) در صورتی که
\-\-exec\-prefix
مشخص نشده باشد به کار می‌رود. این گزینه باید پیش از هر گزینه
\-\-libs
یا
\-\-cflags
مشخص شود.
.TP 8
.B  \-\-exec\-prefix=PREFIX
در صورت تعیین، هنگام محاسبه خروجی برای گزینه‌های
\-\-cflags
و
\-\-libs،
به جای پیشوند اجرایی نصبی که
\fIGIMP\fP
با آن ساخته شده است از PREFIX استفاده می‌کند. این گزینه باید پیش از هر گزینه
\-\-libs
یا
\-\-cflags
مشخص شود.


.SH "محیط (ENVIRONMENT)"
.PP
.TP 8
.B CC
برای دریافت نام کامپایلر C مورد نظر.
.TP 8
.B CFLAGS
برای دریافت فلگ‌های ترجیحی جهت ارسال به کامپایلر C هنگام ساخت پلاگین.
.TP 8
.B LDFLAGS
برای دریافت فلگ‌های ترجیحی جهت ارسال به پیونددهنده (linker).
.TP 8
.B LIBS
برای ارسال کتابخانه‌های اضافی که ممکن است در فرآیند ساخت نیاز باشند؛ برای نمونه:
LIBS=-lintl .
.TP 8
.B PKG_CONFIG
برای دریافت مسیر برنامه
\fIpkg-config\fP
که جهت تعیین جزئیات نصب بسته‌های glib، pango، gtk و gimp شما استفاده می‌شود.


.SH "همچنین ببینید (SEE ALSO)"
.BR gimp (1), 
.BR gimprc (5),
.BR pkg\-config (1)


.SH "نویسندگان (AUTHORS)"
ابزار gimptool توسط Manish Singh (yosh@gimp.org) نوشته شده و بر اساس gtk\-config اثر Owen Taylor (owen@gtk.org) است.
.PP
این صفحه راهنما توسط Ben Gertzfield (che@debian.org) نوشته شده و توسط Manish Singh (yosh@gimp.org)، Adrian Likins (adrian@gimp.org) و Marc Lehmann (pcg@goof.com) ویرایش شده است.