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