Class: SceneThumbnailAssetEntry¶

A single STAC Item asset entry produced by Storyboarding (#216) for one

variant of one Scene's thumbnail. Always appears as part of a

pair in an Item's assets map: a large entry under the key

scene-thumbnail-{ULID} and a small entry under the key

scene-thumbnail-{ULID}-sm, where {ULID} is the owning Scene's

identifier (matches SceneProperties.id).

__

Why ULID: the owning Scene's id; lets every per-Scene asset be

traced back to its Scene without an explicit foreign-key field

in the asset payload.

__

Why pairs: the Storyboarding capture pipeline produces both

sizes atomically (800x600 large for inspection; 200x150 small

for timeline strips). A single-variant entry is a defect — see

schema rule scene-thumbnail-pair-rule-001.

__

Lifecycle: created when a Scene is captured. Deleted when the

Scene is deleted (garbage-collection invariant — see schema

rule scene-thumbnail-orphan-rule-001). Both rules are enforced

by the debrief-stac audit module; the JSON Schema layer

enforces the value shape and key format only (see schema rule

scene-thumbnail-key-format-rule-001).

__

Supersedes the spec-241 placeholder item_assets["scene-thumbnail"]

and the ^scene-thumbnail(-.+)?$ patternProperties rule.

URI: debrief:class/SceneThumbnailAssetEntry

 classDiagram
    class SceneThumbnailAssetEntry
    click SceneThumbnailAssetEntry href "../../classes/SceneThumbnailAssetEntry/"
      SceneThumbnailAssetEntry : href

      SceneThumbnailAssetEntry : roles

      SceneThumbnailAssetEntry : title

      SceneThumbnailAssetEntry : type

Slots¶

Name	Cardinality and Range	Description	Inheritance
href	1 String	URI-reference relative to the Item directory; conventionally	direct
type	1 String	Always image/png — Storyboarding capture writes PNGs only	direct
roles	1..* String	Exactly ["thumbnail"]	direct
title	0..1 String	Optional human label	direct

Identifier and Mapping Information¶

Schema Source¶

from schema: https://debrief.info/schemas/debrief

Mappings¶

Mapping Type	Mapped Value
self	debrief:SceneThumbnailAssetEntry
native	debrief:SceneThumbnailAssetEntry

LinkML Source¶

Direct¶

name: SceneThumbnailAssetEntry
description: 'A single STAC Item asset entry produced by Storyboarding (#216) for
  one

  variant of one Scene''s thumbnail. Always appears as part of a

  pair in an Item''s `assets` map: a large entry under the key

  `scene-thumbnail-{ULID}` and a small entry under the key

  `scene-thumbnail-{ULID}-sm`, where `{ULID}` is the owning Scene''s

  identifier (matches SceneProperties.id).


  Why ULID: the owning Scene''s id; lets every per-Scene asset be

  traced back to its Scene without an explicit foreign-key field

  in the asset payload.


  Why pairs: the Storyboarding capture pipeline produces both

  sizes atomically (800x600 large for inspection; 200x150 small

  for timeline strips). A single-variant entry is a defect — see

  schema rule scene-thumbnail-pair-rule-001.


  Lifecycle: created when a Scene is captured. Deleted when the

  Scene is deleted (garbage-collection invariant — see schema

  rule scene-thumbnail-orphan-rule-001). Both rules are enforced

  by the debrief-stac audit module; the JSON Schema layer

  enforces the value shape and key format only (see schema rule

  scene-thumbnail-key-format-rule-001).


  Supersedes the spec-241 placeholder `item_assets["scene-thumbnail"]`

  and the `^scene-thumbnail(-.+)?$` patternProperties rule.'
from_schema: https://debrief.info/schemas/debrief
attributes:
  href:
    name: href
    description: URI-reference relative to the Item directory; conventionally ./scene-thumbnails/scene-{ULID}.png
      (large) or ./scene-thumbnails/scene-{ULID}-sm.png (small).
    from_schema: https://debrief.info/schemas/storyboard
    domain_of:
    - ToolResultAnnotations
    - SceneThumbnailAssetEntry
    range: string
    required: true
  type:
    name: type
    description: Always image/png — Storyboarding capture writes PNGs only.
    from_schema: https://debrief.info/schemas/storyboard
    domain_of:
    - GeoJSONPoint
    - GeoJSONEmptyPoint
    - GeoJSONLineString
    - GeoJSONPolygon
    - GeoJSONMultiPoint
    - GeoJSONMultiLineString
    - GeoJSONMultiPolygon
    - TrackFeature
    - ReferenceLocation
    - SystemState
    - MultiPointFeature
    - MultiPolygonFeature
    - NarrativeEntry
    - CircleAnnotation
    - RectangleAnnotation
    - LineAnnotation
    - TextAnnotation
    - VectorAnnotation
    - PolyAnnotation
    - ToolParameter
    - FileProvEntry
    - RawGeoJSONFeature
    - RawGeoJSONFeatureCollection
    - DatasetAxisMetadata
    - DatasetEntry
    - StoryboardFeature
    - SceneFeature
    - SceneThumbnailAssetEntry
    range: string
    required: true
    equals_string: image/png
  roles:
    name: roles
    description: Exactly ["thumbnail"]. Storyboarding-derived thumbnails are not declared
      as overview (which is reserved for plot-level overviews of dimensions 600x800).
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    domain_of:
    - SceneThumbnailAssetEntry
    range: string
    required: true
    multivalued: true
  title:
    name: title
    description: Optional human label. Storyboarding writer emits "Scene thumbnail"
      (large) or "Scene thumbnail (small)" (small).
    from_schema: https://debrief.info/schemas/storyboard
    domain_of:
    - PlotSummary
    - StacItemSummary
    - DatasetEntry
    - SceneProperties
    - SceneThumbnailAssetEntry
    range: string
    required: false

Induced¶

name: SceneThumbnailAssetEntry
description: 'A single STAC Item asset entry produced by Storyboarding (#216) for
  one

  variant of one Scene''s thumbnail. Always appears as part of a

  pair in an Item''s `assets` map: a large entry under the key

  `scene-thumbnail-{ULID}` and a small entry under the key

  `scene-thumbnail-{ULID}-sm`, where `{ULID}` is the owning Scene''s

  identifier (matches SceneProperties.id).


  Why ULID: the owning Scene''s id; lets every per-Scene asset be

  traced back to its Scene without an explicit foreign-key field

  in the asset payload.


  Why pairs: the Storyboarding capture pipeline produces both

  sizes atomically (800x600 large for inspection; 200x150 small

  for timeline strips). A single-variant entry is a defect — see

  schema rule scene-thumbnail-pair-rule-001.


  Lifecycle: created when a Scene is captured. Deleted when the

  Scene is deleted (garbage-collection invariant — see schema

  rule scene-thumbnail-orphan-rule-001). Both rules are enforced

  by the debrief-stac audit module; the JSON Schema layer

  enforces the value shape and key format only (see schema rule

  scene-thumbnail-key-format-rule-001).


  Supersedes the spec-241 placeholder `item_assets["scene-thumbnail"]`

  and the `^scene-thumbnail(-.+)?$` patternProperties rule.'
from_schema: https://debrief.info/schemas/debrief
attributes:
  href:
    name: href
    description: URI-reference relative to the Item directory; conventionally ./scene-thumbnails/scene-{ULID}.png
      (large) or ./scene-thumbnails/scene-{ULID}-sm.png (small).
    from_schema: https://debrief.info/schemas/storyboard
    alias: href
    owner: SceneThumbnailAssetEntry
    domain_of:
    - ToolResultAnnotations
    - SceneThumbnailAssetEntry
    range: string
    required: true
  type:
    name: type
    description: Always image/png — Storyboarding capture writes PNGs only.
    from_schema: https://debrief.info/schemas/storyboard
    alias: type
    owner: SceneThumbnailAssetEntry
    domain_of:
    - GeoJSONPoint
    - GeoJSONEmptyPoint
    - GeoJSONLineString
    - GeoJSONPolygon
    - GeoJSONMultiPoint
    - GeoJSONMultiLineString
    - GeoJSONMultiPolygon
    - TrackFeature
    - ReferenceLocation
    - SystemState
    - MultiPointFeature
    - MultiPolygonFeature
    - NarrativeEntry
    - CircleAnnotation
    - RectangleAnnotation
    - LineAnnotation
    - TextAnnotation
    - VectorAnnotation
    - PolyAnnotation
    - ToolParameter
    - FileProvEntry
    - RawGeoJSONFeature
    - RawGeoJSONFeatureCollection
    - DatasetAxisMetadata
    - DatasetEntry
    - StoryboardFeature
    - SceneFeature
    - SceneThumbnailAssetEntry
    range: string
    required: true
    equals_string: image/png
  roles:
    name: roles
    description: Exactly ["thumbnail"]. Storyboarding-derived thumbnails are not declared
      as overview (which is reserved for plot-level overviews of dimensions 600x800).
    from_schema: https://debrief.info/schemas/storyboard
    rank: 1000
    alias: roles
    owner: SceneThumbnailAssetEntry
    domain_of:
    - SceneThumbnailAssetEntry
    range: string
    required: true
    multivalued: true
  title:
    name: title
    description: Optional human label. Storyboarding writer emits "Scene thumbnail"
      (large) or "Scene thumbnail (small)" (small).
    from_schema: https://debrief.info/schemas/storyboard
    alias: title
    owner: SceneThumbnailAssetEntry
    domain_of:
    - PlotSummary
    - StacItemSummary
    - DatasetEntry
    - SceneProperties
    - SceneThumbnailAssetEntry
    range: string
    required: false