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

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

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

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

.SH "نویسنده (AUTHOR)"
برنامه glmark2-es2-drm توسط Alexandros Frantzis و Jesse Barker بر پایه glmark اصلی نوشته‌شده توسط Ben Smith توسعه داده شده است.