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

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

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

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

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

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


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

              glmark2-drm

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

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

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

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

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

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

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

glmark2-drm 2023.01              January 2023                   GLMARK2-DRM(1)