
######################
A3DRWParamsGeneralData
######################

.. c:struct:: A3DRWParamsGeneralData

   Reading options to filter the types of information that are read when CAD files are loaded.
   
   While the options below are common among all CAD formats, some of them may be irrelevant to a specific format.
   
   All the ``m_bRead*``\ fields are boolean options defaulted to ``A3D_FALSE``\ , which means the related entity is skipped upon reading.
   
   
      `Loading a model <https://docs.techsoft3d.com/exchange/latest/guide/basic_operations/load_model.html>`__
   
   
   
      `PRC basics <https://docs.techsoft3d.com/exchange/latest/guide/basic_operations/prc_basics.html>`__
   
   
   
      `Reading views and PMIs <https://docs.techsoft3d.com/exchange/latest/guide/markup.html>`__
   
   
   
      `Traversing feature trees <https://docs.techsoft3d.com/exchange/latest/guide/feature_trees.html>`__
   
   
   
   Index
   =====
   
   .. rubric:: Variables
   
   
   .. rst-class:: api-xref-list
   
   
   * :c:member:`~A3DRWParamsGeneralData.m_bReadSolids`
   * :c:member:`~A3DRWParamsGeneralData.m_bReadSurfaces`
   * :c:member:`~A3DRWParamsGeneralData.m_bReadWireframes`
   * :c:member:`~A3DRWParamsGeneralData.m_bReadPmis`
   * :c:member:`~A3DRWParamsGeneralData.m_bReadAttributes`
   * :c:member:`~A3DRWParamsGeneralData.m_bReadHiddenObjects`
   * :c:member:`~A3DRWParamsGeneralData.m_bReadConstructionAndReferences`
   * :c:member:`~A3DRWParamsGeneralData.m_bReadActiveFilter`
   * :c:member:`~A3DRWParamsGeneralData.m_eReadingMode2D3D`
   * :c:member:`~A3DRWParamsGeneralData.m_eReadGeomTessMode`
   * :c:member:`~A3DRWParamsGeneralData.m_eDefaultUnit`
   * :c:member:`~A3DRWParamsGeneralData.m_bReadFeature`
   * :c:member:`~A3DRWParamsGeneralData.m_bReadConstraints`
   * :c:member:`~A3DRWParamsGeneralData.m_uiSearchTextureDirectoriesSize`
   * :c:member:`~A3DRWParamsGeneralData.m_ppcSearchTextureDirectories`
   * :c:member:`~A3DRWParamsGeneralData.m_uiSearchMaterialLibraryFilesSize`
   * :c:member:`~A3DRWParamsGeneralData.m_ppcSearchMaterialLibraryFiles`
   * :c:member:`~A3DRWParamsGeneralData.m_bTreatLongWireframeAsConstructionAndReferences`
   * :c:member:`~A3DRWParamsGeneralData.m_dLongWireframeThreshold`
   
   



.. rst-class:: kind-group kind-variable

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


.. c:member:: A3DBool A3DRWParamsGeneralData.m_bReadSolids

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Allows reading of solid parts.
      



.. c:member:: A3DBool A3DRWParamsGeneralData.m_bReadSurfaces

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Allows reading of surface entities.
      



.. c:member:: A3DBool A3DRWParamsGeneralData.m_bReadWireframes

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Allows reading of wireframe entities.
      



.. c:member:: A3DBool A3DRWParamsGeneralData.m_bReadPmis

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Allows reading of PMIs.
      



.. c:member:: A3DBool A3DRWParamsGeneralData.m_bReadAttributes

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Allows reading of non-geometric information linked to entities and files.
      
      Attributes linked to solids and entities, such as material and density, are always read, even if ``m_bReadAttributes``\ is ``A3D_FALSE``\ .
      



.. c:member:: A3DBool A3DRWParamsGeneralData.m_bReadHiddenObjects

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Allows reading of representation items which are marked as hidden in the CAD file.
      
      Default is ``A3D_TRUE``\ . When set to ``A3D_FALSE``\ , representation items considered hidden in the CAD file won't be kept in the resulting PRC. This can be useful when the objective is to observe the visible appearance of the resulting PRC. This option only impacts representation items. Reading of assembly-level entities (parts and product occurrences) is not affected, whether the CAD file identifies them as hidden or not.
      
      
         Setting ``m_bReadHiddenObjects``\ to ``A3D_FALSE``\ when reading PMIs, Views or complex assemblies may lead to unexpected behavior due to the potential for removal of bodies referenced by residual PMI or Views.
      
      



.. c:member:: A3DBool A3DRWParamsGeneralData.m_bReadConstructionAndReferences

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Allows reading of construction entities, such as planes and axes.
      



.. c:member:: A3DBool A3DRWParamsGeneralData.m_bReadActiveFilter

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Allows reading of only data stored in the active filter or on layers corresponding to the active filter.
      



.. c:member:: A3DEReadingMode2D3D A3DRWParamsGeneralData.m_eReadingMode2D3D

      .. rst-class:: sig-pretty-signature
      
         | :c:enum:`~A3DEReadingMode2D3D`
      
      If applicable, choose whether reading 2D drawing, 3D model or both.
      
      For IGES format, ``kA3DRead_Both``\ is not available and will default to ``kA3DRead_3D``\ .
      



.. c:member:: A3DEReadGeomTessMode A3DRWParamsGeneralData.m_eReadGeomTessMode

      .. rst-class:: sig-pretty-signature
      
         | :c:enum:`~A3DEReadGeomTessMode`
      
      Select between reading geometry, tessellation or both.
      



.. c:member:: A3DEUnits A3DRWParamsGeneralData.m_eDefaultUnit

      .. rst-class:: sig-pretty-signature
      
         | :c:enum:`~A3DEUnits`
      
      DefaultUnit option restricted to those formats where unit never exists or is unreliable (U3D, CGR, STL, VRML)
      
      
      - If it is different than :c:enumerator:`~kA3DUnitUnknown`\ , the default unit used is the one defined with this enum
      - If it is set to :c:enumerator:`~kA3DUnitUnknown`\ , the default unit is considered unknown and the value is 1.0.
      



.. c:member:: A3DBool A3DRWParamsGeneralData.m_bReadFeature

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Allows reading of model feature tree.
      



.. c:member:: A3DBool A3DRWParamsGeneralData.m_bReadConstraints

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Allows reading of assembly constraints.
      



.. c:member:: A3DUns32 A3DRWParamsGeneralData.m_uiSearchTextureDirectoriesSize

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DUns32`
      
      The size of :c:member:`m_ppcSearchTextureDirectories <A3DRWParamsGeneralData.m_ppcSearchTextureDirectories>`\ array.
      



.. c:member:: A3DUTF8Char** A3DRWParamsGeneralData.m_ppcSearchTextureDirectories

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DUTF8Char`\ \*\*
      
      Additional search directories for texture files.
      



.. c:member:: A3DUns32 A3DRWParamsGeneralData.m_uiSearchMaterialLibraryFilesSize

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DUns32`
      
      The size of :c:member:`m_ppcSearchMaterialLibraryFiles <A3DRWParamsGeneralData.m_ppcSearchMaterialLibraryFiles>`\ array.
      



.. c:member:: A3DUTF8Char** A3DRWParamsGeneralData.m_ppcSearchMaterialLibraryFiles

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DUTF8Char`\ \*\*
      
      Additional material library files.
      



.. c:member:: A3DBool A3DRWParamsGeneralData.m_bTreatLongWireframeAsConstructionAndReferences

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DBool`
      
      Remove long wireframe when :c:member:`m_bReadConstructionAndReferences <A3DRWParamsGeneralData.m_bReadConstructionAndReferences>`\ is set to ``A3D_FALSE``\ .
      
      Threshold value to determine long wireframe is set via :c:member:`m_dLongWireframeThreshold <A3DRWParamsGeneralData.m_dLongWireframeThreshold>`\ . This option applies when :c:member:`m_bReadWireframes <A3DRWParamsGeneralData.m_bReadWireframes>`\ is set to ``A3D_TRUE``\ . When :c:member:`m_bReadWireframes <A3DRWParamsGeneralData.m_bReadWireframes>`\ is set to ``A3D_FALSE``\ , all wireframes are removed, no matter the value of m_dLongWireframeThreshold.
      



.. c:member:: A3DDouble A3DRWParamsGeneralData.m_dLongWireframeThreshold

      .. rst-class:: sig-pretty-signature
      
         | :c:type:`~A3DDouble`
      
      Defines the threshold for long wireframe.
      
      Any wireframe with a bounding box longer than this value will be removed if :c:member:`m_bTreatLongWireframeAsConstructionAndReferences <A3DRWParamsGeneralData.m_bTreatLongWireframeAsConstructionAndReferences>`\ is ``A3D_TRUE``\ , and m_bReadConstructionAndReferences is ``A3D_FALSE``\ . Default is 24690.0.
      




