Add archetypes.ImageEncoded and hook up to spatial viewer

Cargo.lock

@@ -5297,6 +5297,7 @@ dependencies = [
  "egui_tiles",
  "glam",
  "half 2.3.1",
+ "image",
  "indexmap 2.1.0",
  "itertools 0.13.0",
  "linked-hash-map",

crates/store/re_types/definitions/rerun/archetypes.fbs

@@ -8,6 +8,7 @@ include "./archetypes/boxes3d.fbs";
 include "./archetypes/clear.fbs";
 include "./archetypes/depth_image.fbs";
 include "./archetypes/disconnected_space.fbs";
+include "./archetypes/image_encoded.fbs";
 include "./archetypes/image.fbs";
 include "./archetypes/line_strips2d.fbs";
 include "./archetypes/line_strips3d.fbs";

crates/store/re_types/definitions/rerun/archetypes/image.fbs

@@ -20,12 +20,12 @@ namespace rerun.archetypes;
 /// Leading and trailing unit-dimensions are ignored, so that
 /// `1x480x640x3x1` is treated as a `480x640x3` RGB image.
 ///
-/// Rerun also supports compressed image encoded as JPEG, N12, and YUY2.
-/// Using these formats can save a lot of bandwidth and memory.
-/// \py To compress an image, use [`rerun.Image.compress`][].
-/// \py To pass in an already encoded image, use  [`rerun.ImageEncoded`][].
-/// \rs See [`crate::components::TensorData`] for more.
-/// \cpp See [`rerun::datatypes::TensorBuffer`] for more.
+/// Rerun also supports compressed images (JPEG, PNG, …), using [archetypes.ImageEncoded].
+/// Compressing images can save a lot of bandwidth and memory.
+///
+/// \py You can compress an image using [`rerun.Image.compress`][].
+///
+/// See also [components.TensorData] and [datatypes.TensorBuffer].
 ///
 /// \cpp Since the underlying `rerun::datatypes::TensorData` uses `rerun::Collection` internally,
 /// \cpp data can be passed in without a copy from raw pointers or by reference from `std::vector`/`std::array`/c-arrays.

crates/store/re_types/definitions/rerun/archetypes/image_encoded.fbs

@@ -0,0 +1,51 @@
+include "fbs/attributes.fbs";
+
+include "rerun/datatypes.fbs";
+include "rerun/components.fbs";
+
+namespace rerun.archetypes;
+
+
+/// An image encoded as e.g. a JPEG or PNG.
+///
+/// Rerun also supports uncompressed images with the [archetypes.Image].
+///
+/// \py To compress an image, use [`rerun.Image.compress`][].
+///
+/// \example archetypes/image_encoded
+table ImageEncoded (
+  "attr.cpp.no_field_ctors",
+  "attr.docs.category": "Image & tensor",
+  "attr.docs.unreleased",
+  "attr.docs.view_types": "Spatial2DView, Spatial3DView: if logged under a projection",
+  "attr.rust.derive": "PartialEq"
+) {
+  // --- Required ---
+
+  /// The encoded content of some image file, e.g. a PNG or JPEG.
+  blob: rerun.components.Blob ("attr.rerun.component_required", order: 1000);
+
+  // --- Recommended ---
+
+  /// The Media Type of the asset.
+  ///
+  /// Supported values:
+  /// * `image/jpeg`
+  /// * `image/png`
+  ///
+  /// If omitted, the viewer will try to guess from the data blob.
+  /// If it cannot guess, it won't be able to render the asset.
+  media_type: rerun.components.MediaType  ("attr.rerun.component_recommended", nullable, order: 2000);
+
+  // --- Optional ---
+
+  /// Opacity of the image, useful for layering several images.
+  ///
+  /// Defaults to 1.0 (fully opaque).
+  opacity: rerun.components.Opacity ("attr.rerun.component_optional", nullable, order: 3000);
+
+  /// An optional floating point value that specifies the 2D drawing order.
+  ///
+  /// Objects with higher values are drawn on top of those with lower values.
+  draw_order: rerun.components.DrawOrder ("attr.rerun.component_optional", nullable, order: 3100);
+}