AIS_InteractiveContext
前言
交互上下文(Interactive Context)允许您在一个或多个视图器中管理交互对象的图形行为和选择。类方法使这一操作非常透明。需要记住的是,对于已经被交互上下文识别的交互对象,必须使用上下文方法进行修改。如果交互对象尚未加载到交互上下文中,您才能直接调用交互对象的方法。
每个可选择的对象必须指定负责整体选择对象的选择模式(全局选择模式)。交互上下文本身支持使用选择过滤器进行分解对象的选择。默认情况下,全局选择模式等于0,但如果需要,可以重新定义。
object local transformation management
38:SetLocation
将位置放在对象的初始图形表示和选择上。
39:ResetLocation
将对象放回其初始位置。
40:HasLocation
如果对象有位置,则返回 true。
41:Location
返回对象的位置。
42:SetTransformPersistence
设置变换持久性。
mouse picking logic (detection and dynamic highlighting of entities under cursor)鼠标选择逻辑(检测和动态突出显示光标下的实体)。
43:SetPixelTolerance
设置 MoveTo() 操作的像素容差。
44:PixelTolerance
返回像素容差,默认为 2。像素容差扩展了 MoveTo() 操作中的灵敏度(通过点拾取),可以根据用户输入精度(例如屏幕像素密度、输入设备精度等)由应用程序进行调整。
45:SetSelectionSensitivity
允许管理交互对象 theObject 的特定选择的灵敏度,并将选择中以 theMode 为前提的所有敏感实体的先前灵敏度值更改为给定的 theNewSensitivity。
46:LastActiveView
返回上一个活动视图(MoveTo()/Select() 方法的参数)。
47:MoveTo
重载1:将轴 theAxis 传递给交互上下文选择器。这是由视图 theView 通过将该轴传递给主观察者并更新来完成的。如果将 ToRedrawOnUpdate 设置为 false,则被调用者应该调用 RedrawImmediate() 来突出显示检测到的对象。
重载2:突出显示检测到的对象。如果将 ToRedrawOnUpdate 设置为 false,则被调用者应该调用 RedrawImmediate() 来更新视图。
重载3:将以像素为单位的鼠标位置 theXPix 和 theYPix 转发给交互上下文选择器。这是通过视图 theView 将该位置传递给主观察者并更新来完成的。如果将 ToRedrawOnUpdate 设置为 false,则被调用者应该调用 RedrawImmediate() 来突出显示检测到的对象。
另请参阅
- PickingStrategy()
- HighlightStyle() 定义检测到的所有者的默认动态突出显示样式(Prs3d_TypeOfHighlight_Dynamic 和 Prs3d_TypeOfHighlight_LocalDynamic)
- PrsMgr_PresentableObject::DynamicHilightAttributes() 定义检测到的所有者的每个对象动态突出显示样式(覆盖默认值)
48:ClearDetected
清除由 MoveTo() 检测到的实体列表,并重置动态突出显示。
参数
- theToRedrawImmediate:如果为 TRUE,则主 Viewer 将在更新时重绘
返回值
- 如果视图需要更新(例如,实际上存在动态突出显示的实体),则返回 TRUE
49:HasDetected
如果上下文中有鼠标检测到的实体,则返回 true。
另请参阅
- DetectedOwner()
- HasNextDetected()
- HilightPreviousDetected()
- HilightNextDetected()
50:DetectedOwner
返回当前动态突出显示的检测到的敏感原始物的所有者。警告!此方法与 InitDetected()/MoreDetected()/NextDetected() 无关。
另请参阅
- HasDetected()
- HasNextDetected()
- HilightPreviousDetected()
- HilightNextDetected()
51:DetectedInteractive
返回上下文中最后检测到的交互对象。通常,这只是 DetectedOwner()->Selectable() 的 Handle(AIS_InteractiveObject)::DownCast() 包装。
另请参阅
- DetectedOwner()
52:HasDetectedShape
如果本地上下文中存在检测到的形状,则返回 true。
另请参阅
- HasDetected()
- DetectedShape()
已弃用:
(“本地上下文已弃用 - 应该使用无本地上下文的本地选择”)
53:DetectedShape
返回本地上下文中检测到的形状。
另请参阅
- DetectedOwner()
已弃用:
(“本地上下文已弃用 - 应该使用无本地上下文的本地选择”)
54:HasNextDetected
如果在上次鼠标检测中检测到了其他实体,则返回 True。
另请参阅
- HilightPreviousDetected()
- HilightNextDetected()
56:HilightNextDetected
如果选择器检测到多个对象,则只有“最佳”所有者会在鼠标位置突出显示。该方法允许用户依次突出显示其他检测到的实体。如果调用 select 方法,则所选实体将成为突出显示的实体!警告:循环方法。当所有检测到的实体都已突出显示时,下一次调用将再次突出显示第一个实体。
返回值:
突出显示实体的排名
另请参阅:
- HasNextDetected()
- HilightPreviousDetected()
57:HilightPreviousDetected
与前面的方法相同,但是在相反的方向上。
另请参阅:
- HasNextDetected()
- HilightNextDetected()
iteration through detected entities 迭代检测到的实体
58:InitDetected
初始化迭代器,以便在交互上下文中或本地上下文中(如果已打开)迭代鼠标检测到的对象。
另请参阅:
- DetectedCurrentOwner()
- MoreDetected()
- NextDetected()
60:MoreDetected
如果在迭代鼠标检测到的交互对象期间,当前对象之后还有更多鼠标检测到的对象,则返回 TRUE。
另请参阅:
- DetectedCurrentOwner()
- InitDetected()
- NextDetected()
61:NextDetected
在迭代鼠标检测到的交互对象期间获取下一个当前对象。
另请参阅:
- DetectedCurrentOwner()
- InitDetected()
- MoreDetected()
62:DetectedCurrentOwner
返回由当前迭代器位置指向的检测到列表中的所有者。警告!此方法与 DetectedOwner() 无关,后者返回最后选择的所有者,而不管迭代器位置如何!
另请参阅:
- InitDetected()
- MoreDetected()
- NextDetected()
用法用例
在OpenCASCADE中,AIS_InteractiveContext
提供了管理对象本地变换(local transformation)的功能,允许用户对每个交互式对象应用独立的变换,例如平移、旋转和缩放。以下是关于 AIS_InteractiveContext
中对象本地变换管理的常见用法和用例:
1. 设置对象的本地变换
-
平移对象:
gp_Trsf translation; translation.SetTranslation(gp_Vec(dx, dy, dz)); myContext->SetLocation(anObject, translation);
使用
SetLocation()
方法将对象anObject
平移至指定的偏移量(dx, dy, dz)
处。 -
旋转对象:
gp_Trsf rotation; rotation.SetRotation(gp_Ax1(origin, direction), angleInRadians); myContext->SetLocation(anObject, rotation);
使用
SetLocation()
方法将对象anObject
绕给定轴(origin, direction)
旋转指定的角度(弧度)。 -
缩放对象:
gp_Trsf scaling; scaling.SetScale(center, scaleFactor); myContext->SetLocation(anObject, scaling);
使用
SetLocation()
方法将对象anObject
绕指定中心点center
缩放到指定的比例因子scaleFactor
。
2. 获取对象的本地变换
-
获取对象的当前变换状态:
gp_Trsf currentTransform = myContext->Location(anObject);
使用
Location()
方法获取对象anObject
当前的本地变换状态。
3. 重置对象的本地变换
-
重置对象的本地变换为默认状态:
myContext->ResetLocation(anObject);
使用
ResetLocation()
方法将对象anObject
的本地变换重置为默认状态,即恢复到未经过任何变换的初始状态。
4. 应用本地变换与全局变换的区别
-
应用全局变换:
myContext->SetTransformation(translation);
使用
SetTransformation()
方法设置全局变换,将影响场景中所有对象的显示位置。与之相反,对象本地变换仅影响单个对象的显示位置,不会影响其他对象。
5. 高级变换操作
-
组合多个变换操作:
gp_Trsf combinedTransform; combinedTransform.SetTranslation(gp_Vec(dx, dy, dz)); combinedTransform.SetRotation(gp_Ax1(origin, direction), angleInRadians); combinedTransform.SetScale(center, scaleFactor); myContext->SetLocation(anObject, combinedTransform);
可以组合多个变换操作(如平移、旋转、缩放)并将它们应用于对象
anObject
。
相关类和方法:
AIS_InteractiveContext
: 主要类,用于管理交互式对象、选择和操作。gp_Trsf
: 用于表示3D变换(平移、旋转、缩放)的类。gp_Vec
: 用于表示3D向量的类。gp_Ax1
: 用于表示3D轴线的类。
通过这些用例,可以看到如何利用 AIS_InteractiveContext
的对象本地变换管理功能,对每个对象进行灵活的位置调整和变换,从而实现更复杂的场景布局和视觉效果。