Difference between revisions of "KMatrix/ru"

From KolibriOS wiki
Jump to navigation Jump to search
(Добавлена новая программа.)
 
(Добавлена всевозможная информация о программе.)
 
Line 13: Line 13:
 
|rep=[http://websvn.kolibrios.org/listing.php?repname=Kolibri+OS&path=%2Fprograms%2Fdemos%2Fkmatrix%2F Ссылка]
 
|rep=[http://websvn.kolibrios.org/listing.php?repname=Kolibri+OS&path=%2Fprograms%2Fdemos%2Fkmatrix%2F Ссылка]
 
}}
 
}}
'''KMatrix''' — консольная/графическая программа, которая рисует матрицу, как в одноименной серии фильмов. Написана на языке C. Компилируется внутри системы с помощью Tiny C Compiler. Может быть установлена как скринсейвер.
+
'''KMatrix''' — консольная/графическая программа, которая рисует матрицу, как в одноимённой серии фильмов. Написана на языке C. Компилируется внутри системы с помощью Tiny C Compiler. Может быть установлена как скринсейвер. В случае возникновения каких-либо ошибок во время выполнения программа постарается не сломаться и выведет текст ошибки в [[Board/ru|BOARD]].
  
== Описание функций ==
+
== Обычный запуск программы ==
Здесь скоро появится дополнительная информация...
+
Как только вы запустите '''KMatrix''', во весь экран начнет отрисовываться матрица с предустановленными параметрами. По умолчанию программа запускается в графическом режиме, однако вы можете запустить её в консольном режиме, используя параметр <code>--shell</code>.<br />
 +
=== Настройка матрицы во время её работы (граф. режим) ===
 +
* <code>[НАЗВАНИЕ]</code> — кнопка на клавиатуре.
 +
<code>[1]-[8]</code>: смена цветов (см. пункт "'''Названия цветов и их RGB-значения'''");<br />
 +
<code>[~]</code>: переключение редактируемого цвета. Изначально выбран FG. При нажатии происходит изменение по цепочке (FG -> BG -> HL -> FG ...);
 +
* FG — цвет символов, BG — цвет фона, HL — цвет выделенного символа.
 +
<code>[+]</code>/<code>[-]</code>: выбор режима скорости из набора, в котором 5 вариантов (100/33, 50/11, 10, 25, 100). Если была переназначена скорость во время запуска, то при увеличении или уменьшении скорости выберется ближайший по значению режим.<br />
 +
<code>[ESC]</code>: завершить работу программы.
 +
 
 +
== Параметры по умолчанию ==
 +
=== Только графический режим ===
 +
* CCOPT: выключен;
 +
* @SS: выключен.
 +
=== Оба режима ===
 +
* Цвет символов: <code>green</code>;<br />
 +
* Цвет фона: <code>black</code>;<br />
 +
* Цвет выделенного символа (самый нижний в "столбце"): <code>white</code>;<br />
 +
* Скорость: <code>10</code> символов в секунду.
 +
 
 +
== Названия цветов и их RGB-значения ==
 +
Набор из 8 цветов по умолчанию взят из системного [[Console/ru|console.obj]].<br />
 +
Таблица значений (RGB в формате HEX):
 +
{| class="wikitable" border="1"
 +
! Название
 +
! Кнопка на клавиатуре
 +
! RGB-значение
 +
|-
 +
| black
 +
| <code>1</code>
 +
| 000000
 +
|-
 +
| red
 +
| <code>2</code>
 +
| 800000
 +
|-
 +
| green
 +
| <code>3</code>
 +
| 008000
 +
|-
 +
| brown
 +
| <code>4</code>
 +
| 808000
 +
|-
 +
| blue
 +
| <code>5</code>
 +
| 000080
 +
|-
 +
| purple
 +
| <code>6</code>
 +
| 800080
 +
|-
 +
| turqoise
 +
| <code>7</code>
 +
| 008080
 +
|-
 +
| white
 +
| <code>8</code>
 +
| C0C0C0
 +
|}
 +
 
 +
== Возможные параметры ==
 +
<code>-F, --foreground < COLOR ></code>
 +
* устанавливает цвет символов. На месте <code>< COLOR ></code> указывается либо название цвета словом (из вышеперечисленных вариантов), либо RGB-значение (доступно только в графическом режиме).
 +
* '''Примеры:'''
 +
* <code>-F red</code>
 +
* <code>--foreground 255,0,255</code>
 +
<code>-B, --background < COLOR ></code>
 +
* устанавливает цвет фона. <code>< COLOR ></code> указывается, как в <code>-F</code>/<code>--foreground</code>;
 +
<code>-H, --highlight < COLOR ></code>
 +
* устанавливает цвет выделенного символа. <code>< COLOR ></code> указывается, как в <code>-F</code>/<code>--foreground</code>;
 +
<code>-S, --speed < SPEED ></code>
 +
* установить скорость падения символов в матрице. На месте <code>< SPEED ></code> должно быть натуральное число, которое определит, сколько символов в секунду будут падать.
 +
* '''Внимание:''' так как скорость регулируется с помощью функции _ksys_delay(1/100 sec), то вычисляется длительность простоя по формуле floor(100 / speed). Из этого следует, что скорости > 100 символов в секунду будут одинаково работать, а также некоторые значения в пределах [1; 100] тоже могут работать одинаково;
 +
<code>@ss</code>
 +
* служебный параметр для запуска программы как скринсейвера. Строго рекомендуется его не использовать, если вы не знаете, что делаете;
 +
<code>--ccopt</code>
 +
* оптимизация отрисовки (при смене цвета символа не будет обновляться фон под ним), которая понижает нагрузку на видеоадаптер/процессор. Работает только в графическом режиме, но выключена по умолчанию, так как отрисовка некоторых символов будет немного "размытой";
 +
<code>--shell</code>
 +
* запустить программу в консольном режиме;
 +
<code>--help</code>
 +
* отобразить текст с возможными параметрами для использования в программе;
 +
<code>--version</code>
 +
* отобразить версию программы.
  
 
{{Демо}}
 
{{Демо}}

Latest revision as of 15:36, 15 January 2022

KMatrix/ru
Which one pill will you choose? :D
{{{caption}}}
Исполняемый файл: KMatrix
Версия: 1.2
Написан на: C
Статус: stable, нововведения не планируются
Разработчики: Vitaliy Krylov (vitalkrilov)
Тема на форуме: Ссылка на форум
Исходный код: Ссылка

KMatrix — консольная/графическая программа, которая рисует матрицу, как в одноимённой серии фильмов. Написана на языке C. Компилируется внутри системы с помощью Tiny C Compiler. Может быть установлена как скринсейвер. В случае возникновения каких-либо ошибок во время выполнения программа постарается не сломаться и выведет текст ошибки в BOARD.

Обычный запуск программы

Как только вы запустите KMatrix, во весь экран начнет отрисовываться матрица с предустановленными параметрами. По умолчанию программа запускается в графическом режиме, однако вы можете запустить её в консольном режиме, используя параметр --shell.

Настройка матрицы во время её работы (граф. режим)

  • [НАЗВАНИЕ] — кнопка на клавиатуре.

[1]-[8]: смена цветов (см. пункт "Названия цветов и их RGB-значения");
[~]: переключение редактируемого цвета. Изначально выбран FG. При нажатии происходит изменение по цепочке (FG -> BG -> HL -> FG ...);

  • FG — цвет символов, BG — цвет фона, HL — цвет выделенного символа.

[+]/[-]: выбор режима скорости из набора, в котором 5 вариантов (100/33, 50/11, 10, 25, 100). Если была переназначена скорость во время запуска, то при увеличении или уменьшении скорости выберется ближайший по значению режим.
[ESC]: завершить работу программы.

Параметры по умолчанию

Только графический режим

  • CCOPT: выключен;
  • @SS: выключен.

Оба режима

  • Цвет символов: green;
  • Цвет фона: black;
  • Цвет выделенного символа (самый нижний в "столбце"): white;
  • Скорость: 10 символов в секунду.

Названия цветов и их RGB-значения

Набор из 8 цветов по умолчанию взят из системного console.obj.
Таблица значений (RGB в формате HEX):

Название Кнопка на клавиатуре RGB-значение
black 1 000000
red 2 800000
green 3 008000
brown 4 808000
blue 5 000080
purple 6 800080
turqoise 7 008080
white 8 C0C0C0

Возможные параметры

-F, --foreground < COLOR >

  • устанавливает цвет символов. На месте < COLOR > указывается либо название цвета словом (из вышеперечисленных вариантов), либо RGB-значение (доступно только в графическом режиме).
  • Примеры:
  • -F red
  • --foreground 255,0,255

-B, --background < COLOR >

  • устанавливает цвет фона. < COLOR > указывается, как в -F/--foreground;

-H, --highlight < COLOR >

  • устанавливает цвет выделенного символа. < COLOR > указывается, как в -F/--foreground;

-S, --speed < SPEED >

  • установить скорость падения символов в матрице. На месте < SPEED > должно быть натуральное число, которое определит, сколько символов в секунду будут падать.
  • Внимание: так как скорость регулируется с помощью функции _ksys_delay(1/100 sec), то вычисляется длительность простоя по формуле floor(100 / speed). Из этого следует, что скорости > 100 символов в секунду будут одинаково работать, а также некоторые значения в пределах [1; 100] тоже могут работать одинаково;

@ss

  • служебный параметр для запуска программы как скринсейвера. Строго рекомендуется его не использовать, если вы не знаете, что делаете;

--ccopt

  • оптимизация отрисовки (при смене цвета символа не будет обновляться фон под ним), которая понижает нагрузку на видеоадаптер/процессор. Работает только в графическом режиме, но выключена по умолчанию, так как отрисовка некоторых символов будет немного "размытой";

--shell

  • запустить программу в консольном режиме;

--help

  • отобразить текст с возможными параметрами для использования в программе;

--version

  • отобразить версию программы.