
#######################################
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
   
   




