Preface

What Is the Solaris XIL Imaging Library?

The Solaris^(TM) XIL^(TM) Imaging Library is the Solaris software's foundation imaging library. Foundation libraries are the lowest-level device-independent software layer of Solaris software. This level of interface is designed to support a wide variety of common functions; higher-level libraries can be built on top of the foundation, or an application can use the foundation layer directly.

The XIL Imaging Library is suitable for use by libraries or applications that require imaging or digital video capabilities, such as document imaging, color prepress, or digital video generation and playback.

Prerequisites

You should be thoroughly familiar with the XIL Imaging Library and should have read the XIL Programmer's Guide before you begin working with the XIL Test Suite.

What Is the XIL Test Suite?

The XIL Test Suite is a suite of test programs that enable you to test XIL functionality and a set of functions that enable you to write your own test programs.

What's in This Book?

Chapter 1, "Overview of the XIL Test Suite" is an overview of the XIL Test Suite.

Chapter 2, "Running Test Programs in the XIL Test Suite" describes how to run test programs in the XIL Test Suite. Requirements for setting up and running the Xilch master control program, or harness, are described in detail.

Chapter 3, "Writing Test Programs in the XIL Test Suite Environment"

describes how to write new test programs that will run under the Xilch harness. The functions in the XIL Test Suite library are described, and other pertinent details are discussed.

The XIL Test Suite may be useful to some system developers as they enhance XIL functionality by porting the XIL library to new devices or by creating new molecules. The usefulness of the XIL Test Suite to system developers is also described in this chapter.

Appendix A, "XIL Test Suite Directory Structure" describes the XIL Test Suite directory structure.

Appendix B, "Example Test Program" contains the text of an example test program.

Appendix C, "Equivalence Testing Example" provides an example of the equivalence testing functions.

Related Books

For information about the XIL Imaging Library, refer to the XIL Programmer's Guide, which is provided with the AnswerBook^(R) on-line documentation. This book explains how to use XIL functions to develop application programming interfaces (APIs) and end-user applications.

A companion to the XIL Programmer's Guide is the XIL Reference Manual, which is also provided with the AnswerBook on-line documentation. The reference manual contains man pages for all of the functions in the XIL library.

Because programming with the XIL library can be closely tied to programming with the X library, you may also find it useful to consult the Xlib Programming Manual and the Xlib Reference Manual.

What Typographic Changes and Symbols Mean

The following table describes the type changes and symbols used in this book.

Table P-1

Typeface or Symbol	Meaning	Example
AaBbCc123	The names of commands, files, and directories; on-screen computer output	Edit your .login file. Use ls -a to list all files. system% You have mail.
AaBbCc123	What you type, contrasted with on-screen computer output	system%su Password:
AaBbCc123	Command-line placeholder: replace with a real name or value	To delete a file, type rm filename.
AaBbCc123	Book titles, new words or terms, or words to be emphasized	Read Chapter 6 in User's Guide. These are called class options. You must be root to do this.
Code samples are included in boxes and may display the following:
%	UNIX C shell prompt	system%
$	UNIX Bourne and Korn shell prompt	system$
#	Superuser prompt, all shells	system#