3dxmlw.hpp

Go to the documentation of this file.

#ifndef _3DXMLW_HPP_
#define _3DXMLW_HPP_
 
 
//! \brief Exported APIs for 3dxml (.3dxml) Write Library
namespace _3dxmlw 
{
     //! \class WriteParameters 
     //! \brief This class provides several parameters to tunes 3dxml Writter.\n
     //! It must be provided to addInstance3D method.
     //! \code
     //! //...
     //! \endcode
     class WriteParameters
     {
     protected:
          Dtk_Int32           _Blanked;
          Dtk_FontLineType    _CurveType;
          Dtk_RGB                  _Color;
          Dtk_Double64        _CurveThickness;
     public:
          //! \BaseConstructor
          WriteParameters() :_Blanked(0), _Color(Dtk_RGB()), _CurveType( DTK_NO_PATTERN ), _CurveThickness(0)
          {
          }
 
          //! \BaseDestructor
          ~WriteParameters()
          {
          }
 
          //! \brief Sets the blanked status for the written instance node.
          //! \param [in] inBlanked : blanked status.
          inline void SetBlankedStatus( const Dtk_Int32 inBlanked )
          {
               _Blanked = inBlanked;
          }
          //! \brief Retrieve the Written blanked status.
          inline Dtk_Int32 GetBlankedStatus() const
          {
               return _Blanked;
          }
          //! \brief Sets the color for the written instance node.
          //! \param [in] inColor : color.
          inline void SetColor( const Dtk_RGB & inColor )
          {
               _Color = inColor;
          }
          //! \brief Retrieve the Written color.
          inline Dtk_RGB GetColor() const
          {
               return _Color;
          }
          //! \brief Sets the curve type for the written instance node.
          //! \param [in] inCurvetype : curve type.
          inline void SetCurveType( Dtk_FontLineType inCurveType )
          {
               _CurveType = inCurveType;
          }
          //! \brief Retrieve the Written curve type.
          inline Dtk_FontLineType GetCurveType() const
          {
               return _CurveType;
          }
          //! \brief Sets the curve thickness for the written instance node.
          //! \param [in] inCurveThickness : curve thickness.
          inline void SetCurveThickness( Dtk_Double64 inCurveThickness )
          {
               _CurveThickness = inCurveThickness;
          }
          //! \brief Retrieve the Written curve thickness.
          inline Dtk_Double64 GetCurveThickness() const
          {
               return _CurveThickness;
          }
     };
 
    //! \class WriteOptions 
    //! \brief This class provides several options to tune 3dxml Writer.\n
    //! It must be provided to _3dxmlw::InitWrite method.
    //! \code
    //! //...
    //! Dtk_string LogFile = L"MyLogFile.log";
    //! _3dxmlw::WriteOptions 3DxmlOptions;
    //! Dtk_ErrorStatus err = _3dxmlw::InitWrite( LogFile, 3DxmlOptions);
    //! //...
    //! \endcode
    class WriteOptions
    {
    protected:
 
    public:
        //! \BaseConstructor
        WriteOptions() {}
 
        //! \BaseDestructor
        ~WriteOptions() {}
 
    };
 
    //! \brief Initialize the 3dxmlw Writer  
    //! \return dtkNoError if it is OK.
    //! \param [in] inOutputFile : Output file name
    //! \param [in] inLogFile : Log file
    //! \param [in] inOptions : Options
    //! \remark This function is the first call for the writer, it must me called after Dtk_API::StartAPI(...)
    DtkErrorStatus InitWrite(const Dtk_string& inOutputFile, const Dtk_string& inLogFile, WriteOptions& inOptions);
 
    //! \brief Creation of the output file and free the 3dxmlw Writer  
    //! \return dtkNoError if it is OK.
    //! \remark used as the last function used for the writer.
    DtkErrorStatus EndWrite();
 
    //! \brief Don't create a component already viewed. Is instantiate by an instance 
    //! \param [in] inCurrentChildId : Current child id
    //! \return DTK_TRUE if component already exist.
    //! \remark 
     Dtk_bool isAlreadyAddComponent(Dtk_ID inCurrentChildId);
 
    //! \brief Create Reference3D node
    //! \param [in] inName : Node Name
     //! \param [in] inComponentId : Component id
     //! \param [in] inMetadata : metadata
    //! \return 
    //! \remark  : add only V_description
     void addReference3D(const Dtk_string & inName, Dtk_ID inComponentId,Dtk_tab<Dtk_MetaDataPtr> & inMetadata);
 
    //! \brief Create ReferenceRep node
     //! \param [in] inMesh : Mesh Array
    //! \param [in] inName : Node Name
     //! \param [in] inComponentId : Component id
    //! \return 
    //! \remark
     void addReferenceRep(const Dtk_tab<Dtk_MeshPtr> & inMesh, const Dtk_string & inName, Dtk_Size_t inComponentId);
 
    //! \brief Create Instance3D node
     //! \param [in] inParentId : Parent id
     //! \param [in] inChildId : Child id
     //! \param [in] inMatrix : Instance matrix
    //! \param [in] inInstanceName : Instance Name
     //! \param [in] inMetadata : metadata
     //! \param [in] inParameters : parameters
    //! \return 
     //! \remark  : add only V_description
     void addInstance3D( Dtk_ID parentId,
                              Dtk_ID ref3dId,
                              const Dtk_transfo &matrix,
                              const Dtk_string &objectName,
                              Dtk_MetaDataPtr & inMetadata,
                              const WriteParameters & inParameters = WriteParameters() );
}
 
#endif