/////////////////////////////////////////////////////////////////////////////// 
// Copyright (C) 2002-2025, Open Design Alliance (the "Alliance"). 
// All rights reserved. 
// 
// This software and its documentation and related materials are owned by 
// the Alliance. The software may only be incorporated into application 
// programs owned by members of the Alliance, subject to a signed 
// Membership Agreement and Supplemental Software License Agreement with the
// Alliance. The structure and organization of this software are the valuable  
// trade secrets of the Alliance and its suppliers. The software is also 
// protected by copyright law and international treaty provisions. Application  
// programs incorporating this software must include the following statement 
// with their copyright notices:
//   
//   This application incorporates Open Design Alliance software pursuant to a license 
//   agreement with Open Design Alliance.
//   Open Design Alliance Copyright (C) 2002-2025 by Open Design Alliance. 
//   All rights reserved.
//
// By use of this software, its documentation or related materials, you 
// acknowledge and accept the above terms.
///////////////////////////////////////////////////////////////////////////////




#ifndef _ODDBDATABASE_INCLUDED_
#define _ODDBDATABASE_INCLUDED_

#include "TD_PackPush.h"

#include "RxObject.h"
#include "DbObjectId.h"
#include "RxObjectImpl.h"
#include "OdString.h"
#include "DbDate.h"
#include "OdCodePage.h"
#include "OdToolKit.h"
#include "DbObject.h"
#include "CmColor.h"
#include "DbSecurity.h"
#include "DbSystemServices.h"
#include "ViewportDefs.h"
#include "DbAnnotationScale.h"
#include "DbDataLink.h"

#include "OdDbAppInfoRecordSet.h"

class OdDbObject;

class OdDbSymbolTable;
class OdDbBlockTable;
class OdDbTextStyleTable;
class OdDbLinetypeTable;
class OdDbLayerTable;
class OdDbViewTable;
class OdDbUCSTable;
class OdDbUCSTable;
class OdDbViewportTable;
class OdDbRegAppTable;
class OdDbDimStyleTable;
class OdDbDimStyleTableRecord;
class OdDbBlockTableRecord;
class OdDbTextStyleTableRecord;
class OdDbRegAppTableRecord;
class OdDbLinetypeTableRecord;
class OdDbHostAppServices;
class OdDbLayout;
class OdDbLayoutManagerReactor;
class OdGsView;
class OdGsDevice;
class OdGsDCRect;

class OdDbDictionary;
class OdDbDictionaryWithDefault;
class OdDbFiler;
class OdDbIdMapping;
class OdDbDatabaseReactor;
class OdDbSpatialFilter;
class OdDbLayerFilter;
class OdDbAuditInfo;
class OdDbUndoController;
class OdDbTransactionReactor;
class OdDbEntity;

class OdGePoint2d;
class OdGePoint3d;
class OdGeMatrix3d;
class OdGeVector3d;
class OdDbDwgFiler;

class OdGsModel;

class OdStreamBuf;
class OdThumbnailImage;

class OdDbDatabaseImpl;
class OdResBuf;
class OdDbUnitsFormatter;
class OdDbLayerStateManager;
class OdDbObjectIdGraph;
class OdDbHistoryManager;

/** \details
  This template class is a specialization of the OdSmartPtr class for OdResBuf object pointers.
*/
typedef OdSmartPtr<OdResBuf> OdResBufPtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbDictionary object pointers.
*/
typedef OdSmartPtr<OdDbDictionary> OdDbDictionaryPtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbDictionaryWithDefault object pointers.
*/
typedef OdSmartPtr<OdDbDictionaryWithDefault> OdDbDictionaryWithDefaultPtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbSymbolTable object pointers.
*/
typedef OdSmartPtr<OdDbSymbolTable> OdDbSymbolTablePtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbBlockTable object pointers.
*/
typedef OdSmartPtr<OdDbBlockTable> OdDbBlockTablePtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbLayerTable object pointers.
*/
typedef OdSmartPtr<OdDbLayerTable> OdDbLayerTablePtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbTextStyleTable object pointers.
*/
typedef OdSmartPtr<OdDbTextStyleTable> OdDbTextStyleTablePtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbViewTable object pointers.
*/
typedef OdSmartPtr<OdDbViewTable> OdDbViewTablePtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbUCSTable object pointers.
*/
typedef OdSmartPtr<OdDbUCSTable> OdDbUCSTablePtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbViewportTable object pointers.
*/
typedef OdSmartPtr<OdDbViewportTable> OdDbViewportTablePtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbRegAppTable object pointers.
*/
typedef OdSmartPtr<OdDbRegAppTable> OdDbRegAppTablePtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbDimStyleTable object pointers.
*/
typedef OdSmartPtr<OdDbDimStyleTable> OdDbDimStyleTablePtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbLinetypeTable object pointers.
*/
typedef OdSmartPtr<OdDbLinetypeTable> OdDbLinetypeTablePtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbBlockTableRecord object pointers.
*/
typedef OdSmartPtr<OdDbBlockTableRecord> OdDbBlockTableRecordPtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbDimStyleTableRecord object pointers.
*/
typedef OdSmartPtr<OdDbDimStyleTableRecord> OdDbDimStyleTableRecordPtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbTextStyleTableRecord object pointers.
*/
typedef OdSmartPtr<OdDbTextStyleTableRecord> OdDbTextStyleTableRecordPtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbRegAppTableRecord object pointers.
*/
typedef OdSmartPtr<OdDbRegAppTableRecord> OdDbRegAppTableRecordPtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbDimStyleTableRecord object pointers.
*/
typedef OdSmartPtr<OdDbDimStyleTableRecord> OdDbDimStyleTableRecordPtr;
/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbLinetypeTableRecord object pointers.
*/
typedef OdSmartPtr<OdDbLinetypeTableRecord> OdDbLinetypeTableRecordPtr;

class OdSecurityParams;

/** \details
  This template class is a specialization of the OdSmartPtr class for OdSecurityParams object pointers.
*/
typedef OdSmartPtr<OdSecurityParams> OdSecurityParamsPtr;

class OdFileDependencyManager;

/** \details
  This template class is a specialization of the OdSmartPtr class for OdFileDependencyManager object pointers.
*/
typedef OdSmartPtr<OdFileDependencyManager> OdFileDependencyManagerPtr;

class OdDbObjectContextManager;

/** \details
This template class is a specialization of the OdSmartPtr class for OdDbObjectContextManager object pointers.
*/
typedef OdSmartPtr<OdDbObjectContextManager> OdDbObjectContextManagerPtr;

/** \details
  This template class is a specialization of the OdSmartPtr class for OdDbDatabase object pointers.
*/
typedef OdSmartPtr<OdDbDatabase> OdDbDatabasePtr;

/** \details
    The namespace contains common enumration declarations used for drawing database options.
    <group TD_Namespaces>
*/
namespace OdDb
{

  /** \details
	Describes possible types of an endcap.
  !When changing the enum is necessary to change value tags definitions in DbValueTypes.cpp
  */
  enum EndCaps
  {
    kEndCapNone       =  0, //!< No endcap.
    kEndCapRound      =  1, //!< Rounded endcap.
    kEndCapAngle      =  2, //!< Angled endcap.
    kEndCapSquare     =  3  //!< Squared endcap.
  };

  /** \details
  Describes possible values of the lineweight endcaps for new entities.
  !When changing the enum is necessary to change value tags definitions in DbValueTypes.cpp
  */
  enum JoinStyle
  {
    kJnStylNone       =  0, //!< No style.
    kJnStylRound      =  1, //!< Round.
    kJnStylAngle      =  2, //!< Angle.
    kJnStylFlat       =  3  //!< Flat.
  };

  /** \details
    Describes how duplicates of a linetype should be processed.
  */
  enum DuplicateLinetypeLoading
  {
    kDltNotApplicable = 0, //!< Not Applicable.
    kDltIgnore        = 1, //!< Ignore duplicate Linetypes.
    kDltReplace       = 2  //!< Replace duplicate Linetypes.
  };

  /** \details
    Represents the old vesrion of Microsoft(R) timezone index reordering.
    \remarks
    For additional information about timezone index, please see http://support.microsoft.com/kb/973627.
  */
  enum TimeZone
  {
    kInternationalDateLine      = -12000,   //!< (GMT-12:00) International Date Line West
    kMidwayIsland               = -11000,   //!< (GMT-11:00) Midway Island, Samoa
    kHawaii                     = -10000,   //!< (GMT-10:00) Hawaii
    kAlaska                     = -9000,    //!< (GMT-09:00) Alaska
    kPacific                    = -8000,    //!< (GMT-08:00) Pacific Time (US & Canada); Tijuana
    kMountain                   = -7000,    //!< (GMT-07:00) Mountain Time (US & Canada)
    kArizona                    = -7001,    //!< (GMT-07:00) Arizona
    kMazatlan                   = -7002,    //!< (GMT-07:00) Chihuahua, La Paz, Mazatlan
    kCentral                    = -6000,    //!< (GMT-06:00) Central Time (US & Canada)
    kCentralAmerica             = -6001,    //!< (GMT-06:00) Central America
    kMexicoCity                 = -6002,    //!< (GMT-06:00) Guadalajara, Mexico City, Monterrey
    kSaskatchewan               = -6003,    //!< (GMT-06:00) Saskatchewan
    kEastern                    = -5000,    //!< (GMT-05:00) Eastern Time (US & Canada)
    kIndiana                    = -5001,    //!< (GMT-05:00) Indiana (East)
    kBogota                     = -5002,    //!< (GMT-05:00) Bogota, Lima, Quito
    kAtlanticCanada             = -4000,    //!< (GMT-04:00) Atlantic Time (Canada)
    kCaracas                    = -4001,    //!< (GMT-04:00) Caracas, La Paz
    kSantiago                   = -4002,    //!< (GMT-04:00) Santiago
    kNewfoundland               = -3300,    //!< (GMT-03:30) Newfoundland and Labrador
    kBrasilia                   = -3000,    //!< (GMT-03:00) Brasilia
    kBuenosAires                = -3001,    //!< (GMT-03:00) Buenos Aires, Georgetown
    kGreenland                  = -3002,    //!< (GMT-03:00) Greenland
    kMidAtlantic                = -2000,    //!< (GMT-02:00) Mid-Atlantic
    kAzores                     = -1000,    //!< (GMT-01:00) Azores
    kCapeVerde                  = -1001,    //!< (GMT-01:00) Cape Verde Islands
    kUTC                        =     0,    //!< (UTC) Universal Coordinated Time
    kGMT                        =     1,    //!< (GMT) Greenwich Mean Time: Dublin, Edinburgh, Lisbon, London
    kMonrovia                   =     2,    //!< (GMT) Casablanca, Monrovia
    kBerlin                     =  1000,    //!< (GMT+01:00) Amsterdam, Berlin, Bern, Rome, Stockholm, Vienna
    kParis                      =  1001,    //!< (GMT+01:00) Brussels, Copenhagen, Madrid, Paris
    kPrague                     =  1002,    //!< (GMT+01:00) Belgrade, Bratislava, Budapest, Ljubljana, Prague
    kSarajevo                   =  1003,    //!< (GMT+01:00) Sarajevo, Skopje, Warsaw, Zagreb
    kWestCentralAfrica          =  1004,    //!< (GMT+01:00) West Central Africa
    kAthens                     =  2000,    //!< (GMT+02:00) Athens, Beirut, Istanbul, Minsk
    kEasternEurope              =  2001,    //!< (GMT+02:00) Bucharest
    kCairo                      =  2002,    //!< (GMT+02:00) Cairo
    kHarare                     =  2003,    //!< (GMT+02:00) Harare, Pretoria
    kHelsinki                   =  2004,    //!< (GMT+02:00) Helsinki, Kyiv, Riga, Sofia, Tallinn, Vilnius
    kJerusalem                  =  2005,    //!< (GMT+02:00) Jerusalem
    kMoscow                     =  3000,    //!< (GMT+03:00) Moscow, St. Petersburg, Volgograd
    kRiyadh                     =  3001,    //!< (GMT+03:00) Kuwait, Riyadh
    kBaghdad                    =  3002,    //!< (GMT+03:00) Baghdad
    kEastAfrica                 =  3003,    //!< (GMT+03:00) Nairobi
    kTehran                     =  3300,    //!< (GMT+03:30) Tehran
    kAbuDhabi                   =  4000,    //!< (GMT+04:00) Abu Dhabi, Muscat
    kCaucasus                   =  4001,    //!< (GMT+04:00) Baku, Tbilisi, Yerevan
    kKabul                      =  4300,    //!< (GMT+04:30) Kabul
    kEkaterinburg               =  5000,    //!< (GMT+05:00) Ekaterinburg
    kIslamabad                  =  5001,    //!< (GMT+05:00) Islamabad, Karachi, Tashkent
    kKolkata                    =  5300,    //!< (GMT+05:30) Chennai, Kolkata, Mumbai, New Delhi
    kKathmandu                  =  5450,    //!< (GMT+05:45) Kathmandu
    kAlmaty                     =  6000,    //!< (GMT+06:00) Almaty, Novosibirsk
    kDhaka                      =  6001,    //!< (GMT+06:00) Astana, Dhaka
    kSriLanka                   =  6002,    //!< (GMT+06:00) Sri Jayawardenepura
    kRangoon                    =  6300,    //!< (GMT+06:30) Rangoon
    kBangkok                    =  7000,    //!< (GMT+07:00) Bangkok, Hanoi, Jakarta
    kKrasnoyarsk                =  7001,    //!< (GMT+07:00) Krasnoyarsk
    kBeijing                    =  8000,    //!< (GMT+08:00) Beijing, Chongqing, Hong Kong, Urumqi
    kSingapore                  =  8001,    //!< (GMT+08:00) Kuala Lumpur, Singapore
    kTaipei                     =  8002,    //!< (GMT+08:00) Taipei
    kIrkutsk                    =  8003,    //!< (GMT+08:00) Irkutsk, Ulaan Bataar
    kPerth                      =  8004,    //!< (GMT+08:00) Perth
    kTokyo                      =  9000,    //!< (GMT+09:00) Osaka, Sapporo, Tokyo
    kSeoul                      =  9001,    //!< (GMT+09:00) Seoul
    kYakutsk                    =  9002,    //!< (GMT+09:00) Yakutsk
    kAdelaide                   =  9300,    //!< (GMT+09:30) Adelaide
    kDarwin                     =  9301,    //!< (GMT+09:30) Darwin
    kSydney                     = 10000,    //!< (GMT+10:00) Canberra, Melbourne, Sydney
    kGuam                       = 10001,    //!< (GMT+10:00) Guam, Port Moresby
    kBrisbane                   = 10002,    //!< (GMT+10:00) Brisbane
    kHobart                     = 10003,    //!< (GMT+10:00) Hobart
    kVladivostock               = 10004,    //!< (GMT+10:00) Vladivostok
    kMagadan                    = 11000,    //!< (GMT+11:00) Magadan, Solomon Is., New Caledonia
    kWellington                 = 12000,    //!< (GMT+12:00) Auckland, Wellington
    kFiji                       = 12001,    //!< (GMT+12:00) Fiji, Kamchatka, Marshall Is.
    kTonga                      = 13000     //!< (GMT+13:00) Nuku'alofa
  };

  /** \details
    Specifies settings that affect the shape of the lofted solid or surface.
  */
  enum LoftParamType   
  {
    kLoftNoParam           = 0x00, //!< No loft parameters.
    kLoftNoTwist           = 0x01, //!< No twisted lofting.
    kLoftAlignDirection    = 0x02, //!< Lofting alining in a specified direction.
    kLoftSimplify          = 0x04, //!< Simplifyed lofting.
    kLoftClose             = 0x08, //!< Closed lofting.
    kLoftPeriodic          = 0x10, //!< Periodic lofting.
    kLoftDefault           = kLoftNoTwist | kLoftAlignDirection | kLoftSimplify //!< Default lofting settings.
  };

  /** \details
    Specifies the normals of the lofted object where it passes through cross section curves.
    // !When changing the enum is necessary to change value tags definitions in DbValueTypes.cpp
  */
  enum LoftNormalsType  
  {
    kLoftRuled            = 0, //!< Body or surface of the lofted object are specified with lines between cross section curves.
    kLoftSmooth           = 1, //!< Body or surface of the lofted object are specified with smooth lines between cross section curves.
    kLoftFirstNormal      = 2, //!< Normal of the lofted object surface is the normal to the first cross section curve as well.
    kLoftLastNormal       = 3, //!< Normal of the lofted object surface is the normal to the last cross section curve as well.
    kLoftEndsNormal       = 4, //!< Normal of the lofted object surface is also the normal to both first and last cross section curves.
    kLoftAllNormal        = 5, //!< Normal of the lofted object surface is also the normal to all cross section curves.
    kLoftUseDraftAngles   = 6  //!< Body or surface of the lofted object are specified with angle and cone constraints of the first and last cross section curves.
  };

    /** \details
      Specifies how the entity interacts with collision detection.
    */
    enum CollisionType     
    {
      kCollisionTypeNone  = 0, //!< The entity is not involved in collision detection.
      kCollisionTypeSolid = 1  //!< The entity is involved in collision detection and acts as a solid object in it.
    };

  /** \details 
    Determines how proxy images should be shown.
  */
  enum ProxyImage
  {
    kProxyNotShow	    = 0, //!< Proxy images are not shown.
    kProxyShow	      	= 1, //!< Proxy images are shown.
    kProxyBoundingBox	= 2  //!< Proxy images are shown as a bounding box.
  };

  /** \details 
	Represents the fillet trimming mode.
  */
  enum FilletTrimMode   
  { 
    kTrimNone      = 0, //!< No fillet is trimmed.
    kTrimFirst     = 1, //!< The first fillet is trimmed.
    kTrimSecond    = 2, //!< The second fillet is trimmed.
    kTrimBoth      = 3  //!< Both fillets are trimmed.
  };

  /** \details
    Determines what file encoding algorithm is used for functions that write data to a text file.
  */
  enum TextFileEncoding
  {
    kTextFileEncodingDefault = 0,   //!< Chooses the current system encoding automatically.
    kTextFileEncodingANSI = 1,      //!< Forces ANSI character set encoding text writing.
    kTextFileEncodingUTF8 = 11,     //!< Uses UTF8 encoding for file writing.
    kTextFileEncodingUTF16 = 21,    //!< Chooses UTF16 endian automatically.
    kTextFileEncodingUTF16LE = 22,  //!< UTF16 LittleEndian.
    kTextFileEncodingUTF16BE = 23,  //!< UTF16 BigEndian.
    kTextFileEncodingUTF32 = 31,    //!< Chooses UTF32 endian automatically.
    kTextFileEncodingUTF32LE = 32,  //!< UTF32 LittleEndian.
    kTextFileEncodingUTF32BE = 33   //!< UTF32 BigEndian.
  };

  /** \details 
    Represents the system layer types.
  */
  enum LayerAdskType
  {
    kLayerSystemLights = 0, //!< System lights layer type.
    kLayerConstraints  = 1  //!< System constraints layer type.
  };

  enum IndexingModeFlags {
    kNoIndexing             = 0,
    kUpdateBlockIndexOnSave = 1,
    kUseBlockChangeIterator = 2,  // partial index update
    kUseAll                 = kUpdateBlockIndexOnSave | kUseBlockChangeIterator
  };

  /** \details
  Specifies behavior of the vertical application.
  */
  enum VerticalApplicationMode
  {
    /** Disables creating of default objects in every drawing. */
    kEnabler = 0,
    /** Enables creating of default objects in every drawing. */
    kEditor = 1
  };

  /** \details
  Represents the vertical application types.
  */
  enum VerticalApplicationType
  {
    /** ODA Architecture. */
    kArchitecture = 0x01,
    /** ODA Civil. */
    kCivil        = 0x02,
    /** ODA Mechanical. */
    kMechanical   = 0x04
  };
}

/** \details
    This class represents a complete drawing file.

    
    <group OdDb_Classes>
*/
class TOOLKIT_EXPORT OdDbDatabase : public OdDbObject
{
protected:

  OdDbDatabase();

public:

  /** \details 
    Returns the GUID of the database class. 
  */
  OdResult subGetClassID(
    void* pClsid) const;

  ODRX_DECLARE_MEMBERS(OdDbDatabase);

  virtual void addRef() override;

  virtual void release() ODRX_NOEXCEPT override;

  /** \details
    Returns the OdDbHostAppServices object associated with this database object.
  */
  OdDbHostAppServices* appServices() const;

  /** \details
    Adds the default set of objects and settings to this database object.

    \remarks
    This includes the ModelSpace and PaperSpace blocks, default table entries, system variable settings, etc.

    \remarks
    Measurement must be one the following:

    <table>
    Name              Value
    OdDb::kEnglish    0
    OdDb::kMetric     1
    </table>

    \param measurement [in]  Units of measurement.
  */
  void initialize(
    OdDb::MeasurementValue measurement = OdDb::kEnglish);

  /** \details 
    Destroys a database instance. 
  */
  virtual ~OdDbDatabase();

  /** \details
    Adds an object to this database object, and returns its Object ID.

    \param pObject  [in]  Pointer to the object.
    \param ownerId  [in]  Object ID of the owner of pObject.
    \param handle   [in]  Handle for pObject.

    \remarks
    A unique handle will be generated if a handle is not supplied or is 0.

  */
  OdDbObjectId addOdDbObject(
    OdDbObject* pObject,
    OdDbObjectId ownerId = OdDbObjectId::kNull,
    OdDbHandle handle = 0);

  /** \details
    Adds the specified name to the APPID table of this database object.

    \param regAppName [in]  Application name.

    \remarks
    True if and only if the specified name had not been, and is now, in the APPID table.
  */
  bool newRegApp(
    const OdString& regAppName);

  /** \details
    Returns the object ID of the BlockTable of this database object.
  */
  OdDbObjectId getBlockTableId() const;

  /** \details
    Returns the object ID of the LayerTable of this database object.
  */
  OdDbObjectId getLayerTableId() const;

  /** \details
    Returns the object ID of the TextStyleTable of this database object.
  */
  OdDbObjectId getTextStyleTableId() const;

  /** \details
    Returns the object ID of the LinetypeTable of this database object.
  */
  OdDbObjectId getLinetypeTableId() const;

  /** \details
    Returns the object ID of the ViewTable of this database object.
  */
  OdDbObjectId getViewTableId() const;

  /** \details
    Returns the object ID of the UCSTable of this database object.
  */
  OdDbObjectId getUCSTableId() const;

  /** \details
    Returns the object ID of the ViewportTable of this database object.
  */
  OdDbObjectId getViewportTableId() const;

  /** \details
    Returns the object ID of the RegAppTable of this database object.
  */
  OdDbObjectId getRegAppTableId() const;

  /** \details
    Returns the object ID of the DimStyleTable of this database object.
  */
  OdDbObjectId getDimStyleTableId() const;

  /** \details
    Returns the object ID of the MLineStyle dictionary of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getMLStyleDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the Group dictionary of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getGroupDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the Layout dictionary of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getLayoutDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the PlotStyleName dictionary of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getPlotStyleNameDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the NamedObjects dictionary of this database object.
  */
  OdDbObjectId getNamedObjectsDictionaryId() const;

  /** \details
    Returns the object ID of the PlotSettings dictionary of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getPlotSettingsDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the Color dictionary of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getColorDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the Material dictionary of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getMaterialDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the VisualStyle dictionary of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getVisualStyleDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the TableStyle dictionary of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getTableStyleDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the ScaleList dictionary of this database object.
    
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getScaleListDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the current TableStyle of this database object.
  */
  OdDbObjectId tablestyle() const;

  /** \details
    Sets the object ID of the current TableStyle of this database object.
    \param objectId [in]  Object ID.
  */
  void setTablestyle(
    OdDbObjectId objectId);

  /** \details
    Returns the object ID of the MLeaderStyle dictionary of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getMLeaderStyleDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the current MLeaderStyle of this database object.
  */
  OdDbObjectId mleaderstyle() const;

  /** \details
    Sets the object ID of the current MLeaderStyle of this database object.
    \param objectId [in]  Object ID.
  */
  void setMLeaderstyle(
    OdDbObjectId objectId);

  /** \details
    Returns the object ID of the DetailViewStyle dictionary of this database object.
    \param createIfNotFound [in]  Determines whether to create a DetailViewStyle dictionary if it does not exist.
  */
  OdDbObjectId getDetailViewStyleDictionaryId(
    bool createIfNotFound = true) const;
   
  /** \details
    Returns the object ID of the current DetailViewStyle of this database object.
  */
  OdDbObjectId detailViewStyle() const;

  /** \details
    Sets the object ID of the current DetailViewStyle of this database object.
    \param objectId [in]  Object ID.
  */
  void setDetailViewStyle(
    OdDbObjectId objectId);

  /** \details
    Returns the object ID of the SectionViewStyle dictionary of this database object.
    \param createIfNotFound [in]  Determines whether to create a SectionViewStyle dictionary if it does not exist.
  */
  OdDbObjectId getSectionViewStyleDictionaryId(
    bool createIfNotFound = true) const;

  /** \details
    Returns the object ID of the current SectionViewStyle of this database object.
  */
  OdDbObjectId sectionViewStyle() const;

  /** \details
    Sets the object ID of the current SectionViewStyle of this database object.
    \param objectId [in]  Object ID.
  */
  void setSectionViewStyle(
    OdDbObjectId objectId);

  /** \details
    Returns the object ID of the "ACAD" RegApp object of this database object.
  */
  OdDbObjectId getRegAppAcadId() const;

  /** \details
    Returns the object ID of the "Continuous" Linetype object of this database object.
  */
  OdDbObjectId getLinetypeContinuousId() const;

  /** \details
    Returns the object ID of the "ByLayer" Linetype object of this database object.
  */
  OdDbObjectId getLinetypeByLayerId() const;

  /** \details
    Returns the object ID of the "ByBlock" Linetype object of this database object.
  */
  OdDbObjectId getLinetypeByBlockId() const;

  /** \details
    Returns the object ID of the ModelSpace Block object of this database object.
  */
  OdDbObjectId getModelSpaceId() const;

  /** \details
    Returns the object ID of the PaperSpace Block object of this database object.
  */
  OdDbObjectId getPaperSpaceId() const;

  /** \details
    Returns the object ID of the "Standard" text style object of this database object.
  */
  OdDbObjectId getTextStyleStandardId() const;

  /** \details
    Returns the object ID of the "Standard" dimension style object of this database object.
  */
  OdDbObjectId getDimStyleStandardId() const;

  /** \details
    Returns the object ID of the "0" layer object of this database object.
  */
  OdDbObjectId getLayerZeroId() const;

  /** \details
    Returns the object ID of the "DEFPOINTS" layer object of this database object.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
  */
  OdDbObjectId getLayerDefpointsId(
    bool createIfNotFound = false) const;

  /** \details
    Returns the object ID of the specified system layer object of this database object.
    \param layerType [in]  Type of system layer.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.

    \remarks
    layerType must be one of the following:

    <table>
    Name                        Value       Layer name
    OdDb::kLayerSystemLights    0           *ADSK_SYSTEM_LIGHTS
    OdDb::kLayerConstraints     1           *ADSK_CONSTRAINTS
    </table>
  */
  OdDbObjectId getLayerAdskId(
    OdDb::LayerAdskType layerType,
    bool createIfNotFound = false) const;

  /** \details
    Returns the object ID of the section manager.

    \remarks
    The ID may be null if the database
    has never contained any section planes.
  */
  OdDbObjectId getSectionManager() const;

  /** \details
    Returns the object ID of the point cloud dictionary.

    \remarks
    The ID may be null if the database
    has never contained any point clouds.
  */
  OdDbObjectId getPointCloudDictionaryId() const;

  /** \details
    Returns the class DXF name for the specified class.

    \param pClass [in]  Pointer to the class object.

    \sa
	<exref target= "https://docs.opendesign.com/tkernel/OdRxClass.html">OdRxClass</exref>
  */
  const OdString classDxfName(
    const OdRxClass* pClass);

  /** \details
    Returns the object ID corresponding to the specified handle object in this database.

    \param objHandle        [in]  Database handle.
    \param createIfNotFound [in]  Controls the creation of the object if it does not exist.
    \param xRefId           [in]  Not used.

    \remarks
    If objHandle is 0, this function will create a new unique handle and return a
    newly created object ID corresponding to this handle.

    \remarks
    createIfNotFound is for internal use only and should always be false for client applications.

    \sa
    <link OdDbObjectId, OdDbObjectId class>
  */
  OdDbObjectId getOdDbObjectId(
    const OdDbHandle& objHandle,
    bool createIfNotFound = false,
    OdUInt32 xRefId = 0);

  /** \details
    Writes the contents of this database object to the specified StreamBuf object.

    \param pStreamBuf         [in]  Pointer to the StreamBuf object to which the data is to be written.
    \param fileType           [in]  File type.
    \param fileVersion        [in]  File version.
    \param saveThumbnailImage [in]  Controls the saving of a thumbnail image to the file.
    \param dxfPrecision       [in]  DXF file decimal digits precision. [0 .. 16].

    \remarks
    fileType must be one of the following:

    <table>
    Name          Value   Description
    OdDb::kDwg    0       .dwg file.
    OdDb::kDxf    1       .dxf file.
    OdDb::kDxb    2       Binary .dxf file.
    </table>

    Parameter fileVersion must be one of the following:

    <table>
    OdDb::kDwg?    Name          Value  Description
    n              OdDb::vAC09   11     Release 9
    n              OdDb::vAC10   13     Release 10
    y              OdDb::vAC12   16     Release 11-12
    y              OdDb::vAC13   19     Release 13
    y              OdDb::vAC14   21     Release 14
    y              OdDb::vAC15   23     2000-2002
    y              OdDb::vAC18   25     2004-2006
    y              OdDb::vAC21   27     2007-2009
    y              OdDb::vAC24   29     2010-2012
    y              OdDb::vAC27   31     2013-2016
    </table>

    Throws:
    OdError if the write is unsuccessful.
  */
  void writeFile(
    OdStreamBuf* pStreamBuf,
    OdDb::SaveType fileType,
    OdDb::DwgVersion fileVersion,
    bool saveThumbnailImage = false,
    int dxfPrecision = 16);


  /** \details
    Writes the contents of this database object to the specified output file.

    \param filename           [in] Name of the file to which the data is to be written.
    \param fileType           [in] File type.
    \param fileVersion        [in] File version.
    \param saveThumbnailImage [in] Controls the saving of a thumbnail image to the file.
    \param dxfPrecision       [in] DXF file decimal digits precision. [0 .. 16].

    \remarks
    Parameter fileType must be one of the following:

    <table>
    Name          Value   Description
    OdDb::kDwg    0       .dwg file.
    OdDb::kDxf    1       .dxf file.
    OdDb::kDxb    2       Binary .dxf file.
    </table>

    fileVersion must be one of the following:

    <table>
    OdDb::kDwg?    Name          Value  Description
    n              OdDb::vAC09   11     Release 9
    n              OdDb::vAC10   13     Release 10
    y              OdDb::vAC12   16     Release 11-12
    y              OdDb::vAC13   19     Release 13
    y              OdDb::vAC14   21     Release 14
    y              OdDb::vAC15   23     2000-2002
    y              OdDb::vAC18   25     2004-2006
    y              OdDb::vAC21   27     2007-2009
    y              OdDb::vAC24   29     2010-2012
    y              OdDb::vAC27   31     2013-2016
    </table>

    Throws:
    OdError if the write is unsuccessful.
  */
  void writeFile(
    const OdString& filename,
    OdDb::SaveType fileType,
    OdDb::DwgVersion fileVersion,
    bool saveThumbnailImage = false,
    int dxfPrecision = 16)
  {
    closeInput();
    OdStreamBufPtr pFile = odSystemServices()->createFile(filename, (Oda::FileAccessMode)(Oda::kFileRead | Oda::kFileWrite), 
      Oda::kShareDenyReadWrite, Oda::kCreateAlways);
    writeFile(pFile, fileType, fileVersion, saveThumbnailImage, dxfPrecision);
  }
  
  /** \details 
    Incrementally saves the database contents to the specified output stream buffer. 
    Database contents are saved as a .dwg file of the latest supported version.
    
    \param pStreamBuf         [in] Pointer to the StreamBuf object to which the data is to be written.
    \param saveThumbnailImage [in] Controls the saving of a thumbnail image to the file.

    \remarks
    Use writeFile for a full save.
  */
  void save(
    OdStreamBuf* pStreamBuf,
    bool saveThumbnailImage = false);

  /** \details 
    Incrementally saves the database contents to the specified output .dwg file.
    Output file has the latest supported version format. 
    Database contents are saved as a .dwg file of the latest supported version.
    
    \param filename         [in] Target file absolute path.
    \param saveThumbnailImage [in] Controls the saving of a thumbnail image to the file.

    \remarks
    Use writeFile for a full save.
  */
  void save(
    const OdString& filename,        
    bool saveThumbnailImage = false);
  
  /** \details
    Reads the contents of the specified StreamBuf object or file into this database object.

    \param pStreamBuf         [in]  Pointer to the StreamBuf object from which the data is to be read.
    \param partialLoad        [in]  Controls the partial loading of .dwg files.
    \param pAuditInfo         [in]  Pointer to an OdDbAuditInfo object.
    \param password           [in]  Password for file.
    \param allowCPConversion  [in]  If and only if true, allows code page conversion.

    \remarks
    Using this function in .tx code is not recommended.
    In .tx modules use OdDbHostAppServices::readFile() or OdDbHostAppServices::recoverFile() instead.
    This provides more control for host applications which can override these virtual methods.

    The specified OdDbAuditInfo object controls the audit and receives the audit status.

    If pAuditInfo is non-zero, a recover will be performed instead of a load.

    Throws:
    OdError if the read is unsuccessful.
  */
  void readFile(
    OdStreamBuf* pStreamBuf,
    bool partialLoad = false,
    OdDbAuditInfo *pAuditInfo = 0,
    const OdPassword& password = OdPassword(),
    bool allowCPConversion = false );

  /** \details 
    Reads the contents of the specified drawing file into this database object.
  
    \param filename   [in] Name of the file from which the data is to be read.
    \param shareMode  [in] Share mode to use when opening the specified file.

    \remarks
    shareMode must be one of the following:

    <table>
    Name                         Value       Description
    Oda::kShareDenyReadWrite     0x10        deny read/write mode
    Oda::kShareDenyWrite         0x20        deny write mode
    Oda::kShareDenyRead          0x30        deny read mode
    Oda::kShareDenyNo            0x40        deny none mode
    </table>

  */
  void readFile(
    const OdString& filename,
    bool partialLoad = false,
    Oda::FileShareMode shareMode = Oda::kShareDenyWrite,
    const OdPassword& password = OdPassword(),
    bool allowCPConversion = false )
  {
    readFile(odSystemServices()->createFile(filename, Oda::kFileRead, shareMode), partialLoad, 0, password, allowCPConversion);
  }

  //DOM-IGNORE-BEGIN
  /** \details
    Forces all data to be loaded from the input file associated with this database object, and closes the file.

    \remarks
    Client applications will normally not need to call this function.
  */
  void closeInput();
  //DOM-IGNORE-END

  /** \details
    Returns the approximate number of objects in this database object.

    \remarks
    This function returns a value greater than or equal to the number of objects
    in this database object.

    This number is used to construct an OdDbObjectIdArray that can hold all the objects in the database, avoiding
    memory fragmentation and increasing performance.
  */
  OdInt32 approxNumObjects() const;

  /** \details
    Returns the version of this database object.

    \param pMaintReleaseVer [in]  Pointer to the MaintReleaseVer object to receive the maintenance release version.
    
    \remarks
    The maintenance release version is returned if and only if pMaintReleaseVer != 0.
  */
  OdDb::DwgVersion version(
    OdDb::MaintReleaseVer* pMaintReleaseVer = 0) const;

  /** \details
    Returns the number of times this database object has been saved since it was opened.

    \remarks
    This number can be zero.
  */
  OdInt32 numberOfSaves() const;

  /** \details
    Returns the version to which this database object was last saved.

    \param pMaintReleaseVer [in]  Pointer to the MaintReleaseVer object to receive the maintenance release version.

    \remarks
    The maintenance release version is returned if and only if pMaintReleaseVer != 0.
  */
  OdDb::DwgVersion lastSavedAsVersion(
    OdDb::MaintReleaseVer* pMaintReleaseVer = 0) const;

  /** \details
    Returns the filetype of the file from which this database object was read.

    \remarks
    originalFileType() returns one of the following:

    <table>
    Name         Value   Description
    OdDb::kDwg    0       .dwg file.
    OdDb::kDxf    0       .dxf file.
    </table>
  */
  OdDb::SaveType originalFileType() const;

  /** \details
    Returns the version of the file from which this database object was read.

    \param pMaintReleaseVer [in]  Pointer to the MaintReleaseVer object to receive the maintenance release version.

    \remarks
    The maintenance release version is returned if and only if pMaintReleaseVer != 0.
  */
  OdDb::DwgVersion originalFileVersion(
    OdDb::MaintReleaseVer* pMaintReleaseVer = 0) const;

  /** \details
    Returns the version of the application that created the file from which this database object was read.

    \param pMaintReleaseVer [in]  Pointer to the MaintReleaseVer object to receive the maintenance release version.

    \remarks
    The maintenance release version is returned if and only if pMaintReleaseVer != 0.
  */
  OdDb::DwgVersion originalFileSavedByVersion(
    OdDb::MaintReleaseVer* pMaintReleaseVer = 0) const;

   /** \details
    Adds the specified reactor to this object's reactor list.

    \param pReactor [in]  Pointer to the reactor object.
   */
  void addReactor(
    OdDbDatabaseReactor* pReactor) const;

  /** \details
    Removes the specified reactor from this object's reactor list.

    \param pReactor [in]  Pointer to the reactor object.
  */
  void removeReactor(OdDbDatabaseReactor*
    pReactor) const;

  /** \details
    Returns the R14 DIMFIT system variable of this database object.

    \remarks
    The DIMATFIT and DIMTMOVE values will be converted to DIMFIT. The complete mapping is as follows:

    <table>
    DIMTMOVE    DIMAFIT   DIMFIT
    0           0         0
    0           1         1
    0           2         2
    0           3         3
    1           0         4
    1           1         4
    1           2         4
    1           3         4
    2           0         5
    2           1         5
    2           2         5
    2           3         5
    </table>
  */
  int dimfit() const;

  /** \details
    Returns the R14 DIMUNIT system variable of this database object.

    \remarks
    The DIMLUNIT and DIMFRAC values will be converted to DIMUNIT. The complete mapping is as follows:

    <table>
    DIMFRAC   DIMLUNIT  DIMUNIT
    0         1         1
    0         2         2
    0         3         3
    0         4         4
    0         5         5
    0         6         8
    1         1         1
    1         2         2
    1         3         3
    1         4         4
    1         5         5
    1         6         8
    2         1         1
    2         2         2
    2         3         3
    2         4         6
    2         5         7
    2         6         8
    </table>

    All other input combinations return 2.
  */
  int dimunit() const;

  /** \details
    Sets the R14 DIMFIT system variable of this database object.

    \param val [in]  New value for DIMFIT. [0..5]

    \remarks
    The DIMFIT value will be converted to DIMATFIT and DIMTMOVE values.
  */
  void setDimfit(
    int val);

  /** \details
    Sets the R14 DIMUNIT system variable of this database object.

    \param val [in]  New value for DIMUNIT. [1..7]

    \remarks
    The DIMUNIT value will be converted to DIMLUNIT and DIMFRAC values.
  */
  void setDimunit(
    int val);

  /** \details
    Deep clones a set of objects and appends the clones to the specified owner object.

    \param objectIds [in]  Array of object IDs of the objects to be cloned.
    \param ownerId [in]  Object ID of owner object.
    \param idMap [in/out] ID map.
    \param deferXlation [in] Defer translation.

    \remarks
    idMap associates the object IDs of the original objects with the object IDs of the newly created clones.

    When cloning objects with different owner IDs, a separate call to this function is required for each
    ownerId. In this case, all but the final call to this function should be made with deferXlation == true.
    This defers translation until all objects have been cloned.

    A deep clone is a clone of the specified objects and everything they own.
    This function is used to clone objects within a single database. To clone objects to a different database, use OdDbDatabase::wblockCloneObjects().

    \sa
    <link OdDbDatabase::wblockCloneObjects@OdDbObjectIdArray&@OdDbObjectId@OdDbIdMapping&@OdDb::DuplicateRecordCloning@bool, OdDbDatabase::wblockCloneObjects() method>

  */
  void deepCloneObjects(
    const OdDbObjectIdArray& objectIds,
    OdDbObjectId ownerId,
    OdDbIdMapping& idMap,
    bool deferXlation = false);


  /** \details
    Clones a set of objects from this database to another one (target database) and appends the clones to the specified owner object.

    \param objectIds    [in]  Array of object IDs of the objects to be cloned.
    \param ownerId      [in]  Object ID of the owner object (should belong to the target database).
    \param idMap        [in/out] ID map.
    \param deferXlation [in] Defer translation.

    \remarks
    idMap associates the object IDs of the original objects with the object IDs of the newly created clones.

    When cloning objects with different owner IDs, a separate call to this function is required for each
    ownerId. In this case, all but the final call to this function should be made with deferXlation == true.
    This defers translation until all objects have been cloned.

    This function is used to clone objects between databases. To clone within a single database, use OdDbDatabase::deepCloneObjects().

	duplicateRecordCloning must be one of the following:

    <table>
    Name                        Value   Description
    OdDb::kDrcNotApplicable     0       Not applicable to the object.
    OdDb::kDrcIgnore            1       If a duplicate record exists, use the existing record in the database and ignore the clone.
    OdDb::kDrcReplace           2       If a duplicate record exists, replace it with the cloned record.
    OdDb::kDrcXrefMangleName    3       Incoming record names are mangled with <Xref>$0$<name>.
    OdDb::kDrcMangleName        4       Incoming record names are mangled with $0$<name>.
    OdDb::kDrcUnmangleName      5       Unmangle the names mangled by OdDb::kDrcMangleName, then default to OdDb::kDrcIgnore. Typically used by RefEdit when checking records into the original database.
    </table>

    The sequence of reactors called by OdDbDatabase::wblockCloneObjects:
    - OdRxEventReactor::beginDeepClone()
    - OdRxEventReactor::beginWblockObjects()
    - OdRxEventReactor::beginDeepCloneXlation() (if deferXlation is false)
    - OdRxEventReactor::endDeepClone() (if deferXlation is false)
    - OdRxEventReactor::abortDeepClone() (if cloning failed/was aborted)

    \sa
    <link OdDbDatabase::deepCloneObjects@OdDbObjectIdArray&@OdDbObjectId@OdDbIdMapping&@bool OdDbDatabase::deepCloneObjects() method>

  */
  void wblockCloneObjects(
    const OdDbObjectIdArray& objectIds,
    OdDbObjectId ownerId,
    OdDbIdMapping& idMap,
    OdDb::DuplicateRecordCloning duplicateRecordCloning,
    bool deferXlation = false);

  /** \details
    Terminates a call to deepCloneObjects() or wblockCloneObjects().

    \param idMap [in/out] ID map of the function call to be terminated.

    \remarks
    Parameter idMap associates the object IDs of the original objects with the object IDs of the newly created clones.

    This call is necessary only when a call to deepCloneObjects() or wblockCloneObjects() is made with deferXlation == true,
    and no call will be made with deferXlation == false.
  */
  void abortDeepClone(
    OdDbIdMapping& idMap);

  /** \details
    Performs an audit operation on the header of this database object.

    \param pAuditInfo [in]  Pointer to an OdDbAuditInfo object.

    \remarks
    The specified OdDbAuditInfo object controls the audit and receives the audit status.
  */
  void audit(
    OdDbAuditInfo* pAuditInfo);

  /** \details
    Starts a new transaction of this database object.
  */
  virtual void startTransaction();

  /** \details
    Flush all the changes made during first transaction started on this database object.
    \remarks
    Forces all the objects modified in transaction to send reactor notifications
    and mark them to be in non-modified state. Does nothing if there is no active transaction.
    \returns true if transaction is active false otherwise.
  */
  virtual bool flushAllTransactedChanges();

  /** \details
    Ends the current transaction associated with this database object.

    \remarks
    This function commits all changes to objects since the start of the current transaction.
  */
  virtual void endTransaction();

  /** \details
    Aborts the current transaction associated with this database object.

    \remarks
    This function initiates an immediate rollback of all changes to objects
    since the start of the current transaction. This rollback occurs for
    all transaction-resident objects.
  */
  virtual void abortTransaction();

  /** \details
    Returns the number of active transactions associated with this database object.
  */
  virtual int numActiveTransactions();

  /** \details
    Adds a transaction reactor to this database object.

    \param reactor [in]  Transaction reactor.
  */
  virtual void addTransactionReactor(
    OdDbTransactionReactor* reactor);

  /** \details
    Removes the specified transaction reactor from this database object.

    \param reactor [in]  Transaction reactor.
  */
  virtual void removeTransactionReactor(
    OdDbTransactionReactor* reactor);


  /** \details
    Returns the thumbnail bitmap associated with this database object.

    \remarks
    The thumbnail is in Microsoft(R) Windows(R) BITMAPINFO* format.

    \param dataLength [out]  Receives the data length of the thumbnail.
  */
  const void* thumbnailBitmap(
    OdUInt32& dataLength) const;

  /** \details
    Sets the thumbnail bitmap associated with this database object.

    \remarks
    The thumbnail is in Windows BITMAPINFO* format.

    \param dataLength [in]  Data length of the thumbnail.
    \param pBMPData   [in]  Pointer to the bitmap data.
  */
  void setThumbnailBitmap(
    const void* pBMPData,
    OdUInt32 dataLength);

  /** \details
    Returns the state of the RetainOriginalThumbnailBitmap flag.
  */
  bool retainOriginalThumbnailBitmap() const;

  /** \details
    Controls the state of the RetainOriginalThumbnailBitmap flag.

    \param retain [in]  Retain if and only if true.
  */
  void setRetainOriginalThumbnailBitmap(
    bool retain);

  void dwgOutFields(
    OdDbDwgFiler* pFiler) const;

  OdResult dwgInFields(
    OdDbDwgFiler* pFiler);

//DOM-IGNORE-BEGIN
#define VAR_DEF(type, name, def_value, metric_def_value, reserve1, reserve2)\
    SVARS_FUNC_MODIFIER type get##name() const;

#include "SysVarDefs.h"

#undef VAR_DEF
#undef RO_VAR_DEF

#define RO_VAR_DEF(type, name, def_value, metric_def_value, reserve1, reserve2)
#define VAR_DEF(type, name, def_value, metric_def_value, reserve1, reserve2)\
    SVARS_FUNC_MODIFIER void set##name(type val);

#include "SysVarDefs.h"

#undef RO_VAR_DEF
#undef VAR_DEF

#define VAR_DEF(type, name, dxf, def_value, metric_def_value, reserve1, reserve2)\
    virtual type dim##name() const;\
    virtual void setDim##name(type val);

#include "DimVarDefs.h"

#undef VAR_DEF
//DOM-IGNORE-END

  /** \details
    Returns true if current dimension style is annotative.
  */
  bool getDIMANNO() const;

  /** \details
    Returns the TDCREATE system variable of this database object.
    
    \remarks
    TDUCREATE represents the time and date, in local time, that the database was created.
  */
  OdDbDate getTDCREATE() const;

  /** \details
    Returns the TDUPDATE system variable of this database object.
    
    \remarks
    TDUUPDATE represents the time and date, in local time, that the database was last saved.
  */
  OdDbDate getTDUPDATE() const;

  /** \details
    Returns the CGEOCS system variable of this database object.
    
    \remarks
    CGEOCS represents the name of the GIS coordinate system assigned to the drawing file.
  */
  OdString getCGEOCS() const;

  /** \details
    Resets TDCREATE, TDUPDATE, TDINDWG and TDUSRTIMER system variables to the settings of the new drawing.
    
    \remarks
    TDCREATE and TDUPDATE will be set to the current system time and date. TDINDWG and TDUSRTIMER will be set to zero.
  */
  void resetTimes();

  /** \details
    Returns the specified system variable of this database object.

    \param name [in]  Name of the system variable.

    \returns
    Returns a smart pointer to an OdResBuf object that contains the value.

    System variable names are case-insensitive strings.

    \sa
	<link TD_SysVars System Variables>
  */
  OdResBufPtr getSysVar(
    const OdString& name) const;

  /** \details
    Sets the specified system variable of this database object.

    \param name   [in]  Name of the system variable.
    \param pValue [in]  Pointer to an OdResBuf object that contains the new value.

    \remarks
    System variable names are case-insensitive strings.

    \sa
    <link TD_SysVars, System Variables>
  */
  void setSysVar(
    const OdString& name,
    const OdResBuf* pValue);

  /** \details
    Returns the next available handle number of this database object.
    
    \remarks
    Use OdDbHandle::getIntoAsciiBuffer() to return the hex string version of the handle.
  */
  OdDbHandle handseed() const;

  /** \details
    Copies the dimension variables of this database object to the
    specified DimStyleTableRecord.

    \param pDestination [in]  Pointer to the destination record.
  */
  void getDimstyleData(
    OdDbDimStyleTableRecord* pDestination) const;

  /** \details
    Returns the child dimension style data and dimension style object identifier.

    \param pDimClass  [in]  A pointer to a dimension class instance.
    \param pRec       [out] A pointer to an output dimension styles table record, which should contain child dimension style data after the method returns the control. 
    \param style      [out] Identifier of the output style object.
    
    \returns Returns eOk if style data has been retrieved successfully or an error code in the other case.

    \remarks
    The method returns parent style information and identifier if the child style can not be retrieved.
  */
  OdResult getDimstyleChildData(const OdRxClass *pDimClass,
                                OdDbDimStyleTableRecord* pRec,
                                OdDbObjectId &style) const;
  /** \details 
  
    Returns the identifier of the child dimension style. 
    
    \param pDimClass    [in] A pointer to a dimension class instance. 
    \param parentStyle  [in] A parent dimension style object identifier.
    
    \remarks 
    The method returns the parent dimension identifier if the child style can not be retrieved. 
  */
  OdDbObjectId getDimstyleChildId(const OdRxClass *pDimClass,
                                  const OdDbObjectId &parentStyle) const;

  /** \details 
    Returns the identifier of the parent dimension style.
    
    \param childStyle [in] A child dimension style object identifier.
    
    \remarks 
    The method returns the child dimension identifier if the parent style can not be retrieved. 
  */
  OdDbObjectId getDimstyleParentId(const OdDbObjectId &childStyle) const;


  /** \details
    Copies the dimension style data from the specified DimStyleTableRecord
    to the dimension variables of this database object.
    
    \param pSource [in] Pointer to the source record.
  */
  void setDimstyleData(
    const OdDbDimStyleTableRecord* pSource);

  /** \details
    Copies the dimension style data from the specified DimStyleTableRecord
    to the dimension variables of this database object.
    
    \param objectId [in]  Object ID of the source record.
  */
  void setDimstyleData(
    OdDbObjectId objectId);

  /** \details
    Loads a linetype into this database object.

    \param ltName   [in] Name of the linetype to load.
    \param filename [in] Name of the linetype file from which to load.
    \param encode   [in] Encoding used in linetype text file (if known).

    \remarks
    Wildcards are permitted in ltName; if "*" is specified, all linetypes from the filename will be loaded.

    dlt must be one of the following:

    <table>
    Name                      Value   Description
    OdDb::kDltNotApplicable     0       Not Applicable.
    OdDb::kDltIgnore            1       Ignore duplicate linetypes.
    OdDb::kDltReplace           2       Replace duplicate linetypes.
    </table>

    Throws:
    An appropriate error if not successful.
  */
  void loadLineTypeFile(
    const OdString& ltName,
    const OdString& filename,
    OdDb::DuplicateLinetypeLoading dlt = OdDb::kDltNotApplicable,
    OdDb::TextFileEncoding encode = OdDb::kTextFileEncodingDefault);

  /** \details
    Returns the name of the file this database object was loaded from.
    Can return empty string in case the database was created from scratch.
  */
  virtual OdString originalFilename() const;

  /** \details
    Returns the name of the file associated with this database object.
  */
  virtual OdString getFilename() const;

  /** \details
    Forcibly sets the name of the current file for this database instance.
    
    \param fileName [in] Name of the file to be set as current for this database instance.
  */
  virtual void setFilename(const OdString& fileName);

  /** \details
    Removes the object IDs from the specified array that are hard referenced in this database object.
    
    \param objectIds [in/out] Array of object IDs.

    \remarks
    Any remaining object IDs can be safely erased.
    This function does not modify this database object.
  */
  virtual void purge(
    OdDbObjectIdArray& objectIds) const;

  /** \details
    Removes the nodes from the id graph that are hard referenced in this database object.
    
    \param objectIds [in/out] Id graph to examine.
   
    \remarks
    This function builds a reference graph between the objects, which can be used to remove objects with circular references in one pass.
    All the objects referenced from outside of the graph are removed from it on return.
    This function does not modify this database object.
  */
  virtual void purge(
    OdDbObjectIdGraph& objectIds) const;

  /** \details
      Returns a count of hard references to each of the specified object IDs.

      \param objectIds  [in]  Array of object IDs.
      \param counts     [out] Receives an array of hard reference counts. 

      \remarks
      counts must be the same size as objectIds.

      Each element of counts will be incremented for each hard reference of the corresponding objectId.
      The caller must initialize the elements of count to zero or an appropriate value
      before calling this function.
  */
  virtual void countHardReferences(
    const OdDbObjectIdArray& objectIds,
    OdUInt32* counts) const;

  /** \details
      Returns the object ID of the active layout of this database object.
  */
  OdDbObjectId currentLayoutId() const;

  /** \details
    Sets the current layout of this database object.

    \param layoutName [in]  Name of the layout to be set as current.
  */
  virtual void setCurrentLayout(
    const OdString& layoutName);

  /** \details 
    Sets the current layout of this database object.
    
    \param layoutId [in]  Object ID of layout to be set as current.
  */
  virtual void setCurrentLayout(
    const OdDbObjectId& layoutId);

  /** \details
      Returns the name of the active layout of this database object.

      \param allowModel [in]  If and only if true, allows the ModelSpace layout name to be returned.

      \remarks
      If allowModel == false, an empty string will be returned if the active layout is ModelSpace.
  */
  virtual OdString findActiveLayout(
    bool allowModel) const;

  /** \details
    Returns the object ID of the BlockTableRecord associated with the active
    layout of this database object.
  */
  virtual OdDbObjectId getActiveLayoutBTRId() const;

  /** \details
    Returns the object ID of the BlockTableRecord of active space. It can be Model Space even if
    Paper layout is active but current viewport is Model one.
  */
  virtual OdDbObjectId currentSpaceId() const;

  /** \details
    Returns the object ID of overall viewport of Paper Space.
  */
  virtual OdDbObjectId paperSpaceVportId() const;

  /** \details
    Returns the object ID of the specified layout in this database object.

    \param layoutName [in]  Layout name.

    \remarks
    Returns a null object ID if the specified layout is not found.
  */
  virtual OdDbObjectId findLayoutNamed(
    const OdString& layoutName) const;

  /** \details
    Deletes the specified layout from this database object.

    \param layoutName [in]  Layout name.
  */
  virtual void deleteLayout(
    const OdString& layoutName);

  /** \details
    Creates a new layout with the specified name in this database object.

    \remarks
    The newly created layout is added to this database object along with its
    newly created associated OdDbBlockTableRecord.

    \param layoutName [in]  Layout name.
    \param pBlockTableRecId [in]  Pointer to the BlockTableRecID to receive the object ID of the new BlockTableRecord object.
  */
  virtual OdDbObjectId createLayout(
    const OdString& layoutName,
    OdDbObjectId* pBlockTableRecId = 0);

  /** \details
    Returns the number of layouts in this database object.
  */
  virtual int countLayouts() const;

  /** \details
    Renames the specified layout in this database object.
    \param oldName [in]  Old name.
    \param newName [in]  New name.
  */
  virtual void renameLayout(
    const OdString& oldName,
    const OdString& newName);

  /** \details
      Starts undo recording of this database object.
  */
  void startUndoRecord();

  /** \details
      Returns true if undo information exists for this database object.
  */
  bool hasUndo() const;

  /** \details
    Performs an undo operation on this database object.

    \remarks
    All operations performed since the last call to startUndoRecord will be undone.
    At least 1 undo step is always supported for internal needs.
    To support more steps overload OdDbHostAppServices::newUndoController()
  */
  void undo();

  /** \details
    Starts/Ends an undo block. Undo block can be undone as a whole in the "UNDO" command.
    
    \param bBegin [in] A flag determining whether undo history recording is grouped (if true) or not (if false). 
  */
  void blockUndoRecording(bool bBegin);

  /** \details
    Returns whether undo history recording has been blocked (returns true) or not (returns false). 
  */
  bool isUndoBlockStarted();

  /** \details
    Sets an undo marker on this database object.
  */
  void setUndoMark();

  /** \details
    Returns whether an undo marker has been set on this database object (returns true) or not (returns false).
  */
  bool hasUndoMark() const;

  /** \details
    Performs the undo operation on this database object. 
  */
  void undoBack();

  /** \details
    Returns the quantity of undo markers.
  */
  int getUNDOMARKS() const;

  /** \details
    Clears undo history.
  */
  void clearUndo();

  /** \details
    Returns true if redo information exists for this database object.
  */
  bool hasRedo() const;

  /** \details
    Clears redo.
  */
  void clearRedo();
    
  /** \details
    Performs a redo operation on this database object.

    \remarks
    Restores operations undone by the last undo.
  */
  void redo();

  /** \details
    Performs an audit operation on the this entire database object.

    \param pAuditInfo [in]  Pointer to an AuditInfo object.

    \remarks
    The specified AuditInfo object controls the audit and receives the audit status.
  */
  void auditDatabase(
    OdDbAuditInfo *pAuditInfo);

  /** \details 
    Applies a partial undo operation.
    
    \param pUndoFiler [in] Object used for perfoming input/output operations. 
    \param pClassObj  [in] A pointer to an object for perfoming undo actions.
  */
  void applyPartialUndo(
    OdDbDwgFiler* pUndoFiler,
    OdRxClass* pClassObj);

  /** \details 
    Returns the current object used for udo file input/output operations. 
  */
  OdDbDwgFiler* undoFiler();

  /** \details
    Copies the content of a specified database to this database.  

    \param destinationBlockName   [in]  Name for the new OdDbBlockTableRecord.
    \param pSource                [in]  Source database.
    \param preserveSourceDatabase [in]  Not used. Objects from the source database are always copied, not moved.
    
    \remarks
    The data that will be copied includes content of the following enities: 
    * BlockTable
    * LayerTable
    * LinetypeTable
    * DimStyleTable
    * RegAppTable
    * TextStyleTable
    * PlotStyleNameDictionary
    * PlotSettingsDictionary
    * MLStyleDictionary
    * ColorDictionary
    * MaterialDictionary
    * TableStyleDictionary
    * MLeaderStyleDictionary
    * ScaleListDictionary
    * VisualStyleDictionary 
    * GroupDictionary

    Unlike the wblockCloneObjects() method, insert() also copies the sortens table. 
    While copying duplicate objects, names will be ignored; a destination object that has the same name as the source object will be rewritten by the source one.

    A new OdDbBlockTableRecord is created and all model space entities of pSource are copied into the new block.
	  */
  OdDbObjectId insert(
    const OdString& destinationBlockName,
    OdDbDatabase* pSource,
    bool preserveSourceDatabase = true);

  /** \details
    Copies the content of a specified database to this database.  

    \param sourceBlockName        [in]  Name of the OdDbBlockTableRecord in pSource.
    \param destinationBlockName   [in]  Name for the new OdDbBlockTableRecord.
    \param pSource                [in]  Source database.
    \param preserveSourceDatabase [in]  Not used. Objects from the source database are always copied, not moved.
    
    \remarks
    The data that will be copied includes content of the folloowing enities: 
    * BlockTable,
    * LayerTable
    * LinetypeTable
    * DimStyleTable
    * RegAppTable
    * TextStyleTable
    * PlotStyleNameDictionary
    * PlotSettingsDictionary
    * MLStyleDictionary
    * ColorDictionary
    * MaterialDictionary
    * TableStyleDictionary
    * MLeaderStyleDictionary
    * ScaleListDictionary
    * VisualStyleDictionary
    * GroupDictionary

    Unlike the wblockCloneObjects() method, insert() also copies the sortens table. 
    While copying duplicate objects, names will be ignored; a destination object that has the same name as the source object will be rewritten by the source one.

    All entities in the BlockTableRecord specified by sourceBlockName in pSource are copied into the new OdDbBlockTableRecord and offset by the INSBASE value. 
    Contents of layout blocks are copied only if sourceBlockName is a layout block name. 
  */
  OdDbObjectId insert(
    const OdString& sourceBlockName,
    const OdString& destinationBlockName,
    OdDbDatabase* pSource,
    bool preserveSourceDatabase = true);

  /** \details
    Copies the content of a specified database to this database.  

    \param xfm                    [in]  Transformation matrix.
    \param pSource                [in]  Source database.
    \param preserveSourceDatabase [in]  Not used. Objects from the source database are always copied, not moved.
    
    \remarks
    The data that will be copied includes content of the folloowing enities: 
    * BlockTable
    * LayerTable
    * LinetypeTable
    * DimStyleTable
    * RegAppTable
    * TextStyleTable
    * PlotStyleNameDictionary
    * PlotSettingsDictionary
    * MLStyleDictionary
    * ColorDictionary
    * MaterialDictionary
    * TableStyleDictionary
    * MLeaderStyleDictionary
    * ScaleListDictionary
    * VisualStyleDictionary
    * GroupDictionary

    Unlike the wblockCloneObjects() method, insert() also copies the sortens table. 
    While copying duplicate objects, names will be ignored; a destination object that has the same name as the source object will be rewritten by the source one.
    
    All model space entities in pSource are copied into model space of this database object and transformed by xfm.
    Transformation matrix should be uniform. Non-uniform transform is ignored.
  */
  void insert(
    const OdGeMatrix3d& xfm,
    OdDbDatabase* pSource,
    bool preserveSourceDatabase = true);

  /** \details
    Clones specified objects of this database to a new database.

    \param outObjIds [in]  Array of object IDs to be cloned.
    \param basePoint [in]  WCS base point for the insertion.

    \remarks
    The method creates a new OdDbDatabase object, populates it with specified objects from this database using the wblockClone() method and returns a smart pointer to the new database. 
    All objects are copied with their dependencies. For example, if a text entity uses a specific textstyle, it will be copied as well; line entities will be copied with their linestyles, etc.
  */
  OdDbDatabasePtr wblock(
    const OdDbObjectIdArray& outObjIds,
    const OdGePoint3d& basePoint);

  /** \details
    Clones specified objects of this database to a new database.

    \param blockId [in]  Object ID of the BlockTableRecord to be cloned.
     
    \remarks
    The method creates a new OdDbDatabase object, populates it with specified objects from this database using the wblockClone() method and returns a smart pointer to the new database. 
    All objects are copied with their dependencies. For example, if a text entity uses a specific textstyle, it will be copied as well; line entities will be copied with their linestyles, etc.
  */
  OdDbDatabasePtr wblock(
    OdDbObjectId blockId);

  /** \details
    Clones the entire contents of this database to a new database.

    \remarks
    The method creates a new OdDbDatabase object, populates it with objects from this database and returns a smart pointer to the new database. 
    All objects are copied with their dependencies. For example, if a text entity uses a specific textstyle, it will be copied as well; line entities will be copied with their linestyles, etc.
  */
  OdDbDatabasePtr wblock();


  /** \details
    Clones specified objects of this database to the model space of the database pointed to by pOutputDb

    \param pOutputDb [in]  Existing database.
    \param outObjIds [in]  Array of object IDs to be cloned.
    \param basePoint [in]  WCS base point for the output database (INSBASE).
    \param drc [in]  must be one of the following:

    <table>
    Name                        Description
    OdDb::kDrcIgnore            If a duplicate record exists, use the existing record in the database and ignore the clone.
    OdDb::kDrcReplace           If a duplicate record exists, replace it with the cloned record.
    OdDb::kDrcMangleName        Incoming record names are mangled with $0$<name>.
    OdDb::kDrcUnmangleName      Unmangle the names mangled by OdDb::kDrcMangleName, then default to OdDb::kDrcIgnore. Typically used by RefEdit when checking records into the original database.
    </table>

    \remarks
    The method expects the output database to be initialized (either read from file, or created with default objects).
    All objects are copied with their dependencies. For example, if a text entity uses a specific textstyle, it will be copied as well; line entities will be copied with their linestyles, etc.
  */
  void wblock(OdDbDatabase* pOutputDb, const OdDbObjectIdArray& outObjIds, const OdGePoint3d& basePoint, OdDb::DuplicateRecordCloning drc);

 /** \details
    As implemented, this function does nothing but return a null SmartPointer.
    It will be fully implemented in a future release.
 */
  OdDbObjectPtr subWblockClone(OdDbIdMapping& ownerIdMap, OdDbObject*) const;
  using OdDbObject::subWblockClone; // Fix -Woverloaded-virtual

  /** \details
    Sets the security parameters of this database object.

    \param secParams  [in]  Security params.
    \param setDbMod   [in]  If and only if true, the DBMOD variable will be set if the security settings are modified.

    \remarks
    As implemented, this function ignores setDbMod and never modifies the DBMOD variable.
    It will be fully implemented in a future release.
  */
  void setSecurityParams(
    const OdSecurityParams& secParams,
    bool setDbMod = true);

  /** \details
    Returns the security parameters of this database object.
    
    \param secParams [in]  Security params.
    
    \remarks
    Returns true only if field nFlags of secParams is not equal to 0 and field password of secParams is not empty.
  */
  bool securityParams(
    OdSecurityParams& secParams) const;
    
  /** \details
    Returns the OdFileDependencyManager object of this database object.
  */
  OdFileDependencyManagerPtr fileDependencyManager() const;
  
  /** \details
  Returns the OdDbObjectContextManager object of this database object.
  */
  OdDbObjectContextManagerPtr objectContextManager() const;
  
  /** \details
    Returns the OdDbLayerStateManager object of this database object.
  */
  OdDbLayerStateManager* getLayerStateManager() const;

  /** \details
    Recalculates the extents of this database object.
    
    \param bExact [in]  Enables a slower but more exact extents calculation algorithm.
  */
  void updateExt(bool bExact = false);

  /** \details
    Returns true if and only if this database object was created by an educational version of the application.
  */
  bool isEMR() const;
  
  /** \details
    Returns the object ID of the OdDbBlockTableRecord that references this database object as an Xref.
  */
  OdDbObjectId xrefBlockId() const;

  /** \details
    Returns true if and only if this database object is partially opened.
  */
  bool isPartiallyOpened() const;

  /** \details
    Returns true if and only if this database object is being loaded from a file.
  */
  bool isDatabaseLoading() const;

  /** \details
    Returns true if and only if this database object is being converted after loading from a file or before saving to a file.
  */
  bool isDatabaseConverting() const;

  /** \details
    Returns the pointer to OdDbAuditInfo if the database is being loaded from a file in recover modem, otherwise returns Null.
  */
  OdDbAuditInfo* auditInfo() const;

  /** \details
    Sets the current UCS of this database object.

    \param viewType [in]  Orthographic view type.

    \remarks
    viewType must be one of the following:

    <table>
    Name                  Value   View type
    OdDb::kNonOrthoView   0       Non-orthographic with respect to the UCS
    OdDb::kTopView        1       Top view with respect to the UCS
    OdDb::kBottomView     2       Bottom view with respect to the UCS
    OdDb::kFrontView      3       Front view with respect to the UCS
    OdDb::kBackView       4       Back view with respect to the UCS
    OdDb::kLeftView       5       Left view with respect to the UCS
    OdDb::kRightView      6       Right view with respect to the UCS
    </table>
  */
  void setCurrentUCS(
    OdDb::OrthographicView viewType);
 
  /** \details
    Sets the current UCS of this database object.

    \param ucsId    [in]  Object ID of the UCS.
  */
  void setCurrentUCS(
    const OdDbObjectId& ucsId);
    
  /** \details
    Sets the current UCS of this database object.

    \param origin   [in]  The WCS origin of the UCS.
    \param xAxis    [in]  The WCS X-axis of the UCS.
    \param yAxis    [in]  The WCS Y-axis of the UCS.
  */
  void setCurrentUCS(
    const OdGePoint3d& origin,
    const OdGeVector3d& xAxis,
    const OdGeVector3d& yAxis);

  /** \details
    Returns the UCS origin and orthographic view type for the current UCS.

    \param viewType [in]  Orthographic view type.

    \remarks
    viewType must be one of the following:

    <table>
    Name            Value   View type
    OdDb::kNonOrthoView   0       Non-orthographic with respect to the UCS
    OdDb::kTopView        1       Top view with respect to the UCS
    OdDb::kBottomView     2       Bottom view with respect to the UCS
    OdDb::kFrontView      3       Front view with respect to the UCS
    OdDb::kBackView       4       Back view with respect to the UCS
    OdDb::kLeftView       5       Left view with respect to the UCS
    OdDb::kRightView      6       Right view with respect to the UCS
    </table>
  */
  OdGePoint3d getUCSBASEORG(
    OdDb::OrthographicView viewType) const;

  /** \details
    Sets the UCS origin and orthographic view type for the current UCS.

    \param origin   [in]  The WCS origin of the UCS.
    \param viewType [in]  Orthographic view type.

    \remarks
    viewType must be one of the following:

    <table>
    Name            Value   View type
    OdDb::kNonOrthoView   0       Non-orthographic with respect to the UCS
    OdDb::kTopView        1       Top view with respect to the UCS
    OdDb::kBottomView     2       Bottom view with respect to the UCS
    OdDb::kFrontView      3       Front view with respect to the UCS
    OdDb::kBackView       4       Back view with respect to the UCS
    OdDb::kLeftView       5       Left view with respect to the UCS
    OdDb::kRightView      6       Right view with respect to the UCS
    </table>
  */
  void setUCSBASEORG(
    OdDb::OrthographicView viewType,
    const OdGePoint3d& origin);

  /** \details
    Returns the UCS origin and orthographic view type for the current PaperSpace UCS.

    \param viewType [in]  Orthographic view type.

    \remarks
    viewType must be one of the following:

    <table>
    Name                  Value   View type
    OdDb::kNonOrthoView   0       Non-orthographic with respect to the UCS
    OdDb::kTopView        1       Top view with respect to the UCS
    OdDb::kBottomView     2       Bottom view with respect to the UCS
    OdDb::kFrontView      3       Front view with respect to the UCS
    OdDb::kBackView       4       Back view with respect to the UCS
    OdDb::kLeftView       5       Left view with respect to the UCS
    OdDb::kRightView      6       Right view with respect to the UCS
    </table>
  */
   OdGePoint3d getPUCSBASEORG(
    OdDb::OrthographicView viewType) const;

 /** \details
    Sets the UCS origin and orthographic view type for the current PaperSpace UCS.

    \param origin   [in]  The WCS origin of the UCS.
    \param viewType [in]  Orthographic view type.

    \remarks
    viewType must be one of the following:

    <table>
    Name                  Value   View type
    OdDb::kNonOrthoView   0       Non-orthographic with respect to the UCS
    OdDb::kTopView        1       Top view with respect to the UCS
    OdDb::kBottomView     2       Bottom view with respect to the UCS
    OdDb::kFrontView      3       Front view with respect to the UCS
    OdDb::kBackView       4       Back view with respect to the UCS
    OdDb::kLeftView       5       Left view with respect to the UCS
    OdDb::kRightView      6       Right view with respect to the UCS
    </table>
 */
  void setPUCSBASEORG(
    OdDb::OrthographicView viewType,
    const OdGePoint3d& origin);

  /** \details
  Returns the database to its original state (when the xref was first read) by undoing
  any modifications.
  \remarks
  This function should be used with restoreForwardingXrefSymbols when reading or writing any xref object. 
  */
  void restoreOriginalXrefSymbols();

  /** \details
  Returns the database to its modified state (before any original state restoration) by
  redoing modifications.
  \remarks
  This function should be used with restoreOriginalXrefSymbols when reading or
  writing any xref object. The database requires write-access to symbol tables and 
  records.
  */
  void restoreForwardingXrefSymbols();

  /** \details
    Requires a lineweight and returns True if the specified lineweight is valid, that is, one of the
    predefined lineweights in this database, or False otherwise.

    \param weight [in]  The lineweight value.
  */
  static bool isValidLineWeight(int weight);

  /** \details
    Requires a lineweight and returns the nearest OdDb::LineWeight enum number for this database. For example, 
    when the passed value is 8, the returned value is kLnWt009.

    \param weight [in]  The lineweight value.
  */
  static OdDb::LineWeight getNearestLineWeight(int weight);

  //DOM-IGNORE-BEGIN
  /*
  bool plotStyleMode() const;


  void forceWblockDatabaseCopy();

  void auditXData(OdDbAuditInfo* pInfo);

  OdDbUndoController* undoController() const;

  void setDimblk(const OdChar*);
  void setDimblk1(const OdChar*);
  void setDimblk2(const OdChar*);
  void setDimldrblk(const OdChar*);

  void getDimstyleChildData(const OdRxClass *pDimClass,
                            OdDbDimStyleTableRecordPtr& pRec,
                            OdDbObjectId &style) const;

  OdDbObjectId getDimstyleChildId(const OdRxClass *pDimClass,
                                  OdDbObjectId &parentStyle) const;

  OdDbObjectId getDimstyleParentId(OdDbObjectId &childStyle) const;

  void getDimRecentStyleList(OdDbObjectIdArray& objIds) const;

  void applyPartialOpenFilters(const OdDbSpatialFilter* pSpatialFilter,
                               const OdDbLayerFilter* pLayerFilter);

  void disablePartialOpen();

  void newFingerprintGuid();

  void newVersionGuid();

  double viewportScaleDefault() const;

  void setViewportScaleDefault(double newDefaultVPScale);

  OdDbObjectId getPaperSpaceVportId() const;

  virtual void copyLayout(const OdChar* copyname, const OdChar* newname);

  virtual void cloneLayout(const OdDbLayout* pLBTR, const OdChar* newname, int newTabOrder);

  virtual OdDbObjectId getNonRectVPIdFromClipId(const OdDbObjectId& clipId);

  virtual bool isViewportClipped(short index);

  */
  //DOM-IGNORE-END
  
  /** \details
    Returns the identifier of the by-layer material for this database.
  */
  OdDbObjectId byLayerMaterialId() const;
  
  /** \details
    Returns the identifier of the by-block material for this database.
  */
  OdDbObjectId byBlockMaterialId() const;
  
  
  /** \details
    Returns the identifier of the global material for this database.
  */  
  OdDbObjectId globalMaterialId() const;

  /** \details
    Returns the identifier of the active viewport for this database.
    If Model Space is active it is "*Active" OdDbViewortTableRecord Id
    If Paper Space is active it will be overall OdDbViewport Id if it is active
    or Model Space "*Active" OdDbViewortTableRecord Id if one of non-overall
    OdDbViewport entities is active.
  */  
  OdDbObjectId activeViewportId() const;

  /** \details
    Returns the current formatter for units in this database.
  */  
  virtual OdDbUnitsFormatter& formatter();

  /** \details
    Enables graphics flushing.
    
    \param bEnable [in] A flag which determines whether graphic flushing is enabled (true) or not (false).
  */  
  void enableGraphicsFlush(bool bEnable);
  
  /** \details
    Flushes the graphics in this database.
  */  
  void flushGraphics();

// ODA_MT_DB_BEGIN
  /** \details 
    If multi-threaded mode is on, the method returns true. In the other case it returns false. 
  */
  bool isMultiThreadedMode() const;
  
  /** \details 
    Returns which multi-threaded mode the database currently uses. 
    
    \remarks 
    Returns one of the following values:
    <table>
    Name                                    Value   Multi-Threaded mode
    OdDb::MultiThreadedMode::kSTMode        0       No multi-threaded, uses single-threaded mode.
    OdDb::MultiThreadedMode::kMTLoading     1       Multi-threaded data loading.
    OdDb::MultiThreadedMode::kMTRendering   2       Multi-threaded rendering.
  */
  OdDb::MultiThreadedMode multiThreadedMode() const;
  
    /** \details 
    Sets a new multi-threaded mode for the database. 
    
    \param  [in] A new value of multi-threaded mode to be set. 
    
    \remarks 
    New value can be one of the following:
    <table>
    Name                                    Value   Multi-threaded mode
    OdDb::MultiThreadedMode::kSTMode        0       No multi-threaded, uses single-threaded mode.
    OdDb::MultiThreadedMode::kMTLoading     1       Multi-threaded data loading.
    OdDb::MultiThreadedMode::kMTRendering   2       Multi-threaded rendering.
  */
  virtual void setMultiThreadedMode(OdDb::MultiThreadedMode);
// ODA_MT_DB_END
  
  /** \details 
    Sets a new annotation scale as a context object for this database. 
    \param val [in] A new value of annotation scale. 
    
    \sa 
    <link OdDbAnnotationScale, OdDbAnnotationScale class>
  */
  void setCannoscale(OdDbAnnotationScale* val);
  
  /** \details 
    Returns the current annotation scale as a context object for this database. 
    
    \sa 
    <link OdDbAnnotationScale, OdDbAnnotationScale class>
  */
  OdDbAnnotationScalePtr cannoscale() const;

  OdDbObjectId   dataLinkDictionaryId(void) const;
  OdDbDictionaryPtr dataLinkDictionary(OdDb::OpenMode mode);

  /** \details 
    Returns the true if OdDbDatabase instance is restricted to use only core objects.
    In such mode implementation of OdDbDatabase::initialize() for example will not create some objects
    like dimension style table and default dimension style or default multi-line style.
    Default implementation simply returns 'false'
  */
  virtual bool usingCoreOnly() const;

  /** \details
    Enqueues the object paging, mark it for paging in next call to pageObjects().  

    \remarks
    See Paging Support for details.
  */
  bool enqueuePaging(const OdDbObjectId &id);

  /** \details
    Pages the database objects that have been marked for paging since the last call to this function.  

    \remarks
    See Paging Support for details.
  */
  bool pageObjects();

  /** \details
    \returns OdDb::IndexingModeFlags combination

  */
  int indexingMode() const;

  /** \details
    \param nIndexingModeBitFlags[in] OdDb::IndexingModeFlags combination

  */
  void setIndexingMode(int nIndexingModeBitFlags);

  /** \details
    Returns true if per object converting mode is used for this database object.
  */
  bool isPerObjectConverting() const;

  /** \details
    Returns the pointer to record set related to AppInfo if present in the file, otherwise returns Null.
  */
  OdDbAppInfoRecordSetPtr getAppInfo();

  /** \details
    Returns the pointer to record set related to AppInfoHistory if present in the file, otherwise returns Null.
  */
  OdDbAppInfoRecordSetPtr getAppInfoHistory();

private:
  friend class OdDbDatabaseImpl;
  OdDbDatabaseImpl* m_pImpl;
};

  /** \details
  */
TOOLKIT_EXPORT OdUInt32 getGapsAmount(OdDbDatabase* pDb);
TOOLKIT_EXPORT OdRxClass* getClassByName(OdDbDatabase* pDb, const OdString& className);

/** \details
   Verify drawing Digital Signature if exists.

   \param drawingFullPath [in] Full path to the drawing file to verify the signature.
   \param verificationResult  [out] Verification result.
   \param signatureDesc       [out] Data structure into which signature description data will be placed.

   \returns
   Returns eOk if the verification process completed without errors, and verificationResult contains the verification result.
   Returns eCantOpenFile if can't open the drawing file specified by drawingFullPath.
   Returns eInvalidInput if the drawing file has a version for which the verification process can not be performed.   
*/
DBIO_EXPORT OdResult validateDrawingSignature(const OdString& drawingFullPath, 
  OdCryptoServices::OdSignatureVerificationResult& verificationResult, 
  OdSignatureDescription& signatureDesc);

/** Fills in the OdThumbnailImage object from stream. Throws appropriate exception if an error occurred.
*/

TOOLKIT_EXPORT void odDbGetPreviewBitmap(OdStreamBuf* pStreamBuf, OdThumbnailImage* pPreview);


// The functions below provide write access to "Read-Only" *database* variables.
// Actually they are a OdDb::kludge for bypassing non-implemented DD functionality
// or to repair invalid drawings.
// They should be used with care.

/** \details
    Sets the DWGCODEPAGE value in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for DWGCODEPAGE.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetDWGCODEPAGE(
  OdDbDatabase& db,
  OdCodePageId val);

/** \details
    Sets the TDUCREATE system variable in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for TDUCREATE.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetTDUCREATE(
  OdDbDatabase& db,
  OdDbDate val);

/** \details
    Sets the TDUUPDATE value in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for TDUUPDATE.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetTDUUPDATE(
  OdDbDatabase& db,
  OdDbDate val);

/** \details
    Sets the TDINDWG value in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for TDINDWG.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetTDINDWG(
  OdDbDatabase& db,
  OdDbDate val);

/** \details
    Sets the TDUSRTIMER value in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for TDUSRTIMER.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetTDUSRTIMER(
  OdDbDatabase& db,
  OdDbDate val);

/** \details
    Sets the PSTYLEMODE value in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for PSTYLEMODE.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetPSTYLEMODE(
  OdDbDatabase& db,
  bool val);

/** \details
    Sets the UCSORG system variable in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for UCSORG.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetUCSORG(
  OdDbDatabase& db,
  OdGePoint3d val);

/** \details
    Sets the UCSXDIR value in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for UCSXDIR.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetUCSXDIR(
  OdDbDatabase& db,
  OdGeVector3d val);

/** \details
    Sets the UCSYDIR value in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for UCSYDIR.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetUCSYDIR(
  OdDbDatabase& db,
  OdGeVector3d val);

/** \details
    Sets the PUCSORG value in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for PUCSORG.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetPUCSORG(
  OdDbDatabase& db,
  OdGePoint3d val);

/** \details
    Sets the PUCSXDIR value in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for PUCSXDIR.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetPUCSXDIR(
  OdDbDatabase& db,
  OdGeVector3d val);

/** \details
    Sets the PUCSYDIR value in the specified OdDbDatabase instance.

    \param db [in]  Database.
    \param val [in]  Value for PUCSYDIR.

    \remarks
    This function provides write access to "Read-Only" system variables.
    It may be used to bypass non-implemented Drawings functionality or to repair drawings,
    and should be used with care.
*/
TOOLKIT_EXPORT void odDbSetPUCSYDIR(
  OdDbDatabase& db,
  OdGeVector3d val);


 /** \details
    Saves linetypes to the specified file.
    \param db [in]  OdDbDatabase object.
    \param filename [in]  Name of the linetype file to save.
		\param encode [in]  Encoding used for writing linetype text files.
 */
extern TOOLKIT_EXPORT void odDbSaveLineTypeFile(OdDbDatabase &Db, OdStreamBuf &filename, OdDb::TextFileEncoding encode = OdDb::kTextFileEncodingDefault);

 /** \details
    Loads an MLineStyle into the specified database object.

    \param db [in]  OdDbDatabase object.
    \param patternName [in]  Name of the pattern to load.
    \param filename [in]  Name of the MlineStyle file from which to load.
    \param dlt [in]  Duplicate linetype loading.
    \remarks
    dlt must be one of the following:

    <table>
    Name                        Value   Description
    OdDb::kDltNotApplicable     0       Not Applicable.
    OdDb::kDltIgnore            1       Ignore duplicate linetypes.
    OdDb::kDltReplace           2       Replace duplicate linetypes.
    </table>

    Throws:
    An appropriate error if not successful.
 */
extern DBENT_EXPORT void odDbLoadMlineStyleFile(
  OdDbDatabase &db,
  const OdString& patternName,
    OdStreamBuf &filename,
  OdDb::DuplicateLinetypeLoading dlt = OdDb::kDltNotApplicable );

 /** \details
    Saves an MLineStyle to the specified file.
    \param db [in]  OdDbDatabase object.
    \param filename [in]  Name of the MlineStyle file to save.
 */
extern DBENT_EXPORT void odDbSaveMlineStyleFile(OdDbDatabase &db, OdStreamBuf &filename );

/** \details
    Suppresses OdDbDatabaseReactor notifications firing.
    \param pDb [in] OdDbDatabase object.
    \param bValue [in] New state of the reactor suppression.
    \returns Old state of the reactor suppression.
*/
TOOLKIT_EXPORT bool oddbSetDbNotificationSuppression(OdDbDatabase* pDb, bool bValue);

namespace OdDb
{
  /** \details 
    Returns a specified .dwg version as a null terminated string. 
    \param ver [in] A .dwg version value to be converted to string.
  */
  TOOLKIT_EXPORT const char* DwgVersionToStr(DwgVersion ver);

  /** \details 
    Returns the .dwg version value from a null-terminated string. 
    \param ver [in] A pointer to a null-terminated string, from which the version value should be converted.
  */
  TOOLKIT_EXPORT DwgVersion DwgVersionFromStr(const char* str);
}

class OdDbDataLinkManager;
DBENT_EXPORT OdDbDataLinkManager* odDbGetDataLinkManager(OdDbDatabase* db);

/**
  <group !!RECORDS_tdrawings_apiref>
*/
struct TOOLKIT_EXPORT OdMTLoadReactor
{
  /** \details
  This function is continuously queried during partial loading process, to stop it if necessary.
  */
  virtual bool shouldInterrupt() { return false; }
  /** \details
  This function notifies detected block references for further processing
  */
  virtual void insertDetected(OdDbObjectId) {}
  /** \details
  This function returns database access mutex
  */
  virtual OdMutex* accessMutex() { return NULL; }
};

/** \details
    \param pDb [in] OdDbDatabase object.
    \returns string indicating ODA SDK version if file was saved with it
    \else returns empty string.
*/
TOOLKIT_EXPORT OdString odFileWasSavedByODASoftware(const OdDbDatabase* pDb);

/** \details
    \param pDb [in] OdDbDatabase object.
    \param pYear [in] Pointer to OdString to recieve string of product release year.
    \param pLicense [in] Pointer to OdString to recieve product license string.
    \returns Product Line Code (PLC) string indicating ADSK product if the file was created with it.
*/
TOOLKIT_EXPORT OdString odPreviousProductInfo(const OdDbDatabase* pDb, OdString* pYear = 0, OdString* pLicense = 0);

#include "TD_PackPop.h"

#endif /* _ODDBDATABASE_INCLUDED_ */