
#######################################
A3DCutWithMultiPlanarSectionOnModelFile
#######################################

.. c:function:: A3DStatus A3DCutWithMultiPlanarSectionOnModelFile(A3DAsmModelFile const *pModelFile, A3DMkpView const *pOptMrkRView, A3DMultiPlanarSectionData const *psSectionParametersData, A3DUns32 *pNumberOfRepItems, A3DRiRepresentationItem ***pppRIRepresentationItem, A3DRiRepresentationItem ***pppRIPlanarSections)

   .. rst-class:: sig-pretty-signature
   
      | :c:enum:`~A3DStatus` A3DCutWithMultiPlanarSectionOnModelFile(:c:type:`~A3DAsmModelFile`\ \* **pModelFile**\ , :c:type:`~A3DMkpView`\ \* **pOptMrkRView**\ , :c:struct:`~A3DMultiPlanarSectionData`\ \* **psSectionParametersData**\ , :c:type:`~A3DUns32`\ \* **pNumberOfRepItems**\ , :c:type:`~A3DRiRepresentationItem`\ \*\*\* **pppRIRepresentationItem**\ , :c:type:`~A3DRiRepresentationItem`\ \*\*\* **pppRIPlanarSections**\ )
   
   Function to compute the result of a section with several planes on a :c:type:`~A3DAsmModelFile`\ .
   
   
      8.2
   
   
   Call A3DCutWithMultiPlanarSectionOnModelFile(A3D_NULL_HANDLE, pOptMrkRView, psSectionParametersData, NULL, pNumberOfRepItems, pppRIRepresentationItem, pppRIPlanarSections) to release pppRIRepresentationItem and pppRIPlanarSections data
   
   If ``pOptMrkRView``\ is a cutting view, ``psSectionParametersData``\ can be set to ``0``\ . In this case, the cutting planes within ``pOptMrkRView``\ are used for the computation. Planes must to ordered and be set a profile, otherwise the function will return ``#A3D_TOOLS_INVALID_SECTION_PLANE``\ .
   
   **Parameters**
   
   
      **pModelFile**\ : Model file to section.
   
      **pOptMrkRView**\ : optional :c:type:`~A3DMkpView`\ (filter and/or move entities).
   
      **psSectionParametersData**\ : define the section to use (can be NULL if pOptMrkRView is a cutting view).
   
      **pNumberOfRepItems**\ : Number of :c:type:`~A3DRiRepresentationItem`\ in pppRIRepresentationItem and pppRIPlanarSections array.
   
      **pppRIRepresentationItem**\ : :c:type:`~A3DRiRepresentationItem`\ corresponding to the section results. Can be NULL if a :c:type:`~A3DRiRepresentationItem`\ if fully cutted by the section.
   
      **pppRIPlanarSections**\ : :c:type:`~A3DRiRepresentationItem`\ corresponding to planar section for each :c:type:`~A3DRiRepresentationItem`
   
   
   **Returns**
   
   
      ``A3D_SUCCESS``\ on success, or an error code on failure
   
   




