10/15/2016 TuxPaintREADME

version0.9.22
Asimpledrawingprogramforchildren

Copyright20022014byBillKendrickandothers
NewBreedSoftware&Tux4Kids

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

June14,2002August5,2014

TableofContents
About
UsingTuxPaint
LoadingOtherPicturesintoTuxPaint
FurtherReading
HowtoGetHelp

About
WhatIs'TuxPaint?'
TuxPaintisafreedrawingprogramdesignedforyoungchildren(kidsages3andup).
Ithasasimple,easytouseinterface,funsoundeffects,andanencouragingcartoon
mascotwhohelpsguidechildrenastheyusetheprogram.Itprovidesablankcanvas
andavarietyofdrawingtoolstohelpyourchildbecreative.

License:
TuxPaintisanOpenSourceproject,FreeSoftwarereleasedundertheGNUGeneral
PublicLicense(GPL).Itisfree,andthe'sourcecode'behindtheprogramisavailable.
(Thisallowsotherstoaddfeatures,fixbugs,andusepartsoftheprogramintheirown
GPL'dsoftware.)

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 1/19
10/15/2016 TuxPaintREADME

SeeCOPYING.txtforthefulltextoftheGPLlicense.

Objectives:
EasyandFun
TuxPaintismeanttobeasimpledrawingprogramforyoungchildren.Itisnot
meantasageneralpurposedrawingtool.Itismeanttobefunandeasytouse.
Soundeffectsandacartooncharacterhelplettheuserknowwhat'sgoingon,and
keepsthementertained.Therearealsoextralargecartoonstylemousepointer
shapes.
Extensibility
TuxPaintisextensible.Brushesand"rubberstamp"shapescanbedroppedin
andpulledout.Forexample,ateachercandropinacollectionofanimalshapes
andasktheirstudentstodrawanecosystem.Eachshapecanhaveasoundwhich
isplayed,andtextualfactswhicharedisplayed,whenthechildselectstheshape.
Portability
TuxPaintisportableamongvariouscomputerplatforms:Windows,Macintosh,
Linux,etc.Theinterfacelooksthesameamongthemall.TuxPaintrunssuitably
wellonoldersystems(likeaPentium133),andcanbebuilttorunbetteronslow
systems.
Simplicity
Thereisnodirectaccesstothecomputer'sunderlyingintricacies.Thecurrent
imageiskeptwhentheprogramquits,andreappearswhenitisrestarted.Saving
imagesrequiresnoneedtocreatefilenamesorusethekeyboard.Openingan
imageisdonebyselectingitfromacollectionofthumbnails.Accesstoother
filesonthecomputerisrestricted.

UsingTuxPaint
LoadingTuxPaint
Linux/UnixUsers
TuxPaintshouldhaveplacedalauchericoninyourKDEand/orGNOME
menus,under'Graphics.'

Alternatively,youcanrunthefollowingcommandatashellprompt
(e.g.,"$"):

$tuxpaint

Ifanyerrorsoccur,theywillbedisplayedontheterminal(to"stderr").

WindowsUsers

IfyouinstalledTuxPaintonyourcomputerusingthe
'TuxPaintInstaller,'itwillhaveaskedyouwhetheryouwanted
a'Start'menushortcut,and/oradesktopshortcut.Ifyou TuxPaint
agreed,youcansimplyrunTuxPaintfromthe'TuxPaint'
file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 2/19
10/15/2016 TuxPaintREADME

sectionofyour'Start'menu(e.g.,under"AllPrograms"onWindowsXP),
orbydoubleclickingthe"TuxPaint"icononyourdesktop.

IfyouinstalledTuxPaintusingthe'ZIPfile'download,orifyouusedthe
'TuxPaintInstaller,'butchosenottohaveshortcutsinstalled,you'llneedto
doubleclickthe"tuxpaint.exe"iconinthe'TuxPaint'folderonyour
computer.

Bydefault,the'TuxPaintInstaller'willputTuxPaint'sfolderin
"C:\ProgramFiles\",thoughyoumayhavechangedthiswhentheinstaller
ran.

Ifyouusedthe'ZIPfile'download,TuxPaint'sfolderwillbewherever
youputitwhenyouunzippedtheZIPfile.

MacOSXUsers
Simplydoubleclickthe"TuxPaint"icon.

TitleScreen
WhenTuxPaintfirstloads,atitle/creditsscreenwillappear.

Onceloadingiscomplete,pressakeyorclickonthemousetocontinue.(Or,after
about30seconds,thetitlescreenwillgoawayautomatically.)

MainScreen
Themainscreenisdividedintothefollowingsections:

LeftSide:Toolbar

Thetoolbarcontainsthedrawingandeditingcontrols.
file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 3/19
10/15/2016 TuxPaintREADME

Middle:DrawingCanvas

Thelargestpartofthescreen,inthecenter,isthedrawingcanvas.Thisis,
obviously,whereyoudraw!

Note:ThesizeofthedrawingcanvasdependsonthesizeofTuxPaint.Youcan
changethesizeofTuxPaintusingtheTuxPaintConfig.configurationtool,orby
othermeans.SeetheOPTIONSdocumentationformoredetails.

RightSide:Selector

Dependingonthecurrenttool,theselectorshowsdifferentthings.e.g.,whenthe
PaintBrushtoolisselected,itshowsthevariousbrushesavailable.Whenthe
RubberStamptoolisselected,itshowsthedifferentshapesyoucanuse.

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 4/19
10/15/2016 TuxPaintREADME

Lower:Colors

Apaletteofavailablecolorsareshownnearthebottomofthescreen.

(NOTE:YoucandefineyourowncolorsforTuxPaint.Seethe"Options"
documentation.)

Bottom:HelpArea

Attheverybottomofthescreen,Tux,theLinuxPenguin,providestipsandother
informationwhileyoudraw.

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 5/19
10/15/2016 TuxPaintREADME

AvailableTools
DrawingTools

Paint(Brush)

ThePaintBrushtoolletsyoudrawfreehand,usingvarious
brushes(chosenintheSelectorontheright)andcolors
(chosenintheColorpalettetowardsthebottom).

Ifyouholdthemousebuttondown,andmovethemouse,itwill
drawasyoumove.

Asyoudraw,asoundisplayed.Thebiggerthebrush,thelowerthe
pitch.

Stamp(RubberStamp)

TheStamptoolislikeasetofrubberstampsorstickers.It
letsyoupastepredrawnorphotographicimages(likea
pictureofahorse,oratree,orthemoon)inyourpicture.

Asyoumovethemousearoundthecanvas,anoutlinefollowsthe
mouse,showingwherethestampwillbeplaced,andhowbigitwill
be.

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 6/19
10/15/2016 TuxPaintREADME

Therecanbenumerouscategoriesofstamps(e.g.,
animals,plants,outerspace,vehicles,people,etc.).
UsetheLeftandRightarrowstocyclethroughthe
collections.

Somestampscanbecoloredortinted.Ifthecolorpalettebelowthe
canvasisactivated,youcanclickthecolorstochangethetintor
colorofthestampbeforeplacingitinthepicture.

Stampscanbeshrunkandexpanded,andmanystampscanbe
flippedvertically,ordisplayedasamirrorimage,usingcontrolsat
thebottomrightofthescreen.

Differentstampscanhavedifferentsoundeffectsand/or
descriptive(spoken)sounds.Buttonsatthelowerleft(near
Tux,theLinuxpenguin)allowyoutoreplaythesoundeffectsand
descriptivesoundsforthecurrentlyselectedstamp.

(NOTE:Ifthe"nostampcontrols"optionisset,TuxPaintwon't
displaytheMirror,Flip,ShrinkandGrowcontrolsforstamps.See
the"Options"documentation.)

Lines

Thistoolletsyoudrawstraightlinesusingthevarious
brushesandcolorsyounormallyusewiththePaintBrush.

Clickthemouseandholdittochoosethestartingpointoftheline.
Asyoumovethemousearound,athin'rubberband'linewillshow
wherethelinewillbedrawn.

Letgoofthemousetocompletetheline.A"sproing!"soundwill
play.

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 7/19
10/15/2016 TuxPaintREADME

Shapes

Thistoolletsyoudrawsomesimplefilled,andunfilled
shapes.

Selectashapefromtheselectorontheright(circle,square,oval,
etc.).

Inthecanvas,clickthemouseandholdittostretchtheshapeout
fromwhereyouclicked.Someshapescanchangeproportion(e.g.,
rectangleandoval),otherscannot(e.g.,squareandcircle).

Letgoofthemousewhenyou'redonestretching.

NormalMode

Nowyoucanmovethemousearoundthecanvastorotatethe
shape.

Clickthemousebuttonagainandtheshapewillbedrawnin
thecurrentcolor.

SimpleShapesMode
Ifsimpleshapesareenabled(e.g.,withthe"simpleshapes"
option),theshapewillbedrawnonthecanvaswhenyoulet
goofthemousebutton.(There'snorotationstep.)

TextandLabel

Chooseafont(fromthe'Letters'availableontheright)anda
color(fromthecolorpalettenearthebottom).Clickonthe
screenandacursorwillappear.Typetextanditwillshow
uponthescreen.

Press[Enter]or[Return]andthetextwillbedrawnontothe
pictureandthecursorwillmovedownoneline.

Alternatively,press[Tab]andthetextwillbedrawnontothe
picture,butthecursorwillmovetotherightofthetext,ratherthan
file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 8/19
10/15/2016 TuxPaintREADME

downaline,andtotheleft.(Thiscanbeusefultocreatealineof
textwithmixedcolors,fonts,stylesandsizes:Likethis.)

Clickingelsewhereinthepicturewhilethetextentryisstillactive
causesthecurrentlineoftexttomovetothatlocation(whereyou
cancontinueeditingit).

TextversusLabel

TheTexttoolistheoriginaltextentrytoolinTuxPaint.Text
enteredusingthistoolcan'tbemodifiedormovedlater,since
itbecomespartofthedrawing.However,becausethetext
becomespartofthepicture,itcanbedrawnoverormodified
usingMagictooleffects(e.g.,smudged,tinted,embossed,
etc.)

WhenusingtheLabeltool(whichwasaddedtoTuxPaintin
version0.9.22),thetext'floats'overtheimage,andthedetails
ofthelabel(thetext,thepositionofthelabel,thefontchoice
andthecolor)getstoredseparately.Thisallowsthelabeltobe
repositionedoreditedlater.

TheLabeltoolcanbedisabled(e.g.,byselecting
"Disable'Label'Tool"inTuxPaintConfig.orrunning
TuxPaintwiththe"nolabel"commandlineoption).

InternationalCharacterInput

TuxPaintallowsinputtingcharactersindifferentlanguages.
MostLatincharacters(AZ,,,etc.)canbyentereddirectly.
SomelanguagesrequirethatTuxPaintbeswitchedintoan
alternateinputmodebeforeentering,andsomecharacters
mustbecomposedusingnumerouskeypresses.

WhenTuxPaint'slocaleissettooneofthelanguagesthat
providealternateinputmodes,akeyisusedtocyclethrough
normal(Latincharacter)andlocalespecificmodeormodes.

Currentlysupportedlocales,theinputmethodsavailable,and
thekeytotoggleorcyclemodes,arelistedbelow.Note:Many
fontsdonotincludeallcharactersforalllanguages,so
sometimesyou'llneedtochangefontstoseethecharacters
you'retryingtotype.

JapaneseRomanizedHiraganaandRomanized
Katakanaright[Alt]
KoreanHangul2Bulright[Alt]orleft[Alt]
TraditionalChineseright[Alt]orleft[Alt]
Thairight[Alt]

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 9/19
10/15/2016 TuxPaintREADME

Magic(SpecialEffects)

The'Magic'toolisactuallyasetofspecialtools.Selectone
ofthe"magic"effectsfromtheselectorontheright.Then,
dependingonthetool,youcaneitherclickanddragaround
thepicture,and/orsimplyclickthepictureonce,toapplytheeffect.

Ifthetoolcanbeusedbyclickinganddragging,a'painting'button
willbeavailableontheleft,belowthelistof"magic"toolsonthe
rightsideofthescreen.Ifthetoolcanaffecttheentirepictureat
once,an'entirepicture'buttonwillbeavailableontheright.

SeetheinstructionsforeachMagictool(inthe'magicdocs'folder).

Eraser

ThistoolissimilartothePaintBrush.Whereveryouclick
(orclickanddrag),thepicturewillbeerased.(Thismaybe
white,someothercolor,ortoabackgroundpicture,
dependingonthepicture.)

Anumberoferasersizesareavailable,bothroundandsquare..

Asyoumovethemousearound,asquareoutlinefollowsthepointer,
showingwhatpartofthepicturewillbeerasedtowhite.

Asyouerase,a"squeakyclean"eraser/wipingsoundisplayed.

OtherControls
Undo

Clickingthistoolwillundothelastdrawingaction.Youcan
evenundomorethanonce!

Note:Youcanalsopress[Control][Z]onthekeyboardtoundo.

Redo

Clickingthistoolwillredothedrawingactionyoujust
"undid"withthe'Undo'button.

Aslongasyoudon'tdrawagain,youcanredoasmanytimesasyou
had"undone!"

Note:Youcanalsopress[Control][R]onthekeyboardtoredo.

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 10/19
10/15/2016 TuxPaintREADME

New

Clickingthe"New"buttonwillstartanewdrawing.A
dialogwillappearwhereyoumaychoosetostartanew
pictureusingasolidbackgroundcolor,orusinga'Starter'
image(seebelow).Youwillfirstbeaskedwhetheryoureallywant
todothis.

Note:Youcanalsopress[Control][N]onthekeyboardtostarta
newdrawing.

'Starter'Images

'Starters'canbelikeapagefromacoloringbook(a
blackandwhiteoutlineofapicture,whichyoucanthen
colorin),orlikea3Dphotograph,whereyoudrawthe
bitsinbetween.

Whenyouloada'Starter,'drawonit,andthenclick
'Save,'itcreatesanewpicturefile(itdoesn'toverwrite
theoriginal'Starter,'soyoucanuseitagainlater).

Open

Thisshowsyoualistofallofthepicturesyou'vesaved.If
therearemorethancanfitonthescreen,usethe"Up"and
"Down"arrowsatthetopandbottomofthelisttoscroll
throughthelistofpictures.

Clickapicturetoselectit,then...

Clickthegreen"Open"buttonatthe
lowerleftofthelisttoloadtheselected
picture.

(Alternatively,youcandoubleclickapicture's
icontoloadit.)

Clickthebrown"Erase"(trashcan)buttonatthe
lowerrightofthelisttoerasetheselectedpicture.
file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 11/19
10/15/2016 TuxPaintREADME

(Youwillbeaskedtoconfirm.)

Note:Asofversion0.9.22,thepicture
willbeplacedinyourdesktop'strashcan,on
Linuxonly.

Clicktheblue"Slides"(slideprojector)
buttonatthelowerlefttogotoslideshow
mode.See"Slides",below,fordetails.

Orclickthered"Back"arrowbuttonat
thelowerrightofthelisttocanceland
returntothepictureyouweredrawing.

Ifchoosetoopenapicture,andyourcurrentdrawinghasn'tbeen
saved,youwillbepromptedastowhetheryouwanttosaveitornot.
(See"Save,"below.)

Note:Youcanalsopress[Control][O]onthekeyboardtogetthe
'Open'dialog.

Save

Thissavesyourcurrentpicture.

Ifyouhaven'tsaveditbefore,itwillcreateanewentryin
thelistofsavedimages.(i.e.,itwillcreateanewfile)

Note:Itwon'taskyouanything(e.g.,forafilename).Itwillsimply
savethepicture,andplaya"camerashutter"soundeffect.

IfyouHAVEsavedthepicturebefore,orthisisapictureyoujust
loadedusingthe"Open"command,youwillfirstbeaskedwhether
youwanttosaveovertheoldversion,orcreateanewentry(anew
file).

(NOTE:Ifeitherthe"saveover"or"saveovernew"optionsareset,it
won'taskbeforesavingover.Seethe"Options"documentation.)

Note:Youcanalsopress[Control][S]onthekeyboardtosave.

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 12/19
10/15/2016 TuxPaintREADME

Print

Clickthisbuttonandyourpicturewillbeprinted!

Onmostplatforms,youcanalsoholdthe[Alt]key(called
[Option]onMacs)whileclickingthe'Print'buttontogetaprinter
dialog.Notethatthismaynotworkifyou'rerunningTuxPaintin
fullscreenmode.Seebelow.

DisablingPrinting

Ifthe"noprint"optionwasset(eitherwith"noprint=yes"in
TuxPaint'sconfigurationfile,orusing"noprint"onthe
commandline),the"Print"buttonwillbedisabled.

Seethe"Options"documentation.)

RestrictingPrinting

Ifthe"printdelay"optionwasused(eitherwith
"printdelay=SECONDS"intheconfigurationfile,orusing"
printdelay=SECONDS"onthecommandline),youcanonly
printonceeverySECONDSseconds.

Forexample,with"printdelay=60",youcanprintonlyoncea
minute.

Seethe"Options"documentation.)

PrintingCommands

(LinuxandUnixonly)

TuxPaintprintsbygeneratingaPostScriptrepresentationof
thedrawingandsendingittoanexternalprogram.Bydefault,
theprogramis:

lpr

Thiscommandcanbechangedbysettingthe"printcommand"
valueinTuxPaint'sconfigurationfile.

Ifthe[Alt]keyonthekeyboardisbeingpushedwhileclicking
the'Print'button,aslongasyou'renotinfullscreenmode,an
alternativeprogramisrun.Bydefault,theprogramisKDE's
graphicalprintdialog:

kprinter

Thiscommandcanbechangedbysettingthe
"altprintcommand"valueinTuxPaint'sconfigurationfile.

Forinformationonhowtochangetheprintingcommands,see
the"Options"documentation.

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 13/19
10/15/2016 TuxPaintREADME

PrinterSettings

(WindowsandMacOSX)

Bydefault,TuxPaintsimplyprintstothedefaultprinterwith
defaultsettingswhenthe'Print'buttonispushed.

However,ifyouholdthe[Alt](or[Option])keyonthe
keyboardwhilepushingthebutton,aslongasyou'renotin
fullscreenmode,youroperatingsystem'sprinterdialogwill
appear,whereyoucanchangethesettings.

Youcanhavetheprinterconfigurationchangesstoredby
usingthe"printcfg"option,eitherbyusing"printcfg"on
thecommandline,or"printcfg=yes"inTuxPaint'sown
configurationfile("tuxpaint.cfg").

Ifthe"printcfg"optionisused,printersettingswillbeloaded
fromthefile"print.cfg"inyourpersonalfolder(seebelow).
Anychangeswillbesavedthereaswell.

Seethe"Options"documentation.)

PrinterDialogOptions

Bydefault,TuxPaintonlyshowstheprinterdialog(or,on
Linux/Unix,runsthe"altprintcommand",e.g.,"kprinter"
insteadof"lpr")ifthe[Alt](or[Option])keyisheldwhile
clickingthe'Print'button.

However,thisbehaviorcanbechanged.Youcanhavethe
printerdialogalwaysappearbyusing"altprintalways"on
thecommandline,or"altprint=always"inTuxPaint's
configurationfile.Or,youcanpreventthe[Alt]/[Option]key
fromhavinganyeffectbyusing"altprintnever",or
"altprint=never".

Seethe"Options"documentation.)

Slides(under"Open")

The"Slides"buttonisavailableinthe"Open"dialog.It
displaysalistofyoursavedfiles,justlikethe"Open"
dialog.

Clickeachoftheimagesyouwishtodisplayinaslideshowstyle
presentation,onebyone.Adigitwillappearovereachimage,letting
youknowinwhichordertheywillbedisplayed.

Youcanclickaselectedimagetounselectit(takeitoutofyour
slideshow).

Aslidingscaleatthelowerleftofthescreen(nexttothe"Play"
button)canbeusedtoadjustthespeedoftheslideshow,from
file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 14/19
10/15/2016 TuxPaintREADME

slowesttofastest.Choosetheleftmostsettingtodisableautomatic
advancementyouwillneedtopressakeyorclicktogotothe
nextslide(seebelow).

Note:Theslowestsettingdoesnotautomaticallyadvancethrough
theslides.Useitforwhenyouwanttostepthroughthemmanually.

Whenyou'reready,clickthe"Play"buttontobegintheslideshow.
(Note:Ifyouhadn'tselectedANYimages,thenALLimageswillbe
playedintheslideshow.)

Duringtheslideshow,press[Space],[Enter]or[Return]orthe
[RightArrow],orclickthe"Next"buttonatthelowerleft,to
manuallyadvancetothenextslide.Press[Left]togobacktothe
previousslide.

Press[Escape],orclickthe"Back"buttonatthelowerright,toexit
theslideshowandreturntotheslideshowimageselectionscreen.

Click"Back"intheslideshowimageselectionscreentoreturntothe
"Open"dialog.

Quit

Clickingthe"Quit"button,closingtheTuxPaintwindow,or
pushingthe[Escape]keywillquitTuxPaint.

Youwillfirstbepromptedastowhetheryoureallywanttoquit.

Ifyouchoosetoquit,andyouhaven'tsavedthecurrentpicture,you
willfirstbeaskedifwishtosaveit.Ifit'snotanewimage,youwill
thenbeaskedifyouwanttosaveovertheoldversion,orcreatea
newentry.(See"Save"above.)

NOTE:Iftheimageissaved,itwillbereloadedautomaticallythe
nexttimeyourunTuxPaint!

NOTE:The"Quit"buttonand[Escape]keycanbedisabled(e.g.,
byselecting"Disable'Quit'Button"inTuxPaintConfig.orrunning
TuxPaintwiththe"noquit"commandlineoption).

Inthatcase,the"windowclose"buttononTuxPaint'stitlebar(if
notinfullscreenmode)orthe[Alt]+[F4]keysequencemaybe
usedtoquit.

Ifneitherofthosearepossible,thekeysequenceof
[Shift]+[Control]+[Escape]maybeusedtoquit.(Seethe
"Options"documentation.)

SoundMuting

Thereisnoonscreencontrolbuttonatthistime,butbypressing
[Alt]+[S],soundeffectscanbedisabledandreenabled(mutedand
unmuted)whiletheprogramisrunning.
file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 15/19
10/15/2016 TuxPaintREADME

Notethatifsoundsarecompletelydisabled(e.g.,byunselecting
"EnableSoundEffects"inTuxPaintConfigorrunningTuxPaint
withthe"nosound"commandlineoption),the[Alt]+[S]key
sequencehasnoeffect.(i.e.,itcannotbeusedtoturnonsounds
whentheparent/teacherwantsthemdisabled.)

LoadingOtherPicturesintoTuxPaint
SinceTuxPaint's'Open'dialogonlydisplayspicturesyoucreatedwithTuxPaint,whatifyouwant
toloadsomeotherpictureorphotographintoTuxPainttoedit?

Todoso,yousimplyneedtoconvertthepictureintoaPNG(PortableNetworkGraphic)imagefile,
andplaceitinTuxPaint's"saved"directory:

WindowsVista
Insidetheuser's"AppData"folder,e.g.:"C:\Users\
(username)\AppData\Roaming\TuxPaint\saved\"
Windows95,98,ME,2000,XP
Insidetheuser's"ApplicationData"folder,e.g.:"C:\DocumentsandSettings\
(username)\ApplicationData\TuxPaint\saved\"
MacOSX
Insidetheuser's"Library"folder:"/Users/(username)/Library/Application
Support/TuxPaint/saved/"
Linux/Unix
Insideahidden".tuxpaint"directory,intheuser'shomedirectory:
"$(HOME)/.tuxpaint/saved/"

Note:ItisfromthisfolderthatyoucancopyoropenpicturesdrawninTuxPaintusingother
applications.

Using'tuxpaintimport'
LinuxandUnixuserscanusethe"tuxpaintimport"shellscriptwhichgetsinstalled
whenyouinstallTuxPaint.ItusessomeNetPBMtoolstoconverttheimage
("anytopnm"),resizeitsothatitwillfitinTuxPaint'scanvas("pnmscale"),andconvert
ittoaPNG("pnmtopng").

Italsousesthe"date"commandtogetthecurrenttimeanddate,whichisthefile
namingconventionTuxPaintusesforsavedfiles.(Remember,youareneveraskedfor
a'filename'whenyougotoSaveorOpenpictures!)

Touse'tuxpaintimport',simplyrunthecommandfromacommandlinepromptand
provideitthename(s)ofthefile(s)youwishtoconvert.

TheywillbeconvertedandplacedinyourTuxPaint'saved'directory.(Note:Ifyou're
doingthisforadifferentusere.g.,yourchild,you'llneedtomakesuretorunthe
commandundertheiraccount.)

Example:

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 16/19
10/15/2016 TuxPaintREADME

$tuxpaintimportgrandma.jpg
grandma.jpg>/home/username/.tuxpaint/saved/20020921123456.png
jpegtopnm:WRITINGAPPMFILE

Thefirstline("tuxpaintimportgrandma.jpg")isthecommandtorun.Thefollowing
twolinesareoutputfromtheprogramwhileit'sworking.

NowyoucanloadTuxPaint,andaversionofthatoriginalpicturewillbeavailable
underthe'Open'dialog.Justdoubleclickitsicon!

DoingitManually
Windows,MacOSXandBeOSusersmustcurrentlydotheconversionmanually.

LoadagraphicsprogramthatiscapableofbothloadingyourpictureandsavingaPNG
formatfile.(Seethedocumentationfile"PNG.txt"foralistofsuggestedsoftware,and
otherreferences.)

WhenTuxPaintloadsanimagethat'snotthesamesizeasitsdrawingcanvas,itscales
(andsometimessmearstheedgesof)theimagesothatitfitswithinthecanvas.

Toavoidhavingtheimagestretchedorsmeared,youcanresizeittoTuxPaint'scanvas
size.ThissizedependsonthesizeoftheTuxPaintwindow,orresolutionatwhich
TuxPaintisrun,ifinfullscreen.(Note:Thedefaultresolutionis800x600.)See
"CalculatingImageDimensions",below.

SavethepictureinPNGformat.Itishighlyrecommendedthatyounamethefilename
usingthecurrentdateandtime,sincethat'stheconventionTuxPaintuses:

YYYYMMDDhhmmss.png

YYYY=Year
MM=Month(0112)
DD=Day(0131)
HH=Hour,in24hourformat(0023)
mm=Minute(0059)
ss=Second(0059)

e.g.:

20020921130500forSeptember21,2002,1:05:00pm

PlacethisPNGfileinyourTuxPaint'saved'directory.(Seeabove.)

CalculatingImageDimensions
ThewidthofTuxPaint'scanvasissimplythewidthofthewindow(e.g.,
640,800or1024pixels),minus192.

CalculatingtheheightofTuxPaint'scanvasrequiresmultiplesteps:

1.Taketheheightofthewindow(e.g,480,600or768pixels)and
subtract144
2.TaketheresultofStep1anddivideitby48

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 17/19
10/15/2016 TuxPaintREADME

3.TaketheresultofStep2androunditdown(e.g.,9.5becomes
simply9)
4.TaketheresultofStep3andmultiplyitby48
5.Finally,taketheresultofStep4andadd40

Example:TuxPaintrunningatfullscreenona1440x900display.

Thecanvaswidthissimply1440192,or1248.
Thecanvasheightiscalculatedas:
1.900144,or756
2.756/48,or15.75
3.15.75roundeddown,or15
4.15*48,or720
5.720+40,or760

Sothecanvaswithina1440x900TuxPaintwindowis1248x760.

FurtherReading
OtherdocumentationincludedwithTuxPaint(inthe"docs"folder/directory)include:

"Magic"ToolDocumentation("magicdocs")
Documentationforeachofthecurrentlyinstalled"Magic"tools.
AUTHORS.txt
Listofauthorsandcontributors.
CHANGES.txt
Summaryofchangedbetweenreleases.
COPYING.txt
Copyinglicense(TheGNUGeneralPublicLicense).
INSTALL.txt
Instructionsforcompiling/installing,whenapplicable.
EXTENDING.html
Detailedinstructionsoncreatingbrushes,stampsandstarters,andaddingfonts,toextend
TuxPaint.
OPTIONS.html
Detailedinstructionsoncommandlineandconfigurationfileoptions,forthosewhodon't
wanttouseTuxPaintConfig.
PNG.txt
NotesoncreatingPNGformatbitmappedimagesforuseinTuxPaint.
SVG.txt
NotesoncreatingSVGformatvectorimagesforuseinTuxPaint.

HowtoGetHelp
Ifyouneedhelp,feelfreetocontactNewBreedSoftware:

http://www.newbreedsoftware.com/

YoumayalsowishtoparticipateinthenumerousTuxPaintmailinglists:

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 18/19
10/15/2016 TuxPaintREADME

http://www.tuxpaint.org/lists/

file:///C:/Program%20Files%20(x86)/TuxPaint/docs/html/README.html 19/19