Rule Name: Color Mapping Restrictions

Definition

The color_mapping field of a Color must not be empty.

In addition,

1. The SE_LIGHT_RENDERING_BEHAVIOR_PRIMARY_COLOR and SE_LIGHT_RENDERING_BEHAVIOR_SECONDARY_COLOR flags may only be used for objects with Light Rendering Properties.

2. The SE_LIGHT_RENDERING_BEHAVIOR_PRIMARY_COLOR flag may not be combined with any other SE_COLOR_MAPPING_ENUM.

3. The SE_LIGHT_RENDERING_BEHAVIOR_SECONDARY_COLOR flag may not be combined with any other SE_COLOR_MAPPING_ENUM.

Rationale

A Color must specify how it is applied to the objects that use it, so the color_mapping must not be empty.

The SE_LIGHT_RENDERING_BEHAVIOR_PRIMARY_COLOR and SE_LIGHT_RENDERING_BEHAVIOR_SECONDARY_COLOR flags specify the primary and secondary colors of an object's Light Rendering Behavior.

If the Color applies to the Light Rendering Behavior of an object rather than the object itself, it must apply only to that Light Rendering Behavior. In addition, the same Color cannot be both the primary and the secondary color of a Light Rendering Behavior.

Example

1. Consider a Polygon with 2 Inline Colors and an Image Mapping Function, where the Image Mapping Function's method is set to SE_BLEND_IMAGE.
   Each Inline Color must specify whether it is primary, image blend, or neither, and which side of the Polygon is affected, in order to determine how to combine the colors with the texture.

FAQs

See the comments for Color, SE_COLOR_MAPPING_ENUM, and Image Mapping Function for discussions of how color_mapping is interpreted.