.\" Copyright (c) 2017, Martin Kepplinger <martink@posteo.de>
.\"
.\" %%%LICENSE_START(GPLv2+_DOC_FULL)
.\" This is free documentation; you can redistribute it and/or
.\" modify it under the terms of the GNU General Public License as
.\" published by the Free Software Foundation; either version 2 of
.\" the License, or (at your option) any later version.
.\"
.\" The GNU General Public License's references to "object code"
.\" and "executables" are to be interpreted as the output of any
.\" document formatting or typesetting system, including
.\" intermediate and printed output.
.\"
.\" This manual is distributed in the hope that it will be useful,
.\" but WITHOUT ANY WARRANTY; without even the implied warranty of
.\" MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
.\" GNU General Public License for more details.
.\"
.\" You should have received a copy of the GNU General Public
.\" License along with this manual; if not, see
.\" <http://www.gnu.org/licenses>.
.\" %%%LICENSE_END
.\"
.TH "TS_CALIBRATE" "1" "" "" "tslib"
.SH "نام (NAME)"
ts_calibrate \- برنامه‌ای آزمایشی برای کالیبراسیون صفحه لمسی مورد استفاده tslib\&.

.SH "خلاصه دستور (SYNOPSIS)"
.B ts_calibrate

.SH "توضیحات (DESCRIPTION)"
.PP
\fBts_calibrate\fR برای پیکربندی دستی پلاگین فیلتر \fBlinear\fR در tslib به کار می‌رود. این ابزار نشانه‌گاه‌هایی (crosshair) را روی بافر فریم (framebuffer) رسم می‌کند تا توسط کاربر لمس شوند و موقعیت‌های لمسی واقعی را در برابر موقعیت‌های مورد انتظار برای اعمال فیلتر و ارائه یک تجربه کاربری لمسی مطلوب ثبت می‌کند. این ابزار از متغیر محیطی \fBTSLIB_CALIBFILE\fR برای ذخیره مقادیر خود استفاده می‌کند.
.sp
.sp
\fB\-r, \-\-rotate [value]\fR
.sp
.RS 4
چرخش صفحه نمایش. مقدار (value) برای ۰ درجه 0، برای ۹۰ درجه (در جهت عقربه‌های ساعت یا CW) 1، برای ۱۸۰ درجه (وارونه) 2 و برای ۲۷۰ درجه (پادساعت‌گرد یا CCW) 3 است. این مقدار به فایل پیکربندی کالیبراسیون TSLIB_CALIBFILE اضافه شده و توسط ماژول فیلتر linear از آنجا خوانده می‌شود. این مقدار می‌تواند توسط یکی از پارامترهای ماژول linear تغییر داده شود.
.RE
.PP

.sp
.sp
\fB\-t, \-\-min_interval\fR
.sp
.RS 4
مدت‌زمانی بر حسب میلی‌ثانیه که باید قبل از فشرده شدن نشانه‌گاه توسط کاربر سپری شود. این گزینه ممکن است برای جلوگیری از ضربه‌های بیش از حد سریع یا لمس‌های اشتباه تصادفی و در نتیجه کالیبراسیون نادقیق مفید باشد. پیش‌فرض: 0.
.RE
.PP

.sp
.sp
\fB\-c, \-\-validate\fR
.sp
.RS 4
اعتبارسنجی کالیبراسیون. مطمئن شوید که ماژول linear در ts.conf پیکربندی شده باشد تا کالیبراسیون فعلی اعمال شود. در این حالت، علامت‌های بعلاوه در مکان‌های تصادفی روی صفحه نمایش داده می‌شوند و لمس‌ها با موقعیت‌های آن‌ها ارزیابی می‌شوند. در این حالت گزینه‌های \-\-loops و \-\-boundary در دسترس هستند.
.RE
.PP

.sp
.sp
\fB\-b, \-\-boundary\fR
.sp
.RS 4
مرز اعتبارسنجی بر حسب پیکسل. فقط در صورت استفاده از \-\-validate در دسترس است. این گزینه مشخص می‌کند که اعتبارسنجی چقدر باید سخت‌گیرانه باشد؛ یعنی فاصله‌ای که ورودی لمسی ارزیابی‌شده مجاز است از علامت بعلاوه فاصله داشته باشد تا همچنان اعتبارسنجی موفقیت‌آمیز باشد. اگر از این مرز فراتر رود، اعتبارسنجی ناموفق خواهد بود. پیش‌فرض: 10.
.RE
.PP

.sp
.sp
\fB\-o, \-\-border\fR
.sp
.RS 4
تعداد پیکسل‌هایی که باید از حاشیه صفحه نمایش فاصله گرفته شود. فقط در صورت استفاده از \-\-validate در دسترس است. پیش‌فرض: 0.
.RE
.PP

.sp
.sp
\fB\-l, \-\-loops\fR
.sp
.RS 4
تعداد دورها در حالت اعتبارسنجی. فقط در صورت استفاده از \-\-validate در دسترس است. این گزینه مشخص می‌کند چه تعداد علامت بعلاوه باید لمس و ارزیابی شوند. پیش‌فرض: 3.
.RE
.PP

.SH "متغیرهای محیطی (ENVIRONMENT VARIABLES)"
.PP
به ts.conf (5) مراجعه کنید.
.RE
.PP

.SH "همچنین ببینید (SEE ALSO)"
.PP
ts\&.conf (5),
ts_test (1),
ts_uinput (1)