GLMARK2-EGL(1)              General Commands Manual             GLMARK2-EGL(1)

نام (NAME)
       glmark2-egl - مجموعه بنچمارک OpenGL (ES) 2.0

خلاصه دستور (SYNOPSIS)
       glmark2-egl [گزینه‌ها]

توضیحات (DESCRIPTION)
       glmark2-egl ابزاری برای سنجش کارایی (بنچمارک) OpenGL (ES) 2.0 است. این
       ابزار تنها از زیرمجموعه‌ای از رابط برنامه‌نویسی (API) نسخه OpenGL 2.0
       استفاده می‌کند که با OpenGL ES 2.0 سازگار باشد.

گزینه‌ها (OPTIONS)
       -b, --benchmark BENCH
              یک بنچمارک برای اجرا: 'scene(:opt1=val1)*' (این گزینه می‌تواند
              چندین بار استفاده شود)

       -f, --benchmark-file FILE
              بارگذاری بنچمارک‌ها برای اجرا از یک فایل حاوی فهرستی از توصیفات
              بنچمارک (در هر خط یکی) (این گزینه می‌تواند چندین بار استفاده شود)

       --validate
              اجرای یک آزمون اعتبارسنجی سریع خروجی به جای اجرای بنچمارک‌ها

       --data-path PATH
              مسیر مدل‌ها، شیدرها (shaders) و بافت‌های (textures) ابزار glmark2

       --frame-end METHOD
              نحوه پایان دادن به یک فریم [default,none,swap,finish,readpixels]

       --swap-mode MODE
              نحوه جابه‌جایی فریم (swap)؛ همه حالت‌ها تنها در نوع DRM پشتیبانی
              می‌شوند، حالت 'fifo' در همه نوع‌ها برای اجبار vsync در دسترس است
              [default,immediate,mailbox,fifo]

       --off-screen
              رندر گرفتن روی یک سطح خارج از صفحه (off-screen)

       --visual-config
              پیکربندی بصری مورد استفاده برای هدف رندر:
              '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' روی
              مقداری غیر از صفر تنظیم شود، سایر پارامترها نادیده گرفته می‌شوند

       --reuse-context
              استفاده از یک بافتار (context) واحد برای همه صحنه‌ها (به‌طور
              پیش‌فرض، هر صحنه context اختصاصی خود را دریافت می‌کند)

       -s, --size WxH
              اندازه پنجره خروجی (پیش‌فرض: 800x600)

       --fullscreen
              اجرا در حالت تمام‌صفحه (معادل --size -1x-1)

       --results RESULTS
              انواع نتایج برای گزارش در هر بنچمارک، به صورت فهرستی جدا شده با
              ':' [fps,cpu,shader]

       --results-file RESULTS-FILE
              فایلی برای ذخیره نتایج، در قالبی که با پسوند فایل تعیین می‌شود
              [csv,xml]

       --winsys-options OPTS
              فهرستی از جفت‌های 'opt=value' برای گزینه‌های مختص سیستم پنجره‌بندی،
              جدا شده با ':'

       -l, --list-scenes
              نمایش اطلاعات درباره صحنه‌های موجود و گزینه‌های آن‌ها

       --show-all-options
              نمایش تمام مقادیر گزینه‌های صحنه استفاده‌شده برای بنچمارک‌ها (به‌طور
              پیش‌فرض تنها گزینه‌هایی که صراحتاً تنظیم شده‌اند نشان داده می‌شوند)

       --run-forever
              اجرای نامحدود، با تکرار مداوم در یک حلقه از آخرین بنچمارک به
              اولین بنچمارک

       --annotate
              حاشیه‌نویسی بنچمارک‌ها با اطلاعات روی صفحه (مشابه -b :show-
              fps=true:title=#info#)

       -d, --debug
              نمایش پیام‌های اشکال‌زدایی

       --version
              نمایش نسخه برنامه

       -h, --help
              نمایش راهنما

بنچمارک‌ها (BENCHMARKS)
       برنامه glmark2-egl مجموعه‌ای از صحنه‌ها را فراهم می‌کند که می‌توان از آن‌ها
       برای اندازه‌گیری جنبه‌های متعددی از کارایی OpenGL (ES) 2.0 استفاده کرد.
       نحوه رندر شدن هر صحنه از طریق مجموعه‌ای از گزینه‌ها قابل پیکربندی است.
       برای مشاهده صحنه‌های موجود و گزینه‌های مجاز آن‌ها می‌توانید از گزینه خط
       فرمان -l، --list-scenes استفاده کنید.

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

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


مثال‌ها (EXAMPLES)
       برای اجرای بنچمارک‌های پیش‌فرض:

              glmark2-egl

       برای اجرای یک بنچمارک با استفاده از صحنه 'shading' با مدت زمان
       ('duration') برابر '5.0' ثانیه و نوع شیدینگ 'phong':

              glmark2-egl -b shading:duration=5.0:shading=phong

       برای اجرای مجموعه‌ای از بنچمارک‌ها، گزینه خط فرمان -b، --benchmark را
       چندین بار به کار ببرید:

              glmark2-egl -b shading:duration=5.0 -b build:use-vbo=false -b
              texture

       برای تنظیم مقادیر پیش‌فرض گزینه‌ها برای بنچمارک‌ها:

              glmark2-egl -b :duration=2.0 -b shading -b build -b
              :duration=5.0 -b texture

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

glmark2-egl 2023.01              January 2023                   GLMARK2-EGL(1)