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: