# Руководство &kblackbox;

## Что такое &kblackbox;?

&kblackbox; — интересная логическая игра с графическим интерфейсом. За её основу была взята игра blackbox из ОС emacs. Большая часть этого руководства взята из справки emacs.

&kblackbox; — игра в прятки на поле из ячеек. Ваш противник (в данном случае генератор случайных чисел) прячет несколько шаров в чёрном ящике. Вы, используя лазеры, должны исследовать содержимое ящика и указать места расположения шаров. Чем меньше лазеров вы используете для обнаружения шаров, тем лучше (меньше) ваш результат.

## Описание игры

В первой части этого раздела дано описание игрового поля, во второй — описание взаимодействия с пользователем и, наконец, в третьей — объясняются правила игры.

### Описание игрового поля

На игровом поле состоит из следующих ячеек:

Чёрные квадраты

- Это поля чёрного ящика. На нём вам нужно отмечать квадраты в которых, по вашему мнению, находятся шары.

Зелёные квадраты

- Это лазеры. При включении они приобретают более яркий зеленый цвет.

Светло-серые квадраты

- Ничего интересного, просто границы :-).

Синие шары

- Вы думаете, что шар находится именно здесь? Синим шаром (меткой) отмечается предположительное место нахождения шара в чёрном ящике.

Голубые шары

- Поля, в которых действительно находятся шары.

Красные шары

- Неверно отмеченные места нахождения шаров в чёрном ящике окрашиваются в красный цвет.

Коричневые квадраты

- Цвет отметки

Названия цветов используются только для определения различных типов полей в этом тексте. Они не обязательно соответствуют цветам полей в игре. Важно понять главное: в центре — чёрный ящик, вокруг него лазеры, а вокруг них — границы поля. С расстановкой цветов разбирайтесь сами :-).

### Взаимодействие с пользователем

Курсор можно перемещать по игровому полю с помощью стрелок клавиатуры или с помощью мыши. Включение лазеров или установка меток на чёрном ящике выполняются левой кнопкой мыши, а также нажатием кнопки Ввод.

Также можно отмечать поля, на которых шаров, по вашему мнению, точно нет ("коричневые поля"). Для этого нажимайте правую кнопку мыши. Это поможет вам в поиске области, в которой шар может быть. Для снятия пометок (синих или коричневых) нажмите левую кнопку мыши. Коричневые метки не могут быть установлены поверх синих. Это предотвращает случайное стирание синих меток.

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

### Правила игры

Необходимо найти расположение шаров, скрытых в чёрном ящике. Для этого можно использовать только лучи лазеров, расположенных вокруг ящика. Возможны три варианта прохождения лучей каждого из лазеров через ящик:

Отклонение

- Луч отклоняется и выходит не в том месте куда был направлен. На игровом поле места входа и выхода отмечены одинаковыми цифрами — одна в месте, где луч вошёл в чёрный ящик, другая — в том месте, где он вышел.

Отражение

- Луч отражается и выходит в том же месте, где и вошел. На игровом поле в этом месте появляется буква R (от Reflection).

Поглощение

- Луч попадает в шар и поглощается, в результате чего он не выходит из ящика. На игровом поле такой случай отмечается буквой H (от Hit).

Правила взаимодействия шаров и лучей просты, и лучше всего видны на примере.

При столкновении с шаром луч отклоняется на девяносто градусов. Лучи могут быть отклонены несколько раз. В примерах ниже чёрточки являются пустыми полями ящика, а буквами O обозначены шары. Вход и выход каждого луча отмечены числами, как описано в пункте Отклонение выше. Обратите внимание, что путь луча всегда обратим (вход можно поменять с выходом). Путь, пройденный лучом, обозначается * .

Обратите внимание на положение шара и 90-градусное отклонение луча, которое он вызывает.

    1
      - * - - - - - -         - - - - - - - -         - - - - - - - -
      - * - - - - - -         - - - - - - - -         - - - - - - - -
    1 * * - - - - - -         - - - - - - - -         - O - - - - O -
      - - O - - - - -         - - O - - - - -         - - * * * * - -
      - - - - - - - -         - - - * * * * * 2     3 * * * - - * - -
      - - - - - - - -         - - - * - - - -         - - - O - * - -
      - - - - - - - -         - - - * - - - -         - - - - * * - -
      - - - - - - - -         - - - * - - - -         - - - - * - O -
                                    2                         3

Как сказано выше, отражение означает, что луч возвращается в точку из которой он выходит. Такая ситуация может возникнуть в нескольких случаях:

    - - - - - - - -         - - - - - - - -          - - - - - - - -
      - - - - O - - -         - - O - O - - -          - - - - - - - -
    R * * * * - - - -         - - - * - - - -          O - - - - - - -
      - - - - O - - -         - - - * - - - -        R - - - - - - - -
      - - - - - - - -         - - - * - - - -          - - - - - - - -
      - - - - - - - -         - - - * - - - -          - - - - - - - -
      - - - - - - - -       R * * * * - - - -          - - - - - - - -
      - - - - - - - -         - - - - O - - -          - - - - - - - -

В первом примере луч отклоняется вниз верхним шаром, затем влево нижним шаром, после чего возвращается в точку из которой вышел. Второй пример подобен первому. Третий пример является немного необычным, но может быть решён, исходя из того, что луч не может остаться в ящике. Либо, о луче можно думать как об отклоненном вниз и сразу же вышедшем из ящика.

Поглощение происходит, когда луч попадает прямо в шар:

    - - - - - - - -         - - - - - - - -          - - - - - - - -
      - - - - - - - -         - - - - - - - -          - - - - O - - -
      - - - - - - - -         - - - - O - - -        H * * * * - - - -
      - - - - - - - -       H * * * * O - - -          - - - * - - - -
      - - - - - - - -         - - - - O - - -          - - - O - - - -
    H * * * O - - - -         - - - - - - - -          - - - - - - - -
      - - - - - - - -         - - - - - - - -          - - - - - - - -
      - - - - - - - -         - - - - - - - -          - - - - - - - -

Сравните второй пример поглощения с первым примером отражения.

## Описание интерфейса

### Меню Игра

&Ctrl;N Игра Создать

- Начало новой игры (и прерывание текущей).

Игра Сдаюсь

- Показывает расположение шаров в ящике.

Игра Готово

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

Игра Изменить размер

- Изменяет размер главного окна так, чтобы его содержимое отображалось наилучшем образом. Это удобно, если вы случайно измените размер окна...

&Ctrl;Q Игра Выход

- Выход из &kblackbox;

### Меню Настройка

Настройка Показать/Скрыть панель инструментов

- Показать или скрыть панель &kblackbox;

Настройка Показать/Скрыть строку состояния

- Показать или скрыть строку состояния в нижней части окна &kblackbox;

Настройка Размер

- Устанавливает размера игрового поля (чёрного ящика). Доступны размеры 8 x 8, 10 x 10 и 12 x 12. Размер по умолчанию — 8 x 8.

Настройка Шары

- Устанавливает количество шаров в черном ящике. Вы можете выбирать между 4 (по умолчанию), 6 или 8 шарами.

Настройка Обучение

- Включает обучающий режим. В обучающем режиме, Вы можете видеть расположение шаров в чёрном ящике. Учтите, что режим активируется только когда вы начнёте новую игру.

Настройка Комбинации клавиш...

- Отображает стандартный диалог выбора комбинаций клавиш &kde;, в нем Вы можете изменять комбинации клавиш используемые в &kblackbox;.

Настройка Настройки панели инструментов...

- Отображает стандартный диалог конфигурации панели инструментов &kde;, для настройки панели &kblackbox;.

### Меню Справка

&help.menu.documentation;

### Панель инструментов

панель &kblackbox;

Панель инструментов &kblackbox; обеспечивает быстрый доступ к часто используемым функциям &kblackbox;. Иконки означают (слева на право):

Создать

- Начать новую игру.

Сдаюсь

- Показывает расположение шаров в ящике.

Готово

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

## Авторские права и лицензирование

&kblackbox;

Разработка (с) 1998-2000 &Robert.Cimrman; &Robert.Cimrman.mail;

Документация: &Robert.Cimrman;. Обновление и преобразование к формату руководства &kde; 2.0 — &Lauri.Watts; &Lauri.Watts.mail;

Текущий сопровождающий: &Philip.Rodrigues; &Philip.Rodrigues.mail;

Перевод на русский — Стас Ивановf0ma@smtp.ru, редактирование перевода — Николай Шафоростовshafff@ukr.net

&underFDL; &underGPL;

## Установка

&install.intro.documentation;

### Сборка и установка

&install.compile.documentation;