.. _group__a3d__40__graphics:

#######################
Graphics and Appearance
#######################

Appearance and rendering.

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:


- ``A3DGraphAmbientLightData``
- \ ``A3DGraphCameraData``
- \ ``A3DGraphDirectionalLightData``
- \ ``A3DGraphHatchingPatternLineData``
- \ ``A3DGraphicsData``
- \ ``A3DGraphPointLightData``
- \ ``A3DGraphSceneDisplayParametersData``
- \ ``A3DGraphSpotLightData``
- \ ``A3DMiscCascadedAttributesData``

\ The module also provides a set of indexed data:


- ``A3DGraphDottingPatternData``
- \ ``A3DGraphHatchingPatternData``
- \ ``A3DGraphLinePatternData``
- \ ``A3DGraphMaterialData``
- \ ``A3DGraphPictureData``
- \ ``A3DGraphRgbColorData``
- \ ``A3DGraphSolidPatternData``
- \ ``A3DGraphStyleData``
- \ ``A3DGraphVPicturePatternData``

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

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.

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``\ .


   **Please refer to classical graphical definitions when needed (OpenGL, DirectX, ...). Notions are quite similar to the ones used inside common scene graphs**\ . This is true for lights, textures, line styles, patterns, cameras.


.. rst-class:: kind-group kind-topic

.. rubric:: Topics
   :class: kind-group-title


.. rst-class:: api-xref-list


* :ref:`Bit Field for Behavior on Graphics <group__a3d__graphicsbits>`
* :ref:`Display Style <group__a3d__style>`
* :ref:`Global Data Module <group__a3d__global__data__module>`
* :ref:`Texture Alpha Mode Parameter <group__a3d__texturealphamode>`
* :ref:`Texture Alpha Test <group__a3d__texturealphatest>`
* :ref:`Texture Application <group__a3dtexture__application>`
* :ref:`Texture Blend Parameter <group__a3d__textureblendparameter>`
* :ref:`Texture Definition <group__a3dtexture__definition>`
* :ref:`Texture Function <group__a3d__texturefunction>`
* :ref:`Texture Mapping Attribute Components <group__a3d__texture__mapping__attributes__components>`
* :ref:`Texture Mapping Operator <group__a3d__texturemappingoperator>`
* :ref:`Texture Mapping Type <group__a3d__texturemapping>`
* :ref:`Texture Transformation <group__a3d__texturetransformation>`
* :ref:`Texture Wrapping Mode <group__a3d__texturewrappingmode>`

.. rst-class:: kind-group kind-enumeration

.. rubric:: Enumerations
   :class: kind-group-title


.. rst-class:: api-xref-list


* :c:enum:`~A3DEPictureDataFormat`

.. rst-class:: kind-group kind-enumerator

.. rubric:: Enumerators
   :class: kind-group-title


.. rst-class:: api-xref-list


* :c:enumerator:`~kA3DPictureBitmapGreyaByte`
* :c:enumerator:`~kA3DPictureBitmapGreyByte`
* :c:enumerator:`~kA3DPictureBitmapRgbaByte`
* :c:enumerator:`~kA3DPictureBitmapRgbByte`
* :c:enumerator:`~kA3DPictureBmp`
* :c:enumerator:`~kA3DPictureJpg`
* :c:enumerator:`~kA3DPicturePng`

.. rst-class:: kind-group kind-function

.. rubric:: Functions
   :class: kind-group-title


.. rst-class:: api-xref-list


* :c:func:`~A3DGlobalGetGraphDottingPatternData`
* :c:func:`~A3DGlobalGetGraphHatchingPatternData`
* :c:func:`~A3DGlobalGetGraphLinePatternData`
* :c:func:`~A3DGlobalGetGraphMaterialData`
* :c:func:`~A3DGlobalGetGraphPictureData`
* :c:func:`~A3DGlobalGetGraphRgbColorData`
* :c:func:`~A3DGlobalGetGraphSolidPatternData`
* :c:func:`~A3DGlobalGetGraphStyleData`
* :c:func:`~A3DGlobalGetGraphVPicturePatternData`
* :c:func:`~A3DGlobalInsertGraphDottingPattern`
* :c:func:`~A3DGlobalInsertGraphHatchingPattern`
* :c:func:`~A3DGlobalInsertGraphLinePattern`
* :c:func:`~A3DGlobalInsertGraphMaterial`
* :c:func:`~A3DGlobalInsertGraphPicture`
* :c:func:`~A3DGlobalInsertGraphRgbColor`
* :c:func:`~A3DGlobalInsertGraphSolidPattern`
* :c:func:`~A3DGlobalInsertGraphStyle`
* :c:func:`~A3DGlobalInsertGraphVPicturePattern`
* :c:func:`~A3DGraphAmbientLightCreate`
* :c:func:`~A3DGraphAmbientLightGet`
* :c:func:`~A3DGraphCameraCreate`
* :c:func:`~A3DGraphCameraGet`
* :c:func:`~A3DGraphDirectionalLightCreate`
* :c:func:`~A3DGraphDirectionalLightGet`
* :c:func:`~A3DGraphicsCreate`
* :c:func:`~A3DGraphicsDelete`
* :c:func:`~A3DGraphicsGet`
* :c:func:`~A3DGraphPointLightCreate`
* :c:func:`~A3DGraphPointLightGet`
* :c:func:`~A3DGraphSceneDisplayParametersCreate`
* :c:func:`~A3DGraphSceneDisplayParametersGet`
* :c:func:`~A3DGraphSpotLightCreate`
* :c:func:`~A3DGraphSpotLightGet`
* :c:func:`~A3DMiscCascadedAttributesCreate`
* :c:func:`~A3DMiscCascadedAttributesDelete`
* :c:func:`~A3DMiscCascadedAttributesEntityReferencePush`
* :c:func:`~A3DMiscCascadedAttributesGet`
* :c:func:`~A3DMiscCascadedAttributesPush`
* :c:func:`~A3DMiscCascadedAttributesPushTessFace`
* :c:func:`~A3DMiscPointerFromIndexGet`
* :c:func:`~A3DMiscRootBaseInsertAttribute`

.. toctree::
   :maxdepth: 1
   :hidden:

   a3d_texturemappingoperator
   a3d_texturemapping
   a3d_texturefunction
   a3d_textureblendparameter
   a3d_texturealphamode
   a3d_texture_mapping_attributes_components
   a3d_texturealphatest
   a3d_texturewrappingmode
   a3d_graphicsbits
   a3d_style
   a3d_global_data_module
   a3d_texturetransformation
   a3dtexture_definition
   a3dtexture_application


