.\" Man page generated from reStructuredText
.\" by the Docutils 0.22.4 manpage writer.
.
.
.nr rst2man-indent-level 0
.
.de1 rstReportMargin
\\$1 \\n[an-margin]
level \\n[rst2man-indent-level]
level margin: \\n[rst2man-indent\\n[rst2man-indent-level]]
-
\\n[rst2man-indent0]
\\n[rst2man-indent1]
\\n[rst2man-indent2]
..
.de1 INDENT
.\" .rstReportMargin pre:
. RS \\$1
. nr rst2man-indent\\n[rst2man-indent-level] \\n[an-margin]
. nr rst2man-indent-level +1
.\" .rstReportMargin post:
..
.de UNINDENT
. RE
.\" indent \\n[an-margin]
.\" old: \\n[rst2man-indent\\n[rst2man-indent-level]]
.nr rst2man-indent-level -1
.\" new: \\n[rst2man-indent\\n[rst2man-indent-level]]
.in \\n[rst2man-indent\\n[rst2man-indent-level]]u
..
.TH "gtk4-rendernode-tool" "1" "" "GTK" "GTK commands"
.SH "نام (NAME)"
gtk4-rendernode-tool \- ابزار کاربردی GskRenderNode
.SH "خلاصه دستور (SYNOPSIS)"
.nf
\fBgtk4\-rendernode\-tool\fP <COMMAND> [OPTIONS...] <FILE>

\fBgtk4\-rendernode\-tool\fP benchmark [OPTIONS...] <FILE>
\fBgtk4\-rendernode\-tool\fP compare [OPTIONS...] <FILE1> <FILE2>
\fBgtk4\-rendernode\-tool\fP convert [OPTIONS...] <FILE1>
\fBgtk4\-rendernode\-tool\fP extract [OPTIONS...] <FILE>
\fBgtk4\-rendernode\-tool\fP info [OPTIONS...] <FILE>
\fBgtk4\-rendernode\-tool\fP match [OPTIONS...] <PATTERN> <FILE>
\fBgtk4\-rendernode\-tool\fP render [OPTIONS...] <FILE> [<FILE>]
\fBgtk4\-rendernode\-tool\fP show [OPTIONS...] <FILE>
.fi
.sp
.SH "توضیحات (DESCRIPTION)"
.sp
دستور \fBgtk4\-rendernode\-tool\fP می‌تواند عملیات مختلفی را روی rendernodeهای سریال‌سازی‌شده انجام دهد.
.SH "دستورها (COMMANDS)"
.SS "اطلاعات (Information)"
.sp
دستور \fBinfo\fP اطلاعات کلی درباره rendernode، مانند تعداد گره‌ها و عمق درخت را نمایش می‌دهد.
.SS "نمایش (Showing)"
.sp
دستور \fBshow\fP گره رندر (rendernode) را نمایش می‌دهد.
.sp
\fB\-\-offload\fP
.sp
گره را درون یک GraphicsOffload قرار می‌دهد. این گزینه برای آزمایش قابلیت‌های برون‌سپاری بار پردازشی (offloading) در rendernodeهای ساده در نظر گرفته شده است.
.sp
\fB\-\-undecorated\fP
.sp
تزئینات پنجره را حذف می‌کند. این قابلیت برای رندر کردن دقیق rendernode بدون هیچ‌گونه نوار عنوان در نظر گرفته شده است.
.SS "رندر کردن (Rendering)"
.sp
دستور \fBrender\fP خروجی رندرشده از rendernode را به صورت یک تصویر png، tiff یا svg یا یک سند pdf ذخیره می‌کند. نام فایل خروجی را می‌توان به عنوان آرگومان دوم FILE مشخص کرد.
.sp
\fB\-\-renderer=RENDERER\fP
.INDENT 0.0
.INDENT 3.5
استفاده از رندرکننده (renderer) مشخص‌شده. از \fB\-\-renderer=help\fP برای دریافت اطلاعات درباره مقادیر ممکن برای \fBRENDERER\fP استفاده کنید.
.UNINDENT
.UNINDENT
.sp
\fB\-\-dont\-move\fP
.sp
موقعیت گره را نسبت به شبکه پیکسل‌ها (pixel grid) بدون تغییر نگه می‌دارد.
.SS "سنجش کارایی (Benchmark)"
.sp
دستور \fBbenchmark\fP رندر یک گره را با رندرکننده‌های موجود ارزیابی (سنجش کارایی) کرده و زمان‌های اجرا را چاپ می‌کند.
.sp
\fB\-\-renderer=RENDERER\fP
.INDENT 0.0
.INDENT 3.5
افزودن رندرکننده مشخص‌شده. این آرگومان می‌تواند چندین بار برای آزمایش چندین رندرکننده ارسال شود. به طور پیش‌فرض، تمام رندرکننده‌های اصلی GTK اجرا می‌شوند.
.UNINDENT
.UNINDENT
.sp
\fB\-\-runs=RUNS\fP
.INDENT 0.0
.INDENT 3.5
تعداد دفعات رندر گره روی هر رندرکننده. این مقدار به طور پیش‌فرض ۳ بار است. به یاد داشته باشید که اجرای نخست اغلب برای پر کردن حافظه‌های موقت (cache) استفاده می‌شود و ممکن است به طور قابل توجهی کندتر باشد.
.UNINDENT
.UNINDENT
.sp
\fB\-\-no\-download\fP
.INDENT 0.0
.INDENT 3.5
تلاشی برای بارگیری (download) نتیجه انجام نمی‌دهد. این ممکن است باعث شود سنجش کارایی شامل اجرای دستورات روی GPU نشود. استفاده از این پرچم می‌تواند برای سنجش کارایی ارسال دستورات (command submission) مفید باشد.
.UNINDENT
.UNINDENT
.SS "مقایسه (Compare)"
.sp
دستور \fBcompare\fP رندر یک گره را با یک تصویر مرجع، یا رندرهای دو گره، یا دو تصویر را با یکدیگر مقایسه می‌کند. در صورت یافتن هرگونه تفاوت، وضعیت خروج ۱ است. اگر تصاویر یکسان باشند، مقدار خروج ۰ خواهد بود.
.sp
\fB\-\-renderer=RENDERER\fP
.INDENT 0.0
.INDENT 3.5
استفاده از رندرکننده مشخص‌شده.
.UNINDENT
.UNINDENT
.sp
\fB\-\-output=FILE\fP
.INDENT 0.0
.INDENT 3.5
ذخیره تفاوت‌ها به عنوان یک تصویر png در \fBFILE\fP\&.
.UNINDENT
.UNINDENT
.sp
\fB\-\-quiet\fP
.INDENT 0.0
.INDENT 3.5
نتایج را در stdout نمی‌نویسد.
.UNINDENT
.UNINDENT
.SS "تبدیل (Convert)"
.sp
دستور \fBconvert\fP یک آیکون نمادین SVG را به یک گره تبدیل کرده و نتیجه را در stdout می‌نویسد.
.sp
\fB\-\-recolor\fP
.INDENT 0.0
.INDENT 3.5
در صورت استفاده از این گزینه، رنگ‌های نمادین گره حاصل با مقادیر داده‌شده به گزینه‌های \fB\-\-fg\fP، \fB\-\-success\fP، \fB\-\-warning\fP و \fB\-\-error\fP جایگزین خواهند شد. در غیر این صورت، گره رنگ‌های جایگزین‌نشده را خواهد داشت که می‌تواند برای عیب‌یابی مشکلات رندر مفید باشد.
.UNINDENT
.UNINDENT
.sp
\fB\-\-fg=COLOR\fP
\fB\-\-success=COLOR\fP
\fB\-\-warning=COLOR\fP
\fB\-\-error=COLOR\fP
.INDENT 0.0
.INDENT 3.5
تنظیم رنگ‌های نمادین برای رنگ‌آمیزی مجدد آیکون. در صورت مشخص نشدن، از رنگ‌های پیش‌فرض استفاده می‌شود.
.UNINDENT
.UNINDENT
.sp
\fB\-\-size=SIZE\fP
.INDENT 0.0
.INDENT 3.5
اندازه مورد نظر برای رندر آیکون را تعیین می‌کند. اندازه می‌تواند یک عدد یا رشته‌ای به شکل \fBWIDTHxHEIGHT\fP باشد.
.UNINDENT
.UNINDENT
.SS "استخراج (Extract)"
.sp
دستور \fBextract\fP تمام data urlهای موجود در یک فایل گره را در یک دایرکتوری مشخص ذخیره می‌کند. نام فایل‌های استخراج‌شده از mimetype نشانی url گرفته می‌شود.
.sp
\fB\-\-dir=DIRECTORY\fP
.INDENT 0.0
.INDENT 3.5
ذخیره فایل‌های استخراج‌شده در \fBDIRECTORY\fP (پیش‌فرض دایرکتوری جاری است).
.UNINDENT
.UNINDENT
.SS "تطبیق الگو (Matching)"
.sp
دستور \fBmatch\fP امکان شمارش رخدادهای الگوهای گره در یک گره بزرگ‌تر را فراهم می‌کند. نحو الگوها امکان توصیف مجموعه‌هایی از گره‌ها با انواع مشخص را فراهم می‌سازد، مانند این موارد:
.INDENT 0.0
.INDENT 3.5
\fB(mask . color)\fP
.sp
تطبیق گره‌های mask با هر فرزند منبع و یک گره color به عنوان فرزند mask.
.sp
\fB(rounded\-clip linear\-gradient)\fP
.sp
تطبیق گره‌های rounded clip حاوی یک linear gradient.
.sp
\fB(container 2 color (fill color))\fP
.sp
تطبیق containerهایی با ۲ فرزند، که نخستین آن یک گره color و دومین آن یک گره fill حاوی یک گره color است.
.UNINDENT
.UNINDENT
.\" End of generated man page.