Table 6.115 — DRM_Image_Mapping_Function

Property

Description

Class
  • <DRM Image Mapping Function>

Superclass

Subclass
  • None.

Definition

An instance of this DRM class specifies how the given <DRM Image> is to be mapped onto a given textured object, including the mapping method, the projection, and how <DRM Texture Coordinate> instances (if present) are to be treated if they fall outside the image space bounded by (0, 0), (1, 1).

Class diagram

Figure 6.135 — DRM_Image_Mapping_Function

Inherited field elements

Field name

Range

Field data type

None

    

Field elements

Field name

Range

Field data type

image_mapping_method1

 

Image_Mapping_Method

image_wrap_s2

 

Image_Wrap

image_wrap_t3

 

Image_Wrap

image_projection_type4

 

Image_Projection_Type

intensity_level5

[0.0..1.0]

Long_Float

gain6

 

Long_Float

image_detail_mapping7

 

Boolean

Associated to (one-way) (inherited)
  • None.

Associated to (one-way)

Associated by (one-way) (inherited)
  • None.

Associated by (one-way)
  • None.

Associated with (two-way) (inherited)
  • None.

Associated with (two-way)
  • None.

Composed of (two-way) (inherited)
  • None.

Composed of (two-way)

Composed of (two-way metadata) (inherited)
  • None.

Composed of (two-way metadata)
  • None.

Component of (two-way) (inherited)
  • None.

Component of (two-way)

Constraints

Clarifications

1 For details on these methods, see Image_Mapping_Method.

2 This specifies whether to clamp or repeat the given <DRM Image> instance in s.

3 This specifies whether to clamp or repeat the given <DRM Image> instance in t.

4 This specifies the type of projection to be used when applying the given instance to textured objects.

  1. If planar projection is specified, the following cases may apply.

    See <DRM Image Mapping Function> FAQs for how to interpret these cases.

  2. If cylindrical or spherical projection is specified, the object shall not have <DRM Texture Coordinate> or <DRM Tack Point> instances. Instead, either the <DRM Image Mapping Function> instance or its <DRM Image> instance shall have an <DRM Image Anchor> instance.

5 This indicates the percent contribution of the given <DRM Image Mapping Function> instance to the total effect on the textured object. For an <DRM Image> instance with a colour coordinate component specified by its signature, multiply first, second, and third colour coordinate values within the <DRM Image> instance's texels by this value.

6 This value is to be added to each colour data value from the texel data of the given <DRM Image> instance to obtain the displayed image.

7 This indicates whether the given <DRM Image Mapping Function> instance is used to describe mapping of a “detail” image on the textured object.

8 Note that <DRM Presentation Domain> is optional only when the aggregating object(s) have one and only one <DRM Image Mapping Function> component. If multiple <DRM Image Mapping Function> instances are present, each shall have a distinct <DRM Presentation Domain> component.

Example(s)