SDL_ttf.pdf

SDLttf

7February2004

JonathanAtkins

Copyrightc2003JonathanAtkins

Permissionisgrantedtodistributefreely,orinadistributionofanykind.Alldistributions

ofthisﬁlemustbeinanunalteredstate,exceptforcorrections.

Thelatestcopyofthisdocumentcanbefoundat http://jcatki.no-ip.org/SDL_ttf

TableofContents

1Overview .................................. 1

2GettingStarted ............................ 3

2.1Includes................................................ 4

2.2Compiling.............................................. 5

3Functions ................................. 6

3.1General................................................. 7

3.1.1TTFLinkedVersion............................ 8

3.1.2TTFInit...................................... 9

3.1.3TTFWasInit................................. 10

3.1.4TTFQuit.................................... 11

3.1.5TTFSetError................................. 12

3.1.6TTFGetError................................ 13

3.2Management........................................... 14

3.2.1TTFOpenFont................................ 15

3.2.2TTFOpenFontRW............................ 16

3.2.3TTFOpenFontIndex.......................... 17

3.2.4TTFOpenFontIndexRW....................... 18

3.2.5TTFCloseFont................................ 19

3.3Attributes............................................. 20

3.3.1TTFByteSwappedUNICODE.................. 21

3.3.2TTFGetFontStyle............................. 22

3.3.3TTFSetFontStyle............................. 23

3.3.4TTFFontHeight.............................. 24

3.3.5TTFFontAscent.............................. 25

3.3.6TTFFontDescent............................. 26

3.3.7TTFFontLineSkip............................ 27

3.4Render................................................ 28

3.4.1TTFRenderTextSolid........................ 29

4Types .................................... 30

4.1TTFFont............................................. 31

5Deﬁnes ................................... 32

6Glossary ................................. 33

Index ....................................... 35

Chapter1:Overview 1

1Overview

ALittleBitAboutMe

Iamcurrently,asIwritethisdocument,aprogrammerforRaytheon.ThereIdoall

sortsofcommunications,network,GUI,andothergeneralprogrammingtasksinC/C ++ on

theSolarisandsometimesLinuxOperatingSystems.I’veusedSDLttfasoneofthemany

methodsofputtingtextonmySDLapplications,anduseitinmyownSDLGUIcodeas

well.Whilethisdocumentdoesn’texplainhowandwheretogetfontstouse,itwillexplain

howtousethemwithSDLttf.

Feelfreetocontactme: jcatki@jcatki.no-ip.org

Thelatestversionofthislibraryisavailablefrom:

SDLttfHomepage

IamalsousuallyonIRCatirc.freenode.netinthe#SDLchannelasLIM

Chapter1:Overview 2

ThisistheREADMEintheSDLttfsourcearchive.

ThislibraryisawrapperaroundtheexcellentFreeType1.2library,availableat: Freetype

Homepage

WARNING:TheremaybepatentissueswithusingtheFreeTypelibrary.Checkthe

FreeTypewebsiteforup-to-datedetails.

ThislibraryallowsyoutouseTrueTypefontstorendertextinSDLapplications.

Tomakethelibrary,ﬁrstinstalltheFreeTypelibrary,thentype’make’tobuildtheSDL

truetypelibraryand’makeall’tobuildthedemoapplication.

Becarefulwhenincludingfontswithyourapplication,asmanyofthemarecopyrighted.

TheMicrosoftfonts,forexample,arenotfreelyredistributableandeventhefree " web "

fontstheyprovideareonlyredistributableintheirspecialexecutableinstallerform(May

1998).ThereareplentyoffreewareandsharewarefontsavailableontheInternetthough,

andmaysuityourpurposes.

Pleaseseetheﬁle " COPYING " forlicenseinformationforthislibrary.

Enjoy!-SamLantinga slouken@devolution.com (5/1/98)

Plik z chomika:

Inne pliki z tego folderu:

Inne foldery tego chomika: