.TH GLMARK2-DRM "1" "January 2023" "glmark2-drm 2023.01"
.SH "نام (NAME)"
glmark2-drm \- مجموعه بنچمارک OpenGL (ES) 2.0 برای DRM
.SH "خلاصه دستور (SYNOPSIS)"
.B glmark2-drm
[\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
.B glmark2-drm
یک ابزار بنچمارک و سنجش کارایی برای OpenGL (ES) 2.0 است. این برنامه تنها از زیرمجموعه‌ای از رابط برنامه‌نویسی (API) نسخه OpenGL 2.0 استفاده می‌کند که با OpenGL ES 2.0 سازگار است.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-b\fR, \fB\-\-benchmark\fR \fIBENCH\fR
اجرای یک بنچمارک مشخص: 'scene(:opt1=val1)*'
(این گزینه می‌تواند چندین بار استفاده شود)
.TP
\fB\-f\fR, \fB\-\-benchmark-file\fR \fIFILE\fR
بارگذاری بنچمارک‌ها برای اجرا از فایلی حاوی فهرستی از توصیفات بنچمارک (یک مورد در هر خط)
(این گزینه می‌تواند چندین بار استفاده شود)
.TP
\fB\-\-validate\fR
اجرای یک تست سریع اعتبارسنجی خروجی به جای اجرای بنچمارک‌ها
.TP
\fB\-\-data-path\fR \fIPATH\fR
مسیر مدل‌ها، سایه‌زن‌ها (shaders) و بافت‌های (textures) برنامه glmark2
.TP
\fB\-\-frame-end\fR \fIMETHOD\fR
نحوه خاتمه دادن به یک فریم [default,none,swap,finish,readpixels]
.TP
\fB\-\-swap-mode\fR \fIMODE\fR
نحوه جابه‌جایی فریم (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 \fIWxH\fR
اندازه پنجره خروجی (پیش‌فرض: 800x600)
.TP
\fB\-\-fullscreen\fR
اجرا در حالت تمام‌صفحه (معادل --size -1x-1)
.TP
\fB\-\-results\fR \fIRESULTS\fR
انواع نتایج برای گزارش در هر بنچمارک، به صورت فهرستی با جداکننده ':' شامل [fps,cpu,shader]
.TP
\fB\-\-results-file\fR \fIRESULTS-FILE\fR
فایل ذخیره نتایج، در قالبی که بر اساس پسوند فایل مشخص می‌شود [csv,xml]
.TP
\fB\-\-winsys-options\fR \fIOPTS\fR
فهرستی از جفت‌های '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)"
برنامه
.B glmark2-drm
مجموعه‌ای از صحنه‌ها را فراهم می‌کند که می‌توانند برای سنجش جنبه‌های مختلف کارایی OpenGL (ES) 2.0 به کار روند. نحوه رندر هر صحنه از طریق مجموعه‌ای از گزینه‌ها قابل پیکربندی است. برای دریافت صحنه‌های موجود و گزینه‌های قابل قبول آن‌ها می‌توانید از گزینه خط فرمان
.BR \-l ,
.B \-\-list\-scenes
استفاده کنید.
.PP
در
.BR glmark2-drm ,
یک بنچمارک به صورت یک صحنه به همراه مجموعه‌ای از مقادیر گزینه‌ها تعریف می‌شود. می‌توانید فهرست و ترتیب بنچمارک‌های اجرایی را با استفاده از گزینه خط فرمان
.BR \-b ,
.B \-\-benchmark
(احتمالاً چندین بار) مشخص کنید. اگر هیچ بنچمارکی تعیین نشود، یک مجموعه پیش‌فرض از بنچمارک‌ها استفاده خواهد شد. اگر گزینه‌ای برای یک بنچمارک تعیین نشود، مقدار پیش‌فرض خود را می‌گیرد (که با
.BR \-l ,
.B \-\-list\-scenes
فهرست شده است).
.PP
به عنوان یک حالت ویژه، یک رشته توصیف بنچمارک می‌تواند فاقد نام صحنه باشد (یعنی با ':' شروع شود). در این حالت، مقادیر گزینه‌های مشخص‌شده به عنوان مقادیر پیش‌فرض برای بنچمارک‌های بعد از این رشته توصیف استفاده می‌شوند.

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

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