Skip to content

studioeslimage

Version: v1 Scope: per-tenant+store (one per ESL page) Owning service: studio-renderer

The studioeslimage is the rendered page image produced by the studio rendering pipeline for an ESL page. studio-renderer (historically called image-render-service) writes this DTO after it renders a design against item data from a Single-variant link. The image is stored in LFS and the DTO records the file path and any required display rotation.

studioeslimage is an intermediate DTO: it is not delivered directly to hardware. Instead, eslimage-merger reads it alongside ecceslimage and writes the final eslimage that pricer-server eventually delivers to the physical ESL.

A studioeslimage record exists for an ESL page when and only when the current active link is a Single variant (studio path). When the link switches to an EccSingle or MultiItem variant, studio-renderer deletes the studioeslimage record (triggered by the by_storeesl alias watch on the link).

ID pattern

t/{tenantid}/s/{storeid}/esls/{barcode}/pages/{pagenum}/studioimage

  • t/{tenantid} — tenant namespace
  • s/{storeid} — store within the tenant
  • esls/{barcode} — the ESL's barcode
  • pages/{pagenum} — zero-based page index
  • studioimage — fixed terminal segment distinguishing this from the ECC-path sibling eccimage

Schema

Field Type Description
id string Primary ID following the pattern above
file_path string LFS path to the rendered PNG. Format: renderer/t/{tenantid}/eslimages/{SHA256}.png. Content-addressed by SHA-256 hash of file contents
rotation Rotation Display rotation to be applied when the image is shown on the ESL hardware

Rotation enum

Value Description
NONE (0) No rotation
CW_90 (1) 90 degrees clockwise
CW_180 (2) 180 degrees clockwise
CW_270 (3) 270 degrees clockwise

Consumed by

Service Why
eslimage-merger Subscribes to studioeslimage.v1; when a new studioeslimage arrives (or the competing ecceslimage is deleted), the merger writes or updates the final eslimage
  • eslimage — the final merged image that eslimage-merger produces from this DTO
  • ecceslimage — the competing ECC-path image for the same ESL page; at most one of studioeslimage / ecceslimage is populated at any time
  • renderedimage — the legacy image DTO that studio-renderer also wrote during the PLT-2487 migration period (via dtoflow-migration-helper bridge); deprecated
  • storeesl — the ESL registration record providing hardware type context