File: EXTENDING.txt

package info (click to toggle)
tuxpaint 1%3A0.9.28-sdl2-1
  • links: PTS, VCS
  • area: main
  • in suites: bookworm
  • size: 39,144 kB
  • sloc: ansic: 46,280; makefile: 1,294; sh: 664; objc: 303; cpp: 120; python: 75
file content (488 lines) | stat: -rw-r--r-- 31,309 bytes parent folder | download | duplicates (3)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
414
415
416
417
418
419
420
421
422
423
424
425
426
427
428
429
430
431
432
433
434
435
436
437
438
439
440
441
442
443
444
445
446
447
448
449
450
451
452
453
454
455
456
457
458
459
460
461
462
463
464
465
466
467
468
469
470
471
472
473
474
475
476
477
478
479
480
481
482
483
484
485
486
487
488
                                   Tux Paint
                                 версия 0.9.16
                           Дополнительные возможности

                Copyright 2002-2006 by Bill Kendrick and others
                               New Breed Software

                           bill@newbreedsoftware.com
                   http://www.newbreedsoftware.com/tuxpaint/

                        14 июня 2002 - 28 сентября 2006

OUT OF DATE

                              See English version.

     ----------------------------------------------------------------------

   Вы можете без особого труда добавлять или изменять такие объекты
   Tux Paint, как кисти или штампы, просто добавляя или удаляя файлы на
   жёстком диске.

   Примечание: для применения эффекта требуется перезагрузить Tux Paint.

Местоположение файлов

  Стандартные файлы

       Tux Paint ищет файлы с различными данными в своей директории "data".

    Linux и Unix

         Местонахождение этой директории зависит от того, какое значение
         "DATA_PREFIX" было установлено при компиляции Tux Paint. Подробности
         см. в INSTALL.txt.

         По умолчанию, однако, это:

           /usr/local/share/tuxpaint/

         При установки из архива более вероятно:

           /usr/share/tuxpaint/

    Windows

         Tux Paint ищет папку под названием "data" в той директории, где
         расположен исполняемый файл. Это директория, которую использует
         инсталлятор при установке Tux Paint, например:

           C:\Program Files\TuxPaint\data

    Mac OS X

         Tux Paint хранит файлы данных внутри иконки "Tux Paint" (которая в
         действительности представляет особый вид папки в Mac OS X).
         Следующие шаги объясняют, как получить содержимое папки:

          1. Вызовите контекстное меню, щёлкнув мышкой по иконке Tux Paint в
             Проводнике с одновременным удержание клавиши [Control]. (Если у
             Вас мышь с более, чем одной кнопкой, Вы можете просто выполнить
             правый клик по иконке.)
          2. Выберите "Show Contents" из контекстного меню. Появится новое
             окно Проводника с папкой "Contents".
          3. Откройте папку "Contents", а затем папку "Resources" внутри.
          4. Здесь Вы найдёте папки "starters", "stamps" и "brushes".
             Добавление файлов в эти папки приводит к созданию контента,
             доступного пользователям при запуске данной копии (иконки)
             Tux Paint.

         Примечание: Если вы устанавливаете новую версию Tux Paint (заменяя
         его иконку), изменения, внесённые согласно вышеприведённым
         инструкциям, будет потеряны, так что не забудьте сделать резервную
         копию нового содержимого (штампов, кистей и т.д.).

         Tux Paint также ищет файлы в папке "TuxPaint", которую Вы можете
         поместить в системную папку "Application Support" (находится в
         корневой директории "Library"):

           /Library/Application Support/TuxPaint/

         Также файлы ищутся в пользовательской папке "Preferences", например:

           /Users/(имя пользователя)/Library/Preferences/TuxPaint/brushes/

     ----------------------------------------------------------------------

  Персональные файлы

       Вы также можете создавать кисти, штампы, шрифты и "начальные
       изображения" в Вашей собственной директории (папке).

    Windows

         Ваша персональная папка Tux Paint хранится в пользовательской папке
         "Application Data". Например, в последних версиях Windows:

           C:\Documents and Settings\(имя пользователя)\Application
           Data\TuxPaint\

    Mac OS X

         Ваша персональная папка Tux Paint хранится в директории "Library":

           /Users/(имя пользователя)/Library/Application Support/ Tux Paint/

    Linux и Unix

         Ваша персональная папка Tux Paint — "$(HOME)/.tuxpaint/" (она же
         "~/.tuxpaint/").

         Таким образом, если Ваша домашняя директория "/home/karl", то папка
         Tux Paint — "/home/karl/.tuxpaint/".

         Не забудьте точку (".") перед 'tuxpaint'!

       Чтобы добавить кисти, штампы, шрифты и "начальные изображения",
       создайте папки внутри Ваших персональных директорий "brushes",
       "stamps", "fonts" и "starters" соответственно.

       (Например, если Вы создали кисть под именем "flower.png", поместите её
       в ~/.tuxpaint/brushes/" под Linux или Unix.)

     ----------------------------------------------------------------------

Кисти

     Кисти, используемые для рисования инструментами "Краска" и "Линии",
     представляют собой просто графические файлы в формате PNG.

     Альфа-канал (прозрачность) рисунка PNG используется, чтобы определить
     форму кисти. Это значит, что форма может сглаженной или даже частично
     прозрачной!

     Серые пиксели будут отрисовываться с использованием текущего цвета
     Tux Paint. Цветные пикселы будут подцвечены.

     Рисунок кисти не должен быть шире 40 пикселов и выше 40 пикселов (т.е.,
     максимальный размер — 40х40).

  Атрибуты кисти

       В отличие от простых рисунков, кистям могут быть приданы
       дополнительные атрибуты. Для этого следует создать "файл данных" для
       кисти.

       Файл данных кисти — это просто текстовый файл с перечислением
       атрибутов.

       У файла должно быть имя, совпадающее с именем рисунка PNG, но с
       расширением ".dat" (например, файл данных для "brush.png"' — текстовый
       файл "brush.dat", расположенный в той же папке).

    Пробелы в кистях

         Начиная с версии Tux Paint 0.9.16., Вы можете определять пробелы для
         кистей (т.е., с какой частотой они отрисовываются). По умолчанию,
         пробел равен четверти высоты кисти.

         Добавьте строку "spacing=N" в файл данных кисти, где N — пробел для
         кисти. (Чем меньше число, тем чаще кисть отрисовывается.)

    Анимированные кисти

         Начиная с версии Tux Paint 0.9.16., Вы можете создавать
         анимированные кисти. При использовании такой кисти, отрисовывается
         каждый кадр анимации.

         Вставьте каждый кадр в большой рисунок PNG друг за другом Например,
         если размер кисти 30х30 и у Вас 5 кадров, размер рисунка должен быть
         150х30.

         Добавьте строку "frames=N" в файл данных кисти, где N — количество
         кадров в кисти.

         Примечание: Для урежения частоты кадров добавьте строку "random" в
         файл данных кисти.

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

         Начиная с версии Tux Paint 0.9.16., Вы можете создавать направленные
         кисти. При использовании такой кисти рисуются различные изображения
         в зависимости от направления движения кисти.

         Рисунок PNG направленной кисти делится на квадраты 3х3. Например,
         если размер кисти 30х30, размер всего изображения должен быть 90х90
         и формы для каждого направления располагается в ячейках решётки 3х3.
         Центральная область используется при отсутствии движения кисти.
         Верхний правый угол используется при движении вправо вверх и т.д.

         Добавьте строку "directional" в файл данных кисти.

    Анимированные направленные кисти

         Вы можете объдинить возможности анимации и направленности в одной
         кисти. Укажите оба параметра ("frames=N" и "directional") в разных
         строках файла "".dat" кисти.

         Создайте для каждого кадра набор 3х3 направленных форм и объедините
         их в одном рисунке PNG друг за другом. Например, для кисти размером
         30х30 и 5 кадров, размер рисунка будет 450х90. (Самые левые 150х90
         пикселов, например, представляют 9 направленных форм для первого
         кадра.)

     Расположите файлы PNG с изображением кистей (и текстовые файлы данных) в
     папке "brushes".

     Примечание: если все Ваши кисти выводятся как квадраты или
     прямоугольники, это потому, что Вы забыли использовать альфа-канал
     прозрачности! Дополнительную информацию и подсказки см. в "PNG.txt".

     ----------------------------------------------------------------------

Штампы

     Файлы штампов выкладывают в папку "stamps". Для упорядочивания штампов
     полезно создавать вложенные папки. (Например, у Вас может быть папка
     "holidays" с вложенными папками "halloween" и "christmas".)

  Изображения

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

       Штампы, используемые в Tux Paint представляют собой рисунки PNG. Они
       могут быть полноцветными или в оттенках серого. Альфа-канал
       (прозрачность) PNG используется для определения формы рисунка (в
       противном случае штамп будет прямоугольным).

       Штампы могут быть разного размера, но на практике, размер 100 пикселей
       ширины на 100 пикселей высоты (100 x 100) обычно достаточен.

       Примечание: если новый штамп имеет видимый прямоугольный контур или
       непрозрачный фоновый цвет (например, чёрный или белый), значит Вы
       забыли использовать альфа-канал! Дополнительную информацию и подсказки
       см. в "PNG.txt".

       Опытным пользователям: Расширенное руководство по штампам детально
       описывает, как создавать хорошо масштабируемые изображения для
       штампов.

     ----------------------------------------------------------------------

  Текстовое описание

       Текстовые (".TXT") файлы с такими же именами, что и файлы PNG
       (например, описание для "picture.png"' находится в файле "picture.txt"
       в той же папке).

       Первая строка текстового файла будет использоваться как описание
       штампа на американском английском. Она должна быть закодирована в
       UTF-8.

    Поддержка языков

         В текстовый файл могут быть добавлены дополнительные строки, чтобы
         опеспечить перевод описания. Они показываются, когда Tux Paint
         запускается под иной локалью (например, русской или испанской).

         В начале строки должен идти код языка (например, "ru" для русского
         или "zh_tw" для традиционного китайского), далее следует ".utf8=" и
         затем переведённое описание (кодированное в UTF-8).

         В директории "po" есть скрипты для конвертирования текстовых файлов
         в формат PO (и обратно) для облегчения перевода на различные языки.
         Таким образом, Вы не должны добавлять или изменять переводы прямо в
         текстовых файлах.

         Если не доступен перевод для языка, под которым Tux Paint в данный
         момент запущен, используется текст на американском английском.

    Пользователям Windows

         Используйте Блокнот или WordPad для редактирования/создания этих
         файлов. Убедитесь, что сохранили как простой текст с расширением
         ".txt" в конце имени файла...

     ----------------------------------------------------------------------

  Звуковые эффекты

       Файлы WAVE (".WAV") с таким же именем, как PNG (например, звуковой
       эффект для "picture.png"' — "picture.wav" в той же папке).

    Поддержка языков

         Для звуков в разных локалях (например, если звуковой эффект содержит
         слово, и Вы желаете это слово перевести) также создайте файл WAV с
         кодом языка в имени файла в формате: "ШТАМП_ЯЗЫК.wav"

         Например, русская версия звукового эффекта для "picture.png"' должна
         храниться в "picture_ru.wav". Французская версия — "picture_fr.wav".
         И так далее...

         Если локализованный звуковой эффект невозможно загрузить, Tux Paint
         попытается загрузить звуковой эффект "по умолчанию" (например,
         "picture.wav").

     ----------------------------------------------------------------------

  Настройки штампов

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

       Файл данных штампа — это просто текстовый файл с настройками.

       У файла такое же имя как и у рисунка PNG, но с расширением ".dat"
       (например, файл данных для "picture.png"' — текстовый файл
       "picture.dat" в той же папке).

    Окрашенные штампы

         Штампы могут быть либо "окрашиваемыми", либо "подкрашиваемыми".

      Окрашиваемые

           "Окрашиваемые" штампы используются подобно кистям — Вы выбираете
           штамп, а затем — цвет, в который желаете его окрасить (в качестве
           примера можно привести штампы-символы, например математические или
           музыкальные).

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

           Добавьте строку "colorable" в файл данных штампа.

      Подкрашиваемые

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

           Добавьте строку "tintable" в файл данных штампа.

        Настройки смешения цветов:

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

             "tinter=normal" (по умолчанию)
                     Нормальный режим.

             "tinter=anyhue"
                     ???.

             "tinter=narrow"
                     ???.

             "tinter=vector"
                     ???.

    Неизменяемые штампы

         По умолчанию, штамп может быть перевёрнут, зеркально отражён, или то
         и другое одновременно. Это можно сделать, используя кнопки ниже
         панели выбора штампов, внизу справа окна Tux Paint.

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

         Для запрета переворота добавьте строку "noflip" к файлу данных
         штампа.

         Для запрета отражения добавьте строку "nomirror" к файлу данных
         штампа.

    Начальный размер штампа

         По умолчанию, Tux Paint предполагает, что размер Вашего штампа
         подобран в расчёте на холст 608x472. Это оригинальный размер холста
         Tux Paint для экрана 640x480. Затем Tux Paint подгоняет размер
         штампа в соответствии с текущими размерами холста и, при наличии, с
         пользовательскими установками.

         Если Ваш штамп слишком велик или мал, Вы можете определить
         коэффициент масштабирования. Например, если Ваш штамп в 2,5 раза
         шире (или выше), чем должен быть, добавьте параметр "scale 40%" или
         "scale 5/2", или "scale 2.5", или "scale 2:5". При желании, можно
         использовать "=", например, "scale=40%".

    Пользователям Windows

         Для создания этого файла можете использовать Блокнот или WordPad.
         Убедитесь, что сохранили его как простой текст и дали расширение
         ".dat", а не ".txt"...

  Зеркальные изображения

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

       Для того, чтобы Tux Paint использовал подготовленную Вами версию, а не
       пытался перевернуть изображение самостоятельно, просто создайте второй
       файл PNG с таким же именем, за исключением частицы "_mirror" перед
       расширением.

       Например, для штампа "truck.png" Вы должны создать файл с именем
       "truck_mirror.png", который и будет использоваться при отражении
       штампа.

     ----------------------------------------------------------------------

Шрифты

     В Tux Paint используются шрифты TrueType (TTF).

     Просто поместите их в папку "fonts". Tux Paint загрузит шрифт и
     обеспечит поддержку четырёх размеров на панели выбора "Буквы" при
     использовании инструмента "Текст".

     ----------------------------------------------------------------------

"Начальные" изображения

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

     Однако, в отличие от сохранённых рисунков, открывая "начальное"
     изображение, Вы фактически создаёте новый рисунок. Этот рисунок
     отличается тем, что не является пустым, а содержит изображение из
     начального рисунка. Это содержимое влияет на создаваемый Вами рисунок.

     Раскраска

       Основной вид "начального" изображения — имитация картинки из
       книги-раскараски. Это контуры рисунка, которые Вы затем можете
       раскрасить и добавить детали. В то время как Вы рисуете, печатаете
       текст или добавляете штампы, контуры остаются "над" тем, что Вы
       рисуете. Вы можете стереть часть нарисованного Вами рисунка, но Вы не
       можете стереть контуры.

       Чтобы создать этот вид "начального" изображения, просто нарисуйте
       контурную картинку в какой-либо программе для рисования, сделайте
       остальную часть рисунка прозрачной (в Tux Paint это будет выглядеть
       белым) и сохраните в формате PNG.

     Фоновые изображения

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

       "Ластик", при использовании с рисунком на основе фонового изображения,
       не стирает до белого холста, а восстанавливает фон.

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

       Для создания этого вида "начального" изображения просто создайте
       оверлей (с использованием альфа-прозрачности), как описано выше, и
       сохраните как PNG. Затем создайте другой рисунок (без прозрачности) и
       сохраните его под тем же именем, но с добавленным окончанием "-back"
       (например, "reef-back.png" — фоновый рисунок, связанный с оверлеем
       "reef.png").

     "Начальные" изображения должны быть того же размера, что и холст
     Tux Paint. В принятом по умолчанию режиме 640x480, это 448x376 пиксел.
     Если Вы используете режим 800x600, следуетс взять 608x496. (На 192
     пикселя уже и 104 ниже разрешения).

     Расположите их в папке "starters". При вызове диалога "Открыть",
     "начальные" изображения появляются вверху списка, на зелёном фоне.

     Примечание: "Начальное" изображение невозможно изменить в самом
     Tux Paint'е, т.к. его загрузка — аналог создания нового рисунка (но с
     содержимым вместо пустого листа). Команда "Сохранить" просто создаст
     новую картинку, так же, как при использовании команды "Новая".

     Примечание: "Начальные" изображения "прикрепляются" к сохранённым
     рисункам посредством маленького текстового файла с таким же именем, но с
     расширением ".dat". Это позволяет сохранить оверлей и фон даже если,
     например, завершена работа Tux Paint, или загружена/начата другая
     картинка. (Иными словами, если Вы создали рисунок на основе "начального"
     изображения, оно постоянно будет присутствовать как часть рисунка).