.TH GLMARK2-WAYLAND "1" "January 2023" "glmark2-wayland 2023.01"
.SH "نام (NAME)"
glmark2-wayland \- مجموعه بنچمارک OpenGL (ES) 2.0
.SH "خلاصه دستور (SYNOPSIS)"
.B glmark2-wayland [گزینه‌ها]
.SH "توضیحات (DESCRIPTION)"
\fBglmark2-wayland\fP یک محک عملکرد (بنچمارک) برای OpenGL (ES) 2.0 است. این برنامه تنها از زیرمجموعه‌ای از API نسخهٔ OpenGL 2.0 استفاده می‌کند که با OpenGL ES 2.0 سازگار است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-b\fR, \fB\-\-benchmark\fR BENCH
یک بنچمارک برای اجرا: 'scene(:opt1=val1)*'
(این گزینه می‌تواند چندین بار استفاده شود)
.TP
\fB\-f\fR, \fB\-\-benchmark-file\fR FILE
بارگذاری بنچمارک‌ها برای اجرا از فایلی حاوی فهرستی از توصیف‌های بنچمارک (هر کدام در یک خط)
(این گزینه می‌تواند چندین بار استفاده شود)
.TP
\fB\-\-validate\fR
اجرای یک آزمون اعتبارسنجی سریع خروجی به جای اجرای بنچمارک‌ها
.TP
\fB\-\-data-path\fR PATH
مسیر مدل‌ها، شیدرها و بافت‌های glmark2
.TP
\fB\-\-frame-end\fR METHOD
نحوه پایان دادن به یک فریم [default,none,swap,finish,readpixels]
.TP
\fB\-\-swap-mode\fR MODE
نحوه تعویض فریم (swap)، تمامی حالت‌ها فقط در نسخهٔ DRM پشتیبانی می‌شوند؛ حالت 'fifo' در تمامی نسخه‌ها برای تحمیل vsync در دسترس است [default,immediate,mailbox,fifo]
.TP
\fB\-\-off-screen\fR
رندر کردن روی یک سطح خارج از صفحه نمایش (off-screen)
.TP
\fB--visual-config\fR
پیکربندی بصری برای استفاده در هدف رندر:
\'id=ID:red=R:green=G:blue=B:alpha=A:buffer=BUF:stencil=STENCIL:samples=SAMPLES'.
پارامترها می‌توانند به هر ترتیبی تعریف شوند، و مقادیر پارامترهای حذف‌شده برابر با مقدار پیش‌فرض '0' (برای id، stencil، samples) یا '1' (برای red، green، blue، alpha، buffer) در نظر گرفته می‌شوند.
اگر 'id' بر روی مقداری غیر از صفر تنظیم شود، تمامی پارامترهای دیگر نادیده گرفته می‌شوند
.TP
\fB\-\-reuse\-context\fR
استفاده از یک بافتار (context) واحد برای تمامی صحنه‌ها
(به‌طور پیش‌فرض، هر صحنه بافتار مخصوص به خود را دریافت می‌کند)
.TP
\fB\-s\fR, \fB\-\-size\fR WxH
اندازهٔ پنجرهٔ خروجی (پیش‌فرض: 800x600)
.TP
\fB\-\-fullscreen\fR
اجرا در حالت تمام‌صفحه (معادل با --size -1x-1)
.TP
\fB\-\-results\fR RESULTS
انواع نتایجی که باید برای هر بنچمارک گزارش شوند، به صورت فهرستی جدا شده با ':' [fps,cpu,shader]
.TP
\fB\-\-results-file\fR RESULTS-FILE
فایلی که نتایج در آن ذخیره می‌شوند، در قالبی که با پسوند فایل تعیین می‌شود [csv,xml]
.TP
\fB\-\-winsys-options\fR OPTS
فهرستی از جفت‌های 'opt=value' برای گزینه‌های مختص سامانه پنجره‌بندی، جدا شده با ':'
.TP
\fB\-l\fR, \fB\-\-list\-scenes\fR
نمایش اطلاعات دربارهٔ صحنه‌های موجود و گزینه‌های آن‌ها
.TP
\fB\-\-show-all-options\fR
نمایش مقادیر تمامی گزینه‌های صحنه که برای بنچمارک‌ها استفاده شده‌اند
(به‌طور پیش‌فرض تنها گزینه‌هایی که صریحاً تنظیم شده‌اند نمایش داده می‌شوند)
.TP
\fB\-\-run-forever\fR
اجرای نامحدود، با چرخش از بنچمارک آخر به اولین بنچمارک
.TP
\fB\-\-annotate\fR
توضیح‌نویسی و درج اطلاعات روی صفحه برای بنچمارک‌ها
(مشابه -b :show-fps=true:title=#info#)
.TP
\fB\-d\fR, \fB\-\-debug\fR
نمایش پیام‌های اشکال‌زدایی
.TP
\fB\-\-version\fR
نمایش نسخهٔ برنامه
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما
.SH "بنچمارک‌ها (BENCHMARKS)"
برنامهٔ glmark2-wayland مجموعه‌ای از صحنه‌ها را ارائه می‌دهد که می‌توان از آن‌ها برای سنجش جنبه‌های گوناگون کارایی OpenGL (ES) 2.0 استفاده کرد. نحوه رندر شدن هر صحنه از طریق مجموعه‌ای از گزینه‌ها قابل پیکربندی است. برای مشاهدهٔ صحنه‌های در دسترس و گزینه‌های پذیرفتنی آن‌ها می‌توانید از گزینهٔ خط فرمان \fB\-l\fR, \fB\-\-list\-scenes\fR استفاده کنید.

در glmark2-wayland، یک بنچمارک به صورت یک صحنه به همراه مجموعه‌ای از مقادیر گزینه‌ها تعریف می‌شود. شما می‌توانید فهرست و ترتیب بنچمارک‌های اجرایی را با استفاده از گزینهٔ خط فرمان \fB\-b\fR, \fB\-\-benchmark\fR (احتمالاً چند باره) مشخص کنید. اگر هیچ بنچمارکی مشخص نشده باشد، مجموعه‌ای پیش‌فرض از بنچمارک‌ها به کار می‌رود. چنانچه یکی از گزینه‌های بنچمارک مشخص نشود، مقدار پیش‌فرض خود را اتخاذ می‌کند (که با \fB\-l\fR, \fB\-\-list\-scenes\fR فهرست شده است).

به‌عنوان یک مورد خاص، یک رشتهٔ توصیف بنچمارک مجاز است شامل نام صحنه نباشد (یعنی با ':' آغاز شود). در این حالت، هر مقدار گزینهٔ مشخص‌شده به عنوان مقادیر پیش‌فرض برای بنچمارک‌هایی که پس از این رشتهٔ توصیف می‌آیند استفاده می‌شود.

.SH "مثال‌ها (EXAMPLES)"
برای اجرای بنچمارک‌های پیش‌فرض:
.PP
.RS
\fBglmark2-wayland\fR
.RE
.PP
برای اجرای یک بنچمارک با استفاده از صحنهٔ 'shading' با 'duration' (مدت زمان) '5.0' ثانیه و 'shading' از نوع 'phong':
.PP
.RS
\fBglmark2-wayland -b shading:duration=5.0:shading=phong\fR
.RE
.PP
برای اجرای مجموعه‌ای از بنچمارک‌ها، از گزینهٔ خط فرمان \fB\-b\fR, \fB\-\-benchmark\fR چندین بار استفاده کنید:
.PP
.RS
\fBglmark2-wayland -b shading:duration=5.0 -b build:use-vbo=false -b texture\fR
.RE
.PP
برای تنظیم مقادیر پیش‌فرض گزینه‌ها برای بنچمارک‌ها:
.PP
.RS
\fBglmark2-wayland -b :duration=2.0 -b shading -b build -b :duration=5.0 -b texture\fR
.RE
.PP

.SH "نویسندگان (AUTHORS)"
برنامهٔ glmark2-wayland توسط Alexandros Frantzis و Jesse Barker بر اساس نسخهٔ اصلی glmark اثر Ben Smith نوشته شده است.