نام (NAME)

jscal - برنامه کالیبراسیون و نگاشت مجدد جوی‌استیک

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

jscal [options] <device‐name>

توضیحات (DESCRIPTION)

دستور jscal جوی‌استیک‌ها را کالیبره کرده و محورها و دکمه‌های جوی‌استیک را نگاشت می‌کند. کالیبره‌سازی جوی‌استیک تضمین می‌کند که موقعیت‌ها روی محورهای مختلف به درستی تفسیر شوند. نگاشت محورها و دکمه‌ها این امکان را فراهم می‌سازد که معنای محورها و دکمه‌های جوی‌استیک دوباره تعریف شوند.

در سیستم‌های دبیان، تنظیمات کالیبراسیون را می‌توان ذخیره کرد و سپس با استفاده از دستور jscal-store به‌طور خودکار اعمال نمود.

گزینه‌ها (OPTIONS)

-c, --calibrate: کالیبره کردن جوی‌استیک.
-h, --help: چاپ خلاصه‌ای از گزینه‌های موجود.
-b <fIbutton>: مشخص کردن دکمه‌ای برای ادامه دادن. به‌طور پیش‌فرض، هنگام کالیبره‌سازی محورها، فشرده شدن هر دکمه‌ای باعث خوانده شدن موقعیت و استفاده از آن برای کالیبراسیون می‌شود؛ این گزینه اجازه می‌دهد تا به جای آن یک دکمه خاص انتخاب شود. این مورد برای دستگاه‌هایی که در آن‌ها یک ورودی واحد هم برای محور و هم برای دکمه استفاده می‌شود، مفید است.
-s, --set-correction <nb_axes,type,precision,coefficients,...>: تنظیم تصحیح روی مقادیر مشخص‌شده. برای هر محور، نوع تصحیح (۰ برای هیچ‌کدام، ۱ برای "broken line")، دقت، و در صورت نیاز ضرایب تصحیح (تصحیحات "broken line" چهار ضریب می‌گیرند) را مشخص کنید.
-u, --set-mappings <nb_axes,axmap1,axmap2,...,nb_buttons,btnmap1,btnmap2,...>: تنظیم نگاشت‌های محور و دکمه. n_of_buttons را می‌توان برای نگاشت مجددِ تنها محورها، روی 0 تنظیم کرد.

-t, --test-center: بررسی می‌کند که آیا جوی‌استیک به‌درستی کالیبره شده است یا خیر. در صورتی که محورها کالیبره نشده باشند مقدار 2، اگر دکمه‌ها فشرده شده باشند مقدار 3، در صورت بروز هر خطای دیگر مقدار 1، و در صورت موفقیت مقدار 0 را برمی‌گرداند.
-V, --version: شماره نسخه درایور در حال اجرای جوی‌استیک و نسخه‌ای که jscal برای آن کامپایل شده است را چاپ می‌کند.
-p, --print-correction: تنظیمات فعلی تصحیح را چاپ می‌کند. قالب خروجی، یک خط فرمان jscal است.
-q, --print-mappings: نگاشت‌های فعلی محور و دکمه را چاپ می‌کند. قالب خروجی، یک خط فرمان jscal است.

کالیبراسیون (CALIBRATION)

با استفاده از سیستم ورودی لینوکس، انتظار می‌رود جوی‌استیک‌ها برای محورها مقادیری بین -32767 و 32767 تولید کنند، به طوری که 0 به معنای قرار داشتن جوی‌استیک در مرکز است. بنابراین، حالت کاملاً چپ (full‐left) باید -32767 روی محور X، حالت کاملاً راست (full‐right) مقدار 32767 روی محور X، حالت کاملاً جلو (full‐forward) مقدار -32767 روی محور Y و به همین ترتیب تولید کند.

بسیاری از جوی‌استیک‌ها و گیم‌پدها (به‌ویژه مدل‌های قدیمی‌تر) اندکی ناتراز هستند؛ در نتیجه ممکن است از کل محدوده مقادیر (برای نقاط انتهایی محورها) استفاده نکنند، یا حتی آزاردهنده‌تر این‌که در حالت مرکز، مقدار 0 ندهند. کالیبره‌سازی جوی‌استیک، اطلاعاتی درباره رفتار واقعی جوی‌استیک به کرنل ارائه می‌دهد که به کرنل اجازه می‌دهد نقص‌های مختلف جوی‌استیک‌ها را برطرف کرده و تا جایی که به نرم‌افزارهای استفاده‌کننده از جوی‌استیک مربوط می‌شود، خروجی یکنواختی تولید کند.

دستور jstest(1) برای تعیین اینکه آیا یک جوی‌استیک کالیبره شده است یا خیر مفید است: هنگام اجرا، زمانی که جوی‌استیک در حالت سکون است باید مقادیر 0 تولید کند، و هر محور باید قادر باشد مقادیر -32767 و 32767 را تولید نماید. جوی‌استیک‌های آنالوگ باید مقادیری بین 0 و نقاط انتهایی تولید کنند، اما این موضوع ضروری نیست؛ پدهای جهت‌نمای دیجیتال تنها با همین سه مقدار به خوبی کار می‌کنند.

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

ffset(1), jstest(1), jscal-store(1).

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

jscal توسط Vojtech Pavlik نوشته شده و توسط افراد بسیار دیگری بهبود یافته است؛ برای جزئیات به مستندات ابزارهای linuxconsole مراجعه کنید.

این صفحه راهنما توسط Stephen Kitt <steve@sk2.org> برای سیستم گنو/لینوکس دبیان نوشته شده است (اما ممکن است توسط دیگران نیز استفاده شود).