Skip to content

Interface: LabelsManager

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:16

序号标签:视图级编号 + members + 气泡位置 + 样式 + 视图级撤销。 经 viewer.labels 访问,不要直接构造。

Methods

addLabel()

addLabel(nodeId, pos?, anchorWorld?): number

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:63

Parameters

nodeId

NodeId

pos?
x

number

y

number

anchorWorld?

Vec3

Returns

number


applyView()

applyView(labels, style?): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:279

Parameters

labels

ViewLabel[]

style?

LabelStyle

Returns

void


beginMove()

beginMove(number): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:195

Parameters

number

number

Returns

void


captureView()

captureView(): object

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:275

Returns

object

labels

labels: ViewLabel[]

style

style: LabelStyle


clearViewLabels()

clearViewLabels(): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:259

Returns

void


commitMove()

commitMove(): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:200

Returns

void


count()

count(): number

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:184

Returns

number


deleteLabel()

deleteLabel(number): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:250

Parameters

number

number

Returns

void


dispose()

dispose(): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:320

Returns

void


getLabelAnchorScreen()

getLabelAnchorScreen(number): { behind: boolean; x: number; y: number; } | null

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:301

号 → 锚点屏幕坐标。按 members 顺序找第一个投影 !behind 的成员:

  • 代表件(members[0]):若 label.anchor 存在且 localToWorld 可用 → localToWorld(anchor) 取世界点;否则 getAnchorWorld(包围盒中心)。
  • 其余成员(遮挡兜底):getAnchorWorld。 全不可见或号不存在 → null(该号本视图休眠)。

Parameters

number

number

Returns

{ behind: boolean; x: number; y: number; } | null


list()

list(): object

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:180

Returns

object

labels

labels: ViewLabel[]

style

style: LabelStyle


memberOf()

memberOf(nodeId): number | undefined

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:57

Parameters

nodeId

NodeId

Returns

number | undefined


mergeNumbers()

mergeNumbers(numbers): number

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:206

Parameters

numbers

number[]

Returns

number


moveLabel()

moveLabel(number, pos): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:188

Parameters

number

number

pos
x

number

y

number

Returns

void


pruneMembersSilent()

pruneMembersSilent(leafIds): LabelMembership[]

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:102

静默批量从 ACTIVE 视图所有号移除 leafIds 成员(删除原子事务用)。 号被清空则整号删除,membership 带 removedLabel 以便重建。 不压撤销栈;有实际改动时发一次 labels-changed;返回 memberships 供 restore。

Parameters

leafIds

readonly NodeId[]

Returns

LabelMembership[]


relateSameMesh()

relateSameMesh(nodeId): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:166

把 nodeId 所属号的代表件(members[0])同 meshId 的全部实例并入 members,去重排序后压入撤销历史。 nodeId 未贴号、sameMeshNodes 未注入或已 disposed 时静默返回。

Parameters

nodeId

NodeId

Returns

void


removeMember()

removeMember(nodeId): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:84

Parameters

nodeId

NodeId

Returns

void


renumber()

renumber(): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:237

Returns

void


restoreMembersSilent()

restoreMembersSilent(memberships): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:139

pruneMembersSilent 的严格逆:号仍在 → 按 indexInMembers 原位插回; 号已删(带 removedLabel)→ 从 removedLabel 整号重建(幂等:同号重复 membership 不重复插入)。 不压撤销栈;memberships 非空时发一次 labels-changed。

Parameters

memberships

readonly LabelMembership[]

Returns

void


setNumber()

setNumber(fromNumber, toNumber): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:224

Parameters

fromNumber

number

toNumber

number

Returns

void


setStyle()

setStyle(patch): void

Defined in: packages/viewer-core/src/public/managers/LabelsManager.ts:267

Parameters

patch

Partial<LabelStyle>

Returns

void