Auto Annotation

Automatically annotates scene objects with semantic labels for AI/segmentation.

Overview

util_autoAnnotation walks the scene tree and assigns annotation labels (e.g., BUILDINGS, NATURE, STREET) to objects that lack them. Uses fuzzy matching on shape names and object names to guess appropriate categories. Useful for generating training data for computer vision / semantic segmentation.

Extension path: lua/ge/extensions/util/autoAnnotation.lua

Exports (M)

Internals

Shape Name Matching

Objects are matched by their shapeName field against known patterns:

Unmatched shapes default to OBSTACLES.

Name Matching (GroundCover)

GroundCover objects use their name instead of shape:

Unmatched names default to NATURE.

Visitor Pattern

visitNode(parent, node) dispatches to class-specific visitors:

The walker recurses into children via getCount() / getObject().

Annotation Application

setAnnotation(node, annotation) sets:

• node.annotation = label string
• node.mode = "Override"
• Calls node:postApply() to commit changes

Only objects with empty annotation fields are modified.

How It Works

1. Call autoAnnotateLevel() to process the entire level.
2. The scenetree is walked starting from MissionGroup.
3. Each node is dispatched to its class visitor.
4. Visitors check the object's annotation field; if empty, guess from shape/name.
5. Forest items are handled separately via ForestItemDataSet.

Lua Examples

-- Annotate the entire current level
extensions.util_autoAnnotation.autoAnnotateLevel()

-- Annotate only the scenetree (no forests)
extensions.util_autoAnnotation.autoAnnotateScenetree()

-- Annotate only forest items
extensions.util_autoAnnotation.autoAnnotateGroups()

Additional Exports

• M.autoAnnotateGroups - (undocumented)
• M.autoAnnotateLevel - (undocumented)
• M.autoAnnotateScenetree - (undocumented)
• M.onInit - (undocumented)