@foxglove/schemas 0.4.0 → 0.5.0

package/schemas/typescript/LinePrimitive.ts

@@ -0,0 +1,37 @@
+// Generated by https://github.com/foxglove/schemas
+
+import { Color } from "./Color";
+import { LineType } from "./LineType";
+import { Point3 } from "./Point3";
+import { Pose } from "./Pose";
+
+/** (Experimental, subject to change) A primitive representing a series of points connected by lines */
+export type LinePrimitive = {
+  /** Drawing primitive to use for lines */
+  type: LineType;
+
+  /** Origin of lines relative to reference frame */
+  pose: Pose;
+
+  /** Line thickness */
+  thickness: number;
+
+  /** Indicates whether `thickness` is a fixed size in screen pixels (true), or specified in world coordinates and scales with distance from the camera (false) */
+  scale_invariant: boolean;
+
+  /** Points along the line */
+  points: Point3[];
+
+  /** Solid color to use for the whole line. One of `color` or `colors` must be provided. */
+  color: Color;
+
+  /** Per-point colors (if specified, must have the same length as `points`). One of `color` or `colors` must be provided. */
+  colors: Color[];
+
+  /**
+   * Indices into the `points` and `colors` attribute arrays, which can be used to avoid duplicating attribute data.
+   * 
+   * If omitted or empty, indexing will not be used. This default behavior is equivalent to specifying [0, 1, ..., N-1] for the indices (where N is the number of `points` provided).
+   */
+  indices: number[];
+};

package/schemas/typescript/LineType.ts

@@ -0,0 +1,13 @@
+// Generated by https://github.com/foxglove/schemas
+
+/** (Experimental, subject to change) An enumeration indicating how input points should be interpreted to create lines */
+export enum LineType {
+  /** 0-1, 1-2, ..., (n-1)-n */
+  LINE_STRIP = 0,
+
+  /** 0-1, 1-2, ..., (n-1)-n, n-0 */
+  LINE_LOOP = 1,
+
+  /** 0-1, 2-3, 4-5, ... */
+  LINE_LIST = 2,
+}

package/schemas/typescript/ModelPrimitive.ts

@@ -0,0 +1,29 @@
+// Generated by https://github.com/foxglove/schemas
+
+import { Color } from "./Color";
+import { Pose } from "./Pose";
+import { Vector3 } from "./Vector3";
+
+/** (Experimental, subject to change) A primitive representing a 3D model file loaded from an external URL or embedded data */
+export type ModelPrimitive = {
+  /** Origin of model relative to reference frame */
+  pose: Pose;
+
+  /** Scale factor to apply to the model along each axis */
+  scale: Vector3;
+
+  /** Solid color to use for the whole model if `override_color` is true. */
+  color: Color;
+
+  /** Whether to use the color specified in `color` instead of any materials embedded in the original model. */
+  override_color: boolean;
+
+  /** URL pointing to model file. One of `url` or `data` should be provided. */
+  url: string;
+
+  /** [Media type](https://developer.mozilla.org/en-US/docs/Web/HTTP/Basics_of_HTTP/MIME_types) of embedded model (e.g. `model/gltf-binary`). Required if `data` is provided instead of `url`. Overrides the inferred media type if `url` is provided. */
+  media_type: string;
+
+  /** Embedded model. One of `url` or `data` should be provided. If `data` is provided, `media_type` must be set to indicate the type of the data. */
+  data: Uint8Array;
+};

package/schemas/typescript/SceneEntity.ts

@@ -0,0 +1,58 @@
+// Generated by https://github.com/foxglove/schemas
+
+import { ArrowPrimitive } from "./ArrowPrimitive";
+import { CubePrimitive } from "./CubePrimitive";
+import { CylinderPrimitive } from "./CylinderPrimitive";
+import { Duration } from "./Duration";
+import { KeyValuePair } from "./KeyValuePair";
+import { LinePrimitive } from "./LinePrimitive";
+import { ModelPrimitive } from "./ModelPrimitive";
+import { SpherePrimitive } from "./SpherePrimitive";
+import { TextPrimitive } from "./TextPrimitive";
+import { Time } from "./Time";
+import { TriangleListPrimitive } from "./TriangleListPrimitive";
+
+/** (Experimental, subject to change) A visual element in a 3D scene. An entity may be composed of multiple primitives which all share the same frame of reference. */
+export type SceneEntity = {
+  /** Timestamp of the entity */
+  timestamp: Time;
+
+  /** Frame of reference */
+  frame_id: string;
+
+  /** Identifier for the entity. A entity will replace any prior entity on the same topic with the same `id`. */
+  id: string;
+
+  /** Length of time (relative to `timestamp`) after which the entity should be automatically removed. Zero value indicates the entity should remain visible until it is replaced or deleted. */
+  lifetime: Duration;
+
+  /** Whether the entity should keep its location in the fixed frame (false) or follow the frame specified in `frame_id` as it moves relative to the fixed frame (true) */
+  frame_locked: boolean;
+
+  /** Additional user-provided metadata associated with the entity. Keys must be unique. */
+  metadata: KeyValuePair[];
+
+  /** Arrow primitives */
+  arrows: ArrowPrimitive[];
+
+  /** Cube primitives */
+  cubes: CubePrimitive[];
+
+  /** Sphere primitives */
+  spheres: SpherePrimitive[];
+
+  /** Cylinder primitives */
+  cylinders: CylinderPrimitive[];
+
+  /** Line primitives */
+  lines: LinePrimitive[];
+
+  /** Triangle list primitives */
+  triangles: TriangleListPrimitive[];
+
+  /** Text primitives */
+  texts: TextPrimitive[];
+
+  /** Model primitives */
+  models: ModelPrimitive[];
+};

package/schemas/typescript/SceneEntityDeletion.ts

@@ -0,0 +1,16 @@
+// Generated by https://github.com/foxglove/schemas
+
+import { SceneEntityDeletionType } from "./SceneEntityDeletionType";
+import { Time } from "./Time";
+
+/** (Experimental, subject to change) Command to remove previously published entities */
+export type SceneEntityDeletion = {
+  /** Timestamp of the deletion. Only matching entities earlier than this timestamp will be deleted. */
+  timestamp: Time;
+
+  /** Type of deletion action to perform */
+  type: SceneEntityDeletionType;
+
+  /** Identifier which must match if `type` is `MATCHING_ID`. */
+  id: string;
+};

package/schemas/typescript/SceneEntityDeletionType.ts

@@ -0,0 +1,10 @@
+// Generated by https://github.com/foxglove/schemas
+
+/** (Experimental, subject to change) An enumeration indicating which entities should match a SceneEntityDeletion command */
+export enum SceneEntityDeletionType {
+  /** Delete the existing entity on the same topic that has the provided `id` */
+  MATCHING_ID = 0,
+
+  /** Delete all existing entities on the same topic */
+  ALL = 1,
+}

package/schemas/typescript/SceneUpdate.ts

@@ -0,0 +1,13 @@
+// Generated by https://github.com/foxglove/schemas
+
+import { SceneEntity } from "./SceneEntity";
+import { SceneEntityDeletion } from "./SceneEntityDeletion";
+
+/** (Experimental, subject to change) An update to the entities displayed in a 3D scene */
+export type SceneUpdate = {
+  /** Scene entities to delete */
+  deletions: SceneEntityDeletion[];
+
+  /** Scene entities to add or replace */
+  entities: SceneEntity[];
+};

package/schemas/typescript/SpherePrimitive.ts

@@ -0,0 +1,17 @@
+// Generated by https://github.com/foxglove/schemas
+
+import { Color } from "./Color";
+import { Pose } from "./Pose";
+import { Vector3 } from "./Vector3";
+
+/** (Experimental, subject to change) A primitive representing a sphere or ellipsoid */
+export type SpherePrimitive = {
+  /** Position of the center of the sphere and orientation of the sphere */
+  pose: Pose;
+
+  /** Size (diameter) of the sphere along each axis */
+  size: Vector3;
+
+  /** Color of the sphere */
+  color: Color;
+};

package/schemas/typescript/TextPrimitive.ts

@@ -0,0 +1,25 @@
+// Generated by https://github.com/foxglove/schemas
+
+import { Color } from "./Color";
+import { Pose } from "./Pose";
+
+/** (Experimental, subject to change) A primitive representing a text label */
+export type TextPrimitive = {
+  /** Position of the center of the text box and orientation of the text. Identity orientation means the text is oriented in the xy-plane and flows from -x to +x. */
+  pose: Pose;
+
+  /** Whether the text should respect `pose.orientation` (false) or always face the camera (true) */
+  billboard: boolean;
+
+  /** Font size (height of one line of text) */
+  font_size: number;
+
+  /** Indicates whether `font_size` is a fixed size in screen pixels (true), or specified in world coordinates and scales with distance from the camera (false) */
+  scale_invariant: boolean;
+
+  /** Color of the text */
+  color: Color;
+
+  /** Text */
+  text: string;
+};

package/schemas/typescript/TriangleListPrimitive.ts

@@ -0,0 +1,27 @@
+// Generated by https://github.com/foxglove/schemas
+
+import { Color } from "./Color";
+import { Point3 } from "./Point3";
+import { Pose } from "./Pose";
+
+/** (Experimental, subject to change) A primitive representing a set of triangles or a surface tiled by triangles */
+export type TriangleListPrimitive = {
+  /** Origin of triangles relative to reference frame */
+  pose: Pose;
+
+  /** Vertices to use for triangles, interpreted as a list of triples (0-1-2, 3-4-5, ...) */
+  points: Point3[];
+
+  /** Solid color to use for the whole shape. One of `color` or `colors` must be provided. */
+  color: Color;
+
+  /** Per-vertex colors (if specified, must have the same length as `points`). One of `color` or `colors` must be provided. */
+  colors: Color[];
+
+  /**
+   * Indices into the `points` and `colors` attribute arrays, which can be used to avoid duplicating attribute data.
+   * 
+   * If omitted or empty, indexing will not be used. This default behavior is equivalent to specifying [0, 1, ..., N-1] for the indices (where N is the number of `points` provided).
+   */
+  indices: number[];
+};

package/schemas/typescript/index.ts

@@ -1,15 +1,22 @@
+export * from "./ArrowPrimitive";
 export * from "./CameraCalibration";
 export * from "./CircleAnnotation";
 export * from "./Color";
 export * from "./CompressedImage";
+export * from "./CubePrimitive";
+export * from "./CylinderPrimitive";
 export * from "./FrameTransform";
 export * from "./GeoJSON";
 export * from "./Grid";
 export * from "./ImageAnnotations";
+export * from "./KeyValuePair";
 export * from "./LaserScan";
+export * from "./LinePrimitive";
+export * from "./LineType";
 export * from "./LocationFix";
 export * from "./Log";
 export * from "./LogLevel";
+export * from "./ModelPrimitive";
 export * from "./NumericType";
 export * from "./PackedElementField";
 export * from "./Point2";
@@ -23,5 +30,12 @@ export * from "./PosesInFrame";
 export * from "./PositionCovarianceType";
 export * from "./Quaternion";
 export * from "./RawImage";
+export * from "./SceneEntity";
+export * from "./SceneEntityDeletion";
+export * from "./SceneEntityDeletionType";
+export * from "./SceneUpdate";
+export * from "./SpherePrimitive";
+export * from "./TextPrimitive";
+export * from "./TriangleListPrimitive";
 export * from "./Vector2";
 export * from "./Vector3";

package/src/schemas.test.ts

@@ -1,4 +1,5 @@
 import { foxgloveEnumSchemas, foxgloveMessageSchemas } from "./schemas";
+import { FoxgloveMessageSchema } from "./types";
 
 describe("schemas", () => {
   it("has matching names", () => {
@@ -11,6 +12,24 @@ describe("schemas", () => {
     }
   });
 
+  const allSchemas = new Set<FoxgloveMessageSchema>();
+  function addNestedSchemas(schema: FoxgloveMessageSchema, schemas: Set<FoxgloveMessageSchema>) {
+    if (schemas.has(schema)) {
+      return;
+    }
+    schemas.add(schema);
+    for (const field of schema.fields) {
+      if (field.type.type === "nested") {
+        addNestedSchemas(field.type.schema, schemas);
+      }
+    }
+  }
+  const exportedSchemas = Object.values(foxgloveMessageSchemas);
+  exportedSchemas.forEach((schema) => addNestedSchemas(schema, allSchemas));
+  it.each([...allSchemas])("exports nested schemas - $name", (nestedSchema) => {
+    expect(exportedSchemas).toContain(nestedSchema);
+  });
+
   it("has valid descriptions", () => {
     for (const schema of Object.values(foxgloveMessageSchemas)) {
       // Multi-line descriptions are supported for fields, but not currently for schemas