Просмотр кода страницы Library/ru

Libs-dev &mdash; набор системных библиотек, нацеленных на различные проблемные области программирования.

=Описание библиотек=
Libs-dev в настоящий момент состоит из четырёх библиотек общего назначения: '''libio''' (программирование ввода-вывода), '''libini''' (поддержка INI файлов), '''libimg''' (манипуляции с графическими файлами) and '''libgfx''' (удобное API для рисования).

==GUI Libraries==
===Box lib===
<small>''Основная статья: [[Box lib/ru]]''</small>

Библиотека box_lib.obj содержит разные элементы управления, которые можно использовать при написании приложений.

==Libs-dev==
===libio===
<small>''Основная статья: [[Libs-dev/libio/ru]]''</small>

Библиотека предоставляет средства для выполнения основных операций ввода-вывода, таких как открытие, закрытие, чтение, изменение, урезание файлов, получение и установка позиции файлового указателя. Также присутствуют методы для перебора файлов в пределах определённой директории с именами, соответствующими маске.

Ею должны, в общем случае, пользоваться программы, которым необходимо производить низкоуровневые файловые операции.

===libini===
<small>''Основная статья: [[Libs-dev/libini/ru]]''</small>

Библиотека предоставляет средства для работы с INI файлами, представляющими собой текстовые файлы с набором ключей и значений, которые пользователь имеет возможность изменять вручную в любом внешнем редакторе.

Ею должны, в общем случае, пользоваться программы, которым необходимо сохранять и загружать свои настройки платформо-независимым образом.

===libimg===
<small>''Основная статья: [[Libs-dev/libimg/ru]]''</small>

Библиотека предоставляет средства для работы с графическими файлами и контейнерами. Она расширяема и может прозрачным образом декодировать изображения в разных форматах, идентифицируя их по файловым сигнатурам и другими эвристическими способами.

Ею должны, в общем случае, пользоваться программы, которым необходимо отображать картинки в их пользовательском интерфейсе (например, иконки на кнопках).

===libgfx===
<small>''Основная статья: [[Libs-dev/libgfx/ru]]''</small>

Библиотека предоставляет средства для рисования различных графических примитивов, таких как точки, линии, простые и закрашенные прямоугольники, круги и т.п. Она использует абстракцию холста, чтобы иметь возможность буферизированной отрисовки.

Ею должны, в общем случае, пользоваться программы, которым необходимо рисовать графику на экране (что, в принципе, относится ко всем существующим программам, так как Kolibri является полностью графической операционной системой).

=Тестирование библиотек=
В исходных кодах присутствует директория <tt>.test</tt>, содержащая различные тесты библиотек. Они спроектированы независимыми друг от друга и должны генерировать (или содержать заранее сгенерированные) тестовые данные, которые приводят к одинаковым результатам независимо от порядка их выполнения.

Программа [[Kiv/ru|KIV]] была изначально основана на одном из таких тестов (002), использующем библиотеки '''libio''' и '''libimg''', чтобы показать их возможности в небольшой графической программе, способной отображать картинку по пути, переданному в качестве параметра командной строки.

=Стиль кодирования=
Все публичные функции содержатся в файле <tt><имя библиотеки>.asm</tt>, вспомогательные публичные определения &mdash; в файле <tt><имя библиотеки>.inc</tt>. Все остальные специфичные для библиотеки (приватные и вспомогательные) основные функции и определения отделены в файлы <tt><имя библиотеки>_p.asm</tt> и <tt><имя библиотеки>_p.inc</tt>. Также могут присутствовать отдельные файлы с говорящими именами, предоставляющие дополнительную функциональность.

Функции, находящиеся в публичных файлах, используют соглашение об именовании <tt><имя области функции>.<имя функции></tt>. Функции, содержащиеся в приватных файлах, используют соглашение об именовании <tt><имя библиотеки>._.<имя функции></tt>. Это позволяет разделить код библиотек при статической сборке.

Используется специфический тип описательных комментариев к функциям, что позволит в будущем генерировать документацию автоматически.

=Смотрите также=
* [[Libraries|Разъяснения по библиотекам KolibriOS]]

[[Category:Кодинг]][[Category:Руководства]]
[[Category:Библиотеки]]