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

نام (NAME)
       glmark2-es2 - مجموعه محک و ارزیابی کارایی OpenGL (ES) 2.0

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

توضیحات (DESCRIPTION)
       دستور glmark2-es2 ابزاری برای محک و ارزیابی کارایی (بنچ‌مارک) 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
              مسیر مدل‌ها، شیدرها و بافت‌های glmark2

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

       --swap-mode MODE
              نحوه جابه‌جایی فریم؛ تمام حالت‌ها فقط در طعم 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) واحد برای همه صحنه‌ها (به طور
              پیش‌فرض، هر صحنه زمینه اختصاصی خود را دریافت می‌کند)

       -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-es2 مجموعه‌ای از صحنه‌ها را فراهم می‌کند که می‌توان از آن‌ها
       برای اندازه‌گیری جنبه‌های متعددی از کارایی OpenGL (ES) 2.0 استفاده کرد.
       نحوه رندر شدن هر صحنه از طریق مجموعه‌ای از گزینه‌ها قابل پیکربندی است.
       برای به دست آوردن صحنه‌های موجود و گزینه‌های قابل قبول آن‌ها می‌توانید از
       گزینه خط فرمان -l, --list-scenes استفاده کنید.

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

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

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

              glmark2-es2

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

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

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

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

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

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

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

glmark2-es2 2023.01              January 2023                   GLMARK2-ES2(1)