نام (NAME)

Xvfb - کارگزار X با فریم‌بافر مجازی برای X Version 11

خلاصه دستور (SYNOPSIS)

Xvfb [ گزینه ] ...

توضیحات (DESCRIPTION)

Xvfb یک کارگزار X است که می‌تواند بر روی سیستم‌های فاقد سخت‌افزار نمایشگر و بدون دستگاه‌های ورودی فیزیکی اجرا شود. این برنامه با استفاده از حافظهٔ مجازی، یک فریم‌بافر ساده را شبیه‌سازی می‌کند.

هدف و کاربرد اولیهٔ این کارگزار، آزمایش خود کارگزار بوده است. کدهای fb برای هر عمق رنگی می‌توانند بدون نیاز به سخت‌افزار واقعیِ پشتیبانی‌کننده از آن عمق، توسط این کارگزار ارزیابی و اجرا شوند. جامعهٔ کاربری X کاربردهای نوآورانهٔ بسیار دیگری برای Xvfb یافته است، از جمله آزمایش برنامه‌های کلاینت در برابر عمق‌های رنگی و پیکربندی‌های نامتعارف صفحه، انجام پردازش دسته‌ای با استفاده از Xvfb به عنوان موتور رندرینگ پس‌زمینه، آزمون بار، کمک به پورت کردن کارگزار X به یک بستر جدید، و فراهم کردن راهکاری نامحسوس برای اجرای برنامه‌هایی که واقعاً نیازی به کارگزار X ندارند اما در هر حال بر وجود آن اصرار می‌ورزند.

گزینه‌ها (OPTIONS)

علاوه بر گزینه‌های معمول کارگزار که در صفحهٔ راهنمای Xserver(1) تشریح شده‌اند، Xvfb سوئیچ‌های خط فرمان زیر را نیز می‌پذیرد:

-screen screennum WxHxD: این گزینه صفحهٔ screennum را ایجاد کرده و عرض، ارتفاع و عمق رنگ آن را به ترتیب روی W و H و D تنظیم می‌کند. به طور پیش‌فرض، فقط صفحهٔ 0 وجود دارد و دارای ابعاد 1280x1024x24 است.
-pixdepths list-of-depths: این گزینه فهرستی از عمق‌های pixmap را مشخص می‌کند که کارگزار باید علاوه بر عمق‌های مرتبط با صفحه‌های پشتیبانی‌شده، از آن‌ها نیز پشتیبانی کند. آرگومان list-of-depths فهرستی از اعداد صحیح است که با فاصله از هم جدا شده‌اند و می‌توانند مقادیری بین 1 تا 32 داشته باشند.
-fbdir framebuffer-directory: این گزینه دایرکتوری‌ای را مشخص می‌کند که فایل‌های نگاشت‌شده در حافظه (memory-mapped) حاوی حافظهٔ فریم‌بافر باید در آن ایجاد شوند. بخش «فایل‌ها» را ببینید. این گزینه فقط در سیستم‌هایی وجود دارد که از فراخوان‌های سیستمی mmap و msync پشتیبانی می‌کنند.
-shmem: این گزینه مشخص می‌کند که فریم‌بافر باید در حافظهٔ اشتراکی (shared memory) قرار گیرد. شناسهٔ حافظهٔ اشتراکی (ID) برای هر صفحه توسط کارگزار چاپ خواهد شد. قالب حافظهٔ اشتراکی xwd است. این گزینه تنها در سیستم‌هایی فعال است که از رابط حافظهٔ اشتراکی System V پشتیبانی کنند.

اگر هیچ‌یک از گزینه‌های -shmem یا -fbdir مشخص نشده باشند، حافظهٔ فریم‌بافر با استفاده از ()malloc تخصیص خواهد یافت.

-linebias n: این گزینه نحوهٔ تنظیم پیکسل‌بندی خطوط باریک را تعیین می‌کند. مقدار n یک ماسک بیتی از هشتک‌ها (octants) است که در آن‌ها، هنگامی که عبارت خطای برزنهام (Bresenham) دقیقاً صفر است، یک گام محوری ترجیح داده می‌شود. برای اطلاعات بیشتر فایل Xserver/mi/miline.h را ببینید. این گزینه احتمالاً تنها برای توسعه‌دهندگان کارگزار مفید است تا محدودهٔ پیکسل‌بندی خطوط ممکن با کدهای fb را بیازمایند.
-blackpixel pixel-value, -whitepixel pixel-value: این گزینه‌ها مقادیر پیکسلی رنگ‌های سیاه و سفید را که کارگزار باید استفاده کند مشخص می‌کنند.

فایل‌ها (FILES)

در صورت تعیین گزینهٔ -fbdir، فایل‌های زیر ایجاد می‌شوند:

framebuffer-directory/Xvfb_screen<n>: فایل نگاشت‌شده در حافظه شامل حافظهٔ فریم‌بافر صفحهٔ n (یک فایل به ازای هر صفحه). این فایل در قالب xwd است. بنابراین، گرفتن یک نماگرفت کامل از صفحه می‌تواند تنها با یک دستور رونوشت فایل انجام شود، و نماگرفت حاصل حتی شامل تصویر مکان‌نما نیز خواهد بود.

مثال‌ها (EXAMPLES)

Xvfb :1 -screen 0 1600x1200x24: کارگزار به عنوان کارگزار شمارهٔ 1 به اتصالات گوش می‌دهد، و صفحهٔ 0 با ابعاد 1600x1200 و عمق رنگ 24 خواهد بود.
Xvfb :1 -screen 1 1600x1200x16: کارگزار به عنوان کارگزار شمارهٔ 1 به اتصالات گوش می‌دهد، صفحهٔ 0 پیکربندی پیش‌فرض (1280x1024x24) را خواهد داشت، و صفحهٔ 1 با ابعاد 1600x1200 و عمق رنگ 16 تنظیم می‌شود.
Xvfb -pixdepths 3 27 -fbdir /var/tmp: کارگزار به عنوان کارگزار شمارهٔ 0 به اتصالات گوش می‌دهد، پیکربندی پیش‌فرض صفحه (یک صفحه با ابعاد 1280x1024x24) را اعمال می‌کند، از عمق‌های pixmap با مقادیر 3 و 27 پشتیبانی خواهد کرد، و از فایل‌های نگاشت‌شده در حافظه در /var/tmp برای فریم‌بافر بهره می‌گیرد.
xwud -in /var/tmp/Xvfb_screen0: صفحهٔ 0 کارگزاری را که در مثال پیشین آغاز شده است، نمایش می‌دهد.

همچنین ببینید (SEE ALSO)

X(7), Xserver(1), xwd(1), xwud(1), XWDFile.h

نویسندگان (AUTHORS)

David P. Wiggins, The Open Group, Inc.