Archived issue #0019986
Version "3" of binary OCAF persistence (BinOcaf)
Description
New version of the OCAF binary persistance format is created.
This improvement unifies the inclusion of non-OCAF data into persistent
documents. In format version 2 there was only one such data block - Shapes
section. In the new format version 3 it is possible to create any number of
custom sections, the Shapes being just one of them.
Each Section is unquely identified by ASCII name string and has also the
attribute IsPostRead. This attribute defines if the Section is read before or
after the OCAF data. In the former case the BinOcaf attribute drivers can have
access to non-OCAF data that are read in advance (as with the SHAPES section).
To use custom sections in OCAF binary documents, it will be necessary to
subclass DocumentRetrievalDriver and DocumentStorageDriver from BinLDrivers,
with the relevant definition of virtual methods that process the section data.
Compatibility with documents written in format version 2 is preserved in
DocumentRetrievalDriver.
This improvement unifies the inclusion of non-OCAF data into persistent
documents. In format version 2 there was only one such data block - Shapes
section. In the new format version 3 it is possible to create any number of
custom sections, the Shapes being just one of them.
Each Section is unquely identified by ASCII name string and has also the
attribute IsPostRead. This attribute defines if the Section is read before or
after the OCAF data. In the former case the BinOcaf attribute drivers can have
access to non-OCAF data that are read in advance (as with the SHAPES section).
To use custom sections in OCAF binary documents, it will be necessary to
subclass DocumentRetrievalDriver and DocumentStorageDriver from BinLDrivers,
with the relevant definition of virtual methods that process the section data.
Compatibility with documents written in format version 2 is preserved in
DocumentRetrievalDriver.
Additional information
Documentation remark, added by Author 2008-07-03 09:36:54:
New features:
In BinLOcaf the new format "3" introduced replacing the previous format.
This format allows to insert any number of custom data blocks (sections) in the
persistent document.
Improvements:
In BinObjMgt added the support of ShortReal and ShortRealArray data types.
Changes:
The basic API of BinOcaf format has not been changed.
Modified entities:
Toolkits: TKBin TKBinL
Packages: BinLDrivers, BinDrivers, BinObjMgt, FSD
New features:
In BinLOcaf the new format "3" introduced replacing the previous format.
This format allows to insert any number of custom data blocks (sections) in the
persistent document.
Improvements:
In BinObjMgt added the support of ShortReal and ShortRealArray data types.
Changes:
The basic API of BinOcaf format has not been changed.
Modified entities:
Toolkits: TKBin TKBinL
Packages: BinLDrivers, BinDrivers, BinObjMgt, FSD
Public activity
No public notes
Participants are labeled by their role within this record.