
#######################
A3DGraphSpotLightCreate
#######################

.. c:function:: A3DStatus A3DGraphSpotLightCreate(const A3DGraphSpotLightData *pData, A3DGraphSpotLight **ppLight)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DGraphSpotLightCreate(*const* :c:struct:`~A3DGraphSpotLightData`\ \* **pData**\ , :c:type:`~A3DGraphSpotLight`\ \*\* **ppLight**\ )
   
   Creates a new spotlight source entity, returning its handle.
   
   
      2.0
   
   
   Once created, the new light entity can be referenced to by its handle, given by ``*ppLight``\ . In case of failure, ``*ppLight``\ is unchanged.
   
   
      :c:struct:`~A3DGraphSpotLightData`
   
   
   
      :c:struct:`~A3DGraphAmbientLightData`
   
   
   
      :c:func:`~A3DGraphAmbientLightGet`
   
   
   
      :c:struct:`~A3DGraphDirectionalLightData`
   
   
   
      :c:struct:`~A3DGraphPointLightData`
   
   
   
      :c:struct:`~A3DGraphSceneDisplayParametersData`
   
   
   **Parameters**
   
   
      **pData**\ : The data used for light creation.
   
      **ppLight**\ : An address to the new handle after creation.
   
   
   **Returns**
   
   
      ``A3D_SUCCESS``\ or an error code in case of failure.
   
   




