.\"
.\"Copyright (C) 2008 tks
.\"
.\"This program is free software: you can redistribute it and/or modify
.\"it under the terms of the GNU General Public License as published by
.\"the Free Software Foundation, either version 3 of the License, or
.\"(at your option) any later version.
.\"
.\"This program is distributed in the hope that it will be useful,
.\"but WITHOUT ANY WARRANTY; without even the implied warranty of
.\"MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\"GNU General Public License for more details.
.\"
.\"You should have received a copy of the GNU General Public License
.\"along with this program.  If not, see <http://www.gnu.org/licenses>.
.\"
.TH XCUR2PNG 1 2008-10-09 GNU
.SH "نام (NAME)"
xcur2png \- استخراج تصاویر PNG از Xcursor و تولید فایل پیکربندی xcursorgen
.SH "خلاصه دستور (SYNOPSIS)"
.B "xcur2png"
[ \fB\-V\fP ] [ \fB\-\-version\fP ]
.sp
.B "xcur2png"
[ \fB\-h\fP ] [ \fB\-\-help\fP ]
.sp
.B "xcur2png"
[ \fB\-c\fP \fIconf\-path\fP ] [ \fB\-\-conf\fP=\fIconf\-path\fP ] 
[ \fB\-d\fP \fIdir\-path\fP ] [ \fB\-\-directory\fP=\fIdir\-path\fP ] 
[ \fB\-i\fP \fIsuffix\fP ] [ \fB\-\-initial-suffix\fP=\fIsuffix\fP ] 
[ \fB\-q\fP ] [ \fB\-\-quiet\fP ] [ \fB\-n\fP ] [ \fB\-\-dry\-run\fP ]
\fIXcursor-file

.SH "توضیحات (DESCRIPTION)"
برنامه \fBxcur2png\fP تصاویر PNG را از \fIXcursor-file\fP استخراج کرده
و یک فایل پیکربندی تولید می‌کند که توسط \fBxcursorgen\fP(1) قابل استفادهٔ مجدد است.
به زبان ساده، این ابزار یک مبدل نشانگر ماوس X به تصویر PNG است.
.P
\fIXcursor-file\fP مسیر یک فایل موجود Xcursor است.
تعیین هم‌زمان چند \fIXcursor-file\fP پشتیبانی نمی‌شود.
تصاویر PNG تولیدشده در دایرکتوری جاری ذخیره می‌شوند.

.SH "گزینه‌ها (OPTIONS)"
.TP 8
.BR \-V ", " \-\-version
نمایش شمارهٔ نسخه و خروج با وضعیت 0.
.TP 8
.BR \-h ", " \-\-help
نمایش پیام راهنما و نحوهٔ استفاده، و سپس خروج با وضعیت 0.
.TP 8
.BR "\-c \fIconf\-path\fP" ", " "\-\-conf=\fIconf\-path\fP"
تنظیم مسیر خروجی فایل پیکربندی.
اگر «\-» مشخص شود، از \fBstdout\fP(3) استفاده می‌شود. در صورت عدم تعیین،
از [نام‌فایلِ \fIXcursor-file\fP].conf استفاده می‌شود. اگر «\fIconf\-path\fP»
یک دایرکتوری باشد، فایل پیکربندی در دایرکتوری مشخص‌شده تحت نام
[نام‌فایلِ \fIXcursor-file\fP].conf ذخیره خواهد شد.
.TP 8
.BR "\-d \fIdir\-path\fP" ", " "\-\-directory=\fIdir\-path\fP"
تنظیم مسیر دایرکتوری‌ای که تصاویر PNG در آن ذخیره می‌شوند.
در صورت عدم تعیین، از دایرکتوری جاری استفاده می‌شود.
.TP 8
.BR "\-i \fIsuffix\fP" ", " "\-\-initial\-suffix=\fIsuffix\fP"
تنظیم پسوند اولیهٔ تصاویر PNG به \fIsuffix\fP.
\fIsuffix\fP باید یک عدد صحیح مثبت و حداکثر ۹۹۹ باشد.
هنگامی که پسوند به ۹۹۹ برسد، xcur2png با یک وضعیت منفی خارج می‌شود.
.TP 8
.BR \-q ", " \-\-quiet
عدم نمایش پیام‌های پیشرفت کار.
.TP 8
.BR \-n ", " \-\-dry\-run
عدم ذخیره تصاویر PNG و داده‌های پیکربندی در فایل‌ها. داده‌های پیکربندی به
stdout ارسال می‌شوند و پیام‌های پیشرفت کار غیرفعال می‌گردند.

.SH "وضعیت خروج (EXIT STATUS)"
.PP 8
.B xcur2png
در صورتی که تبدیل با موفقیت به پایان برسد و \fIconfig\-file\fP تولید شود،
تعداد تصاویر PNG خروجی را برمی‌گرداند.
در صورت وقوع خطا، xcur2png مقدار منفی بازمی‌گرداند.

.SH "همچنین ببینید (SEE ALSO)"
xcursorgen(1)