OpenCAX/entry/src/main/cpp/include/opencascade/XCAFDoc_ClippingPlaneTool.hxx
2026-02-19 19:05:41 +08:00

122 lines
6.0 KiB
C++

// Created on: 2016-11-29
// Created by: Irina KRYLOVA
// Copyright (c) 2016 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 _XCAFDoc_ClippingPlaneTool_HeaderFile
#define _XCAFDoc_ClippingPlaneTool_HeaderFile
#include "gp_Pln.hxx"
#include "TCollection_HAsciiString.hxx"
#include "TDF_LabelSequence.hxx"
#include "TDataStd_GenericEmpty.hxx"
class XCAFDoc_ClippingPlaneTool;
DEFINE_STANDARD_HANDLE(XCAFDoc_ClippingPlaneTool, TDataStd_GenericEmpty)
//! Provide tool for management of ClippingPlane section of document.
//! Provide tool to store, retrieve, remove and modify clipping planes.
//! Each clipping plane consists of gp_Pln and its name.
class XCAFDoc_ClippingPlaneTool : public TDataStd_GenericEmpty
{
public:
Standard_EXPORT XCAFDoc_ClippingPlaneTool();
//! Creates (if not exist) ClippingPlaneTool.
Standard_EXPORT static Handle(XCAFDoc_ClippingPlaneTool) Set(const TDF_Label& theLabel);
Standard_EXPORT static const Standard_GUID& GetID();
//! returns the label under which ClippingPlanes are stored
Standard_EXPORT TDF_Label BaseLabel() const;
//! Returns True if label belongs to a ClippingPlane table and
//! is a ClippingPlane definition
Standard_EXPORT Standard_Boolean IsClippingPlane(const TDF_Label& theLabel) const;
//! Returns ClippingPlane defined by label lab
//! Returns False if the label is not in ClippingPlane table
//! or does not define a ClippingPlane
Standard_EXPORT Standard_Boolean GetClippingPlane(const TDF_Label& theLabel,
gp_Pln& thePlane,
TCollection_ExtendedString& theName,
Standard_Boolean& theCapping) const;
//! Returns ClippingPlane defined by label lab
//! Returns False if the label is not in ClippingPlane table
//! or does not define a ClippingPlane
Standard_EXPORT Standard_Boolean GetClippingPlane(const TDF_Label& theLabel,
gp_Pln& thePlane,
Handle(TCollection_HAsciiString)& theName,
Standard_Boolean& theCapping) const;
//! Adds a clipping plane definition to a ClippingPlane table and returns
//! its label (returns existing label if the same clipping plane
//! is already defined)
Standard_EXPORT TDF_Label AddClippingPlane(const gp_Pln& thePlane,
const TCollection_ExtendedString& theName,
const Standard_Boolean theCapping) const;
//! Adds a clipping plane definition to a ClippingPlane table and returns
//! its label (returns existing label if the same clipping plane
//! is already defined)
Standard_EXPORT TDF_Label AddClippingPlane(const gp_Pln& thePlane,
const Handle(TCollection_HAsciiString)& theName,
const Standard_Boolean theCapping) const;
//! Adds a clipping plane definition to a ClippingPlane table and returns
//! its label (returns existing label if the same clipping plane
//! is already defined)
Standard_EXPORT TDF_Label AddClippingPlane(const gp_Pln& thePlane,
const TCollection_ExtendedString& theName) const;
//! Adds a clipping plane definition to a ClippingPlane table and returns
//! its label (returns existing label if the same clipping plane
//! is already defined)
Standard_EXPORT TDF_Label AddClippingPlane(const gp_Pln& thePlane,
const Handle(TCollection_HAsciiString)& theName) const;
//! Removes clipping plane from the ClippingPlane table
//! Return false and do nothing if clipping plane is referenced in at least one View
Standard_EXPORT Standard_Boolean RemoveClippingPlane(const TDF_Label& theLabel) const;
//! Returns a sequence of clipping planes currently stored
//! in the ClippingPlane table
Standard_EXPORT void GetClippingPlanes(TDF_LabelSequence& Labels) const;
//! Sets new value of plane and name to the given clipping plane label
//! or do nothing, if the given label is not a clipping plane label
Standard_EXPORT void UpdateClippingPlane(const TDF_Label& theLabelL,
const gp_Pln& thePlane,
const TCollection_ExtendedString& theName) const;
//! Set new value of capping for given clipping plane label
Standard_EXPORT void SetCapping(const TDF_Label& theClippingPlaneL,
const Standard_Boolean theCapping);
//! Get capping value for given clipping plane label
//! Return capping value
Standard_EXPORT Standard_Boolean GetCapping(const TDF_Label& theClippingPlaneL) const;
//! Get capping value for given clipping plane label
//! Return true if Label is valid abd capping is exist.
Standard_EXPORT Standard_Boolean GetCapping(const TDF_Label& theClippingPlaneL,
Standard_Boolean& theCapping) const;
Standard_EXPORT const Standard_GUID& ID() const Standard_OVERRIDE;
DEFINE_DERIVED_ATTRIBUTE(XCAFDoc_ClippingPlaneTool, TDataStd_GenericEmpty)
};
#endif // _XCAFDoc_ClippingPlaneTool_HeaderFile