Open CASCADE Technology  7.7.0
Enumerations
TDocStd_FormatVersion.hxx File Reference

Enumerations

enum  TDocStd_FormatVersion {
  TDocStd_FormatVersion_VERSION_2 = 2, TDocStd_FormatVersion_VERSION_3, TDocStd_FormatVersion_VERSION_4, TDocStd_FormatVersion_VERSION_5,
  TDocStd_FormatVersion_VERSION_6, TDocStd_FormatVersion_VERSION_7, TDocStd_FormatVersion_VERSION_8, TDocStd_FormatVersion_VERSION_9,
  TDocStd_FormatVersion_VERSION_10, TDocStd_FormatVersion_VERSION_11, TDocStd_FormatVersion_VERSION_12, TDocStd_FormatVersion_CURRENT = TDocStd_FormatVersion_VERSION_12
}
 Storage format versions of OCAF documents in XML and binary file formats. More...
 
enum  { TDocStd_FormatVersion_LOWER = TDocStd_FormatVersion_VERSION_2, TDocStd_FormatVersion_UPPER = TDocStd_FormatVersion_VERSION_12 }
 

Enumeration Type Documentation

◆ anonymous enum

anonymous enum
Enumerator
TDocStd_FormatVersion_LOWER 
TDocStd_FormatVersion_UPPER 

◆ TDocStd_FormatVersion

Storage format versions of OCAF documents in XML and binary file formats.

OCAF document file format evolves and a new version number indicates each improvement of the format. This enumeration lists all versions of an OCAF document. TDocStd_FormatVersion_CURRENT value refers to the last file format version. By default, Open CASCADE Technology writes new documents using the last file format version. The last version of Open CASCADE Technology is able to read old documents of any version. However, a previous version of Open CASCADE Technology may not be able to read a new document. In this case use the method ChangeStorageFormatVersion() from TDocStd_Document to change the file format version. Then, save the document by means of SaveAs() from TDocStd_Application.

If it is necessary to improve an XML or binary file format of OCAF document, follow please the next steps:

  • increment the file format version in this enumeration. Put a reference to the last file format version by means of TDocStd_FormatVersion_CURRENT.
  • introduce the improvement in OCAF attribute storage and retrieval drivers, if necessary. As an example, please consider the file XmlMDataStd_TreeNodeDriver.cxx.
  • test the improvement on current file format version and on the previous one.
Enumerator
TDocStd_FormatVersion_VERSION_2 

First supported version.

TDocStd_FormatVersion_VERSION_3 

OCCT 6.3.0.

  • XML: Adding DeltaOnModification functionality to set of Standard attributes [#0019403]
  • BIN: Add Delta to numbers data, changes in ShapeSection [#0019986, #0019403]
TDocStd_FormatVersion_VERSION_4 

OCCT 6.3.1.

  • XML: Naming mechanism improvement [#0021004]
  • BIN: entry, ContextLabel for tree [#0021004]
TDocStd_FormatVersion_VERSION_5 

OCCT 6.3.1.

  • XML: Separation of OCAF to Lite and Standard parts completion [#0021093]
  • BIN: Convert old format to new [#0021093]
TDocStd_FormatVersion_VERSION_6 

OCCT 6.5.0.

  • XML: Add location [#0022192]
  • BIN: Add location [#0022192]
TDocStd_FormatVersion_VERSION_7 

OCCT 6.7.0.

  • XML: Add orientation [#0023766]
  • BIN: Add orientation, type migration [#0023766]
TDocStd_FormatVersion_VERSION_8 

OCCT 7.0.0.

TDocStd_FormatVersion_VERSION_9 

OCCT 7.1.0.

  • BIN: Add GUIDs, Process user defined guid [#0027932]
TDocStd_FormatVersion_VERSION_10 

OCCT 7.2.0.

  • BIN: ReadTOC changed to handle 64-bit file length [#0028736]
TDocStd_FormatVersion_VERSION_11 

OCCT 7.6.0.

  • BIN, XML: TopTools_FormatVersion_CURRENT changed to 3 and BinTools_FormatVersion_CURRENT changed to 4 to preserve per-vertex normal information in case of triangulation-only Faces [#0031136]
TDocStd_FormatVersion_VERSION_12 

OCCT 7.6.0.

  • BIN: New binary format for fast reading of part of OCAF document [#0031918]
TDocStd_FormatVersion_CURRENT 

Current version.