Interface Scene

The Scene is the central part of an OC data set. Each OC data set contains exactly one. A Scene may contain initial product representations and/or updates. A Scene may contain products that should be inserted instantly, as well as add-ons to be inserted later on and shown as placeholders before.

Hierarchy

  • Scene

Properties

basePath?: string

The optional attribute provides a partial URI to be added to all relative asset uris. A valid base path should normally start with https:// or file://, and end with either a slash or the path sepa- rator character of the operating system. "Relative" basePath is always relative to the scene.json path, not to an application/deployment specific one! example.configurator.com/assets/oc/scene.json containing "tex.jpg" basepathes "gfx", "./gfx", "/gfx" are all resolved to the same example.configurator.com/assets/oc/gfx/tex.jpg

camera?: Camera

An optional camera setup to restore the camera in another viewer.

catalog?: CatalogEntry[]

Optional, embedded catalog.

comProducts?: Commercial[]

Commercial products without an own visual representation. Version: OC 1.3

configurationId?: string

This optional attribute may contain the id of a server-side session.

configurationLink?: string

This optional attribute may contain the link of the original configuration.

creator?: string

This optional attribute contains informal information about the creator of this OC data set.

format: string

The mandatory attribute format must be structured as follows: "OpenConfiguration_. [PRE]" Legal combinations of . are: 1.0, 1.1 and 1.2 The optional postfix " PRE" marks a preliminary format.

geometries?: Record<string, Geometry>

The optional attribute provides an embedded geometry index.

IGXC Compatibility: now it's embedded, self-contained geometries rather than just geometry names. Thus, separate assignments of geometry normal maps, deformations, etc. are removed. Also, the embedded geometry definition is optional. There can be external geometry definitions, too.

geometryIndexes?: Record<string, string>

The optional attribute provides links to external geometry indices. The key should be a two-level technical namespace to speedup the geometry lookup. The value must be an absolute or relative URI. The content of the value, must be de-serialized as GeometryIndex.

IGXC Compatibility: In IGXC, this concept did not exist.

hashes?: Record<string, string>

The mandatory attribute provides unique content hashes for assets that are directly referenced in the OC data set. The specific hash algorithm is unspecified. It may be an MD5 hash of the binary content for instance. But low-res assets may use the same hash as the originals, they are derived from. So, the only operation that is legal for hash, is to compare them with an optionally existing one.

All assets should have an entry here as downloaders may iterate through this record rather than exploring the other data entities.

materialIndexes?: Record<string, string>

The optional attribute provides links to external geometry indices. The key should be a two-level technical namespace to speedup the geometry lookup. The value must be an absolute or relative URI. The content of the value, must be de-serialized as MaterialIndex.

IGXC Compatibility: In IGXC, this concept did not exist.

materials?: Record<string, Material>

The optional attribute provides an embedded geometry index.

IGXC Compatibility: The embedded material definition is optional. There can be external material definitions, too.

packages?: Package[]

This optional attribute contains informal information about the projects used in this OC data set and its corresponding informal versions.

products: Product[]

The mandatory attribute contains the products to be inserted into/ updated in the client world.

IGXC Compatibility: in IGXC, there is only one product.

redirections?: Record<string, string>

Redirections maybe needed to convert absolute asset urls into file names, especially when compiling a self-contained OC zip. The attribute is optional. Version: OC 1.3

representations?: Representation[]

The representations of the scene. Legal values are: "Standard" - Real-time mesh data. "CAD_BIM" - CAD/BIM volume bodies. "Photo" - High-resolution mesh data. This just lists possible usages and can be used for fast filtering, it does not influence the actual data. A "Photo" renderer would still use meshes attached as geometry.mesh

scripts?: Script[]

The optional attribute contains all client-side JavaScript packages.

status?: Status

This attribute contains general status information about the Scene contents.

Generated using TypeDoc