KCMS CMM Reference Manual

Preface

The KCMS CMM Reference Manual provides detailed descriptions of the Kodak 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, or support alternate profile formats.

Use this book with the KCMS CMM Developer's Guide which provides 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 book if you are interested in:

• Writing your own color management module (CMM)

• Creating your own profile format

• Adding attributes 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 section 1: User Commands and man pages section 3: Basic Library Functions:

• ld(1)

• dlopen(3)

• dlclose(3)

• dlerror(3)

• dlsym(3)

• OWconfigInit(3)

• OWconfigGetAttribute(3)

• OWconfigFreeAttribute(3)

• OWconfigClose(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 9 Installation Guide.

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

How This Book Is Organized

Note - Each chapter in this book describes relevant classes in the KCMS architecture. Although the DDK header files may include additional information (private and methods and other internal interfaces) for each class, be aware that the chapters in this book present all the methods you need to be concerned about to write your CMM.

The chapters are organized as follows:

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 KcsChunkSet class.

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

Chapter 5, KcsProfile Class describes in detail the KcsProfile class.

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 KcsXform class.

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