# Підручник з &palapeli;

## Вступ

&palapeli; гра у складанку для одного гравця.

Вікно програми &palapeli; поділено на дві частини: панель збірки складанок і поле для гри. Далі у підручнику ми зупинимося на описі цих двох частин.

## Перегляд збірки складанок

Після першого запуску &palapeli; до вашої збірки складанок буде додано декілька типових складанок, які постачаються разом з &palapeli;. Натисніть пункт складанки, щоб негайно розпочати гру. Гра відбуватиметься на полі для гри. Настанови щодо користування полем для гри наведено у одному з наступних розділів.

Окрім позначення складанки, збіркою складанок можна скористатися для виконання таких дій:

- створення головоломок з зображень, що зберігаються на диску,

- імпорту складанок, створених іншими користувачами,

- експорту складанок, якими ви бажаєте поділитися з друзями та іншими користувачами,

- вилучення вже не потрібних вам складанок.

У наступному розділі наведено інструкції з виконання цих завдань за допомогою кнопок панелі інструментів.

### Огляд панелі інструментів

Позначити складанку у списку складанок можна одночасним натисканням клавіші &Ctrl; і лівої кнопки миші. Одночасне натискання лівої і правої кнопки миші без натискання клавіші &Ctrl; призведе до відкриття вказаної складанки на ігровому полі.

Створити складанку

- Відкриває діалогове вікно, за допомогою якого ви зможете створити складанку на основі зображення, що зберігається на вашому диску. Докладніше про це у наступному розділі.

Вилучити

- Будь-яку з позначених вами складанок у списку складанок буде назавжди вилучено з вашої бібліотеки.

  Наслідки цієї дії неможливо скасувати.

Імпортувати з файла

- Після звантаження файла складанки &palapeli; (такі файли зазвичай позначаються суфіксом назви `*.puzzle`), ви можете скористатися цією кнопкою для імпортування складанки до вашої збірки. Крім того, почати гру можна простим натисканням позначки файла складанки у обраному вами інструменті керування файлами, але після імпортування пункт складанки з’явиться у вашій локальній збірці, отже ви зможете безпечно вилучити звантажений файл складанки.

Експортувати до файла

- За допомогою цієї кнопки можна експортувати позначені складанки до файлів з метою наступного передавання їх вашим друзям, оприлюднення у мережі або створення резервної копії вашої збірки.

## Створення нових складанок

Як було описано у попередньому розділі, ви можете створювати складанки натисканням кнопки Створити нову складанку на панелі збірки складанок.

Після натискання цієї кнопки буде відкрито діалогове вікно створення складанки. Це вікно складається з трьох сторінок:

1. За допомогою першої сторінки можна вибрати файл зображення, яке буде розрізано на шматочки. Не забудьте ввести належні метадані зображення: вам слід подякувати авторові зображення (наприклад фотографові або художнику); будь ласка, ставтеся до авторських прав на зображення з повагою.

2. За допомогою другої сторінки ви можете вибрати тип шматочків, на які буде розрізано зображення. До складу пакунка &palapeli; включено збірку інструментів розрізання, ви можете також встановити додаткові інструменти розрізання.

3. За допомогою останньої сторінки діалогового вікна ви зможете налаштувати вибраний інструмент розрізання. Ви, наприклад, можете вибрати іншу кількість шматочків або змінити параметри форми шматочків. Набір параметрів, які можна змінити, залежить від вибраного інструменту розрізання.

У цьому підручнику обговорено інструменти розрізання, які є частиною пакунка &palapeli;. Якщо вами було звантажено сторонній інструмент розрізання для &palapeli;, будь ласка, зверніться до документації з цього додатка, якщо у вас виникають проблеми зі встановленням або його використанням у вашій системі.

### Збірка інструментів розрізування &palapeli;

Збірка інструментів розрізування створює реалістичні шматочки заголовки на основі різноманітних основних візерунків:

Прямокутна сітка

- Містить добре відомі прямокутні шматочки.

Каїрська сітка

- Складання п’ятикутних шматочків з нерівними кутами за умови використання цього розрізання є доволі складним, оскільки шматочки розташовано у мозаїці незвичним чином.

Шестикутна сітка

- Створює шестикутні шматочки, які розташовано у сітці подібно до комірок у бджолиних стільниках.

Ромбо-тригексагональна сітка

- Особлива комбінація трикутних, шестикутних та прямокутних шматочків створює візерунок подібний до набору кіл, що перетинаються.

Неправильна сітка

- Цим розрізанням можна буде скористатися, лише якщо встановлено програму qvoronoi з пакунка qhull. qvoronoi використовується для обчислення неправильних форм шматочків на основі випадково розташованих точок.

У наборі інструментів розрізання &palapeli; передбачено різноманітні параметри, які керують формою країв шматочків, зокрема «язичків». Для кожного з параметрів визначено типові значення. Передбачено також додатковий режим, за якого кількість параметрів зводиться до розумного мінімуму. Зазвичай можна визначити значення таких параметрів:

Приблизна кількість шматочків

Частина шматочків зі зворотним з’єднанням

- Ймовірність того, що «язичок» буде віддзеркалено. «Язичок» вважається віддзеркаленим, якщо його розташовано у напрямку, протилежному до повністю правильної сітки. У прямокутній сітці використання віддзеркалених «язичків» призведе до появи шматочків з 3 або 4 «язичками» або «вирізами». Якщо повзунок буде розташовано у крайній лівій позиції, буде створено звичайну повністю правильну сітку. Якщо повзунок перебуватиме у середній позиції, буде використано випадкову орієнтацію «язичків». Якщо повзунок перебуватиме у крайній правій позиції, сітка знову стане правильною, але з використанням правила чергування. Використання цього правила не означатиме інверсії всіх «язичків»: у такій правильній сітці, наприклад, всі шматочки матимуть або чотири «язички», або чотири «вирізи. Зміна значення цього параметра не вплине на формування неправильної сітки.

Кривина країв

- Визначає ступінь викривлення країв шматочків, тобто ступінь використання «вирізів» та «виступів». Пересуньте повзунок у крайню ліву позицію, щоб отримати прямі лінії країв (окрім «язичків»).

Розмір язичка

- Визначає розмір «язичка» на кожному з країв. Якщо повзунок перебуватиме у типовій (середній) позиції, складанка матиме класичну форму. Змінити розміри «язичків» можна у діапазоні від 50% до 150% (доволі великі «язички»). Програма намагається уникнути можливих перетинів «язичків». У разі перетину програма змінює форму шматочків. Все ж іноді розв’язок знайти не вдається, особливо у разі використання «язичків» великих розмірів.

Відмінність кривин

- Визначає рівень зміни кривини (див. вище) між краями. Пересуньте повзунок у крайню ліву позицію, щоб «вирізи» і «виступи» виглядатимуть однаково. Якщо повзунок буде пересунуто у крайню праву позицію, можливе створення шматочків з дуже викривленими або дуже прямими краями.

Відмінність розташування «язичків»

- Визначає рівень зміщення позиції «язичка» на краю шматочка. Якщо повзунок буде пересунуто у крайню ліву позицію, «язички» розташовуватимуться точно посередині краю шматочка.

Відмінність між «язичками»

- Визначає форму окремих «язичків». Якщо повзунок буде пересунуто у крайню ліву позицію, «язички» матимуть однакову форму. Якщо повзунок перебуватиме у крайній правій позиції, кожне з «язичків» матиме власну форму, спеціально створену для вас.

Неправильна сітка: Відмінність у розмірах шматочків

- Лише для неправильної сітки: визначає рівень зміни розмірів шматочків. Дуже малі значення параметра відповідають повній незмінності розмірів (структура кристала). Більші значення призводять до появи дуже маленьких і дуже великих шматочків.

Збереження зображення сітки

- Зберегти зображення сітки (чорні лінії на білому тлі) до файла `~/goldber-slicer-dump.png`. Якщо зображення з такою назвою вже існуватиме, його буде перезаписано.

### Застарілі інструменти розрізування

З історичних причин до складу &palapeli; також включено інструменти розрізання «Класичних шматочків складанки» та «Прямокутних шматочків». За допомогою цих інструментів розрізання можна створити прості прямокутні шматочки з або без з’єднувальних «язичків». У обох інструментах розрізання можна визначити кількість шматочків і співвідношення розмірів шматочків. Якщо перетягнути повзунок співвідношення розмірів у крайню ліву позицію, буде створено вузькі високі шматочки. Перетягування повзунка у крайню праву позицію призведе до створення широких низьких шматочків. За типових налаштувань програма створює майже квадратні шматочки.

## Поле для гри

Поле для гри (докладно)

Метою гри є збирання початкового зображення з його шматочків.

Шматочки можна пересувати довільним чином: достатньо навести на шматочок вказівник миші, натиснути ліву кнопку миші і перетягнути шматочок у бажане місце. Позначити декілька шматочків одразу можна утримуванням натиснутою клавіші &Ctrl; з одночасним клацанням лівою кнопкою миші або утримуванням натиснутою лівої кнопки миші під час перетягування області позначення так, щоб вона містила всі шматочки, які ви бажаєте позначити.

Якщо ви пересунете шматочок так, що він опиниться поряд з сусіднім, програма автоматично пов’яже ці шматочки між собою (1). Після прив’язування шматочки вже не можна буде відокремити. На відміну від реальних складанок у цій грі ви не зможете з’єднати два шматочки, розташовані у різних частинах зображення.

За допомогою смужки поступу, розташованої під полем для гри, програма показуватиме вам поступ складання (2). &palapeli; автоматично зберігатиме дані про поступ після кожного ходу, отже, зазвичай, вам не слід перейматися постійним зберіганням даних на диск.

За допомогою прокручування коліщатка миші або пересування повзунка, розташованого у вікні внизу праворуч (3), ви зможете змінити масштаб поля для гри. Наведення вказівника миші на точку поля для гри з наступним натисканням правої кнопки і перетягуванням надасть вам змогу пересувати область перегляду полем.

Пересувати шматочки можна лише у межах поля для гри. Межу цього поля позначено світлою прямокутною формою. Після того, як ви пересунете шматочок до цієї межі (4), програма автоматично збільшить розміри поля для гри, щоб надати вам більше місця для пересування шматочків. Якщо навести вказівник миші на межу світлої області, програма змінить форму вказівника на двобічну стрілку, що означатиме, що ви можете змінити розміри поля для гри перетягуванням його меж за допомогою вказівника миші (достатньо утримувати натисненою ліву кнопку миші і перетягнути вказівник).

Ви можете заблокувати розміри поля для гри натисканням невеличкої кнопки (5), розташованої поряд зі смужкою поступу. Після цього затінена область (4) зробиться темнішою, а перетягування шматочків до межі вже не призводитиме до збільшення поля для гри. Розміри поля для гри можна буде змінити вручну.

### Дії за допомогою миші

Як ми вже зазначали у попередньому розділі, існує багато способів керування полем для гри &palapeli; за допомогою миші. Ви можете самі призначити відповідні дії до кнопок миші в уподобаний вами спосіб. Докладніший опис налаштування наведено у розділі Налаштування гри. У наведеному нижче списку викладено резюме можливих дій за допомогою миші:

Зміна розмірів поля гри перетягуванням його країв

- Типово цю дію пов’язано з лівою кнопкою миші.

Пересування шматочків перетягуванням

- Якщо ви наведете вказівник миші на шматочок, натиснете кнопку миші і перетягнете вказівник, шматочок перетягнеться з ним. Якщо було позначено декілька шматочків, перетягатимуться всі шматочки. Типово цю дію пов’язано з лівою кнопкою миші.

Пересування поля огляду перетягуванням

- Типово цю дію пов’язано з правою кнопкою миші.

Позначення декількох шматочків одразу

- Якщо ви наведете вказівник не на шматочок, а на вільне місце поля для гри і натиснете кнопку миші, після перетягування вказівника буде створено область позначення. Після того, як ви відпустите кнопку миші, всі шматочки у області позначення буде позначено. Позначення з усіх інших шматочків буде знято. Типово цю дію пов’язано з лівою кнопкою миші.

Позначення шматочків клацанням

- Якщо ви наведете вказівник на непозначений шматочок і клацнете кнопкою миші, шматочок буде позначено. Якщо шматочок вже було позначено, після клацання позначення з нього буде знято. Типово цю дію пов’язано з лівою кнопкою миші, скористатися нею можна, лише якщо ви утримуєте натиснутою клавішу &Ctrl;.

Увімкнути/Вимкнути стан блокування поля для гри

- Ця дія тотожна дії, яка виконується після натискання кнопки (5) на смужці стану. Типово цю дію не пов’язано з жодною з кнопок миші, але ви можете пов’язати її з кнопкою за допомогою діалогового вікна налаштування.

Гортати поле огляду горизонтально і Гортати поле огляду вертикально

- Типово цю дію не пов’язано з коліщатком миші, але ви можете пов’язати її з кнопкою за допомогою діалогового вікна налаштування.

Масштабування поля огляду

- Ця дія тотожна до дії, яка виконується у відповідь на пересування повзунка (3) на смужці стану. Типово цю дію пов’язано з коліщатком миші.

### Огляд панелі інструментів

Почати складанку з початку

- Вилучити дані щодо складання поточної складанки.

## Огляд інтерфейсу

Обидві панелі (частини) вікна &palapeli;, панель збірки складанок та поле для гри, вбудовано до смужки меню як вкладки. Крім того, на смужці меню передбачено два меню, про пункти яких ми поговоримо нижче.

### Меню Параметри

Параметри Показати смужку стану

- Вмикає або вимикає показ смужки поступу і кнопок, розташованих під полем для гри. Використання цього пункту нічого не змінить на панелі збірки складанок.

Параметри Налаштувати скорочення...

- Відкриває діалогове вікно, у якому ви зможете налаштувати клавіатурні скорочення у &palapeli;.

Параметри Налаштувати &palapeli;...

- Відкриває діалогове вікно налаштування гри. Докладніше про це вікно можна дізнатися з розділу Налаштування гри.

### Меню Довідка

&help.menu.documentation;

## Налаштування гри

Щоб відкрити діалогове вікно налаштування, скористайтеся пунктом меню Параметри Налаштувати &palapeli;...

### Загальні параметри

Тло

- Надає вам змогу вибрати іншу текстуру тла для поля для гри. Якщо ви надасте перевагу використанню кольорового тла замість текстури, ви зможете скористатися кнопкою, розташованою поруч з полем для вибору, для визначення кольору.

Вигляд шматочків

- Керує виглядом шматочків на полі складанки. Якщо &palapeli; працює дуже повільно або відкриття складанок триває дуже довго, ви можете вимкнути графічні ефекти з цієї категорії, щоб пришвидшити роботу програми.

Точність прив’язки

- Надає вам змогу визначити граничну відстань між сусідніми шматочками, за досягнення якої програма прив’язуватиме ці шматочки один до одного. Якщо ви пересунете повзунок праворуч, шматочки прилипатимуть один до одного навіть на значній відстані. За допомогою цього пункту можна значно спростити процес гри.

### Взаємодія з мишею

За допомогою цієї сторінки діалогового вікна налаштування ви зможете визначити прив’язку кнопок миші до дій, описану у розділі Поле для гри. Пункти дій поділено на ті, які можна пов’язати з кнопками миші (наприклад Пересування поля огляду перетягуванням), і ті, які можна пов’язати з коліщатком миші (наприклад Гортати поле огляду горизонтально).

#### Вкладка Кнопки миші

Поряд з пунктом кожної з дій наведено зображення миші, за допомогою якого можна бачити поточну прив’язку. Щоб змінити прив’язку наведіть вказівник на цю кнопку і клацніть лівою кнопкою миші, а потім кнопкою миші, яку ви бажаєте пов’язати з дією. Якщо під час клацання другою кнопкою миші буде натиснуто клавішу-модифікатор, відповідна дія виконуватиметься, лише якщо буде натиснуто клавішу-модифікатор.

Крім того, замість клацання ви можете натиснути клавішу Пробіл, що не пов’язувати дію з будь-якою з кнопок (Без кнопки). Подібна прив’язка можлива, лише якщо утримується натиснутою одна з клавіш-модифікаторів. Прив’язка Без кнопки означає, що роль кнопок миші виконуватиме клавіша-модифікатор: дію буде виконано у відповідь на натискання клавіші-модифікатора, виконання дії припинятиметься, щойно клавішу-модифікатор буде відпущено.

#### Вкладка Коліщатко миші

Можливості цієї вкладки подібні до можливостей попередньої. Призначати дії слід прокручуванням коліщатка миші, а не клацанням кнопкою. Натискання клавіш-модифікаторів під час призначення призводитиме до тих самих наслідків, що і на попередній вкладці.

Якщо на вашій миші встановлено коліщатко миші з можливістю зміни напрямку (це зокрема стосується більшості сенсорних панелей ноутбуків), ви зможете скористатися перевагами цього способу керування: програма розпізнаватиме гортання коліщатком у обох напрямках, горизонтальному і вертикальному.

## Подяки і ліцензія

Метою створення &palapeli; є надати вам змогу відпочити за ненав’язливою грою у складанку на вашому комп’ютері.

Ідею гри було вперше висунуто Бернардом Шифнером (Bernhard Schiffner) разом з Стефаном Маєвські (Stefan Majewsky), який і є поточним провідним розробником &palapeli;. Збірку інструментів розрізування було створено Johannes Löhnert.

Авторські права на документацію до програми належать Stefan Majewsky, Johannes Löhnert, 2009, 2010.

Переклад українською: Юрій Чорноіван yurchor@ukr.net

&underFDL; &underGPL;

## Встановлення

&install.intro.documentation;

### Збирання і встановлення

&install.compile.documentation;
&documentation.index;