Model Viewer Technical Guide
Section 3 - TRANSMITTAL CONTENT SPECIFICATION FOR MODEL VIEWER

3.1 Fundamental Requirements
.
First and foremost, any transmittal submitted to Model Viewer as input must pass both Syntax Checker and Rules Checker. If an invalid transmittal is submitted as input, Model Viewer will abort the loading process with an appropriate error message if the errors are fatal in regard to the <Image Library> or <Model Library>.

In a similar vein, if inter-transmittal referencing (ITR) is used in the input transmittal's <Image Library> or <Model Library>, then all transmittals referenced in the context of the <Image Library> or <Model Library> must be provided. For example, if the user specified that <Models> were to be loaded and processed, but some of the <Model> instances in the <Model Library> were unavailable due to missing transmittals, the application would abort during the loading process.

.
3.2 Requirements for <Models>
.
If a <Model Library> ML is provided and the user specifies that <Models> are to be viewed, then ML must satisfy the following requirements.
  1. ML shall contain at least one "root" <Model>, that is, a <Model> instance whose model_reference_type is either SE_MDL_REF_TYP_ROOT or SE_MDL_REF_TYP_ROOT_AND_COMPONENT.

    RATIONALE: Only root <Models> can be instanced as free-standing objects, so only root <Models> are guaranteed to make some kind of visual sense. Only root <Models>, consequently, are displayed by Model Viewer; component <Models> appear only in the context of their usage within other <Models>.

  2. Every <Model> within ML shall be defined within a 3D LSR spatial reference frame.
  3. Every <Model> within ML shall contain a non-empty <Geometry Model>. ( <Feature Models> are currently ignored, if present; only renderable geometry is displayed.)
  4. All <Primitive Colours> in use shall have either an <Ambient Colour> or a <Diffuse Colour> component. <Specular Colours> and <Emissive Colours> are currently ignored.
.
3.3 Requirements for <Images> and <Image Mapping Functions>
.
Only the following image signatures are supported: LUMINANCE, ALPHA, LUMINANCE_AND_ALPHA, 123COLOUR, COLOUR_COORDINATE_1, COLOUR_COORDINATE_2, and COLOUR_COORDINATE_3.

Mipmapped images, to be used for mipmapping, must comply with OpenGL's restrictions on mipmapped image dimensions. Noncompliant images will be treated as though they had only a single MIP level.

Currently, Model Viewer's texture mapping supports only <Image Mapping Functions> defined in conjunction with <Texture Coordinates>, and consequently only planar projection. Expanded support will be phased in in future; currently such support has a low priority since other varieties of texture mapping have not been in demand by SEDRIS' user base.

.
3.4 Limitations
.


Return to:Top of this Page, Table of Contents

Last updated: August 23, 2005 Copyright © 2005 SEDRIS