.TH GLMARK2-ES2 "1" "January 2023" "glmark2-es2 2023.01"
.SH "نام (NAME)"
glmark2-es2 \- مجموعه محک و ارزیابی کارایی OpenGL (ES) 2.0
.SH "خلاصه دستور (SYNOPSIS)"
.B glmark2-es2
[\fIگزینه‌ها\fR]
.SH "توضیحات (DESCRIPTION)"
دستور
\fBglmark2-es2\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
نحوه جابه‌جایی فریم؛ تمام حالت‌ها فقط در طعم 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 مجموعه‌ای از صحنه‌ها را فراهم می‌کند که می‌توان از آن‌ها برای اندازه‌گیری جنبه‌های متعددی از کارایی OpenGL (ES) 2.0 استفاده کرد. نحوه رندر شدن هر صحنه از طریق مجموعه‌ای از گزینه‌ها قابل پیکربندی است. برای به دست آوردن صحنه‌های موجود و گزینه‌های قابل قبول آن‌ها می‌توانید از گزینه خط فرمان
\fB\-l\fR, \fB\-\-list\-scenes\fR
استفاده کنید.
.PP
در glmark2-es2، یک بنچ‌مارک به عنوان یک صحنه به علاوه مجموعه‌ای از مقادیر گزینه‌ها تعریف می‌شود. می‌توانید فهرست و ترتیب بنچ‌مارک‌ها را برای اجرا با استفاده از گزینه خط فرمان
\fB\-b\fR, \fB\-\-benchmark\fR
(احتمالاً چند بار) مشخص کنید. اگر هیچ بنچ‌مارکی مشخص نشود، مجموعه‌ای پیش‌فرض از بنچ‌مارک‌ها استفاده می‌شود. اگر یک گزینه بنچ‌مارک مشخص نشود، مقدار پیش‌فرض خود را به کار می‌گیرد (که با
\fB\-l\fR, \fB\-\-list\-scenes\fR
فهرست شده است).
.PP
به عنوان یک حالت ویژه، رشته توصیف یک بنچ‌مارک مجاز است که نام صحنه را نداشته باشد (یعنی با ':' شروع شود). در این حالت، مقادیر گزینه‌های مشخص‌شده به عنوان مقادیر پیش‌فرض برای بنچ‌مارک‌های بعدی این رشته توصیف به کار می‌روند.
.SH "مثال‌ها (EXAMPLES)"
برای اجرای بنچ‌مارک‌های پیش‌فرض:
.PP
.RS
\fBglmark2-es2\fR
.RE
.PP
برای اجرای یک بنچ‌مارک با استفاده از صحنه 'shading' با مدت زمان '5.0' ثانیه و سایه‌زنی از نوع 'phong':
.PP
.RS
\fBglmark2-es2 -b shading:duration=5.0:shading=phong\fR
.RE
.PP
برای اجرای مجموعه‌ای از بنچ‌مارک‌ها، گزینه خط فرمان
\fB\-b\fR, \fB\-\-benchmark\fR
را چندین بار به کار ببرید:
.PP
.RS
\fBglmark2-es2 -b shading:duration=5.0 -b build:use-vbo=false -b texture\fR
.RE
.PP
برای تنظیم مقادیر پیش‌فرض گزینه‌ها برای بنچ‌مارک‌ها:
.PP
.RS
\fBglmark2-es2 -b :duration=2.0 -b shading -b build -b :duration=5.0 -b texture\fR
.RE
.PP
.SH "نویسندگان (AUTHORS)"
برنامه glmark2-es2 توسط Alexandros Frantzis و Jesse Barker بر پایه نسخه اصلی glmark نوشته Ben Smith توسعه داده شده است.