diff --git a/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadata.g.cs b/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadata.g.cs
index 1638a31..130940c 100644
--- a/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadata.g.cs
+++ b/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadata.g.cs
@@ -4,18 +4,28 @@
namespace WorldLabs
{
///
- /// Semantic metadata for world generation output.
+ /// Semantic metadata describing how to interpret the generated splat
+ /// asset in real-world units. The exported asset is in arbitrary model
+ /// units; apply the transform below to convert to a metric, ground-aligned
+ /// frame:
+ /// metric_xyz = raw_xyz * metric_scale_factor
+ /// aligned_xyz = metric_xyz - (0, ground_plane_offset, 0)
///
public sealed partial class WorldSemanticsMetadata
{
///
- ///
+ /// Vertical (Y-axis) offset, in meters, of the detected ground plane
+ /// in the metric-scaled frame. Subtract from Y after applying
+ /// `metric_scale_factor` to place the ground at y=0.
///
[global::System.Text.Json.Serialization.JsonPropertyName("ground_plane_offset")]
public double? GroundPlaneOffset { get; set; }
///
- ///
+ /// Multiplicative factor that converts raw asset coordinates to
+ /// meters. Multiply all XYZ positions (and isotropic scales) by this
+ /// value. A value of 1.0 means scale could not be inferred and the
+ /// asset was left in model units.
///
[global::System.Text.Json.Serialization.JsonPropertyName("metric_scale_factor")]
public double? MetricScaleFactor { get; set; }
@@ -29,8 +39,17 @@ public sealed partial class WorldSemanticsMetadata
///
/// Initializes a new instance of the class.
///
- ///
- ///
+ ///
+ /// Vertical (Y-axis) offset, in meters, of the detected ground plane
+ /// in the metric-scaled frame. Subtract from Y after applying
+ /// `metric_scale_factor` to place the ground at y=0.
+ ///
+ ///
+ /// Multiplicative factor that converts raw asset coordinates to
+ /// meters. Multiply all XYZ positions (and isotropic scales) by this
+ /// value. A value of 1.0 means scale could not be inferred and the
+ /// asset was left in model units.
+ ///
#if NET7_0_OR_GREATER
[global::System.Diagnostics.CodeAnalysis.SetsRequiredMembers]
#endif
diff --git a/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadataGroundPlaneOffset.g.cs b/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadataGroundPlaneOffset.g.cs
index 7f472f2..41eb1b5 100644
--- a/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadataGroundPlaneOffset.g.cs
+++ b/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadataGroundPlaneOffset.g.cs
@@ -4,7 +4,9 @@
namespace WorldLabs
{
///
- ///
+ /// Vertical (Y-axis) offset, in meters, of the detected ground plane
+ /// in the metric-scaled frame. Subtract from Y after applying
+ /// `metric_scale_factor` to place the ground at y=0.
///
public sealed partial class WorldSemanticsMetadataGroundPlaneOffset
{
diff --git a/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadataMetricScaleFactor.g.cs b/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadataMetricScaleFactor.g.cs
index 1e52457..98eecdc 100644
--- a/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadataMetricScaleFactor.g.cs
+++ b/src/libs/WorldLabs/Generated/WorldLabs.Models.WorldSemanticsMetadataMetricScaleFactor.g.cs
@@ -4,7 +4,10 @@
namespace WorldLabs
{
///
- ///
+ /// Multiplicative factor that converts raw asset coordinates to
+ /// meters. Multiply all XYZ positions (and isotropic scales) by this
+ /// value. A value of 1.0 means scale could not be inferred and the
+ /// asset was left in model units.
///
public sealed partial class WorldSemanticsMetadataMetricScaleFactor
{
diff --git a/src/libs/WorldLabs/openapi.yaml b/src/libs/WorldLabs/openapi.yaml
index b5df9b4..3dbe059 100644
--- a/src/libs/WorldLabs/openapi.yaml
+++ b/src/libs/WorldLabs/openapi.yaml
@@ -1176,18 +1176,34 @@ components:
title: WorldAssets
type: object
WorldSemanticsMetadata:
- description: Semantic metadata for world generation output.
+ description: |
+ Semantic metadata describing how to interpret the generated splat
+ asset in real-world units. The exported asset is in arbitrary model
+ units; apply the transform below to convert to a metric, ground-aligned
+ frame:
+
+ metric_xyz = raw_xyz * metric_scale_factor
+ aligned_xyz = metric_xyz - (0, ground_plane_offset, 0)
properties:
ground_plane_offset:
anyOf:
- type: number
- type: 'null'
title: Ground Plane Offset
+ description: |
+ Vertical (Y-axis) offset, in meters, of the detected ground plane
+ in the metric-scaled frame. Subtract from Y after applying
+ `metric_scale_factor` to place the ground at y=0.
metric_scale_factor:
anyOf:
- type: number
- type: 'null'
title: Metric Scale Factor
+ description: |
+ Multiplicative factor that converts raw asset coordinates to
+ meters. Multiply all XYZ positions (and isotropic scales) by this
+ value. A value of 1.0 means scale could not be inferred and the
+ asset was left in model units.
title: WorldSemanticsMetadata
type: object
WorldTextPrompt-Input: