Chapter 1 - Introduction

The TMS340 Graphics Library is a collection of software functions that execute 
on the TMS34010 and TMS34020 Graphics System Processors. The functions in the 
library are designed to be called from C programs executing on a TMS340 
graphics processor, but they can also be called from TMS340 assembly language 
programs that mimic the C compiler's calling conventions. The library provides 
capabilities for outputting text and graphics to video monitors and other 
raster graphics display devices controlled by TMS340 graphics processors. 
Library functions are provided for performing pixel-block-aligned transfers (or 
"PixBlts"), for printing bit-mapped text, and for drawing lines, polygons, 
ellipses, arcs and other figures.

The TMS34010 and TMS34020 are advanced single-chip, 32-bit graphics 
microprocessors. They combine 32-bit general-purpose processing power with 
features that accelerate computer graphics applications and decrease the size 
and cost of graphics systems. Both are software-compatible members of the 
TMS340 Family of graphics products from Texas Instruments.

The TMS34010 and TMS34020 are well supported by a full set of hardware and 
software development tools. The available software tools include a C compiler, 
assembler, linker and archiver. These are described in the TMS340 Family Code 
Generation Tools User's Guide. Hardware tools include full-speed hardware 
emulators and IBM PC-compatible software development boards. These are 
described in the user's guides for the TMS34010 and TMS34020 extended 
development systems (XDSs) and software development boards (SDBs).

Texas Instruments bundles software debugging tools with its software 
development board products for the TMS34010 and TMS34020. In addition, a 
variety of debugging tools are available from third parties. Consult the TMS340 
Family Third Party Guide for an up-to-date listing of debugging tools from 
third parties.

Texas Instruments provides a hotline to assist you with technical questions 
about TMS340 Family products and development tools. The telephone number for 
the hotline is (713) 274-2340.

1.1	Supported Cross-Development Systems

The compilation, assembly, and linking of software modules for execution on a 
TMS340x0 (TMS34010 or TMS34020) processor is performed on a system other than 
the target TMS340x0 display system. The TMS340x0 software tools can be 
installed on the following systems:

IBM-PC or 100% compatible system
       -with PC-DOS or MS-DOS
       -with OS/2

VAX
       -VMS
       -Ultrix

Apollo Workstations
       -Domain/IX
       -AEGIS

Sun-3 and Sun-4 Workstations with Unix

Macintosh with MPW

1.2	An Overview of Development Tools

Figure 1-1 shows the flow of TMS340x0 software development with the TMS340 
Family Code 
Generation Tools. The most widely used software development paths are 
highlighted in the figure; the other paths are optional.

Figure 1-1.	TMS340x0 Software Development Flow

The TMS340 Graphics Library (lower right side of Figure 1-1) in object form is 
linked 
with applications programs written in C and compiled using the C compiler. (The 
library can also be linked with applications written in assembly language that 
mimic the C compiler's subroutine-calling conventions.) The graphics library 
complements the runtime-support and floating-point libraries shipped with the C 
compiler. Other libraries available from Texas Instruments as separate products 
include the CCITT Image Compression/Decompression Library and the 8514 Adapter 
Interface Emulation Function Library.

The complete C and assembly language source code for the TMS340 Graphics 
Library is provided. This makes possible another development path in which the 
programmer modifies the original library source code to accommodate the 
requirements of a proprietary application. The modified source library can be 
compiled, assembled, and archived to form a new object library that can be 
linked with an application.

The C compiler at the top right of Figure 1-1 accepts C source code and 
produces TMS340x0 assembly source code. The C compiler consists of four stages: 
a preprocessor, a parser, a code generator, and an optional optimizer.

The assembler near the top center of Figure 1-1 translates TMS340x0 assembly 
language 
source files into machine language object files. The object files are in COFF 
(common object file format), as described in the TMS340 Family Code Generation 
Tools User's Guide.

The archiver is used to collect a group of files (source or object) into a 
single archive file. The resulting archive file is referred to as a source or 
object library, as appropriate.

The linker shown in the middle of Figure 1-1 combines object files into a 
single 
executable object module. As the linker creates the executable module, it 
performs relocation and resolves external references. The linker accepts 
relocatable COFF object files and object libraries as input. The linker is 
capable of extracting the modules it requires from object libraries constructed 
using the archiver.

The resulting executable TMS340x0 program can be executed either on a 
proprietary TMS340x0-based display system or on one of the hardware products 
provided by Texas Instruments to support software development. The TMS34010 and 
TMS34020 Software Development Boards from Texas Instruments are 
high-performance graphics cards that can be inserted into IBM-compatible PCs. 
The SDBs and accompanying software-debugging tools are sufficient to support 
the software development needs of many applications. More extensive software 
and hardware development capabilities are provided in the XDS (extended 
development system) products for the TMS34010 and TMS34020. For more 
information, refer to the user's guides for these products.

