Table 6.111 — DRM_Image

Property

Description

Class

  • <DRM Image>

Superclass

Subclass

  • None.

Definition

An instance of this DRM class defines one or more MIP levels of texels, and can have 3 dimensions.

Class diagram

Figure 6.129 — DRM_Image

Inherited field elements

Field name

Range

Field data type

None

   

Field elements

Field name

Range

Field data type

name1

 

String

colour_model2

 

Colour_Model

level_count3

 

Short_Integer_Positive

mip_extents_array4

 

Image_MIP_Extents[level_count]

image_signature5

 

Image_Signature

scan_direction6

 

Image_Scan_Direction

scan_direction_z7

 

Image_Scan_Direction_Z

component_data_type8

 

Image_Component_Type

data_is_little_endian9

 

Boolean

data_is_3D10

 

Boolean

bits_of_alpha11

 

Short_Integer_Unsigned

bits_of_luminance12

 

Short_Integer_Unsigned

bits_of_colour_coordinate_113

 

Short_Integer_Unsigned

bits_of_colour_coordinate_214

 

Short_Integer_Unsigned

bits_of_colour_coordinate_315

 

Short_Integer_Unsigned

bits_of_bump_map_height16

 

Short_Integer_Unsigned

bits_of_material_117

 

Short_Integer_Unsigned

bits_of_material_218

 

Short_Integer_Unsigned

bits_of_material_319

 

Short_Integer_Unsigned

bits_of_material_2_percentage20

 

Short_Integer_Unsigned

bits_of_material_3_percentage21

 

Short_Integer_Unsigned

bits_of_image_index22

 

Short_Integer_Unsigned

bits_of_bump_map_u23

 

Short_Integer_Unsigned

bits_of_bump_map_v24

 

Short_Integer_Unsigned

min_value_of_alpha25

 

Float

max_value_of_alpha26

 

Float

min_value_of_luminance27

 

Float

max_value_of_luminance28

 

Float

min_value_of_colour_coordinate_129

 

Float

max_value_of_colour_coordinate_130

 

Float

min_value_of_colour_coordinate_231

 

Float

max_value_of_colour_coordinate_232

 

Float

min_value_of_colour_coordinate_333

 

Float

max_value_of_colour_coordinate_334

 

Float

min_value_of_bump_map_height35

 

Float

max_value_of_bump_map_height36

 

Float

min_value_of_bump_map_u37

 

Float

max_value_of_bump_map_u38

 

Float

min_value_of_bump_map_v39

 

Float

max_value_of_bump_map_v40

 

Float

Associated to (one-way) (inherited)

  • None.

Associated to (one-way)

  • None.

Associated by (one-way) (inherited)

  • None.

Associated by (one-way)

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)

Component of (two-way) (inherited)

  • None.

Component of (two-way)

Constraints

Clarifications

1 This is a meaningful short name. The data provider may use the <DRM Description> component to provide a more detailed description.

2 This specifies the colour model used throughout the given <DRM Image> instance. Only one colour model is allowed per <DRM Image> instance.

3 This specifies the number of Levels of Detail defined for the given <DRM Image> instance (for mipmaps).

If this is not a mipmapped image, only one level will defined (level_count == 1).

Many end-user applications require that <DRM Image> instances having MIP levels specify both the horizontal and vertical dimensions as a power of 2. However, some applications can handle <DRM Image> instances for which the horizontal and vertical dimensions are a multiple of 2 rather than a power of 2. For example, 96 texels in a direction is a multiple of 2 but not a power of 2.

Please note that SEDRIS places no restriction on either the dimensional size of an <DRM Image> instance, nor makes any statement as to whether the use of MIPS information within the <DRM Image> will be valid on a given consumer's system.

Note that for an <DRM Image> instance with an image_signature of EDCS_CLASSIFICATION_CODE, the bit size is a constant of sizeof(Classification_Code).

4 There are level_count entries in the array. Each entry defines the “size” (the number of horizontal, vertical, and z texels) for a single MIP level of the given <DRM Image> instance.

The first map shall contain the highest level of detail; that is, mip_extents_array[0] corresponds to the level containing the most texels.

5 This indicates how texels are represented within the given <DRM Image> instance; see Image_Signature for details.

6 This specifies the origin and direction of the horizontal and vertical components of the given <DRM Image> instance.

7 This specifies the direction in which the given <DRM Image> instance's z components are ordered.

8 This specifies the data type of the raw image data. If signed or unsigned integer is specified, the max size fields apply. If floating point is specified, the values range from 0.0 to 1.0.

9 This flag specifies the endianess of the raw image data.

10 This flag specifies whether the image data has 3 dimensions.

11 If 0 is specified, the image data does not contain alpha information.

12 If 0 is specified, the image data does not contain luminance information.

13 If 0 is specified, the image data does not contain colour information for this colour coordinate (R, C, H).

14 If 0 is specified, the image data does not contain colour information for this colour coordinate (G, M, S).

15 If 0 is specified, the image data does not contain colour information for this colour coordinate (B, Y, V).

16 If 0 is specified, the image data does not contain bump_map_height information.

17 If 0 is specified, the image data does not contain material 1 index information. If non-0 is specified, then this is an index into the <DRM Property Table> instance(s) that are referenced from the given <DRM Image> instance.

NOTE: With no material_2 or material_3 percentages, material_1 is at 100%.

18 If this value is non-zero for a given <DRM Image> instance X, then

However, if bits_of_material_2 = 0, the given <DRM Image> instance's texel data do not contain material 2 index information.

19 If this value is non-zero for a given <DRM Image> instance X, then

However, if bits_of_material_3 = 0, the given <DRM Image> instance's texel data do not contain material 3 index information.

20 If required by the given <DRM Image> instance's image_signature, this field is used to specify the percentage of material 2.

NOTE: the percentage of material 1 is (100% - (percentage of material 2))

21 If required by the given <DRM Image> instance's image_signature, this field is used to specify the percentage of material 3.

NOTE: the percentage of material 1 is (100% - (percentage of material 2) - percentage of material 3))

22 If 0 is specified, the image data does not contain image index information.

23 If 0 is specified, the image data does not contain bump_map_u information.

24 If 0 is specified, the image data does not contain bump_map_v information.

25 This is the minimum value that alpha can be within the image data; it is 0.0 if alpha is not used.

26 This is the maximum value that alpha can be within the image data; it is 0.0 if alpha is not used.

27 This is the minimum value that luminance can be within the image data; it is 0.0 if luminance is not used.

28 This is the maximum value that luminance can be within the image data; it is 0.0 if luminance is not used.

29 This is the minimum value that colour_coordinate_1 can be within the image data; it is 0.0 if not used.

30 This is the maximum value that colour_coordinate_1 can be within the image data; it is 0.0 if colour_coordinate_1 is not used.

31 This is the minimum value that colour_coordinate_2 can be within the image data; it is 0.0 if colour_coordinate_2 is not used.

32 This is the maximum value that colour_coordinate_2 can be within the image data; it is 0.0 if colour_coordinate_2 is not used.

33 This is the minimum value that colour_coordinate_3 can be within the image data; it is 0.0 if colour_coordinate_3 is not used.

34 This is the maximum value that colour_coordinate_3 can be within the image data; it is 0.0 if colour_coordinate_3 is not used.

35 This is the minimum value that bump_map_height can be within the image data; it is 0.0 if bump_map_height is not used.

36 This is the maximum value that bump_map_height can be within the image data; it is 0.0 if bump_map_height is not used.

37 This is the minimum value that bump_map_u can be within the image data; it is 0.0 if bump_map_u is not used.

38 This is the maximum value that bump_map_u can be within the image data; it is 0.0 if bump_map_u is not used.

39 This is the minimum value that bump_map_v can be within the image data; it is 0.0 if bump_map_v is not used.

40 This is the maximum value that bump_map_v can be within the image data; it is 0.0 if bump_map_v is not used.

41 If provided, this specifies either

  1. information about the events and/or source data used in constructing the given <DRM Image> instance, or
  2. lack of knowledge about lineage.

42 This is intended to support geo-specific <DRM Image> instances that are not referenced by any <DRM Image Mapping Function>, because an <DRM Image> may be significant only for a particular domain, e.g. radar, thermal, out-the-window.

Example(s)

  • A brick <DRM Image> that is repeated over the surface of a <DRM Polygon> to represent a brick wall.

  • An <DRM Image> of a tree that when applied to a <DRM Polygon> and combined with <DRM Translucency> creates a flat version of a tree.

  • The <DRM Image> mapped to the surface of a Dismounted Infantryman icon.

  • The sequence of <DRM Image>(s) mapped to a <DRM Polygon> to represent a television.

  • Consider an <DRM Image> that has 3 <DRM Property Table Reference> components:

    • one to a table for Infrared properties,
    • one to a table for Night Vision Goggles properties,
    • and the third to a <DRM Property Table> for Surface Material Category properties.
    NOTE: There is no restriction on the number of possible <DRM Property Table Reference> components.

    Image, Ex 5

    Figure 6.130 — <DRM Image> example

    1. Consider the case of 1 material. A given texel will contain a single integer, which is used in place of the index_on_axis field for all the <DRM Property Table Reference> components of the <DRM Image>.

    2. Consider the case of 2 materials. A given texel will contain 3 integers, 2 of which are used in place of the index_on_axis field for all the <DRM Property Table Reference>s of the <DRM Image>, and a third integer, which specifies the percentage of the 2nd material. For a given texel, say the numbers are 7 6 50 ; then the material at that texel is something that's 50% glass and 50% concrete.

    3. Consider the case of 3 materials. A given texel will contain 5 integers, 3 of which are used in place of the index_on_axis field for all the <DRM Property Table Reference> components of the <DRM Image>, and 2 of which specify the percentages of material 2 and 3. For a given texel, say the numbers are 4 6 7 20 30; then the material at that texel is something that is 50% wood, 20% concrete, and 30% glass.