Graphics

Functions

A3DStatus A3DGraphicsGet()
A3DStatus A3DGraphicsCreate()
A3DStatus A3DGraphicsDelete()
A3DStatus A3DGlobalGetGraphStyleData()
A3DStatus A3DGlobalInsertGraphStyle()
A3DStatus A3DGlobalGetGraphRgbColorData()
A3DStatus A3DGlobalInsertGraphRgbColor()
A3DStatus A3DGlobalGetGraphLinePatternData()
A3DStatus A3DGlobalGetGraphMaterialData()
A3DStatus A3DGlobalInsertGraphMaterial()
A3DStatus A3DGlobalGetGraphPictureData()
A3DStatus A3DGlobalInsertGraphPicture()
A3DStatus A3DGlobalGetGraphDottingPatternData()
A3DStatus A3DGlobalInsertGraphDottingPattern()
A3DStatus A3DGlobalGetGraphHatchingPatternData()
A3DStatus A3DGlobalInsertGraphHatchingPattern()
A3DStatus A3DGlobalGetGraphSolidPatternData()
A3DStatus A3DGlobalInsertGraphSolidPattern()
A3DStatus A3DGlobalGetGraphVPicturePatternData()
A3DStatus A3DGlobalInsertGraphVPicturePattern()
A3DStatus A3DGraphCameraGet()
A3DStatus A3DGraphCameraCreate()
A3DStatus A3DGraphAmbientLightGet()
A3DStatus A3DGraphAmbientLightCreate()
A3DStatus A3DGraphPointLightGet()
A3DStatus A3DGraphPointLightCreate()
A3DStatus A3DGraphSpotLightGet()
A3DStatus A3DGraphSpotLightCreate()
A3DStatus A3DGraphDirectionalLightGet()
A3DStatus A3DGraphDirectionalLightCreate()
A3DStatus A3DGraphSceneDisplayParametersGet()
A3DStatus A3DGraphSceneDisplayParametersCreate()
A3DStatus A3DMiscCascadedAttributesCreate()
A3DStatus A3DMiscCascadedAttributesDelete()
A3DStatus A3DMiscCascadedAttributesGet()
A3DStatus A3DMiscCascadedAttributesPush()
A3DStatus A3DMiscPointerFromIndexGet()
A3DStatus A3DMiscRootBaseInsertAttribute()

Detailed Description

group a3d_graphics_module

Query and manipulate scene and rendering informations.

The graphics group provides the essential set of tools for describing a rendering scene, such as texturing, lighting or view information. The following entities are presents in this modules, along with their public data and access functions:

The module also provides a set of indexed data:

Any entity of the given type can be used as an A3DRootBaseWithGraphics.

General Structure
An entity of type A3DRootBaseWithGraphics embeds an A3DGraphics entity. This structure mainly provides two informations:
  • A layer which allows grouping entities with a common identifier.
  • A style index which references an A3DGraphStyleData. A3DGraphStyleData lists all graphics properties the A3DRootBaseWithGraphics is assigned to, such as drawing patterns, materials or textures.

HOOPS Exchange provides a global container (A3DGlobalData) which references each of these data using indexed lists. Thus, structures such as A3DGraphRgbColorData are obtained using an non-typed numerical index.

Indexed data
Indexed data are plain structures which are globally shared among a potentially important amount of entities within a model file. For example, the same color description can be used for all the graphics entities of a scene.

Yet, these data act as front-end for internal entities which are still referenced to by handles. The purpose of obtaining the underlying entity of an indexed data depends on the context and is generally an uncommon operation. As an example, the full PBR (Physically-Based Rendering) features is provided as an extension of A3DGraphMaterialData throughout its underlying entity. To retrieve the underlying entity of an indexed data, see A3DMiscPointerFromIndexGet.

Function Documentation