mirror of
https://github.com/Open-Cascade-SAS/OCCT.git
synced 2026-07-09 11:57:58 +08:00
f751596e46
Redesign of selection mechanism: - implemented 3-level BVH tree for selection; - selection now calculates in 3D space; - intersection tests were moved to SelectMgr_BaseFrustum descendants; - removed .cdl files in Select3D and .cdl related to selection in MeshVS; - SelectMgr_ViewerSelectors are now shared between local and global contexts; - transformations of sensitive entities are now stored in SelectMgr_SelectableObject only. Sensitive entities are independent from transformations, it is applied to SelectMgr_SelectingVolumeManager instance only; - connected and multiple connected interactive objects are now represented by their child objects only for SelectMgr_SelectionManager; - if interactive object has child objects, they will be stored as separate objects in SelectMgr_SelectionManager now. - test cases bugs/vis/bug24623_1, bug24623_2, bug24623_3, bug24623_4 to test performance and memory issues.
258 lines
11 KiB
Plaintext
258 lines
11 KiB
Plaintext
-- Created on: 1995-02-20
|
|
-- Created by: Mister rmi
|
|
-- Copyright (c) 1995-1999 Matra Datavision
|
|
-- Copyright (c) 1999-2014 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.
|
|
|
|
deferred class SelectableObject from SelectMgr inherits PresentableObject from PrsMgr
|
|
|
|
---Purpose: A framework to supply the structure of the object to be
|
|
-- selected. At the first pick, this structure is created by
|
|
-- calling the appropriate algorithm and retaining this
|
|
-- framework for further picking.
|
|
-- This abstract framework is inherited in Application
|
|
-- Interactive Services (AIS), notably in AIS_InteractiveObject.
|
|
-- Consequently, 3D selection should be handled by the
|
|
-- relevant daughter classes and their member functions
|
|
-- in AIS. This is particularly true in the creation of new interactive objects.
|
|
|
|
|
|
uses
|
|
|
|
Box from Bnd,
|
|
SelectionManager from SelectMgr,
|
|
Selection from SelectMgr,
|
|
SequenceOfSelection from SelectMgr,
|
|
TypeOfPresentation3d from PrsMgr,
|
|
Drawer from Prs3d,
|
|
Presentation from Prs3d,
|
|
PresentationManager from PrsMgr,
|
|
PresentationManager3d from PrsMgr,
|
|
SequenceOfOwner from SelectMgr,
|
|
NameOfColor from Quantity,
|
|
EntityOwner from SelectMgr,
|
|
TransModeFlags from Graphic3d,
|
|
ZLayerId from Graphic3d
|
|
|
|
raises
|
|
NotImplemented from Standard
|
|
|
|
is
|
|
|
|
|
|
---Category: deferred Methods
|
|
|
|
|
|
Initialize(aTypeOfPresentation3d: TypeOfPresentation3d from PrsMgr = PrsMgr_TOP_AllView);
|
|
|
|
ComputeSelection(me:mutable; aSelection : Selection from SelectMgr;
|
|
aMode : Integer) is deferred;
|
|
---Purpose: Recovers and calculates any sensitive primitive,
|
|
-- aSelection, available in Shape mode, specified by
|
|
-- aMode. As a rule, these are sensitive faces.
|
|
-- This method is defined as virtual. This enables you to
|
|
-- implement it in the creation of a new class of AIS
|
|
-- Interactive Object. You need to do this and in so
|
|
-- doing, redefine this method, if you create a class
|
|
-- which enriches the list of signatures and types.
|
|
|
|
|
|
---Category:
|
|
|
|
|
|
RecomputePrimitives (me : mutable)
|
|
is static;
|
|
---Purpose: Re-computes the sensitive primitives for all modes. IMPORTANT: Do not use
|
|
-- this method to update selection primitives except implementing custom selection manager!
|
|
-- This method does not take into account necessary BVH updates, but may invalidate the pointers
|
|
-- it refers to. TO UPDATE SELECTION properly from outside classes, use method UpdateSelection.
|
|
|
|
RecomputePrimitives (me : mutable;
|
|
theMode : Integer from Standard)
|
|
is static;
|
|
---Purpose: Re-computes the sensitive primitives which correspond to the <theMode>th selection mode.
|
|
-- IMPORTANT: Do not use this method to update selection primitives except implementing custom selection manager!
|
|
-- selection manager! This method does not take into account necessary BVH updates, but may invalidate
|
|
-- the pointers it refers to. TO UPDATE SELECTION properly from outside classes, use method UpdateSelection.
|
|
|
|
|
|
AddSelection(me:mutable; aSelection : Selection from SelectMgr;
|
|
aMode : Integer)
|
|
is static;
|
|
---Purpose: Adds the selection aSelection with the selection mode
|
|
-- index aMode to this framework.
|
|
|
|
|
|
ClearSelections(me:mutable; update: Boolean from Standard = Standard_False) is static;
|
|
---Level: Public
|
|
---Purpose: Empties all the selections in the SelectableObject
|
|
-- <update> parameter defines whether all object's
|
|
-- selections should be flagged for further update or not.
|
|
-- This improved method can be used to recompute an
|
|
-- object's selection (without redisplaying the object
|
|
-- completely) when some selection mode is activated not for the first time.
|
|
|
|
Selection(me;aMode : Integer)
|
|
returns any Selection from SelectMgr
|
|
is static;
|
|
---C++: return const&
|
|
---Purpose: Returns the selection Selection having the selection mode aMode.
|
|
|
|
HasSelection(me; aMode: Integer)
|
|
returns Boolean from Standard is static ;
|
|
--- Purpose: Returns true if a selection corresponding to the
|
|
-- selection mode aMode is present in this framework.
|
|
|
|
|
|
|
|
Init(me:mutable) is static;
|
|
---Purpose: Begins the iteration scanning for sensitive primitives.
|
|
---C++: inline
|
|
|
|
|
|
More(me) returns Boolean is static;
|
|
---Purpose: Continues the iteration scanning for sensitive primitives.
|
|
---C++: inline
|
|
|
|
|
|
|
|
Next(me:mutable) is static;
|
|
---Purpose: Continues the iteration scanning for sensitive primitives.
|
|
---C++: inline
|
|
|
|
|
|
|
|
CurrentSelection(me) returns any Selection from SelectMgr;
|
|
---Purpose: Returns the current selection in this framework.
|
|
---C++: return const&
|
|
---C++: inline
|
|
|
|
|
|
ResetTransformation(me:mutable) is redefined static;
|
|
|
|
UpdateTransformation(me:mutable) is redefined virtual;
|
|
---Purpose: Recomputes the location of the selection aSelection.
|
|
|
|
UpdateTransformations(me:mutable;aSelection: Selection from SelectMgr) is virtual;
|
|
---Level: Public
|
|
---Purpose: Updates locations in all sensitive entities from <aSelection>
|
|
-- and in corresponding entity owners.
|
|
|
|
HilightSelected ( me : mutable; PM : PresentationManager3d from PrsMgr;
|
|
Seq : SequenceOfOwner from SelectMgr ) raises NotImplemented from Standard is virtual;
|
|
---Purpose: Method which draws selected owners ( for fast presentation draw )
|
|
|
|
ClearSelected ( me : mutable ) is virtual;
|
|
---Purpose: Method which clear all selected owners belonging
|
|
-- to this selectable object ( for fast presentation draw )
|
|
|
|
HilightOwnerWithColor ( me : mutable; thePM : PresentationManager3d from PrsMgr;
|
|
theColor : NameOfColor from Quantity;
|
|
theOwner : EntityOwner from SelectMgr ) raises NotImplemented from Standard is virtual;
|
|
---Purpose: Method which hilight an owner belonging to
|
|
-- this selectable object ( for fast presentation draw )
|
|
|
|
IsAutoHilight ( me ) returns Boolean from Standard is virtual;
|
|
---Purpose: If returns True, the old mechanism for highlighting
|
|
-- selected objects is used (HilightSelected Method may be empty).
|
|
-- If returns False, the HilightSelected method will be
|
|
-- fully responsible for highlighting selected entity
|
|
-- owners belonging to this selectable object.
|
|
|
|
SetAutoHilight ( me : mutable; newAutoHilight : Boolean from Standard ) is virtual;
|
|
---Purpose: Set AutoHilight property to true or false
|
|
|
|
-- SetTransformPersistence( me : mutable;
|
|
-- aFlag : TransModeFlags from Graphic3d ) is redefined;
|
|
---Level: Public
|
|
---Purpose: Sets up Transform Persistence Mode for this object
|
|
---Category: Graphic attributes management
|
|
|
|
GetHilightPresentation( me: mutable;
|
|
TheMgr: PresentationManager3d from PrsMgr ) returns Presentation from Prs3d is static;
|
|
|
|
GetSelectPresentation( me: mutable;
|
|
TheMgr: PresentationManager3d from PrsMgr ) returns Presentation from Prs3d is static;
|
|
|
|
SetZLayer ( me : mutable;
|
|
theLayerId : ZLayerId from Graphic3d )
|
|
is redefined virtual;
|
|
---Purpose: Set Z layer ID and update all presentations of the selectable object.
|
|
-- The layers mechanism allows drawing objects in higher layers in overlay of objects in lower layers.
|
|
|
|
UpdateSelection ( me : mutable;
|
|
theMode : Integer from Standard = -1)
|
|
is static;
|
|
---Purpose: Sets update status FULL to selections of the object. Must be used as the only method of UpdateSelection
|
|
-- from outer classes to prevent BVH structures from being outdated.
|
|
|
|
BoundingBox (me : mutable;
|
|
theBndBox : out Box from Bnd)
|
|
is deferred;
|
|
---Purpose: Returns bounding box of selectable object
|
|
-- by storing its minimum and maximum 3d coordinates
|
|
-- to output parameters
|
|
|
|
SetAttributes(me:mutable; theDrawer: Drawer from Prs3d) is virtual;
|
|
---Purpose: Initializes the drawing tool theDrawer.
|
|
|
|
Attributes(me) returns any Drawer from Prs3d;
|
|
---C++: return const&
|
|
---C++: inline
|
|
---Purpose: Returns the attributes settings.
|
|
|
|
UnsetAttributes(me:mutable) is virtual;
|
|
---Purpose: Clears settings provided by the drawing tool theDrawer.
|
|
|
|
SetHilightAttributes(me:mutable; theDrawer: Drawer from Prs3d) is virtual;
|
|
---Purpose: Initializes the hilight drawing tool theDrawer.
|
|
|
|
HilightAttributes(me) returns any Drawer from Prs3d;
|
|
---C++: return const&
|
|
---C++: inline
|
|
---Purpose: Returns the hilight attributes settings.
|
|
|
|
UnsetHilightAttributes(me:mutable) is virtual;
|
|
---Purpose: Clears settings provided by the hilight drawing tool theDrawer.
|
|
|
|
InitDefaultHilightAttributes(myclass; theDrawer : Drawer from Prs3d);
|
|
---Purpose: Initializes theDrawer by default hilight settings.
|
|
|
|
SetAssemblyOwner (me : mutable;
|
|
theOwner : EntityOwner from SelectMgr;
|
|
theMode : Integer from Standard = -1);
|
|
---Purpose: Sets common entity owner for assembly sensitive object entities
|
|
|
|
GetAssemblyOwner (me)
|
|
returns EntityOwner from SelectMgr
|
|
is static;
|
|
---C++: return const&
|
|
---Purpose: Returns common entity owner if the object is an assembly
|
|
|
|
fields
|
|
|
|
myselections : SequenceOfSelection is protected;
|
|
myDrawer : Drawer from Prs3d is protected;
|
|
myHilightDrawer : Drawer from Prs3d is protected;
|
|
myAssemblyOwner : EntityOwner from SelectMgr is protected;
|
|
mycurrent : Integer;
|
|
myAutoHilight : Boolean from Standard;
|
|
|
|
mySelectionPrs : Presentation from Prs3d;
|
|
myHilightPrs : Presentation from Prs3d;
|
|
|
|
friends
|
|
class SelectionManager from SelectMgr
|
|
|
|
end SelectableObject;
|