Package limn.demo

Record Class SiteShowcase.Entry

java.lang.Object
java.lang.Record
limn.demo.SiteShowcase.Entry
Record Components:
id - stable slug and file name; treat as published
locale - UI language for this capture. Applied BEFORE the scene is constructed: a scene measures the strings it is built with, so a language set afterwards is a relayout the capture has no reason to wait for
filmed - whether the capture drives a pointer over this screen and writes a frame per step. Off for every screen but one: what a whole-window capture is evidence of is the screen, and a film costs well over a hundred files and a share of the capture's wall clock. Turn it on only when the screen's claim is a change a still cannot show
settles - whether this screen carries a live performance footer the shutter must prime before it is worth photographing: see settling()
Enclosing class:
SiteShowcase

public static record SiteShowcase.Entry(String id, String title, Locale locale, LayoutDirection direction, boolean paletteInvariant, boolean warmUpPass, boolean filmed, boolean settles, Function<Theme,Scene> builder) extends Record
  • Constructor Details

    • Entry

      public Entry(String id, String title, Locale locale, Function<Theme,Scene> builder)
      The ordinary case: the scene is built once per palette and looks different in each.
    • Entry

      public Entry(String id, String title, Locale locale, boolean paletteInvariant, Function<Theme,Scene> builder)
      Palette-invariant, captured once: the common case for a scene that pins its own theme.
    • Entry

      public Entry(String id, String title, Locale locale, boolean paletteInvariant, boolean warmUpPass, boolean filmed, boolean settles, Function<Theme,Scene> builder)
      The flag-bearing case, kept at the old primary's shape so its callers state the flags and nothing else. Left to right: the one right-to-left entry says so through rtl(), because a direction is never derived from the locale beside it — the capture list follows the same rule the toolkit does (ADR 032).
    • Entry

      public Entry(String id, String title, Locale locale, LayoutDirection direction, boolean paletteInvariant, boolean warmUpPass, boolean filmed, boolean settles, Function<Theme,Scene> builder)
      Creates an instance of a Entry record class.
      Parameters:
      id - the value for the id record component
      title - the value for the title record component
      locale - the value for the locale record component
      direction - the value for the direction record component
      paletteInvariant - the value for the paletteInvariant record component
      warmUpPass - the value for the warmUpPass record component
      filmed - the value for the filmed record component
      settles - the value for the settles record component
      builder - the value for the builder record component
  • Method Details

    • rtl

      public SiteShowcase.Entry rtl()
      The same entry, captured under a right-to-left layout axis.
    • settling

      public SiteShowcase.Entry settling()
      The same entry, marked as one the shutter must wait on. Preserves every other axis, the direction included.

      Only a screen with something on a real clock in it. The settle is wall-clock, it is measured in seconds, and it is paid once per palette, so marking a screen that does not need it is the most effective way to make this capture slow: it was blanket before, and the screens that did not need it were most of the run.

      One thing buys it today: a live performance footer, whose gauges latch on a once-per-second heartbeat that frames cannot hurry. The driver used to wait 2.6 s of wall clock per shot for two beats; it now asks the footer for a sample once the warm-up frames have run, which is the same second reading a real interval apart, and photographs on the frame after.

    • toString

      public final String toString()
      Returns a string representation of this record class. The representation contains the name of the class, followed by the name and value of each of the record components.
      Specified by:
      toString in class Record
      Returns:
      a string representation of this object
    • hashCode

      public final int hashCode()
      Returns a hash code value for this object. The value is derived from the hash code of each of the record components.
      Specified by:
      hashCode in class Record
      Returns:
      a hash code value for this object
    • equals

      public final boolean equals(Object o)
      Indicates whether some other object is "equal to" this one. The objects are equal if the other object is of the same class and if all the record components are equal. Reference components are compared with Objects::equals(Object,Object); primitive components are compared with '=='.
      Specified by:
      equals in class Record
      Parameters:
      o - the object with which to compare
      Returns:
      true if this object is the same as the o argument; false otherwise.
    • id

      public String id()
      Returns the value of the id record component.
      Returns:
      the value of the id record component
    • title

      public String title()
      Returns the value of the title record component.
      Returns:
      the value of the title record component
    • locale

      public Locale locale()
      Returns the value of the locale record component.
      Returns:
      the value of the locale record component
    • direction

      public LayoutDirection direction()
      Returns the value of the direction record component.
      Returns:
      the value of the direction record component
    • paletteInvariant

      public boolean paletteInvariant()
      Returns the value of the paletteInvariant record component.
      Returns:
      the value of the paletteInvariant record component
    • warmUpPass

      public boolean warmUpPass()
      Returns the value of the warmUpPass record component.
      Returns:
      the value of the warmUpPass record component
    • filmed

      public boolean filmed()
      Returns the value of the filmed record component.
      Returns:
      the value of the filmed record component
    • settles

      public boolean settles()
      Returns the value of the settles record component.
      Returns:
      the value of the settles record component
    • builder

      public Function<Theme,Scene> builder()
      Returns the value of the builder record component.
      Returns:
      the value of the builder record component