MapSet Alignment

The MapSet Alignment Tool is a utility scene designed to help you manually correct alignment and merge errors in your MapSets.

While MultiSet automatically merges maps, complex environments may sometimes result in slight misalignments. This tool allows you to download the specific MapSet geometry into the Unity Editor, visually adjust the transforms (position and rotation) of individual maps, and push those corrected poses back to the server to fix the MapSet permanently.

Use this tool if:

• You notice visual "drift" or "ghosting" in a merged MapSet.

• Maps within a set are not aligning correctly relative to one another.

• You want to fine-tune the spatial relationship between maps after creation.

• Your Maps are huge and you can't use the Developer portal for manual alignment

Component Reference

1. MapSet Alignment Manager

This is the main controller script found on the root object in the scene. It handles communication with the MultiSet server.

Configuration:

• Map Space GameObject: The parent GameObject in your scene hierarchy under which the map meshes will be spawned.

• MapSet Code: The unique identifier (ID) of the MapSet you wish to edit (e.g., MSET_0AJ28...).

Actions:

• Download MapSet Data: Fetches the map meshes and current pose data from the cloud and instantiates them in the scene.

• Update All Modified Poses: Sends the new transform values of all modified maps back to the server. This button becomes active (Green) only when changes are detected.

2. Map Data Reference

This script is automatically attached to each individual map object spawned inside the Map Space. It acts as a monitor for that specific map's data.

Features:

• Map Identification: Displays the unique Map Code and Name.

• Current Pose (From Transform): Real-time readout of the object's Position and Rotation in the Unity scene.

• Unsaved Changes Warning: A yellow warning icon appears if the object has been moved from its original server position.

---

Workflow: How to Fix Alignment Errors

Follow these steps to manually realign a MapSet:

Step 1: Load the MapSet

1. Open the MapSet Alignment Tool scene.

2. Locate the MapSet Alignment Manager in the hierarchy.

3. Paste your target MapSet Code into the inspector.

4. Click Download MapSet Data.

   • The tool will download the meshes for all maps in the set and place them as children of the "Map Space" object.

Step 2: Visual Alignment

1. Navigate to the Scene View.

2. Select the specific Map object in the Hierarchy that looks misaligned (children of Map Space).

3. Use standard Unity Transform Tools (Move W and Rotate E) to align the mesh so it matches perfectly with the other maps in the set.

   • Note: As you move the object, the Map Data Reference component will show a warning: "This map has unsaved pose changes."

Step 3: Validate Changes

1. Look at the MapSet Alignment Manager inspector.

2. Under the "Maps List" or status section, you will see a count of Modified Maps.

3. Ensure only the maps you intended to move are counted.

Step 4: Save to Server

1. Click the green Update All Modified Poses button on the Manager script.

2. The tool will upload the new transforms to the MultiSet cloud.

3. Once complete, the warning icons will disappear, and your MapSet is now updated with the corrected alignment.

---