.TH vkmark "1" "January 2025" "vkmark 2025.01"
.SH "نام (NAME)"
vkmark \- مجموعه ابزار سنجش کارایی (بنچمارک) Vulkan
.SH "خلاصه دستور (SYNOPSIS)"
.B vkmark [گزینه‌ها]
.SH "توضیحات (DESCRIPTION)"
\fBvkmark\fP یک مجموعه ابزار سنجش کارایی Vulkan با قابلیت گسترش است که از صحنه‌های هدفمند و قابل پیکربندی بهره می‌برد.
.SH "گزینه‌ها (OPTIONS)"
.TP
\fB\-b\fR, \fB\-\-benchmark\fR BENCH
یک بنچمارک برای اجرا: 'scene(:opt1=val1)*'
(از این گزینه می‌توان چندین بار استفاده کرد)
.TP
\fB\-s\fR, \fB\-\-size\fR WxH
اندازه پنجره خروجی (پیش‌فرض: 800x600)
.TP
\fB\-\-fullscreen\fR
اجرا در حالت تمام‌صفحه (معادل با \-\-size \-1x\-1)
.TP
\fB\-p\fR, \fB\-\-present-mode\fR PM
حالت ارائه Vulkan (پیش‌فرض: mailbox)
[immediate, mailbox, fifo, fiforelaxed]
.TP
\fB\-\-pixel-format\fR PF
قالب پیکسل Vulkan (پیش‌فرض: انتخاب بهترین)
.TP
\fB\-l\fR, \fB\-\-list\-scenes\fR
نمایش اطلاعات درباره صحنه‌های موجود و گزینه‌های آن‌ها
.TP
\fB\-\-show-all-options\fR
نمایش تمام مقادیر گزینه‌های صحنه استفاده‌شده برای بنچمارک‌ها
(به‌طور پیش‌فرض تنها گزینه‌هایی که صریحاً تنظیم شده‌اند نمایش داده می‌شوند)
.TP
\fB\-\-winsys-dir\fR DIR
دایرکتوری برای جستجوی افزایه‌های سامانه پنجره
.TP
\fB\-\-data-dir\fR DIR
دایرکتوری برای جستجوی فایل‌های داده صحنه
.TP
\fB\-\-winsys\fR WS
افزایه سامانه پنجره برای استفاده (پیش‌فرض: انتخاب بهترین)
[xcb, wayland, kms]
.TP
\fB\-\-winsys-options\fR OPTS
گزینه‌های سامانه پنجره به‌صورت 'opt1=val1(:opt2=val2)*'
.TP
\fB\-\-run-forever\fR
اجرای نامحدود، با تکرار چرخشی از آخرین بنچمارک به اولین بنچمارک
.TP
\fB\-d\fR, \fB\-\-debug\fR
نمایش پیام‌های اشکال‌زدایی
.TP
\fB\-D\fR, \fB\-\-use-device\fR
استفاده از دستگاه Vulkan با UUID مشخص‌شده
.TP
\fB\-L\fR, \fB\-\-list-devices\fR
فهرست کردن دستگاه‌های Vulkan
.TP
\fB\-h\fR, \fB\-\-help\fR
نمایش راهنما
.SH "بنچمارک‌ها (BENCHMARKS)"
vkmark مجموعه‌ای از صحنه‌ها را ارائه می‌دهد که می‌توان از آن‌ها برای سنجش جنبه‌های مختلف کارایی Vulkan استفاده کرد. نحوه رندر هر صحنه از طریق مجموعه‌ای از گزینه‌ها قابل پیکربندی است. برای مشاهده صحنه‌های موجود و گزینه‌های قابل قبول آن‌ها، می‌توانید از گزینه خط فرمان \fB\-l\fR, \fB\-\-list\-scenes\fR استفاده کنید.

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

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

.SH "مثال‌ها (EXAMPLES)"
برای اجرای بنچمارک‌های پیش‌فرض:
.PP
.RS
\fBvkmark\fR
.RE
.PP
برای اجرای یک بنچمارک با استفاده از صحنه 'vertex' با 'duration' برابر با '5.0' ثانیه و تنظیم 'interleave' روی 'false':
.PP
.RS
\fBvkmark -b vertex:duration=5.0:interleave=false\fR
.RE
.PP
برای اجرای یک سری از بنچمارک‌ها، از گزینه خط فرمان \fB\-b\fR, \fB\-\-benchmark\fR چند بار استفاده کنید:
.PP
.RS
\fBvkmark -b vertex:duration=5.0 -b clear:color=1.0,0.5,0 -b cube\fR
.RE
.PP
برای تنظیم مقادیر گزینه‌های پیش‌فرض برای بنچمارک‌ها و اجرای آن‌ها:
.PP
.RS
\fBvkmark -b :duration=2.0 -b vertex -b clear -b :duration=5.0 -b cube\fR
.RE
.PP
برای تنظیم مقادیر گزینه‌های پیش‌فرض برای بنچمارک‌های پیش‌فرض و اجرای آن‌ها:
.PP
.RS
\fBvkmark -b :duration=2.0\fR
.RE
.PP

.SH "نویسندگان (AUTHORS)"
vkmark توسط Alexandros Frantzis نوشته شده است.