نام (NAME)

waybar-gps - ماژول GPS برای waybar

توضیحات (DESCRIPTION)

ماژول gps برای gpsd.

فایل‌ها (FILES)

$XDG_CONFIG_HOME/waybar/config
فایل پیکربندی اختصاصی کاربر

فایل‌های اضافی (ADDITIONAL FILES)

کتابخانه libgps در مسیرهای زیر قرار دارد:

1.: /usr/lib/libgps.so یا /usr/lib64/libgps.so
2.: /usr/lib/pkgconfig/libgps.pc یا /usr/lib64/pkgconfig/libgps.pc
3.: /usr/include/gps

پیکربندی (CONFIGURATION)

format:
نوع: string
پیش‌فرض: {glyph}
قالب متن.

tooltip:
نوع: bool
پیش‌فرض: true
گزینه‌ای برای غیرفعال کردن راهنمای شناور (tooltip) هنگام رفتن ماوس روی آن.

tooltip-format:
نوع: string
پیش‌فرض: Games running: {glyph}
قالب متنی راهنمای شناور.

interval:
نوع: integer
پیش‌فرض: 5
بازه زمانی برای دریافت اطلاعات GPS (مانند سرعت فعلی).

به‌روزرسانی‌های مهم (مانند حالت تثبیت فعلی) بلافاصله اعمال می‌شوند.

hide-disconnected:
نوع: bool
پیش‌فرض: true
تعیین می‌کند که در صورت عدم وجود گیرنده GPS، آیا ماژول پنهان شود یا خیر.

hide-no-fix:
نوع: bool
پیش‌فرض: false
تعیین می‌کند که در صورت عدم تثبیت موقعیت GPS (عدم وجود fix)، آیا ماژول پنهان شود یا خیر.

جایگزین‌های قالب (FORMAT REPLACEMENTS)

{mode}: حالت تثبیت موقعیت (Fix mode).

{status}: فناوری استفاده‌شده برای تثبیت موقعیت GPS. همه گیرنده‌های GPS این مقدار را گزارش نمی‌کنند.

{latitude}: عرض جغرافیایی، به درجه اعشاری. می‌تواند NaN باشد.

{latitude_error}: میزان خطای عرض جغرافیایی، به متر. می‌تواند NaN باشد.

{longitude}: طول جغرافیایی، به درجه اعشاری. می‌تواند NaN باشد.

{longitude_error}: میزان خطای طول جغرافیایی، به متر. می‌تواند NaN باشد.

{altitude_hae}: ارتفاع، بر فراز بیضوی مبنا (HAE)، به متر. می‌تواند NaN باشد.

{altitude_msl}: ارتفاع از سطح متوسط دریا (MSL)، به متر. می‌تواند NaN باشد.

{altitude_error}: میزان خطای ارتفاع، به متر. می‌تواند NaN باشد.

{speed}: سرعت زمینی، به متر بر ثانیه. می‌تواند NaN باشد.

{speed_error}: میزان خطای سرعت، به متر بر ثانیه. می‌تواند NaN باشد.

{climb}: سرعت عمودی، به متر بر ثانیه. می‌تواند NaN باشد.

{climb_error}: میزان خطای سرعت عمودی، به متر بر ثانیه. می‌تواند NaN باشد.

{satellites_visible}: تعداد ماهواره‌های قابل مشاهده برای گیرنده GPS.

{satellites_used}: تعداد ماهواره‌های استفاده‌شده برای تثبیت موقعیت GPS.

مثال‌ها (EXAMPLES)

"gps": {
	"format": "{mode}",
	"format-disabled": "", // an empty format will hide the module
	"format-no-fix": "No fix",
	"format-fix-3d": "{status}",
	"tooltip-format": "{mode}",
	"tooltip-format-no-fix": "{satellites_visible} satellites visible",
	"tooltip-format-fix-2d": "{satellites_used}/{satellites_visible} satellites used",
	"tooltip-format-fix-3d": "Altitude: {altitude_hae}m",
	"hide-disconnected": false
}

استایل (STYLE)

#gps
#gps.disabled زمانی اعمال می‌شود که GPS غیرفعال باشد.
#gps.fix-none زمانی اعمال می‌شود که GPS در دسترس است، اما موقعیت تثبیت نشده باشد.
#gps.fix-2d زمانی اعمال می‌شود که تثبیت دوبعدی (2D fix) وجود داشته باشد.
#gps.fix-3d زمانی اعمال می‌شود که تثبیت سه‌بعدی (3D fix) وجود داشته باشد.