

Contents

	Introduction						1-1

1.1	Supported Cross-Development Systems			1-2

1.2	An Overview of Development Tools			1-3

	Getting Started 					2-1

2.1	Supported Graphics Cards				2-3

2.2	Installation						2-4

2.2.1	Library Directory Structure				2-4

2.2.2	Dearchiving the Library Files and Subdirectories	2-6

2.2.3	Running the Library Demos				2-6

2.3	Using and Modifying the Library 			2-7

2.3.1	Writing Your Own Application Program			2-7

2.3.2	Porting the Library					2-8

2.3.3	Developing Custom Graphics Functions			2-10

2.4	Symbolic Debugging					2-12

2.5	TMS34010 and TMS34020 Code Compatibility		2-13

2.6	Conversion Between TIGA and Library Font Formats	2-14

	Graphics Library Overview				3-1

3.1	Graphics Capabilities					3-3

3.2	Core and Extended Primitives				3-4

3.3	Differences Between TIGA and TMS340 Graphics Library Routines	3-9

3.4	Graphics Library Environment				3-11

3.5	Bit-Mapped Fonts					3-12

3.6	Application Programming Issues				3-14

3.6.1	Specifying Complete Argument Lists			3-14

3.6.2	Library Globals 					3-14

3.6.3	Portability of C Source Code				3-14

3.6.4	Stack Growth						3-15

3.6.5	Library Code Size					3-15

3.7	System Implementation Issues				3-16

3.7.1	Register Usage Conventions				3-16

3.7.2	Interrupts						3-18

3.7.3	System-Level Hardware Functions 			3-19

3.7.4	Functions with System Dependencies			3-19

3.7.5	TMS34010 and TMS34020 Code Compatibility		3-21

3.7.6	Floating-Point Compatibility				3-21

3.7.7	Silicon Revision Number 				3-22

	Graphics Operations					4-1

4.1	Graphics Function-Naming Conventions			4-2

4.2	Coordinate Systems					4-4

4.3	Area-Filling Conventions				4-6

4.4	Vector-Drawing Conventions				4-9

4.5	Rectangular Drawing Pen 				4-11

4.6	Area-Fill Patterns					4-13

4.7	Line-Style Patterns					4-15

4.8	Operations on Pixels					4-17

4.8.1	Transparency						4-17

4.8.2	Plane Mask						4-18

4.8.3	Pixel-Processing Operations				4-19

4.9	Clipping Window 					4-21

4.10	Pixel-Size Independence 				4-22

	Bit-Mapped Text 					5-1

5.1	Bit-Mapped Font Parameters				5-2

5.2	Font Data Structure					5-5

5.2.1	Font Header Information 				5-5

5.2.2	Font Pattern Table					5-8

5.2.3	Location Table						5-10

5.2.4	Offset/Width Table					5-10

5.3	Proportionally Spaced Versus Block Fonts		5-11

5.4	Font Table						5-12

5.5	Text Attributes 					5-13

5.6	Available Fonts 					5-14

5.6.1	Installable Font Names					5-15

5.6.2	Alphabetical Listing of Fonts				5-16

	Core Primitives 					6-1

	Extended Primitives					7-1

	Data Structures 					A-1

A.1	BITMAP Structure Definition				A-3

A.2	CONFIG Structure Definition				A-4

A.3	ENCODED_RECT Structure Definition			A-5

A.4	ENVIRONMENT Structure Definition			A-6

A.5	ENVTEXT Structure Definition				A-7

A.6	FONT Structure Definition				A-8

A.7	FONTINFO Structure Definition				A-9

A.8	MODEINFO Structure Definition				A-10

A.9	OFFSCREEN_AREA Structure Definition			A-11

A.10	PAGE Structure Definitions				A-12

A.11	PALET Structure Definition				A-13

A.12	PATTERN Structure Definition				A-14

	Reserved Symbols					B-1

B.1	Symbols in Core Primitives Library			B-2

B.2	Symbols in Extended Primitives Library			B-5

B.3	Global Font Names					B-8

	Glossary						C-1

Figures

1-1	TMS340x0 Software Development Flow			1-3

4-1	Screen Coordinates and Drawing Coordinates		4-4

4-2	Mapping of Pixels to Coordinate Grid			4-5

4-3	A Filled Rectangle					4-6

4-4	A Filled Polygon					4-7

4-5	An Outlined Polygon					4-10

4-6	A Line Drawn by a Pen					4-12

4-7	A 16-by-16 Area-Fill Pattern				4-14

4-8	Three Connected Styled Lines				4-16

5-1	Bit-Mapped Font Attributes				5-4

5-2	Data Structure for Bit-Mapped Fonts			5-5

5-3	Bit-Mapped Font Representation				5-9

6-1	Outcodes for Line Endpoints				6-8

Tables

3-1	Summary of Library Functions				3-5

3-2	Library Global Variables				3-11

3-3	Summary of Available Fonts				3-12

4-1	Geometric Types 					4-2

4-2	Rendering Styles					4-3

4-3	Checklist of Available Geometric Types and Rendering Styles	4-3

4-4	Boolean Pixel-Processing Operation Codes		4-19

4-5	Arithmetic Pixel-Processing Operation Codes		4-20

5-1	Text-Related Functions					5-1

5-2	Font Database Summary					5-14

5-3	Installable Font Names					5-15

6-1	Pixel-Processing Operations				6-32

6-2	Pixel-Processing Operations				6-62

