'\" t
.\"     Title: xgps
.\"    Author: Remco Treffcorn, Derrick Brashear, Russ Nelson, Eric S. Raymond
.\" Generator: Asciidoctor 2.0.26
.\"      Date: 2025-11-04
.\"    Manual: GPSD Documentation
.\"    Source: GPSD, Version 3.27.5
.\"  Language: Persian
.\"
.TH "XGPS" "1" "2025-11-04" "GPSD, Version 3.27.5" "GPSD Documentation"
.ie \n(.g .ds Aq \(aq
.el       .ds Aq '
.ss \n[.ss] 0
.nh
.ad l
.de URL
\fI\\$2\fP <\\$1>\\$3
..
.als MTO URL
.if \n[.g] \{\
.  mso www.tmac
.  am URL
.    ad l
.  .
.  am MTO
.    ad l
.  .
.  LINKSTYLE blue R < >
.\}
.SH "نام (NAME)"
xgps \- کلاینت X برای gpsd
.SH "خلاصه دستور (SYNOPSIS)"
.sp
\fBxgps\fP [OPTIONS] [service[:port[:device]]]
.sp
\fBxgps\fP \-h
.sp
\fBxgps\fP \-V
.SH "توضیحات (DESCRIPTION)"
.sp
برنامه \fBxgps\fP یک کلاینت نمونه ساده با رابط گرافیکی X برای gpsd است.
این برنامه اطلاعات موقعیت/زمان/سرعت فعلی GNSS و (برای گیرنده‌های GNSS
که از این قابلیت پشتیبانی می‌کنند) موقعیت ماهواره‌های در دسترس را نمایش
می‌دهد.
.sp
در نمای آسمان (sky view)، ماهواره‌ها برای نمایش کیفیت سیگنال رنگ‌بندی
شده‌اند؛ برای مقادیر دقیق برحسب dB به بخش نمایش داده در سمت چپ مراجعه کنید.
شمایل‌های لوزی‌شکل نشان‌دهنده ماهواره‌های GLONASS، مربع‌ها برای SBAS
(مانند WAAS، EGNOS)، دایره‌ها نشان‌دهنده GPS، و مثلث‌های رو به پایین،
رو به بالا، رو به راست و رو به چپ به ترتیب نشان‌دهنده ماهواره‌های سامانه‌های
Galileo، BeiDou، QZSS و سامانه‌های دیگر (مانند IMES، IRNSS و همچنین
سامانه‌های ناشناخته) هستند. شمایل‌های پُر در تعیین موقعیت (fix) فعلی استفاده
شده‌اند و شمایل‌های توخالی استفاده نشده‌اند. نگه‌داشتن نشانگر ماوس روی یک نماد،
موقتاً پنجره پاپ‌آپ کوچکی حاوی جزئیات ماهواره از پنل فهرست ماهواره‌ها
(Satellite List) را نمایش می‌دهد.
.sp
برنامه \fBxgps\fP هم توسط کاربر عادی و هم توسط کاربر ریشه (root) به خوبی اجرا
می‌شود. اجرای \fBxgps\fP تحت \fBsudo\fP باعث از دست رفتن برخی از قابلیت‌ها خواهد شد.
.SH "گزینه‌ها (OPTIONS)"
.sp
\fB\-?\fP, \fB\-h\fP, \fB\-\-help\fP
.RS 4
باعث می‌شود کلاینت خلاصه‌ای از گزینه‌های خود را نمایش داده و خارج شود.
.RE
.sp
\fB\-device DEVICE\fP
.RS 4
دستگاهی روی میزبان که باید به آن متصل شود. مقدار پیش‌فرض خالی (هر دستگاهی) است.
.RE
.sp
\fB\-D LVL\fP, \fB\-\-debug LVL\fP
.RS 4
سطح اشکال‌زدایی را تنظیم می‌کند که عمدتاً برای استفاده توسط توسعه‌دهندگان GPSD است.
این گزینه پیام‌های پیشرفت گوناگونی را به خروجی خطای استاندارد (standard error) ارسال می‌کند.
.RE
.sp
\fB\-\-host HOST\fP
.RS 4
میزبان (سرور) برای اتصال. پیش‌فرض localhost است.
.RE
.sp
\fB\-l FMT\fP, \fB\-\-llfmt FMT\fP
.RS 4
قالب گزارش عرض و طول جغرافیایی را تعیین می‌کند. مقدار \*(Aqd\*(Aq درجات اعشاری
تولید می‌کند و مقدار پیش‌فرض است. مقدار \*(Aqm\*(Aq درجات و دقایق اعشاری تولید
می‌کند. مقدار \*(Aqs\*(Aq درجات، دقایق و ثانیه‌های اعشاری تولید می‌کند.
.RE
.sp
\fB\-p PORT\fP, \fB\-\-port PORT\fP
.RS 4
درگاهی (پورت) که باید به آن متصل شود. پیش‌فرض 2947 است.
.RE
.sp
\fB\-r DEG\fP, \fB\-\-rotate DEG\fP
.RS 4
آرگومانی برحسب درجه دریافت می‌کند تا نمای آسمان را در خلاف جهت عقربه‌های ساعت بچرخاند.
.RE
.sp
\fB\-c FORMAT\fP, \fB\-\-const FORMAT\fP
.RS 4
قالب نمایش صورت فلکی ماهواره‌ای.
می‌تواند به صورت مخفف، نام کامل، یا در صورت امکان نام کامل به همراه پرچم نمایش داده شود.
نکته: پرچم‌ها نیازمند قلم UTF\-8 با ایموجی‌های پرچم هستند.
.RE
.sp
\fB\-V\fP, \fB\-\-version\fP
.RS 4
این گزینه باعث می‌شود هر کلاینت نسخه بسته را نمایش داده و خارج شود.
.RE
.SH "آرگومان‌ها (ARGUMENTS)"
.sp
به‌طور پیش‌فرض، کلاینت‌ها داده‌ها را از دیمن محلی \fBgpsd\fP در حال اجرا روی
localhost با استفاده از درگاه پیش‌فرض GPSD یعنی 2947 جمع‌آوری می‌کنند.
آرگومان اختیاری برای هر کلاینت می‌تواند این رفتار را بازنویسی کند: \fB[server[:port[:device]]]\fP
.sp
برای توضیحات و مثال‌های بیشتر، بخش \fBARGUMENTS\fP را در صفحه راهنمای
\fBgps\fP(1) ببینید.
.SH "محیط (ENVIRONMENT)"
.sp
متغیر محیطی \fBXGPSOPTS>\fP می‌تواند برای انتقال گزینه‌های پرکاربرد خط فرمان
به \fBxgps\fP تنظیم شود. این متغیر معمولاً برای تنظیم گزینه \fB\-u\fP متناسب با
واحدهای محلی (locale) استفاده می‌شود. \fBXGPSOPTS\fP پیش از گزینه‌های خط فرمان
پردازش می‌شود.
.sp
برنامه \fBxgps\fP همچنین سایر متغیرهای محیطی را برای تعیین واحدهای نمایش
\(em امپریال، دریایی، یا متریک بررسی می‌کند. متغیرها و مقادیر بررسی‌شده
عبارتند از:
.sp
.if n .RS 4
.nf
.fam C
    GPSD_UNITS one of:
              i\&          = miles/feet
              imperial\&   = miles/feet
              n\&          = knots/feet
              nautical\&   = knots/feet
              m\&          = km/meters
              metric\&     = km/meters
    LC_MEASUREMENT
              en_US\&      = miles/feet
              C\&          = miles/feet
              POSIX\&      = miles/feet
              [other]\&    = km/meters
    LANG
              en_US\&      = miles/feet
              C\&          = miles/feet
              POSIX\&      = miles/feet
              [other]\&    = km/meters
.fam
.fi
.if n .RE
.sp
گزینه \fB\-u\fP یا \fB\-\-units\fP بر این تنظیمات اولویت دارد.
.sp
از گزینه \fB\-u\fP می‌توان برای تعیین سامانه واحدهای نمایش استفاده کرد؛ پس از این
کلیدواژه، مقدار \*(Aqi\*(Aq برای \*(Aqimperial\*(Aq جهت واحدهای آمریکایی (فوت بین‌المللی
در ارتفاع و برآوردهای خطا، مایل بر ساعت در سرعت)، مقدار \*(Aqn\*(Aq برای \*(Aqnautical\*(Aq
(فوت در ارتفاع و برآوردهای خطا، گره در سرعت) یا مقدار \*(Aqm\*(Aq برای \*(Aqmetric\*(Aq
(متر در ارتفاع و برآوردهای خطا، کیلومتر بر ساعت در سرعت) قرار می‌گیرد.
.sp
نکته: پای نقشه‌برداری ایالات متحده (USA Survey Foot) پشتیبانی نمی‌شود.
.sp
اگر هیچ سامانه واحدی در خط فرمان یا در \fBXPGSOPTS\fP مشخص نشده باشد، متغیر
محیطی \fBGPSD_UNITS\fP بررسی می‌شود؛ این متغیر ممکن است روی \*(Aqi\*(Aq،
\*(Aqimperial\*(Aq، \*(Aqm\*(Aq، \*(Aqmetric\*(Aq یا \*(Aqn\*(Aq، \*(Aqnautical\*(Aq
تنظیم شده باشد.
.sp
در صورتی که هیچ سامانه واحدی در خط فرمان، در \fBXPGSOPTS\fP یا در \fBGPSD_UNITS\fP
مشخص نشده باشد، ابتدا \fBLC_MEASUREMENT\fP و سپس \fBLANG\fP بررسی می‌شوند. اگر
مقدار آن \*(AqC\*(Aq، \*(AqPOSIX\*(Aq باشد یا با \*(Aqen_US\*(Aq آغاز شود، سامانه
واحدها روی امپریال تنظیم می‌شود. در صورت عدم انتخاب هرگونه سامانه‌ای، مقدار
پیش‌فرض متریک خواهد بود.
.SH "گزینه‌های منو (MENU OPTIONS)"
.sp
File > Connect
.RS 4
تلاش برای برقراری یک اتصال جدید به سرور، که به‌طور پیش‌فرض سرور قبلی است.
.RE
.sp
File > Disconnect
.RS 4
استفاده از قابلیت قطع اتصال برای قطع ارتباط فعلی سرور بدون خروج از نرم‌افزار.
.RE
.sp
File > Devices
.RS 4
این گزینه به شما امکان می‌دهد دستگاهی را که XGPS داده‌ها را از آن گزارش می‌کند تغییر دهید،
که پیش‌فرض آن همه دستگاه‌ها است.
.RE
.sp
File > Quit
.RS 4
خروج از xgps.
.RE
.sp
View
.RS 4
تغییر وضعیت نمایش پنل‌ها در صفحه؛ پنل‌ها (از بالا به پایین) عبارتند از:
نمای آسمان ماهواره‌ها، داده‌های ماهواره‌های موقعیت‌یاب جهانی (GPS)، سامانه شناسایی
خودکار (دریایی) (AIS)، حسگر وضعیت (attitude sensor)، واحدهای اندازه‌گیری
اینرسی (IMU)، آمارهای نویز، و موقعیت‌یابی کینماتیک آنی (RTK).
برنامه Xgps به‌طور پیش‌فرض پنل‌های Skyview و GPS را نمایش می‌دهد، پنل AIS
تا زمان انتخاب پنهان می‌ماند، و پنل‌های وضعیت، IMU، نویز و RTK تا زمان دریافت
داده‌های مربوطه به‌طور خودکار آشکار نمی‌شوند.
.RE
.sp
Units > Imperial, Metric, Nautical
.RS 4
انتخاب مجموعه واحدهای مورد استفاده برای سرعت و ارتفاع. این تنظیم به‌طور پیش‌فرض
متریک است، مگر اینکه xgps مقادیر آمریکایی، "C" یا "POSIX" را برای متغیرهای
محیطی LANG یا LC_MEASUREMENT تشخیص دهد (به بالا مراجعه کنید).
.RE
.sp
Units > DD.dd, DD MM.mm, DD MM SS.ss
.RS 4
تنظیم قالب زاویه برحسب درجات، درجات\-دقایق، یا درجات\-دقایق ثانیه‌ها. آخرین واحد
یک عدد ممیز شناور و واحدهای قبلی اعداد صحیح هستند.
.RE
.sp
Units > 30, 45, Off
.RS 4
تغییر خطوط درجه‌بندی نمودار پراکندگی ماهواره؛ پیش‌فرض ۳۰ درجه است.
.RE
.sp
Units > Mag North Up, Track Up, True North Up
.RS 4
تغییر جهت‌گیری در نمودار پراکندگی ماهواره مطابق سلیقه شما، که پیش‌فرض آن
شمال حقیقی (True North) به سمت بالا است.
.RE
.sp
Help > About
.RS 4
نمایش اطلاعات درباره xgps.
.RE
.SH "وضعیت خروج (RETURN VALUES)"
.sp
\fB0\fP
.RS 4
در صورت موفقیت.
.RE
.sp
\fB1\fP
.RS 4
در صورت شکست.
.RE
.SH "همچنین ببینید (SEE ALSO)"
.sp
\fBgpsd\fP(8), \fBgps\fP(1), \fBxgpsspeed\fP(1)
.SH "منابع (RESOURCES)"
.sp
\fBوبگاه پروژه:\fP \c
.URL "https://gpsd.io" "" ""
.SH "کپی‌رایت و تکثیر (COPYING)"
.sp
حق نشر این پرونده متعلق به پروژه GPSD است
.br
SPDX\-License\-Identifier: BSD\-2\-clause
.SH "نویسندگان (AUTHORS)"
.sp
Remco Treffcorn
.sp
Derrick Brashear
.sp
Russ Nelson
.sp
Eric S. Raymond