gtk4-rendernode-tool(1) GTK commands gtk4-rendernode-tool(1)

gtk4-rendernode-tool - ابزار کاربردی GskRenderNode

gtk4-rendernode-tool <COMMAND> [OPTIONS...] <FILE>
gtk4-rendernode-tool benchmark [OPTIONS...] <FILE>
gtk4-rendernode-tool compare [OPTIONS...] <FILE1> <FILE2>
gtk4-rendernode-tool convert [OPTIONS...] <FILE1>
gtk4-rendernode-tool extract [OPTIONS...] <FILE>
gtk4-rendernode-tool info [OPTIONS...] <FILE>
gtk4-rendernode-tool match [OPTIONS...] <PATTERN> <FILE>
gtk4-rendernode-tool render [OPTIONS...] <FILE> [<FILE>]
gtk4-rendernode-tool show [OPTIONS...] <FILE>

دستور gtk4-rendernode-tool می‌تواند عملیات مختلفی را روی rendernodeهای سریال‌سازی‌شده انجام دهد.

دستور info اطلاعات کلی درباره rendernode، مانند تعداد گره‌ها و عمق درخت را نمایش می‌دهد.

دستور show گره رندر (rendernode) را نمایش می‌دهد.

--offload

گره را درون یک GraphicsOffload قرار می‌دهد. این گزینه برای آزمایش قابلیت‌های برون‌سپاری بار پردازشی (offloading) در rendernodeهای ساده در نظر گرفته شده است.

--undecorated

تزئینات پنجره را حذف می‌کند. این قابلیت برای رندر کردن دقیق rendernode بدون هیچ‌گونه نوار عنوان در نظر گرفته شده است.

دستور render خروجی رندرشده از rendernode را به صورت یک تصویر png، tiff یا svg یا یک سند pdf ذخیره می‌کند. نام فایل خروجی را می‌توان به عنوان آرگومان دوم FILE مشخص کرد.

--renderer=RENDERER

استفاده از رندرکننده (renderer) مشخص‌شده. از --renderer=help برای دریافت اطلاعات درباره مقادیر ممکن برای RENDERER استفاده کنید.

--dont-move

موقعیت گره را نسبت به شبکه پیکسل‌ها (pixel grid) بدون تغییر نگه می‌دارد.

دستور benchmark رندر یک گره را با رندرکننده‌های موجود ارزیابی (سنجش کارایی) کرده و زمان‌های اجرا را چاپ می‌کند.

--renderer=RENDERER

افزودن رندرکننده مشخص‌شده. این آرگومان می‌تواند چندین بار برای آزمایش چندین رندرکننده ارسال شود. به طور پیش‌فرض، تمام رندرکننده‌های اصلی GTK اجرا می‌شوند.

--runs=RUNS

تعداد دفعات رندر گره روی هر رندرکننده. این مقدار به طور پیش‌فرض ۳ بار است. به یاد داشته باشید که اجرای نخست اغلب برای پر کردن حافظه‌های موقت (cache) استفاده می‌شود و ممکن است به طور قابل توجهی کندتر باشد.

--no-download

تلاشی برای بارگیری (download) نتیجه انجام نمی‌دهد. این ممکن است باعث شود سنجش کارایی شامل اجرای دستورات روی GPU نشود. استفاده از این پرچم می‌تواند برای سنجش کارایی ارسال دستورات (command submission) مفید باشد.

دستور compare رندر یک گره را با یک تصویر مرجع، یا رندرهای دو گره، یا دو تصویر را با یکدیگر مقایسه می‌کند. در صورت یافتن هرگونه تفاوت، وضعیت خروج ۱ است. اگر تصاویر یکسان باشند، مقدار خروج ۰ خواهد بود.

--renderer=RENDERER

استفاده از رندرکننده مشخص‌شده.

--output=FILE

ذخیره تفاوت‌ها به عنوان یک تصویر png در FILE.

--quiet

نتایج را در stdout نمی‌نویسد.

دستور convert یک آیکون نمادین SVG را به یک گره تبدیل کرده و نتیجه را در stdout می‌نویسد.

--recolor

در صورت استفاده از این گزینه، رنگ‌های نمادین گره حاصل با مقادیر داده‌شده به گزینه‌های --fg، --success، --warning و --error جایگزین خواهند شد. در غیر این صورت، گره رنگ‌های جایگزین‌نشده را خواهد داشت که می‌تواند برای عیب‌یابی مشکلات رندر مفید باشد.

--fg=COLOR --success=COLOR --warning=COLOR --error=COLOR

تنظیم رنگ‌های نمادین برای رنگ‌آمیزی مجدد آیکون. در صورت مشخص نشدن، از رنگ‌های پیش‌فرض استفاده می‌شود.

--size=SIZE

اندازه مورد نظر برای رندر آیکون را تعیین می‌کند. اندازه می‌تواند یک عدد یا رشته‌ای به شکل WIDTHxHEIGHT باشد.

دستور extract تمام data urlهای موجود در یک فایل گره را در یک دایرکتوری مشخص ذخیره می‌کند. نام فایل‌های استخراج‌شده از mimetype نشانی url گرفته می‌شود.

--dir=DIRECTORY

ذخیره فایل‌های استخراج‌شده در DIRECTORY (پیش‌فرض دایرکتوری جاری است).

دستور match امکان شمارش رخدادهای الگوهای گره در یک گره بزرگ‌تر را فراهم می‌کند. نحو الگوها امکان توصیف مجموعه‌هایی از گره‌ها با انواع مشخص را فراهم می‌سازد، مانند این موارد:

(mask . color)

تطبیق گره‌های mask با هر فرزند منبع و یک گره color به عنوان فرزند mask.

(rounded-clip linear-gradient)

تطبیق گره‌های rounded clip حاوی یک linear gradient.

(container 2 color (fill color))

تطبیق containerهایی با ۲ فرزند، که نخستین آن یک گره color و دومین آن یک گره fill حاوی یک گره color است.

GTK