标记点
关卡标记点是用于编辑器工作的空间标注。它们可以记录标题、正文、标签、评论、类型、位置以及可选的已保存视口视图，但不会成为地图的一部分。
存储和地图安全
Section titled “存储和地图安全”| 范围 | 存储 | 版本控制行为 |
|---|---|---|
| 共享 | <Project>/ProjectPins/ |
可用时使用活动的 Unreal 版本控制提供程序 |
| 私有 | <Project>/Saved/Locus/PrivatePins/ |
永远不会查询或更改提供程序 |
每个标记点都是外部 .locuspin 文件。标记点不是 Actor、Component、UAsset、软件包、地图元数据、运行时对象或烘焙数据所有者。创建、移动、编辑或删除标记点本身不会将地图包标记为已修改。
- 当前地图显示与当前解析出的已保存地图关联的标记点。
- 所有地图按地图将项目标记点分组，而不会加载这些地图。
标记点与其引用的地图彼此分离。复制地图不会复制或重新定位标记点。如果地图移动，Locus 可能会解析 Asset Registry 重定向，但不会静默重写每个标记点文件。
将搜索和标签与紧凑型 类型、状态 和 Assignee 过滤器结合起来。 标记点 类型有 默认、重要、问题、信息 和 成功；状态独立为 开放 或 已解决。共享 标记点 使用可搜索的人员选择器； 我 使用 您的显示名称，而私有 标记点 仍然是 未分配。
请先打开并保存目标关卡。未保存或临时世界不支持持久标记点。
- 放置标记点（Ctrl+Alt+P）放置一个标记点。下一次单击有效表面时会创建标记点并结束放置标记点。如果单击未找到有效表面，放置仍保持就绪状态。再次按 Ctrl+Alt+P 或按 Esc 可取消。
- 标记点工作区中的放置模式是连续的：每次单击有效表面都会创建一个标记点，直到你再次选择放置模式或按 Esc。
- 标记点工作区中的添加标记点无需单击视口即可创建标记点。
- 关卡编辑器视口上下文菜单中的 Locus > 在这里创建收藏会在单击位置创建标记点。
当放置标记点、放置模式或移动标记点处于活动状态时，视口会显示一个明确标示当前状态的指示器；放置标记点和放置模式还会显示共享或私有创建范围。切换地图、开始 Play 或 Simulate，或隐藏关卡标记点时，放置也会结束。
Ctrl+Click 是 Unreal 视口的原生选择操作。Locus 不再使用它放置标记点。
在视口或工作区中选择标记点，可以编辑其标题、正文、标签、类型和评论。类型包括默认、重要、问题、信息和成功。评论是按时间排序的扁平列表，不提供线程、反应或通知。
标记点的 标签 字段使用与笔记相同的芯片编辑器。输入标签并按 Enter 添加，或选择芯片上的 × 移除该标签。空标签和不区分大小写的重复标签会被拒绝，批量添加标签和移除标签遵循相同的标签规则。
视口快速操作
Section titled “视口快速操作”在视口中选择一个处于活动状态且已保存的标记点，即可在标记点上显示紧凑的快速操作：
- 单击状态区段，直接解决或重新打开标记点。
- 打开更多操作，可更改类型或分配该标记点，也可在标记点工作区中打开详情。
- 选择记笔记，打开已将该标记点附加为引用的快速捕获。新笔记独立于该标记点及其评论；私有标记点只能从私有笔记中引用。
这些紧凑操作就是标记点的操作界面；右键单击标记点不会打开标记点操作菜单。快速操作与标记点工作区使用相同的编辑、签出和只读保护措施。
编辑多个标记点
Section titled “编辑多个标记点”使用 Ctrl/Shift-click 选择多个标记点，然后在选择面板或列表的批量操作菜单中使用状态、类型、分配、添加标签或移除标签。如果所选标记点的字段值不同，则显示混合。这些非破坏性编辑完成后仍会保留选择，因此可以连续应用多个更改。删除所选 Locus 标记点仍是需要确认的独立操作。
批量编辑遵循与单个标记点编辑相同的安全规则。如果任何所选标记点无法编辑或签出，批量编辑将不可用；受控共享标记点在更改前会通过正常的提供程序工作流签出。批量操作不会在共享和私有范围之间转换标记点，分配提供可用的受让人选项，而不是自由文本输入。
创建区域结合了共享/私有范围、可选的标记点预设和视口菜单。预设对于用户和项目而言是个人的，仅包含标记点类型和标签，并且仅适用于今后通过添加标记点、放置标记点（Ctrl+Alt+P）、放置模式或 Locus > 在这里创建收藏创建的标记点。
位置和已保存视图
Section titled “位置和已保存视图”- 拖动锚点以更改三个轴上的位置。
- 垂直拖动标记头以调整高度。
- 按 End 将选中的锚点向下吸附到表面。
- 按 F 聚焦选中的标记点。
- 捕获视图会将当前编辑器视口视图与标记点一起保存；捕获过视图后，恢复视图可以返回该视图。
- 移动标记点会在下一次单击有效表面时重新放置选中的标记点，并在成功移动后结束。它可以更改标记点的所属关卡。如果在移动标记点处于活动状态时失去所选标记点，移动标记点会结束，且不会创建新的标记点。
每个标记点可以存储一个可选的视口Snapshot。从可用视角 Level Editor 视口捕获，打开更大的预览，然后使用 更新快照 或 清除快照。共享映像是一个单独的源代码控制文件；私有映像保留在 Saved 下的本地，删除 标记点 会将其删除。
编辑会自动保存。按 Ctrl+S 写入或重试保存。
经典流式加载子关卡
Section titled “经典流式加载子关卡”关卡标记点支持经典流式加载子关卡：
- 交互式放置遵循 Unreal 的当前关卡。放置在持久（主）关卡中的标记点行为与以前相同。
- 由经典流式加载子关卡所属的标记点遵循该关卡的 Editor 可见性，因此当其所属关卡被隐藏或卸载时，标记点也会隐藏。
- 已锁定的当前子关卡会拒绝放置。隐藏的当前子关卡仍可接收标记点；Locus 会显示通知，并且标记点会保持隐藏，直到该关卡显示。
- 标记点工作区会显示子关卡所属标记点的所属关卡。
- 移动标记点可以更改所属关卡。普通拖动和 End 吸附会保留当前所属关卡。
- 前往针只移动摄像机；不会更改关卡可见性、加载状态或当前关卡。
- 标记点锚点保持在世界空间中。移动或变换子关卡不会移动其标记点。
- 添加标记点创建持久关卡标记点，MCP
locus.create_pin工具也只创建持久关卡标记点。 - 不支持 Level Instance 的标记点所属关系。
视口可见性开关与放置模式相互独立。标题显示支持始终、选中时、悬停时、附近和自适应行为。遮挡选项包括始终可见、视线、穿过几何体选择和降低不透明度。
个人标记点设置控制附近标题距离、最大标记高度、标记和连接线呈现以及放置动画。这些偏好只影响编辑器呈现，不会更改地图或权威标记点内容。请参阅设置。
最常用的视觉控制包括：用于调节额外发光能量的 辉光强度、用于调节持续显示核心线的 连接线粗细，以及用于选择语义色或自定义强调色的 连接线和圆环颜色模式。
仅显示已筛选的标记点 默认关闭，并镜像当前地图、范围、搜索、标签、类型、状态和受让人结果。 场景深度使用场景几何体进行深度遮挡； 视线 是默认的碰撞跟踪行为。选定的和活动的评论 标记点 仍然位于前景中。
搜索、复制和删除
Section titled “搜索、复制和删除”搜索和筛选器根据面向用户的字段以及地图/范围上下文缩小标记点范围。Ctrl+D复制选中的标记点。删除请求永久删除并需要确认。无法通过 Unreal 撤销恢复已删除的外部标记点文件。
审阅 N 对过滤结果开始级别审查。 上一个标记点、下一个标记点循环遍历； 退出审阅 保留选择。 All Maps Review 确认使用 打开关卡、跳过标记点 或 取消 进行跨地图导航。审核状态仅限于会话。
共享标记点的恢复快照存储在 <Project>/Saved/ProjectPins/Recovery/，私有标记点的恢复快照存储在 <Project>/Saved/Locus/Recovery/PrivatePins/。恢复操作包括恢复快照、恢复为新标记点和丢弃快照。
如果本地编辑待处理时 .locuspin 在外部发生更改，Locus 会阻止静默替换，并提供从磁盘重新加载或将本地工作保存为新标记点等安全冲突操作。请参阅故障排除。
新的共享 标记点 保持本地状态，Untracked 保持本地状态，直到您明确选择 标记为添加；符合条件的多选 标记点 可以一起添加。受控共享 标记点 在受支持的突变之前自动请求签出。共享快照图像具有单独的添加或签出状态。
私人 标记点 保留在本地，并且永远不会联系提供商。如果没有配置提供程序，本地模式允许编辑并且不显示特定于源代码管理的 UI。 Locus 不提交、同步、管理更改列表或更改类型映射。
随着空间变窄，操作会移入省略号菜单，范围会变成紧凑菜单，元数据会堆叠，快照缩略图会缩小，然后才会变成图标。在极端宽度下，列表和详细信息将成为 返回标记点 的主/详细视图；注释换行以保持操作可达。
- 持久放置需要已保存的顶层世界。
- 不支持 Level Instance 的标记点所属关系。
- 复制地图不会复制或重新定位标记点。
- 对于当前已验证发布矩阵之外的提供程序和复杂世界工作流，依赖前应由项目自行验证。
- 批量编辑无法更改共享/私有范围，并且如果任何所选标记点无法编辑或签出，则不可用。
快照捕获需要可用的透视 Level Editor 视口，并且在 PIE 期间不可用。无法编辑或删除现有评论。