簡介

"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 設定會對您的環境影響非常的大。

您可以使用命令列參數 ("--lang" 和 "--locale") 來選擇語文版本，Tux Paint 也會依循您系統環境對 locale 的設定。

如果您尚未設定您系統環境的 locale 的話，以下是一個簡短的說明：

Linux/Unix 的使用者

首先確定您要使用的 locale 已經寫入 "/etc/locale.gen" 之中，並使用 root 身份執行過 "locale-gen" 。

註：Debian 的使用者可以輕易的用 "dpkg-reconfigure locales" 來完成。

接下來在啟動 Tux Paint 之前先設定 "$LANG" 環境變數成您的 locale 。(如果您希望所有可以轉換語文的程式都能發生作用， 您應該將這個動作寫入到您登入時會使用到的命令檔，如 ~/.profile, ~/.bashrc, ~/.cshrc, 等等。)

例如在 Bourne Shell (BASH) 中：

export LANG=zh_TW.Big5 ; \
tuxpaint

在 C Shell (TCSH) 中：

setenv LANG zh_TW.Big5 ; \
tuxpaint

---

Windows 的使用者

Tux Paint 可以辨識出目前的 locale 並選用適當的檔案。 所以這個章節是給想要測試不同語文版本的人。

最簡單的方式是在捷徑中使用 '--lang' 來切換 (請見 "INSTALL.txt")。 也可以開啟一個 MSDOS 視窗，使用這樣的命令來指定 locale ：

set LANG=zh_TW

這樣會設定這個 DOS 視窗的語文，直到視窗被關掉。

一勞永逸的方式是使用 "sysedit" 編輯您電腦的 'autoexec.bat' 檔案：

Windows 95/98

1. 點擊「開始」功能表，選擇「執行...」。
2. 輸入 "sysedit" 到 '開啟:' 欄位中(有沒有加上雙引號都沒關係).
3. 點擊「確定」。
4. 在系統設定編輯器中選定 AUTOEXEC.BAT 視窗。
5. 加入以下的設定到檔案的最後面：

   set LANG=zh_TW

6. 關閉系統設定編輯器，回答要儲存目前的變更。
7. 重新啟動您的電腦。

要對整部電腦和所有程式都有效的話， 也可以使用控制台裡的「地區選項」來設定：

1. 點擊「開始」功能表，選擇「設定」->「控制台」。
2. 雙擊「區域設定」或「地區選項」的球形圖示。
3. 由下拉表單中選擇一個「語言(地區)」的選項。
4. 點擊「確定」按鈕。
5. 重新啟動您的電腦。

特殊字型

某些語文需要安裝特殊字型檔。這些非常大的字型檔(TrueType format, TTF)可以在 Tux Paint 網站下載，他們是獨立的檔案。(請見前面「選擇不同的語文」一節中的表格。)

當執行需要特殊字型的語文版本時，Tux Paint 會試著由系統的 "fonts" 目錄中載入字型 ("locale" 的子目錄)。字型檔的名稱相對於 'locale' 代碼的前二個字母(例如："ko" 是韓文，"ja" 是日文，"zh" 是中文)。

舉例來說，在 Linux 或 Unix 上，當 Tux Paint 要顯示韓文的訊息 (如：使用參數 "--lang korean")，Tux Paint 將會載入這個字型檔：

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

您可以由 Tux Paint 的網站下載支援語文的字型檔， http://www.newbreedsoftware.com/tuxpaint/. (請見「下載」連結中最後的「字型檔」這一個部份。)

在 Linux 和 Unix 上您可以使用 Makefile 來將字型檔安裝到適當的路徑去。

---

啟始畫面

當一開始啟動 Tux Paint 時會出現一個啟始畫面。

當啟動完成後按下任一鍵或滑鼠鍵就可以繼續。 (或者等 30 秒後這個啟始畫面也會自動關閉。)

---

主畫面

主畫面可以分成以下幾個部份：

左邊：工具列

工具列中包含了繪圖及編輯的工具。

中間：圖紙

這個在螢幕中間最大範圍的就是圖紙，這就是您畫圖的地方了。

右邊：選項

依照目前的工具會顯示出不同的選項。例如當左邊選「繪圖」工具時， 右邊就會出現好幾種不同的筆刷。當左邊選「圖章」工具時， 右邊就會出現可以使用的圖樣來。

下邊：顏色

一個十五種顏色的調色板在接近螢幕底部的地方。

底部：說明區域

當您在畫畫時，在螢幕的最底部，Linux 的企鵝 - Tux 會提供提示和訊息。

---

可用的工具

繪圖工具

繪圖(刷子)

這個刷子繪圖工具讓您畫徒手畫，可以使用不同的筆刷(在右邊選項部份選擇) 和顏色(在底下的調色板來選擇顏色)。

如果您持續按住滑鼠按鍵，然後移動滑鼠，就會畫在移動的路徑上。

當您在畫的同時會有聲音出來，愈大的筆刷聲音愈低沉。

---

圖章 (橡皮圖章)

圖章工具就像是橡皮圖章，或是貼海報，可以讓您印上預先畫好的圖形， 或是現實的照片在圖紙上。(像是一張馬的圖形，或是一顆樹，或是月亮。)

當您移動滑鼠時會看到有一個框線跟著滑鼠移動，顯示出圖章會印在什麼地方。

不同的圖章可以有不同的音效，有些圖章還可以著色。

圖章可以放大縮小，很多圖章還可以上下左右翻轉，都在右下方來控制。

(註：如果設定了 "nostampcontrols" 選項的話，Tux Paint 就不會顯示出左右鏡射，上下翻轉，放大和縮小的控制鈕。請見本文前面「選項」一節的說明。)

---

畫線

這個工具可以使用不同的筆刷和顏色來幫助您畫出真正的直線。

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/