.TH GLMARK2-ES2-WAYLAND "1" "January 2023" "glmark2-es2-wayland 2023.01"
.SH "نام (NAME)"
glmark2-es2-wayland \- مجموعه بنچمارک و ارزیابی کارایی OpenGL (ES) 2.0
.SH "خلاصه دستور (SYNOPSIS)"
.B glmark2-es2-wayland
[\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
دستور \fBglmark2-es2-wayland\fP یک ابزار بنچمارک برای OpenGL (ES) 2.0 در محیط وی‌لند (Wayland) است. این برنامه تنها از زیرمجموعه‌ای از رابط برنامه‌نویسی (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
نحوه جابه‌جایی فریم؛ تمامی حالت‌ها تنها در ساختار 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-es2-wayland مجموعه‌ای از صحنه‌ها را ارائه می‌دهد که می‌توانند برای سنجش جنبه‌های گوناگون کارایی OpenGL (ES) 2.0 به کار روند. نحوه رندر شدن هر صحنه از طریق مجموعه‌ای از گزینه‌ها قابل پیکربندی است. برای مشاهده صحنه‌های موجود و گزینه‌های مجاز آن‌ها می‌توانید از گزینه خط فرمان \fB\-l\fR, \fB\-\-list\-scenes\fR استفاده نمایید.

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

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

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

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