簡介

"Tux Paint" 是專為年幼的兒童設計的繪圖程式，他提供容易使用的介面和固定尺寸的畫布， 以及可以使用縮圖瀏覽的方式來存取儲存的圖畫(註：不需直接讀取檔案系統)。

他只提供非常有限工具組，不像一般的繪圖程式如「GIMP」。總之，他提供非常容易使用的介面， 和具有娛樂性、以兒童為導向的附加效果像是音效等。

授權：

Tux Paint 是一個開放源碼的專案，以 GNU 通用公共授權(GPL)釋出的自由軟體。 他是自由的，而且也可以取得程式的源碼 (允許其他人加上新的功能，更正程式的錯誤， 及使用部份的程式在他們自已的 GPL 的軟體上)。

GNU 通用公共授權的全文請見 COPYING.txt 。

目標：

容易和有趣

Tux Paint 是一個給年幼兒童用的簡易繪圖程式。他並不是一個一般用途的繪圖程式， 他特點是在於有趣和容易使用。音效和卡通人物協助使用者了解現在要作什麼， 也讓他們保持歡樂。還有一個超大的卡通造型的滑鼠游標。

擴充性

Tux Paint 是可擴充的。筆刷及橡皮圖章的形狀可以加上及抽掉的。 例如老師可以加上一組動物的圖章，讓他的學生們來畫動物的生態。 每一個形狀可以在被畫的時候發出他們專屬的聲音， 也可以在小朋友選擇一個形狀時顯示出文字的說明。

移植性

Tux Paint 移植到許多不同的平台上，像是 Windows, Macintosh, Linux 等， 他們的使用介面看起來都是一樣的。Tux Paint 可以在舊的機器上跑的不錯 (像是 Pentium 133)。也可以為比較慢的系統建造一個跑起來還不錯的程式。

簡易的

他並不需要直接碰觸到電腦底層複雜的事情，離開程式的時候當下的圖形會保留住， 當啟動程式時會再出現。儲存圖形時不需要檔案名稱或是使用到鍵盤。 開啟圖形時是由一堆縮圖中挑選打開的。讀取電腦上的其他檔案是被禁止的。

其他文件

Tux Paint 的其他文件 (在 "docs" 目錄中) 包括：

• AUTHORS.txt
  作者及貢獻者的名單。
• CHANGES.txt
  版本差異的摘要。
• COPYING.txt
  授權聲明 (GPL)
• INSTALL.txt
  教導編輯和安裝的方式
• PNG.txt
  說明如何使用 Tux Paint 建立 PNG 的格式
• README.txt
  (本文)
• TODO.txt
  預計的功能或待修的程式臭虫

使用 Tux Paint

建構 Tux Paint

由源碼編譯 Tux Paint 請參考 INSTALL.txt 。

---

載入 Tux Paint

Linux/Unix 的使用者

在 shell 的提示符號(如： "$")後面輸入這個指令：

$ tuxpaint

也可以建立一個啟動的按鍵和小圖示 (例如在 Linux 上的 GNOME 或 KDE 桌面環境中)， 細節請參閱您的桌面環境的文件...

如果有任何的錯誤發生，錯誤訊息會顯示在終端機上(標準錯誤輸出介面)。

---

Windows 的使用者

Tux Paint

只要雙擊桌面上 "Tux Paint" 的圖示 (which was created for you by the installer)， 或是雙擊 'Tux Paint' 目錄裡的 "tuxpaint.exe" 的圖示。

如果有任何的錯誤發生，都會記錄在 Tux Paint 目錄的 "stderr.txt" 檔案裡。

關於如何透過捷徑來設定程式選項的方法，請參閱 "INSTALL.txt" 。

要直接提供命令列選項來啟動 Tux Paint ，您必須在 MSDOS 視窗中執行 "tuxpaint.exe" 。(細節請參閱 "INSTALL.txt" )

---

選項

規劃檔

您可以為 Tux Paint 建立一個在每次執行時都會去讀取的簡單的規劃檔。

這個檔案是純文字檔，裡面放的是您想要開啟的選項：

Linux 的使用者

這個檔案必須放在您的家目錄中，名為 ".tuxpaintrc"。 (就是 "~/.tuxpaintrc" 或 "$HOME/.tuxpaintrc")

在這個檔案被讀取之前，一個系統層級的規劃檔會先被讀取 (預設中這裡沒有任何的設定)。他的路徑是：

/etc/tuxpaint/tuxpaint.conf

您可以用命令列參數指定不要同時讀取這個檔案，預設是沒有的 (這可以使您的 ".tuxpaintrc" 和命令列參數失效)：

--nosysconfig

Windows 的使用者

這個檔案必須放在 Tux Paint 的目錄中，名為 "tuxpaint.cfg"。

您可以使用記事本(NotePad)或是 WordPad 來建立這個檔案，儲存時要確定選用純文字格式， 還有副檔名要確定不是使用 ".txt" ...

有效的選項

以下的設定可以在規劃檔中來作設定。 (命令列的參數可以推翻這些設定，請見後面的敘述)

fullscreen=yes

使用全螢幕模式。

800x600=yes

使用 800x600 螢幕模式(實驗性質)，一般是 640x480 。

nosound=yes

關閉音效。

noquit=yes

關閉螢幕上「離開」的按鍵。 (還是可以用 [Escape] 鍵或視窗右上角的關閉按鈕來離開程式。)

noprint=yes

關閉列印功能。

printdelay=SECONDS

限制列印的間隔時間，每次列印後需間隔 SECONDS 秒後才能再列印。

printcommand=COMMAND

(只限於 Linux 和 Unix )

使用這個 COMMAND 命令來列印 PNG 檔，如果沒有設定的話，預設的命令是：

pngtopnm | pnmtops | lpr

這是將 PNG 轉換成 NetPBM (可移植到任何圖像的格式)，再轉換成 PostScript 格式， 然後 "lpr" 命令把他送到印表機去列印。

printcfg=yes

(只限於 Windows)

Tux Paint 會在列印時使用印表機的規劃檔。當按下 [ALT] 鍵同時按下「列印」按鈕時， Tux Paint 會先開啟印表機的設定視窗。

(註：這只能在 Tux Paint 不是使用全螢幕模式時有作用。) 在設定視窗中的任何變動都會儲存在 "userdata/print.cfg" 檔案中， 當 "printcfg" 選項被設定時都會被重複使用。

simpleshapes=yes

關閉形狀工具的旋轉步驟。只需要點選中心位置，拖拉至適當大小然後放開滑鼠按鍵， 就可以畫出一個形狀來。

uppercase=yes

所有的英文字母都會變成大寫(例如："Brush" 會變成 "BRUSH")。 (這只適用在英文的訊息上。)

grab=yes

Tux Paint 會試著佔住滑鼠及鍵盤，所以滑鼠游標會被鎖在 Tux Paint 的視窗中，大部份的鍵盤輸入也都直接導向他。

這可以用在使 [Alt]-[Tab] 視窗切換的系統動作失效， 和使 [Ctrl]-[Escape] 失效等。特別是在全螢幕模式時非常有幫助。

noshortcuts=yes

這會使鍵盤的快捷鍵失效 (例如：[Ctrl]-[S] 存檔， [Ctrl]-[N] 開新圖，等等。)。

這可以減少不是那麼熟悉鍵盤操作的小朋友，輸入了不是預期中的命令。

nowheelmouse=yes

這可以取消滑鼠上滾輪的功能。 (正常來講滾輪可以捲動右邊的選擇目錄。)

nofancycursors=yes

這會使 Tux Paint 花俏的滑鼠游標失效，而使用系統正常的游標。

在某些環境中花俏的游標會有些問題，可以用這個選項來避開這個問題。

nooutlines=yes

這個模式可以簡化劃線，形狀，圖章和橡皮擦 工具的外框線及彈性線。

這對於在很慢的電腦上執行 Tux Paint 或是在遠端的 X-Window 顯示上很有幫助。

nostamps=yes

這個選項是告訴 Tux Paint 不要載入任何的圖章圖樣， 用來關閉橡皮圖章工具用的。

這可以加快 Tux Paint 第一次載入時的速度，也可以減少記憶體的使用量， 當然這也會造成沒有圖章可以使用的情況。

nostampcontrols=yes

有些圖章圖樣可以上下左右翻轉，或可改變大小。這個選項會關閉這些控制， 而且只會提供基本的圖章。

mirrorstamps=yes

有些圖章是可以左右相反的，這個選項會讓這些圖章預設就是相反的。

這可以幫助喜歡「由右至左」更甚於「由左至右」的人。

keyboard=yes

這會允許使用鍵盤的方向鍵來控制滑鼠的游標。 (例如：用在沒有滑鼠的環境中。)

方向鍵可以移動滑鼠的游標，空格鍵就像是滑鼠的按鍵。

savedir=DIRECTORY

這可以改變 Tux Paint 儲存圖形時的預設路徑。在 Linux 和 Unix 上的預設路徑是 "~/.tuxpaint/saved/" ，在 Windows 上則是 "userdata\"。

這很適合用在當 Tux Paint 是安裝在主機上，而小朋友是在工作站上來使用的 Windows 的教室裡。您可以設定 savedir 到他們的家目錄中。 (例如："H:\tuxpaint\")

註： 當指定一個 Windows 的磁碟裝置時 (如："H:\")， 您也必須指定一個子目錄。

例如： savedir=Z:\tuxpaint\

saveover=yes

這會關閉在儲存時出現「 儲存這張圖畫覆蓋掉舊的版本？ 」的提示。 使用這個選項，舊的版本會自動的被新的版本所覆蓋。

saveover=new

這也會關閉在儲存時出現「 儲存這張圖畫覆蓋掉舊的版本？ 」的提示。 使用這個選項，永遠會另存一張新圖，而不會覆蓋掉舊的版本。

saveover=ask

(這個選項已經是多餘的了，因為這已經是預設值了。)

當要儲存一張已經存過檔的圖畫時，您會先被訊問是否要覆蓋掉舊的版本。

lang=LANGUAGE

可以選擇一個已經支援的語文版本來啟動 Tux Paint， 目前包括有：

english	美式英文
basque	巴斯克文
bokmal	挪威文 (巴克摩)
british-english	英文 (英國)
brazilian-portuguese	巴西葡萄牙文	巴西
catalan	加泰隆尼亞文	西班牙
chinese	簡體中文
czech	捷克文
danish	丹麥文
dutch	荷蘭文
finnish	芬蘭文
french	法文
german	德文
greek	希臘文
hebrew	希伯來文
hungarian	匈牙利文
icelandic	冰島文
indonesian	印尼文
italian	義大利文
japanese	日文
korean	韓文
lithuanian	立陶宛文
malay	馬來文
norwegian	挪威文 (耐諾斯克)
polish	波蘭文
portuguese	葡萄牙文
romanian	羅馬尼亞文
russian	俄文
spanish	西班牙文
slovak	斯洛伐克文
swedish	瑞典文
tamil	坦米爾文
traditional-chinese	繁體中文	(新加入)
turkish	土耳其文
walloon	華隆文

---

使用 .tuxpaintrc 覆蓋系統規劃檔的選項設定

您可以在您自已的 "~/.tuxpaintrc" 檔案中設定覆蓋掉在 "/etc/tuxpaint/tuxpaint.config" 系統規劃檔中設定的選項。

像 "noprint" 及 "grab" 這類訊問是或否的選項， 您可以直接在您的 "~/.tuxpaintrc" 中設定他們為 'no'，像這樣子：

noprint=no
uppercase=no

您也可以使用稍後會提到的命令列的參數來設定，像這樣子：

print=yes
mixedcase=yes

---

命令列參數

當您啟動 Tux Paint 時可以使用命令列來下達參數。

--fullscreen
--800x600
--nosound
--noquit
--noprint
--printdelay=SECONDS
--printcfg
--simpleshapes
--uppercase
--grab
--noshortcuts
--nowheelmouse
--nofancycursors
--nooutlines
--nostamps
--nostampcontrols
--mirrorstamps
--keyboard
--savedir DIRECTORY
--saveover
--saveovernew
--lang LANGUAGE


以上是開啟或相對應規劃檔的選項。

--windowed
--640x480
--sound
--quit
--print
--printdelay=0
--noprintcfg
--complexshapes
--mixedcase
--dontgrab
--shortcuts
--wheelmouse
--fancycursors
--outlines
--stamps
--stampcontrols
--dontmirrorstamps
--mouse
--saveoverask


這些選項可以用來覆蓋規劃檔中的設定。 (如果規劃檔中沒有設定的話，就不需要覆蓋選項。)

--locale locale

執行某一個 Tux Paint 支援的語文版本。locale 字串(如："de_DE@euro" 是德文) 請見稍後 "選擇不同的語文" 這一個章節。

(如果您的 locale 已經使用系統變數 "$LANG" 來指定， 就不需要這個參數了。Tux Paint 已經可以讀取系統的環境變數。)

--nosysconfig

在 Linux 和 Unix 平台，可以取消讀取這個 "/etc/tuxpaint/tuxpaint.conf" 系統層級的規劃檔。

只有當您自已的規劃檔 "~/.tuxpaintrc" 存在時可以這樣作。

---

命令列的訊息參數

以下的參數會顯示一些訊息到螢幕上。當您使用這些參數後 Tux Paint 並不會真的啟動。

--version

顯示您所執行的 Tux Paint 版本編號及日期。 這也會顯示出您在編譯時所指定的任何相關的參數 (請參閱 INSTALL.txt 和 FAQ.txt)。

--copying

顯示出關於複製 Tux Paint 的簡短授權訊息。

--usage

顯示出有效的命令列參數清單。

--help

顯示出簡短的 Tux Paint 使用說明。

---

選擇不同的語文

Tux Paint 已經翻譯成許多種的語文，您可以在命令列使用 "--lang" 參數來要設定使用語文譯本 (如： "--lang spanish")。或是在規劃檔中設定 "lang=" 的選項 (如： "lang=spanish")。

Tux Paint 也可以知道您系統目前的 locale 設定 (您可以用命令列參數 "--locale" 來覆蓋過系統的設定。)

已經支援的語文有：

Locale 代碼	語文	語文 (英文)
C	英文	English
ca_ES	加泰隆尼亞文	Català
cs_CZ	捷克文	Czech
da_DK	丹麥文	Danish
de_DE@euro	德文	German
el_GR.UTF8 (*)	希臘文	Greek
en_GB	英文 (英國)	British English
es_ES@euro	西班牙文	Spanish
eu_ES	巴斯克文	Basque
fi_FI@euro	芬蘭文	Finnish
fr_FR@euro	法文	French
he_IL (*)	希伯來文	Hebrew
hu_HU	匈牙利文	Hungarian
id_ID	印尼文	Indonesian
is_IS	冰島文	Icelandic
it_IT@euro	義大利文	Italian
ja_JP.UTF-8 (*)	日文	Japanese
ko_KR.UTF-8 (*)	韓文	Korean
lt_LT.UTF-8	立陶宛文	Lithuanian
ms_MY	馬來文	Malay
nb_NO	挪威文 (巴克摩)	Norwegian Bokmål
nn_NO	挪威文 (耐諾斯克)	Norwegian Nynorsk
nl_NL@euro	荷蘭文	Dutch
pl_PL	波蘭文	Polish
pt_BR	巴西葡萄牙文	Brazilian Portuguese
pt_PT	葡萄牙文	Portuguese
ro_RO	羅馬尼亞文	Romanian
ru_RU	俄文	Russian
sk_SK	斯洛伐克文	Slovak
sv_SE@euro	瑞典文	Swedish
ta_IN (*)	坦米爾文	Tamil
tr_TR@euro	土耳其文	Turkish
wa_BE@euro	華隆文	Walloon
zh_CN (*)	簡體中文	Chinese (Simplified)
zh_TW (*)	繁體中文	Chinese (Traditional)

(*) - 表示這些語文不是使用拉丁字集而需要安裝自已的字型檔。 請參閱稍後 特殊字型 的章節。

設定您系統的 Locale

改變您的 locale 設定會對您的環境影響非常的大。

As stated above, along with letting you choose the language at runtime using command-line options ("--lang" and "--locale"), Tux Paint honors the global locale setting in your environment.

If you haven't already set your environment's locale, the following will briefly explain how:

Linux/Unix Users

First, be sure the locale you want to use is enabled by editing the file "/etc/locale.gen" on your system and then running the program "locale-gen" as root.

Note: Debian users may be able to simply run the command "dpkg-reconfigure locales".

Then, before running Tux Paint, set your "$LANG" environment variable to one of the locales listed above. (If you want all programs that can be translated to be, you may wish to place the following in your login script; e.g. ~/.profile, ~/.bashrc, ~/.cshrc, etc.)

For example, in a Bourne Shell (like BASH):

export LANG=es_ES@euro ; \
tuxpaint

And in a C Shell (like TCSH):

setenv LANG es_ES@euro ; \
tuxpaint

---

Windows Users

Tux Paint will recognize the current locale and use the appropriate files by default. So this section is only for people trying different languages.

The simplest thing to do is to use the '--lang' switch in the shortcut (see "INSTALL.txt"). However, by using an MSDOS Prompt window, it is also possible to issue a command like this:

set LANG=es_ES@euro

...which will set the language for the lifetime of that DOS window.

For something more permanent, try editing your computer's 'autoexec.bat' file using Windows' "sysedit" tool:

Windows 95/98

1. Click on the 'Start' button, and select 'Run...'.
2. Type "sysedit" into the 'Open:' box (with or without quotes).
3. Click 'OK'.
4. Locate the AUTOEXEC.BAT window in the System Configuration Editor.
5. Add the following at the bottom of the file:

   set LANG=es_ES@euro

6. Close the System Configuration Editor, answering yes to save the changes.
7. Restart your machine.

To affect the entire machine, and all applications, it is possible to use the "Regional Settings" control panel:

1. Click on the 'Start' button, and select 'Settings | Control Panel'.
2. Double click on the "Regional Settings" globe.
3. Select a language/region from the drop down list.
4. Click 'OK'.
5. Restart your machine when prompted.

Special Fonts

Some languages require special fonts be installed. These font files (which are in TrueType format (TTF)), are much too large to include with the Tux Paint download, and are available separately. (See the table above, under the "Choosing a Different Language" section.)

When running Tux Paint in a language that requires its own font, Tux Paint will try to load the font file from its system-wide "fonts" directory (under a "locale" subdirectory). The name of the file corresponds to the first two letters in the 'locale' code of the language (e.g., "ko" for Korean, "ja" for Japanese, "zh" for Chinese).

For example, under Linux or Unix, when Tux Paint is run in Korean (e.g., with the option "--lang korean"), Tux Paint will attempt to load the following font file:

/usr/share/tuxpaint/fonts/locale/ko.ttf

You can download fonts for supported languages from Tux Paint's website, http://www.newbreedsoftware.com/tuxpaint/. (Look in the 'Fonts' section under 'Download.')

Under Unix and Linux, you can use the Makefile that comes with the font to install the font in the appropriate location.

---

Title Screen

When Tux Paint first loads, a title/credits screen will appear.

Once loading is complete, press a key or click on the mouse to continue. (Or, after about 30 seconds, the title screen will go away automatically.)

---

Main Screen

The main screen is divided into the following sections:

Left Side: Toolbar

The toolbar contains the drawing and editing controls.

Middle: Drawing Canvas

The largest part of the screen, in the center, is the drawing canvas. This is, obviously, where you draw!

Right Side: Selector

Depending on the current tool, the selector shows different things. e.g., when the Paint Brush tool is selected, it shows the various brushes available. When the Rubber Stamp tool is selected, it shows the different shapes you can use.

Lower: Colors

A palette of available colors are shown near the bottom of the screen.

Bottom: Help Area

At the very bottom of the screen, Tux, the Linux Penguin, provides tips and other information while you draw.

---

Available Tools

Drawing Tools

Paint (Brush)

The Paint Brush tool lets you draw freehand, using various brushes (chosen in the Selector on the right) and colors (chosen in the Color palette towards the bottom).

If you hold the mouse button down, and move the mouse, it will draw as you move.

As you draw, a sound is played. The bigger the brush, the lower the pitch.

---

Stamp (Rubber Stamp)

The Stamp tool is like a rubber stamp, or stickers. It lets you paste pre-drawn or photographic images (like a picture of a horse, or a tree, or the moon) in your picture.

As you move the mouse around, an outline follows the mouse, showing where the stamp will be placed.

Different stamps can have different sound effects. Some stamps can be colored or tinted.

Stamps and be shrunk and expanded, and many stamps can be flipped vertically, or displayed as a mirror-image, using controls at the bottom right of the screen.

(NOTE: If the "nostampcontrols" option is set, Tux Paint won't display the Mirror, Flip, Shrink and Grow controls for stamps. See the "Options" section of this document, above.)

---

Lines

This tool lets you draw straight lines using the various brushes and colors you normally use with the Paint Brush.

Click the mouse and hold it to choose the starting point of the line. As you move the mouse around, a thin 'rubber-band' line will show where the line will be drawn.

Let go of the mouse to complete the line. A "sproing!" sound will play.

---

Shapes

This tool lets you draw some simple filled, and un-filled shapes.

Select a shape from the selector on the right (circle, square, oval, etc.).

In the canvas, click the mouse and hold it to stretch the shape out from where you clicked. Some shapes can change proportion (e.g., rectangle and oval), others cannot (e.g., square and circle).

Let go of the mouse when you're done stretching.

Normal Mode

Now you can move the mouse around the canvas to rotate the shape.

Click the mouse button again and the shape will be drawn in the current color.

Simple Shapes Mode

If simple shapes are enabled (e.g., with the "--simpleshapes" option), the shape will be drawn on the canvas when you let go of the mouse button. (There's no rotation step.)

---

Text

Choose a font (from the 'Letters' available on the right) and a color (from the color palette near the bottom). Click on the screen and a cursor will appear. Type text and it will show up on the screen.

Press [Enter] or [Return] and the text will be drawn onto the picture and the cursor will move down one line.

Click elsewhere in the picture and the current line of text will move there, where you can continue editing.

---

Magic (Special Effects)

The 'Magic' tool is actually a set of special tools. Select one of the "magic" effects from the selector on the right, and then click and drag around the picture to apply the effect.

Rainbow

This is similar to the paint brush, but as you move the mouse around, it goes through all of the colors in the rainbow.

Sparkles

This draws glowing yellow sparkles on the picture.

Mirror

When you click the mouse in your picture with the "Mirror" magic effect selected, the entire image will be reversed, turning it into a mirror image.

Flip

Similar to "Mirror." Click and the entire image will be turned upside-down.

Blur

This makes the picture fuzzy wherever you drag the mouse.

Blocks

This makes the picture blocky looking ("pixelated") wherever you drag the mouse.

Negative

This inverts the colors wherever you drag the mouse. (e.g., white becomes black, and vice versa.)

Fade

This fades the colors wherever you drag the mouse. (Do it to the same spot many times, and it will eventually become white.)

Chalk

This makes parts of the picture (where you move the mouse) look like a chalk drawing.

Drip

This makes the paint "drip" wherever you move the mouse.

Thick

This makes the darker colors in the picture become thicker wherever you drag the mouse.

Thin

Similar to "Thick," except dark colors become thinner (light colors become thicker).

Fill

This floods the picture with a color. It lets you quickly fill parts of the picture, as if it were a coloring book.

---

Eraser

This tool is similar to the Paint Brush. Wherever you click (or click and drag), the picture will be erased to white.

As you move the mouse around, a very large square outline follows the pointer, showing what part of the picture will be erased to white.

As you erase, a "squeaky clean" eraser/wiping sound is played.

---

Other Controls

Undo

Clicking this tool will undo the last drawing action. You can even undo more than once!

Note: You can also press [Control]-[Z] on the keyboard to undo.

---

Redo

Clicking this tool will redo the drawing action you just "undid" with the 'Undo' button.

As long as you don't draw again, you can redo as many times as you had "undone!"

Note: You can also press [Control]-[R] on the keyboard to redo.

---

New

Clicking the "New" button will start a new drawing. You will first be asked whether you really want to do this.

Note: You can also press [Control]-[N] on the keyboard to start a new drawing.

---

Open

This shows you a list of all of the pictures you've saved. If there are more than can fit on the screen, use the "Up" and "Down" arrows at the top and bottom of the list to scroll through the list of pictures.

Click a picture to select it, then...

• 

  Click the green "Open" button at the lower left of the list to load the selected picture.

  (Alternatively, you can double-click a picture's icon to load it.)

  
  
• 

  Click the brown "Erase" (trash can) button at the lower right of the list to erase the selected picture. (You will be asked to confirm.)

  
  
• 

  Or click the red "Back" arrow button at the lower right of the list to cancel and return to the picture you were drawing.

  
  

If choose to open a picture, and your current drawing hasn't been saved, you will be prompted as to whether you want to save it or not. (See "Save," below.)

Note: You can also press [Control]-[O] on the keyboard to get the 'Open' dialog.

---

Save

This saves your current picture.

If you haven't saved it before, it will create a new entry in the list of saved images. (i.e., it will create a new file)

Note: It won't ask you anything (e.g., for a filename). It will simply save the picture, and play a "camera shutter" sound effect.

If you HAVE saved the picture before, or this is a picture you just loaded using the "Open" command, you will first be asked whether you want to save over the old version, or create a new entry (a new file).

(NOTE: If either the "saveover" or "saveovernew" options are set, it won't ask before saving over. See the "Options" section of this document, above.)

Note: You can also press [Control]-[S] on the keyboard to save.

---

Print

Click this button and your picture will be printed!

Disabling Printing

If the "noprint" option was set (either with "noprint=yes" in Tux Paint's configuration file, or using "--noprint" on the command-line), the "Print" button will be disabled.

See the "Options" section of this document, above.

Restricting Printing

If the "printdelay" option was used (either with "printdelay=SECONDS" in the configuration file, or using "--printdelay=SECONDS" on the command-line), you can only print once every SECONDS seconds.

For example, with "printdelay=60", you can print only once a minute.

See the "Options" section of this document, above.

Printing Command

(Linux and Unix only)

The command used to print is actually a set of commands that convert a PNG to a PostScript and send it to the printer:

pngtopnm | pnmtops | lpr

This command can be changed by setting the "printcommand" value in Tux Paint's configuration file.

See the "Options" section of this document, above.

Printer Settings

(Windows only)

By default, Tux Paint simply prints to the default printer with default settings when the 'Print' button is pushed.

However, if you hold the [ALT] key on the keyboard while pushing the button, as long as you're not in fullscreen mode, a Windows print dialog will appear, where you can change the settings.

You can have the printer configuration changes stored by using the "printcfg" option, either by using "--printcfg" on the command-line, or "printcfg=yes" in Tux Paint's own configuration file ("tuxpaint.cfg").

If the "printcfg" option is used, printer settings will be loaded from the file "userdata/print.cfg". Any changes will be saved there as well.

See the "Options" section of this document, above.

---

Quit

Clicking the "Quit" button, closing the Tux Paint window, or pushing the "Escape" key will quit Tux Paint.

(NOTE: The "Quit" button can be disabled (e.g., with the "--noquit" command-line option), but the [Escape] key will still work. See the "Options" section of this document, above.)

You will first be prompted as to whether you really want to quit.

If you choose to quit, and you haven't saved the current picture, you will first be asked if wish to save it. If it's not a new image, you will then be asked if you want to save over the old version, or create a new entry. (See "Save" above.)

NOTE: If the image is saved, it will be reloaded automatically the next time you run Tux Paint!

Loading Other Pictures into Tux Paint

Since Tux Paint's 'Open' dialog only displays pictures you created with Tux Paint, what if you want to load some other picture or photograph into Tux Paint to edit?

To do so, you simply need to convert the picture into a PNG (Portable Network Graphic) image file, and place it in Tux Paint's "saved" directory. ("~/.tuxpaint/saved/" under Linux and Unix, "userdata\saved\" under Windows.)

Using 'tuxpaint-import'

Linux and Unix users can use the "tuxpaint-import" shell script which gets installed when you install Tux Paint. It uses some NetPBM tools to convert the image ("anytopnm"), resize it so that it will fit in Tux Paint's canvas ("pnmscale"), and convert it to a PNG ("pnmtopng").

It also uses the "date" command to get the current time and date, which is the file-naming convention Tux Paint uses for saved files. (Remember, you are never asked for a 'filename' when you go to Save or Open pictures!)

To use 'tuxpaint-import', simply run the command from a command-line prompt and provide it the name(s) of the file(s) you wish to convert.

They will be converted and placed in your Tux Paint 'saved' directory. (Note: If you're doing this for a different user - e.g., your child, you'll need to make sure to run the command under their account.)

Example:

$ tuxpaint-import grandma.jpg
grandma.jpg -> /home/username/.tuxpaint/saved/20020921123456.png
jpegtopnm: WRITING A PPM FILE

The first line ("tuxpaint-import grandma.jpg") is the command to run. The following two lines are output from the program while it's working.

Now you can load Tux Paint, and a version of that original picture will be available under the 'Open' dialog. Just double-click its icon!

Doing it Manually

Windows users must currently do the conversion manually.

Load a graphics program that is capable of both loading your picture and saving a PNG format file. (See the documentation file "PNG.txt" for a list of suggested software, and other references.)

Reduce the size of the image to no wider than 448 pixels across and no taller than 376 pixels tall. (i.e., the maximum size is 448 x 376 pixels)

Save the picture in PNG format. It is highly recommended that you name the filename using the current date and time, since that's the convention Tux Paint uses:

YYYYMMDDhhmmss.png

• YYYY = Year
• MM = Month (01-12)
• DD = Day (01-31)
• HH = Hour, in 24-hour format (00-23)
• mm = Minute (00-59)
• ss = Second (00-59)

e.g.:

20020921130500 - for September 21, 2002, 1:05:00pm

Place this PNG file in your Tux Paint 'saved' directory. (See above.)

Under Windows, this is in the "userdata" folder.

Extending Tux Paint

If you wish to add or change things like Brushes and Rubber Stamps used by Tux Paint, you can do it fairly easily by simply putting or removing files on your hard disk.

Note: You'll need to restart Tux Paint for the changes to take effect.

Where Files Go

Standard Files

Tux Paint looks for its various data files in its 'data' directory.

Linux and Unix

Where this directory goes depends on what value was set for "DATA_PREFIX" when Tux Paint was built. See INSTALL.txt for details.

By default, though, the directory is:

/usr/local/share/tuxpaint/

If you installed from a package, it is more likely to be:

/usr/share/tuxpaint/

Windows

Tux Paint looks for a directory called 'data' in the same directory as the executable. This is the directory that the installer used when installing Tux Paint e.g.:

C:\Program Files\TuxPaint\data

Mac OS X

Tux Paint stores files in your account's "Libraries" folder, under "Preferences", e.g.:

/Users/Joe/Library/Preferences/

---

Personal Files

You can also create brushes, stamps and fonts in your own directory for Tux Paint to find.

Linux and Unix

Your personal Tux Paint directory is "~/.tuxpaint/".

That is, if your home directory is "/home/karl", then your Tux Paint directory is "/home/karl/.tuxpaint/".

Don't forget the period (".") before the 'tuxpaint'!

Windows

Your personal Tux Paint directory is named "userdata" and is in the same directory as the executable e.g.:

C:\Program Files\TuxPaint\userdata

To add brushes, stamps and fonts, create subdirectories under your personal Tux Paint directory named "brushes", "stamps" and "fonts", respectively.

(For example, if you created a brush named "flower.png", you would put it in "~/.tuxpaint/brushes/" under Linux or Unix.)

---

Brushes

The brushes used for drawing with the 'Brush' and 'Lines' tools in Tux Paint are simply greyscale PNG images.

The alpha (transparency) of the PNG image is used to determine the shape of the brush, which means that the shape can be 'anti-aliased' and even partially-transparent!

Brush images should be no wider than 40 pixels across and no taller than 40 pixels high. (i.e., the maximum size can be 40 x 40.)

Just place them in the "brushes" directory.

Note: If your new brushes all come out as solid squares or rectangles, it's because you forgot to use alpha transparency! See the documentation file "PNG.txt" for more information and tips.

---

Stamps

All stamp-related files go in the "stamps" directory. It's useful to create subdirectories and sub-subdirectories there to organize the stamps. (For example, you can have a "holidays" folder with "halloween" and "christmas" sub-folders.)

Images

Rubber Stamps in Tux Paint can be made up of a number of separate files. The one file that is required is, of course, the picture itself.

The Stamps used by Tux Paint are PNG pictures. They can be full-color or greyscale. The alpha (transparency) of the PNG is used to determine the actual shape of the picture (otherwise you'll stamp a large rectangle on your drawings).

The PNGs can be any size, but in practice, a 100 pixels wide by 100 pixels tall (100 x 100) is quite large for Tux Paint.

Note: If your new stamps all have solid rectangular-shaped outlines of a solid color (e.g., white or black), it's because you forgot to use alpha transparency! See the documentation file "PNG.txt" for more information and tips.

---

Description Text

Text (".TXT") files with the same name as the PNG. (e.g., "picture.png"'s description is stored in "picture.txt" in the same directory.)

The first line of the text file will be used as the default description of the stamp's image.

Language Support

Additional lines can be added to the text file to provide translations of the description, to be displayed when Tux Paint is running in a different locale (like French or Spanish).

There are three ways of placing translated descriptions in a stamp's ".txt" file. In each case, the beginning of the line should correspond to the locale code of the language in question (e.g., "de" for German, "fr" for French, etc.).

• Lines beginning with "xx=" (where "xx" is the locale code) will be considered plain ASCII. That is, any special characters on the line will be interpreted literally.

  For example, "es=¡Niños!", will come out literally as "¡Niños!"

• Lines beginning with "xx.esc=" can contain special 'escape sequences' which allow you to create a description using special ASCII characters (like "á" and "þ") without the need to figure out how to get those characters in the file with whatever editor you chose to use.

  The escape sequences are identical to those used in HTML to display ASCII characters 161 through 255. The sequence begins with a "&" (ampersand), and ends with a ";" (semicolon). See the documentation file "ESCAPES.txt" for a list of escapable characters.

  For example, "es.esc=¡Niños!", will come out as "¡Niños!"

  Note: As in HTML, if you want an actual ampersand ("&") in your description when using the "xx.esc" method ,you'll need to escape it: "&".

• Lines beginning with "xx.utf8=" can be used to use UTF-8 encoded text for the description's translation. You'll need an editor capable of saving UTF-8 encoded files.

If no translation is available for the language Tux Paint is currently running in, the default string (the first line, which is typically in English) is used.

Windows Users

Use NotePad or WordPad to edit/create these files. Be sure to save them as Plain Text, and make sure they have ".txt" at the end of the filename...

---

Sound Effects

WAVE (".WAV") files with the same name as the PNG. (e.g., "picture.png"'s sound effect is the sound "picture.wav" in the same directory.)

Language Support

For sounds for different locales (e.g., if the sound is someone saying a word, and you want translated versions of the word said), also create WAV files with the locale's label in the filename, in the form: "STAMP_LOCALE.wav"

"picture.png"'s sound effect, when Tux Paint is run in Spanish mode, would be "picture_es.wav". In French mode, "picture_fr.wav". And so on...

If no localized sound effect can be loaded, Tux Paint will attempt to load the 'default' sound file. (e.g., "picture.wav")

---

Stamp Options

Aside from a graphical shape, a textual description, and a sound effect, stamps can also be given other attributes. To do this, you need to create a 'data file' for the stamp.

A stamp data file is simply a text file containing the options.

The file has the same name as the PNG image, but a ".dat" extension. (e.g., "picture.png"'s data file is the text file "picture.dat" in the same directory.)

Colored Stamps

Stamps can be made to be either "colorable" or "tintable."

Colorable

"Colorable" stamps they work much like brushes - you pick the stamp to get the shape, and then pick the color you want it to be. (Symbol stamps, like the mathematical and musical ones, are an example.)

Nothing about the original image is used except the transparency ("alpha" channel). The color of the stamp comes out solid.

Add the word "colorable" to the stamp's data file.

Tinted

"Tinted" stamps are similar to "colorable" ones, except the details of the original image are kept. (To put it technically, the original image is used, but its hue is changed, based on the currently-selected color.)

Add the word "tintable" to the stamp's data file.

Unalterable Stamps

By default, a stamp can be flipped upside down, shown as a mirror image, or both. This is done using the control buttons below the stamp selector, at the lower right side of the screen in Tux Paint.

Sometimes, it doesn't make sense for a stamp to be flippable or mirrored; for example, stamps of letters or numbers. Sometimes stamps are symettrical, so letting the user flip or mirror them isn't useful.

To make a stamp un-flippable, add the option "noflip" to the stamp's data file.

To keep a stamp from being mirrored, add the option "nomirror" to the stamp's data file.

Windows Users

You can use NotePad or WordPad to create these file. Be sure to save it as Plain Text, and make sure the filename has ".dat" at the end, and not ".txt"...

Pre-Mirrored Images

In some cases, you may wish to provide a pre-drawn version of a stamp's mirror-image. For example, imagine a picture of a fire truck with the words "Fire Department" written across the side. You probably do not want that text to appear backwards when the image is flipped!

To create a mirrored version of a stamp that you want Tux Paint to use, rather than mirroring one on its own, simply create a second ".png" graphics file with the same name, except with the string "_mirror" before the filename extension.

For example, for the stamp "truck.png" you would create another file named "truck_mirror.png", which will be used when the stamp is mirrored (rather than using a backwards version of 'truck.png').

---

Fonts

The fonts used by Tux Paint are TrueType Fonts (TTF).

Simply place them in the "fonts" directory. Tux Paint will load the font and provide four different sizes in the 'Letters' selector when using the 'Text' tool.

More Information

For more information, see the other documentation files that come with Tux Paint.

If you need help, feel free to contact New Breed Software:

http://www.newbreedsoftware.com/

You may also wish to participate in the numerous Tux Paint mailing lists:

http://www.newbreedsoftware.com/tuxpaint/lists/