.TH GLMARK2-EGL "1" "January 2023" "glmark2-egl 2023.01"
.SH "نام (NAME)"
glmark2-egl \- مجموعه بنچمارک OpenGL (ES) 2.0
.SH "خلاصه دستور (SYNOPSIS)"
.B glmark2-egl [گزینه‌ها]
.SH "توضیحات (DESCRIPTION)"
\fBglmark2-egl\fP ابزاری برای سنجش کارایی (بنچمارک) OpenGL (ES) 2.0 است. این ابزار تنها از زیرمجموعه‌ای از رابط برنامه‌نویسی (API) نسخه OpenGL 2.0 استفاده می‌کند که با OpenGL ES 2.0 سازگار باشد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-b\fR, \fB\-\-benchmark\fR BENCH
یک بنچمارک برای اجرا: \(aqscene(:opt1=val1)*\(aq
(این گزینه می‌تواند چندین بار استفاده شود)
.TP
\fB\-f\fR, \fB\-\-benchmark-file\fR FILE
بارگذاری بنچمارک‌ها برای اجرا از یک فایل حاوی فهرستی از توصیفات بنچمارک (در هر خط یکی)
(این گزینه می‌تواند چندین بار استفاده شود)
.TP
\fB\-\-validate\fR
اجرای یک آزمون اعتبارسنجی سریع خروجی به جای اجرای بنچمارک‌ها
.TP
\fB\-\-data-path\fR PATH
مسیر مدل‌ها، شیدرها (shaders) و بافت‌های (textures) ابزار glmark2
.TP
\fB\-\-frame-end\fR METHOD
نحوه پایان دادن به یک فریم [default,none,swap,finish,readpixels]
.TP
\fB\-\-swap-mode\fR MODE
نحوه جابه‌جایی فریم (swap)؛ همه حالت‌ها تنها در نوع DRM پشتیبانی می‌شوند، حالت \(aqfifo\(aq در همه نوع‌ها برای اجبار vsync در دسترس است [default,immediate,mailbox,fifo]
.TP
\fB\-\-off-screen\fR
رندر گرفتن روی یک سطح خارج از صفحه (off-screen)
.TP
\fB--visual-config\fR
پیکربندی بصری مورد استفاده برای هدف رندر:
\(aqid=ID:red=R:green=G:blue=B:alpha=A:buffer=BUF:stencil=STENCIL:samples=SAMPLES\(aq.
پارامترها می‌توانند به هر ترتیبی تعریف شوند و مقادیر پیش‌فرض برای هر پارامتر حذف‌شده برابر \(aq0\(aq (برای id، stencil، samples) یا \(aq1\(aq (برای red، green، blue، alpha، buffer) خواهد بود.
اگر \(aqid\(aq روی مقداری غیر از صفر تنظیم شود، سایر پارامترها نادیده گرفته می‌شوند
.TP
\fB\-\-reuse\-context\fR
استفاده از یک بافتار (context) واحد برای همه صحنه‌ها
(به‌طور پیش‌فرض، هر صحنه 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
فهرستی از جفت‌های \(aqopt=value\(aq برای گزینه‌های مختص سیستم پنجره‌بندی، جدا شده با ':'
.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-egl مجموعه‌ای از صحنه‌ها را فراهم می‌کند که می‌توان از آن‌ها برای اندازه‌گیری جنبه‌های متعددی از کارایی OpenGL (ES) 2.0 استفاده کرد. نحوه رندر شدن هر صحنه از طریق مجموعه‌ای از گزینه‌ها قابل پیکربندی است. برای مشاهده صحنه‌های موجود و گزینه‌های مجاز آن‌ها می‌توانید از گزینه خط فرمان \fB\-l\fR، \fB\-\-list\-scenes\fR استفاده کنید.

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

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

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

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