fdpowermon - آنلاین در ابر

برنامه:

نام

fdpowermon - یک نماد سطح باتری را به سینی سیستم سازگار با freedesktop.org اضافه کنید

خلاصه

fdpowermon

شرح

این برنامه به شما امکان می‌دهد نماد «سطح باتری» را در هر سازگار با freedesktop.org نمایش دهید
منطقه وضعیت می توان آن را از طریق یک فایل پیکربندی متن ساده مضمون سازی کرد
(/etc/fdpowermon/theme.cfg or $XDG_CONFIG_DIR/fdpowermon/theme.cfg) یا از طریق کوتاه
اسکریپت پرل (/etc/fdpowermon/theme.pl or $XDG_CONFIG_DIR/fdpowermon/theme.pl) اگر
$XDG_CONFIG_DIR تنظیم نشده است، $HOME/.config به عنوان پیش فرض استفاده می شود.

اولی آسان‌تر است، زیرا به هیچ برنامه‌نویسی نیاز ندارد. و در واقع پیش فرض
پیکربندی نمونه‌ای از چنین تم متنی ساده است. با این حال، دومی اجازه می دهد
انعطاف‌پذیری بیشتر، زیرا می‌توان تماس‌هایی را تعریف کرد که باید در زمان شارژ باتری اجرا شوند
به آستانه خاصی می رسد.

تم ها، خواه تم های پرل یا مضامین متن ساده، از طریق «گام ها» ساخته می شوند
در یک خط تعریف شده است. در یک فایل پیکربندی متن ساده، چنین خطی به شکل زیر است:

تخلیه = 2:missing.png:low.png, 10:low.png, 100:full.png

این سه مرحله را تعریف می کند. بالاترین مرحله "full.png" loading="lazy" را زمانی که سطح باتری است نشان می دهد
بین 11٪ و 100٪ (شامل)؛ مرحله دوم "low.png" بارگیری "تنبل" را در زمانی که سطح باتری است نشان می دهد
بین 3 تا 10 درصد (شامل) است. و مرحله سوم به طور متناوب بین "missing.png" خواهد بود.
و "low.png" بارگذاری "تنبل" در فواصل سه ثانیه، زمانی که باتری بین 0٪ و 2٪ است.

از آنجایی که خط با "تخلیه" شروع می شود، این مراحل زمانی که سیستم در حال اجرا است استفاده می شود
روی برق باتری یک خط مشابه از مراحل را می توان برای زمانی که باتری است تعریف کرد
شارژ:

charging = 0:empty-charging.png, 10:low-charging.png, 100: full-charging.png

هنگامی که باتری در 0٪ (دقیقا) است، "empty-charging.png" loading="lazy" را نشان می دهد.
"low-charging.png" loading="lazy" بین 1% و 10% (شامل) و "full-charging.png" loading="lazy" در 11% و
در بالا.

توجه داشته باشید که سفارش مهم است: مراحل باید از کم به بالا تعریف شوند.

برای تکمیل پیکربندی تم، باید چند مورد دیگر اضافه کنیم:

[اسطوره]
مرحله = 3
dir = /home/wouter/.fdpowermon/mytheme-icons
charging = 0:empty-charging.png, 10:low-charging.png, 100: full-charging.png
تخلیه = 2:missing.png:low.png, 10:low.png, 100:full.png

این موضوعی به نام "mytheme" را تعریف می کند که دارای سه مرحله است و تصاویر را در آن جستجو می کند
دایرکتوری "/home/wouter/.fdpowermon/mytheme-icons". نمی توان الف را تعریف کرد
موضوعی که تعداد مراحل متفاوتی برای مرحله شارژ نسبت به مرحله شارژ دارد
فاز تخلیه؛ اگر آن را می خواهید، فقط (یک مرحله) اضافی را برای فازی که می خواهید تعریف کنید
می‌خواهم مراحل کمتری داشته باشد، که نمادی مشابه مرحله بالا یا پایین دارد.

توجه داشته باشید که سفارش در اینجا نیز مهم است. خط "گام ها" باید قبل از هر یک ظاهر شود
خطوط "شارژ" یا "دشارژ" (این مورد در fdpowermon 1.7 یا پایین تر نبود).

اگر بیش از یک تم پیکربندی شده باشد، fdpowermon به طور پیش‌فرض از آخرین تم استفاده می‌کند
در پیکربندی هر کاربر تعریف شده است، یا (اگر هیچ فایل پیکربندی برای هر کاربر وجود ندارد)
آخرین موضوع تعریف شده در پیکربندی کل سیستم.

فایل های پیکربندی تم پرل می توانند از fdpowermon::theme::make_default برای تغییر پیش فرض استفاده کنند.
تم.

PERL API

@warnings
آرایه @fdpowermon::theme::warnings را می توان برای تعیین سطوح fdpowermon استفاده کرد.
باید یک هشدار استاندارد صادر کند. پیش فرض (10، 5، 1) است که به معنای صدور اخطار است
در سطح 10٪، 5٪ و 1٪. توجه داشته باشید که اگر باتری با سرعت خاصی خالی شود
سرعت، سطح ممکن است حتی بیشتر از آن قبل از صدور هشدار کاهش یافته باشد.
همچنین، fdpowermon بلافاصله پس از قطع برق از دستگاه اخطاری صادر می کند
و قدرت زیر سطح اول است.

برای اینکه fdpowermon همیشه هنگام قطع برق یک اخطار صادر کند، آن را روی چیزی تنظیم کنید
مانند (100، 10، 5، 1). برای ایجاد هشدارهای مربوط به fdpowermon در 20٪، 10٪، و 5٪، این را تنظیم کنید
(20 ، 10 ، 5).

توجه داشته باشید که امکان تغییر متن اخطار وجود ندارد. اگر آن را می خواهید، ببینید
fdpowermon::theme::warning sub، و از یک رویداد استفاده کنید.

$use_notify
متغیر $fdpowermon::theme::use_notify می تواند برای تصمیم گیری در مورد استفاده از
پیام libnotify (اگر روی یک مقدار غیر صفر تنظیم شده باشد)، یا یک پنجره گفتگو (اگر روی مقداری تنظیم شده باشد
به صفر می رسد).

اگر داده درون نگری libnotify Glib نصب شده باشد، پیش‌فرض استفاده از libnotify است
یک کادر محاوره ای اگر نه زیرا جعبه های گفتگو می توانند تمرکز را بدزدند و در نتیجه ویران کنند
با کار کاربر، استفاده از libnotify توسط نویسنده به شدت توصیه می شود.

توجه داشته باشید که اگر متغیر را به طور صریح روی غیر صفر تنظیم کنید، بررسی کنید که آیا این متغیر است یا خیر
داده های درون نگری Glib نصب شده است نادیده گرفته می شود. مطمئن شوید که در آن موجود است
مورد!

جدید
یک تم جدید fdpowermon ایجاد کنید. یک مرجع مبارک را برمی‌گرداند. به عنوان مثال،

my $theme = fdpowermon::theme;

$theme->set_stepcount($count)
تعداد مراحل را در موضوع تنظیم کنید. توجه داشته باشید که یک تم fdpowermon باید برابر باشد
تعداد مراحل در هر دو جهت "شارژ" و "دشارژ".

باید قبل از فراخوانی set_charging، set_discharging یا parse_step فراخوانی شود.

$theme->set_dir($dir)
دایرکتوری پایه مورد استفاده برای نام فایل های نماد را تنظیم کنید.

$theme->set_charging(\@elements)
نمادهایی را تنظیم کنید که باید هنگام شارژ شدن باتری نشان داده شوند. استدلال باید باشد
از طریق روش parse_step ایجاد شده است.

$theme->set_discharging(\@elements)
نمادهایی را تنظیم کنید که باید هنگام تخلیه باتری نشان داده شوند. استدلال باید باشد
از طریق روش parse_step ایجاد شده است.

$theme->parse_step($defs)
رشته داده شده را به چیزی تجزیه می کند که می تواند به set_charging یا منتقل شود
set_discharging. تعاریف باید در قالب مراحل، که در بالا توضیح داده شد، بدون
پیشرو "charging =" یا "discharging =".

در حالی که این روش آرایه‌ای را برمی‌گرداند که می‌توان آن را بررسی و (احتمالا) اصلاح کرد،
مضامینی که می خواهند با آینده سازگار باشند باید آن را به عنوان یک ساختار داده مبهم در نظر بگیرند.

$theme->set_event($step, \&بازگشت، 'د')
طرح زمینه را به‌روزرسانی کنید تا زمانی که ما در حال تخلیه و رسیدن به آن هستیم، «پشت به تماس» فرعی اجرا شود
برای اولین بار $step. برای تنظیم یک رویداد هنگام شارژ به جای آن، یک «c» را به عنوان سوم ارسال کنید
بحث و جدل.

توجه داشته باشید که مراحل آرایه هستند و بنابراین بر پایه 0 هستند. کم ترین اقلام هستند
پایین ترین مراحل

هنگامی که رویداد راه‌اندازی می‌شود، روال برگشت به تماس دو آرگومان ارسال می‌شود: اولی این است
سطح باتری فعلی (در درصد)؛ دومی عددی است که نشان می دهد آیا
باتری در حال حاضر در حال شارژ (1) یا تخلیه (0) است. در صورت تجزیه ACPI
فرمان شکست می خورد، با این حال، آرگومان دوم ممکن است unef باشد. شما باید برای این آماده شوید
امکان پذیری. توجه داشته باشید که خود fdpowermon با فرض اینکه باتری است، این مورد را مدیریت می کند
شارژ کردن؛ شما ممکن است بخواهید یا نخواهید همین کار را انجام دهید.

$theme->register($name)
یک موضوع را تحت یک نام خاص ثبت می کند. اگر موضوعی از قبل با آن نام وجود داشته باشد، وجود دارد
جایگزین شد

make_default ($name)
یک طرح زمینه با نام مشخص را به عنوان موضوع پیش فرض تبدیل می کند.

get_theme ($name)
به دنبال موضوعی با نام مشخص می شود. به عنوان مثال،

my $theme = fdpowermon::theme::get_theme("پیش فرض");

هشدار ($message)
با استفاده از libnotify یا با استفاده از کادر محاوره ای یک هشدار ایجاد کنید:

fdpowermon::theme::warning($message);

برای جزئیات بیشتر به اسناد $fdpowermon::theme::use_notify در بالا مراجعه کنید
پیاده سازی انتخاب شده است.

مثال ها

برای مثال کامل تم cfg. به بالا نگاه کنید.

برای ساختن همان تم به طور کامل از پرل، باید کاری شبیه به این انجام دهید:

my $theme = fdpowermon::theme;
$theme->set_stepcount(3)؛
$theme->set_dir("/home/wouter/.fdpowermon/mytheme-icons");
$theme->set_charging($theme->parse_step("0:empty-charging.png, 10:low-charging.png, 100: full-charging.png"));
$theme->set_discharging($theme->parse_step("2:missing.png:low.png, 10:low.png, 100:full.png"));

(توجه داشته باشید، به عنوان یک تم پرل، این در theme.pl قرار می گیرد، نه theme.cfg؛ برای موارد احتمالی به بالا مراجعه کنید
مکان هایی برای تم های پرل)

با این حال، مگر اینکه بخواهید موضوع را به صورت پویا بسازید، انجام آن به این صورت نیست
توصیه شده. در عوض، شما می‌توانید موضوع را از یک فایل cfg. بسازید و احتمالاً آن را تغییر دهید.
از پرل فرض کنید می خواهید یک رویداد اضافه کنید تا در صورت قطع شدن برق سیستم را به حالت تعلیق درآورد
کم؛ در آن صورت، شما چیزی شبیه به این را انجام می دهید:

زیر تعلیق {
system("sudo pm-suspend");
}

my $theme = fdpowermon::theme::get_theme("mytheme");
$theme->set_event(0, \&suspend, 'd');

هنگامی که باتری در حال تخلیه است و ما به پایین ترین حد می رسیم، این زیر "تعلیق" نامیده می شود
مرحله (در مثال بالا، زمانی که باتری به 10% می رسد، ممکن است بخواهید
این کار را کمی بعد انجام دهید). این زیر 'spend' به سادگی برنامه "pm-suspend" را فراخوانی می کند، با
sudo، برای تعلیق سیستم.

با استفاده از خدمات onworks.net از fdpowermon به صورت آنلاین استفاده کنید