
####################################
A3DGraphSceneDisplayParametersCreate
####################################

.. c:function:: A3DStatus A3DGraphSceneDisplayParametersCreate(const A3DGraphSceneDisplayParametersData *pData, A3DGraphSceneDisplayParameters **ppSceneDisplayParameters)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DGraphSceneDisplayParametersCreate(*const* :c:struct:`~A3DGraphSceneDisplayParametersData`\ \* **pData**\ , :c:type:`~A3DGraphSceneDisplayParameters`\ \*\* **ppSceneDisplayParameters**\ )
   
   Creates a new ``A3DGraphSceneDisplayParameters`` entity, returning its handle.
   
   
      2.0
   
   
   Once created, the new entity can be referenced to by its handle, given by ``*ppSceneDisplayParameters``\ . In case of failure, ``*ppLight`` is unchanged.
   
   **Return Values**
   
   
      **A3D_SUCCESS**\ : in case of success.
   
      **A3D_INITIALIZE_NOT_CALLED**\ : if the library is not initialized
   
      **A3D_INVALID_DATA_STRUCT_NULL**\ : if ``pData`` is null.
   
      **A3D_INVALID_DATA_STRUCT_SIZE**\ : if ``pData`` is incorrectly initialized
   
   
   .. code-block:: c
   
      A3DGraphSceneDisplayParameters handle = 0;
      A3DGraphSceneDisplayParametersData data = A3D_MAKE_DATA(A3DGraphSceneDisplayParametersData);
      // Configure data...
      A3DStatus result = A3DGraphSceneDisplayParametersCreate(&data, &handle);
      assert(handle != 0);
   
   
   ..
   
      :c:struct:`~A3DGraphSceneDisplayParametersData`
   
   
   
      :c:func:`~A3DGraphSceneDisplayParametersGet`
   
   
   **Parameters**
   
   
      **pData**\ : The data used for scene parameters creation.
   
      **ppSceneDisplayParameters**\ : An address to the new handle after creation.
   
   
   **Returns**
   
   
      ``A3D_SUCCESS`` or an error code in case of failure.
   
   




