mirror of
https://git.dev.opencascade.org/repos/occt.git
synced 2025-08-29 14:00:49 +03:00
d5c71e2057
Implementation of new format for quick reading and writing parts of the documents (sub-set of labels and sub-set of attributes). It consists in writing shapes and all their contents right in the TNaming_NamedShape attribute placement and skipping the shape section. New format 12 for Binary file types is assigned to this version. Added PCDM_ReaderFilter class that could be used in Open methods of TDocStd_Application. If it is defined, it allows to read: - into already opened document in append mode AppendMode_Protect (do not overwrite existing attributes) or AppendMode_Overwrite - only specified sub-trees of the document using AddPath (const TCollection_AsciiString& theEntryToRead) - only specified attributes using AddRead (const TCollection_AsciiString& theRead) where theRead could be "TDataStd_Name", for example - to skip specified attributes read using AddSkipped (const TCollection_AsciiString& theSkipped) where theSkipped could be "TDF_Reference", for example The current limitations: - only in Bin format - if shapes have in the document shared topology, loaded in "append" mode in different "load" operations, they will have no shared topology anymore Modifications: BinLDrivers and BinDrivers packages - modifications related to the quick part tree format flag usage, skipping shape section writing and adding labels sizes into the document to be able to pass labels during the reading quickly. BinObjMgt_Persistent and BinObjMgt_Position - to add possibility to write directly into the stream some data just after the attribute. Before this record a data-size is recorded. BinMXCAFDoc package modifications to write BinMXCAFDoc_LocationDriver location in the same way as shapes write location data right after the attribute (empty) data in this new format. BinTools package: creation of ShapeReader and ShapeWriter classes with same root class ShapeSetBase with ShapeSet class. These classes allows to write/read shapes directly to the stream. If some object is already in the stream, write a reference - relative position of the duplicated object. The old format of documents is still supported by Bin_ToolsShapeSet class. PCDM_ReaderFilter - Allows the user to create a reading filter. It contains algorithm to browse labels tree quickly, without usage of referencing by entry-strings. TDocStd, CDF and some other packages are changed for supporting reading filters API and options. Tests, documentation and upgrade information are also added for both issues: 31839 and 31918 related to this commit.
88 lines
4.1 KiB
C++
88 lines
4.1 KiB
C++
// Copyright (c) 2021 OPEN CASCADE SAS
|
|
//
|
|
// This file is part of Open CASCADE Technology software library.
|
|
//
|
|
// This library is free software; you can redistribute it and/or modify it under
|
|
// the terms of the GNU Lesser General Public License version 2.1 as published
|
|
// by the Free Software Foundation, with special exception defined in the file
|
|
// OCCT_LGPL_EXCEPTION.txt. Consult the file LICENSE_LGPL_21.txt included in OCCT
|
|
// distribution for complete text of the license and disclaimer of any warranty.
|
|
//
|
|
// Alternatively, this file may be used under the terms of Open CASCADE
|
|
// commercial license or contractual agreement.
|
|
|
|
#ifndef _BinTools_OStream_HeaderFile
|
|
#define _BinTools_OStream_HeaderFile
|
|
|
|
#include <BinTools.hxx>
|
|
#include <BinTools_ObjectType.hxx>
|
|
#include <TopAbs_ShapeEnum.hxx>
|
|
#include <TopAbs_Orientation.hxx>
|
|
#include <gp_Pnt.hxx>
|
|
#include <Poly_Triangle.hxx>
|
|
#include <gp_Vec3f.hxx>
|
|
|
|
//! Substitution of OStream for shape writer for fast management of position in the file
|
|
//! and operation on all writing types.
|
|
class BinTools_OStream
|
|
{
|
|
public:
|
|
|
|
//! Creates OStream using the current stream OStream.
|
|
Standard_EXPORT BinTools_OStream (Standard_OStream& theStream);
|
|
|
|
//! Returns the current position of the stream
|
|
Standard_EXPORT const uint64_t& Position() { return myPosition; }
|
|
//! Writes the reference to the given position (an offset between the current and the given one).
|
|
Standard_EXPORT void WriteReference (const uint64_t& thePosition);
|
|
//! Writes an identifier of shape type and orientation into the stream.
|
|
Standard_EXPORT void WriteShape (const TopAbs_ShapeEnum& theType, const TopAbs_Orientation& theOrientation);
|
|
|
|
|
|
//! Writes an object type to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const BinTools_ObjectType& theType);
|
|
//! Writes a byte to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const Standard_Byte& theValue);
|
|
//! Writes a real to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const Standard_Real& theValue);
|
|
//! Writes a boolean to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const Standard_Boolean& theValue);
|
|
//! Writes a integer to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const Standard_Integer& theValue);
|
|
//! Writes a extended character to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const Standard_ExtCharacter& theValue);
|
|
//! Writes a 3D point to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const gp_Pnt& theValue);
|
|
//! Writes a 3D direction to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const gp_Dir& theValue);
|
|
//! Writes a 2D point to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const gp_Pnt2d& theValue);
|
|
//! Writes a 2D direction to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const gp_Dir2d& theValue);
|
|
//! Writes a transformation matrix to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const gp_Trsf& theValue);
|
|
//! Writes triangle nodes indices to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const Poly_Triangle& theValue);
|
|
//! Writes a vector to the stream.
|
|
Standard_EXPORT BinTools_OStream& operator << (const gp_Vec3f& theValue);
|
|
|
|
//! Writes 3 booleans as one byte to the stream.
|
|
Standard_EXPORT void PutBools (
|
|
const Standard_Boolean theValue1, const Standard_Boolean theValue2, const Standard_Boolean theValue3);
|
|
|
|
//! Writes 7 booleans as one byte to the stream.
|
|
Standard_EXPORT void PutBools (
|
|
const Standard_Boolean theValue1, const Standard_Boolean theValue2, const Standard_Boolean theValue3,
|
|
const Standard_Boolean theValue4, const Standard_Boolean theValue5, const Standard_Boolean theValue6,
|
|
const Standard_Boolean theValue7);
|
|
|
|
private:
|
|
Standard_OStream* myStream; ///< pointer to the stream
|
|
uint64_t myPosition; ///< the current position relatively to the OStream position at the moment of creation of this class instance
|
|
Standard_Real myRealBuf[12]; ///< buffer for 12 reals storage
|
|
Standard_Integer myIntBuf[3]; ///< buffer for 3 integers storage
|
|
float myFloatBuf[3]; ///< buffer for 3 floats storage
|
|
};
|
|
|
|
#endif // _BinTools_OStream_HeaderFile
|