Preface

The KCMS CMM Reference Manual provides detailed descriptions of the Kodak^(TM) Color Management System (KCMS) foundation library. This library is a graphics porting interface (GPI) implemented in C++ for creating KCMS color modules. A set of C++ classes are supplied that can be derived from and extended. You can add attributes to the current list, incorporate new color processing technology.

Use this book with the KCMS CMM Developer's Guide which provides an an in-depth view of the KCMS framework and how the API works with this GPI, how to derive from each C++ class, how to create a dynamically loadable CMM and how to add profiles to the system.

Who Should Use This Book

Use this guide if you are interested in:

• Writing your own color management module (CMM)
• Creating your own profile format
• Adding attributes or tags to the ICC profile format
• Overriding various class methods

Before You Read This Book

You should be familiar with the Kodak Color Management System (KCMS) API which is part of the SDK; see the KCMS Application Developer's Guide.

You should also have an understanding of C++ and Solaris dynamic loading technology. Solaris dynamic loading is discussed in the Linker and Libraries Guide and in the following manual pages in man Pages(1): User Commands:

• ld(1)
• dlopen(3)
• dlclose(3)
• dlerror(3)
• dlsym(3)

A basic understanding of color science is also assumed; references are included in the Bibliography of the KCMS Application Developer's Guide.

See the on-line SUNWrdm packages for information on bugs and issues, engineering news, and patches. For Solaris installation bugs and for late-breaking bugs, news, and patch information, see the Solaris Installation Notes (SPARC or x86).

For SPARC systems, consult the updates your hardware manufacturer may have provided also.

How This Book Is Organized

Chapter 1, "KcsShareable Class," describes the KcsShareable class.

Chapter 2, "I/O Classes," describes these I/O classes: KcsIO, KcsFile, KcsMemoryBlock, KcsSolarisFile and KcsXWindow.

Chapter 3, "KcsChunkSet Class," describes in detail the Chunk classes.

Chapter 4, "KcsLoadable Class," describes in detail the KcsLoadable class.

Chapter 5, "KcsProfile Class," describes in detail the Profile base classes.

Chapter 6, "KcsProfileFormat Class," describes in detail the KcsProfileFormat class.

Chapter 7, "KcsTags Class," describes in detail the KcsAttributeSet class.

Chapter 8, "KcsXform Class," describes the member functions in the Xform classes.

Chapter 9, "KcsXformSeq Class," describes the member functions in the KcsXformSeq class.

Chapter 10, "KcsStatus Class," describes in the KcsStatus class.

Related Books

The following is a list of recommended books that can help you accomplish the tasks described in the manual:

• KCMS Application Developer's Guide
• ICC Profile Format Specification (located on-line in /opt/SUNWsdk/kcms/doc/icc.ps)

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.

KcsId Naming Convention

Each class contains a KcsId that uniquely identifies that class. Most KcsIds are defined in the kcsids.h header file. The naming conventions shown in the following table are used for the KcsId for each class in the KCMS framework. The #defines are helpful in switch statements.

Table P-2

Item	Convention	Examples
const	Kcs<Base Class Id><Derived Class Id>Id	KcsSharIOId
#define	Kcs<Base Class Id><Derived Class Id>Idd	KcsSharIOIdd