نام (NAME)

fbset - نمایش و تغییر تنظیمات دستگاه فریم‌بافر

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

fbset [گزینه‌ها] [حالت]

توضیحات (DESCRIPTION)

این مستندات قدیمی هستند!!

fbset یک ابزار سیستمی برای نمایش یا تغییر تنظیمات دستگاه فریم‌بافر (frame buffer) است. دستگاه فریم‌بافر رابطی ساده و یکتا برای دسترسی به انواع مختلف نمایشگرهای گرافیکی فراهم می‌کند.

دسترسی به دستگاه‌های فریم‌بافر از طریق گره‌های دستگاهی ویژه واقع در دایرکتوری /dev انجام می‌شود. طرح نام‌گذاری این گره‌ها همواره به صورت fb<n>, است، که در آن n شماره دستگاه فریم‌بافر مورد استفاده است.

fbset از پایگاه‌داده حالت‌های ویدئویی اختصاصی خود در مسیر /etc/fb.modes استفاده می‌کند. تعداد نامحدودی از حالت‌های ویدئویی را می‌توان در این پایگاه‌داده تعریف کرد. برای کسب اطلاعات بیشتر به fb.modes(5) مراجعه کنید.

گزینه‌ها (OPTIONS)

اگر هیچ گزینه‌ای مشخص نشود، fbset تنظیمات جاری فریم‌بافر را نمایش خواهد داد.

گزینه‌های عمومی:

--help, -h: نمایش اطلاعات نحوه استفاده
--now, -n: تغییر فوری حالت ویدئویی. اگر هیچ دستگاه فریم‌بافری با استفاده از -fb مشخص نشده باشد، این گزینه به صورت پیش‌فرض فعال است.
--show, -s: نمایش تنظیمات حالت ویدئویی. این حالت در صورتی که گزینه دیگری مشخص نشود یا فقط یک دستگاه فریم‌بافر با -fb مشخص گردد، پیش‌فرض است.
--info, -i: نمایش تمامی اطلاعات موجود فریم‌بافر
--verbose, -v: نمایش اطلاعات درباره عملیاتی که fbset در حال حاضر انجام می‌دهد
--version, -V: نمایش اطلاعات نسخه fbset
--xfree86, -x: نمایش اطلاعات زمان‌بندی به شکلی که برای XFree86 مورد نیاز است

گره‌های دستگاه فریم‌بافر:

-fb <device>: گره دستگاه فریم‌بافر را مشخص می‌کند. اگر هیچ دستگاهی با -fb مشخص نشده باشد، از /dev/fb0 استفاده می‌شود.

پایگاه‌داده حالت‌های ویدئویی:

-db <file>: تنظیم یک فایل پایگاه‌داده حالت‌های ویدئویی جایگزین (پیش‌فرض /etc/fb.modes است)، همچنین به fb.modes(5) مراجعه کنید.

هندسه نمایشگر (Display geometry):

-xres <value>: تنظیم وضوح افقی قابل مشاهده (بر حسب پیکسل)
-yres <value>: تنظیم وضوح عمودی قابل مشاهده (بر حسب پیکسل)
-vxres <value>: تنظیم وضوح افقی مجازی (بر حسب پیکسل)
-vyres <value>: تنظیم وضوح عمودی مجازی (بر حسب پیکسل)
-depth <value>: تنظیم عمق رنگ نمایشگر (بر حسب بیت بر پیکسل)
--geometry, -g ...: تنظیم هم‌زمان تمامی پارامترهای هندسه به ترتیب <xres> <yres> <vxres> <vyres> <depth>، به عنوان مثال: -g 640 400 640 400 4
-match: تطبیق دادن وضوح فیزیکی با وضوح مجازی

زمان‌بندی‌های نمایشگر (Display timings):

-pixclock <value>: تنظیم طول مدت یک پیکسل (بر حسب پیکوثانیه). توجه داشته باشید که دستگاه فریم‌بافر ممکن است فقط از برخی طول‌های پیکسل پشتیبانی کند.
-left <value>: تنظیم حاشیه چپ (بر حسب پیکسل)
-right <value>: تنظیم حاشیه راست (بر حسب پیکسل)
-upper <value>: تنظیم حاشیه بالا (بر حسب خطوط پیکسلی)
-lower <value>: تنظیم حاشیه پایین (بر حسب خطوط پیکسلی)
-hslen <value>: تنظیم طول همگام‌سازی افقی (بر حسب پیکسل)
-vslen <value>: تنظیم طول همگام‌سازی عمودی (بر حسب خطوط پیکسلی)
--timings, -t ...: تنظیم هم‌زمان تمامی پارامترهای زمان‌بندی به ترتیب <pixclock> <left> <right> <upper> <lower> <hslen> <vslen>، به عنوان مثال: -g 35242 64 96 35 12 112 2

پرچم‌های نمایشگر (Display flags):

-hsync {low|high}: تنظیم قطبیت همگام‌سازی افقی
-vsync {low|high}: تنظیم قطبیت همگام‌سازی عمودی
-csync {low|high}: تنظیم قطبیت همگام‌سازی ترکیبی (composite sync)
-extsync {false|true}: فعال یا غیرفعال کردن همگام‌سازی مجدد خارجی. در صورت فعال بودن، زمان‌بندی‌های همگام‌سازی توسط دستگاه فریم‌بافر تولید نمی‌شوند و در عوض باید از خارج تأمین گردند. توجه داشته باشید که ممکن است این گزینه توسط تمام دستگاه‌های فریم‌بافر پشتیبانی نشود.
-bcast {false|true}: فعال یا غیرفعال کردن حالت‌های پخش همگانی (broadcast). در صورت فعال بودن، فریم‌بافر زمان‌بندی‌های دقیق را برای چندین حالت پخش همگانی (مانند PAL یا NTSC) تولید می‌کند. توجه داشته باشید که ممکن است این گزینه توسط تمام دستگاه‌های فریم‌بافر پشتیبانی نشود.
-laced {false|true}: فعال یا غیرفعال کردن حالت درهم‌بافته (interlace). در صورت فعال بودن، تصویر نمایشگر به دو فریم تقسیم می‌شود که هر فریم به ترتیب فقط شامل خطوط زوج یا فرد است. این دو فریم به صورت متناوب نمایش داده می‌شوند؛ بدین ترتیب تعداد خطوط قابل نمایش دو برابر شده و فرکانس عمودی مانیتور ثابت می‌ماند، اما فرکانس عمودی قابل مشاهده نصف می‌شود.
-double {false|true}: فعال یا غیرفعال کردن اسکن دوگانه (doublescan). در صورت فعال بودن، هر خط دو بار نمایش داده می‌شود و بدین ترتیب فرکانس افقی به آسانی می‌تواند دو برابر شود، تا بتوان همان وضوح را روی مانیتورهای مختلف نمایش داد، حتی اگر مشخصات فرکانس افقی آن‌ها متفاوت باشد. توجه داشته باشید که ممکن است این گزینه توسط تمام دستگاه‌های فریم‌بافر پشتیبانی نشود.

موقعیت‌یابی تصویر نمایشگر (Display positioning):

-move {left|right|up|down}: انتقال بخش قابل مشاهده نمایشگر در جهت مشخص‌شده
-step <value>: تنظیم اندازه گام برای موقعیت‌یابی نمایشگر (بر حسب پیکسل یا خطوط پیکسلی). اگر -step مشخص نشود، تصویر به اندازه ۸ پیکسل به صورت افقی یا ۲ خط پیکسلی به صورت عمودی منتقل خواهد شد.

مثال‌ها (EXAMPLES)

برای تنظیم حالت ویدئویی مورد استفاده برای X خط زیر را در rc.local قرار دهید:

fbset -fb /dev/fb0 vga

و برای معرفی دستگاه فریم‌بافر مورد استفاده به X:

export FRAMEBUFFER=/dev/fb0

فایل‌ها (FILES)

/dev/fb*
/etc/fb.modes

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

fb.modes(5), fbdev(4)

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

Geert Uytterhoeven <Geert.Uytterhoeven@cs.kuleuven.ac.be>
Roman Zippel <zippel@fh-brandenburg.de>: فایل‌های راهنما (man files)