Organization of This Book

This book is the definitive reference manual for mental ray^® version 3.6. It begins with a brief overview over the features of mental ray and continues with the specifications of the mental ray scene description language and the mental ray shader interface. All material is presented in reference form, organized by grammar elements and C function call, rather than by feature set. It is intended for translator writers and shader writers who are familiar with the C and C++ programming languages.

For a tutorial-style description of mental ray, refer to the book "Rendering with mental ray" [Driemeyer 01], which is intended for non-programmers who want to effectively use mental ray without concern for its internal structure and programming interfaces. The functionality of mental ray is presented in much greater detail there.

This book is organized in six chapters and an appendix:

Chapter 1

gives a brief overview over the functionality of mental ray.

Chapter 2

describes the scene language in detail. This chapter is organized by language unit.

Chapter 3

explains how custom shaders and Phenomena^™ are written, and documents the shader call interface.

Chapter 4

describes the extended geometry shader interface.

Chapter 5

contains porting guidelines for users and shader writers upgrading from mental ray version 3.4 to version 3.5, and from 3.3 to 3.4.

Appendix A

describes the command-line interface of mental ray.

Appendix B

contains the source code of mental ray's scene language parser.

The mental ray version described in this book is 3.6.1.

Throughout this book, features only available in mental ray version 3.6 are marked with 3.6, and features only available from another version 3.x on are marked with ^3.x.