opencascade AIS_InteractiveContext源码学习4 object local transformation management

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 的对象本地变换管理功能，对每个对象进行灵活的位置调整和变换，从而实现更复杂的场景布局和视觉效果。