The PhotoJazz interface has two layers: a foundation layer and a file layer.

Foundation Layer

The Foundation layer defines types and and interfaces specific to the operating system: basic data types (JzTypes.h) and the interfaces for memory allocation (JzAllocator.h), thread management (JzYielder.h), and input/output (JzStream.h). The allocator, stream, and yielder are object-oriented C structures that you can extend. The suites of functions defined by these interfaces are callbacks: functions that you supply for the PhotoJazz engine to call. We provide sample code for the callback functions which you are free to use with or without modification.

File Layer

The File layer defines the interfaces for getting and setting PhotoJazz parameters (JzGet.h and JzSet.h), reading and writing PhotoJazz image files (JzRead.h and JzWrite.h), and interpreting private data chunks (JzInterpreter.h), all referring to an opaque JzFile object. The JzGet, JzSet, JzRead, and JzWrite suites contain functions in the PhotoJazz engine that you call directly. We provide sample code snippets using these suites that you may incorporate into your code with or without modification. The interpreter is an object-oriented C structure that you can extend. The function it defines is a callback function that you supply for the PhotoJazz engine to call. We provide sample code for the callback function that you may use with or without modification.

A top-level interface file, JzPhotoJazz.h, ties the whole interface together.