Package ke.ric.renderer.api

Interface MapSink

Functional Interface:
This is a functional interface and can therefore be used as the assignment target for a lambda expression or method reference.
@FunctionalInterface public interface MapSink
Caller-owned palette destination for a stream. Every callback runs on the server thread and should finish quickly. The SDK allocates no map and saves no photograph for this sink; the caller chooses how to display or consume bytes. Cleanup calls close() once per registration when the stream ends.

  • Method Summary

    Modifier and Type
    Method
    Description
    void
    accept(MapFrame frame)
    Consumes the next immutable palette frame after freshness and lifecycle validation.
    default void
    close()
    Releases caller-side resources on the server thread, once per registration during terminal cleanup.
    default void
    status(RenderStream.Status status)
    Observes availability and terminal lifecycle transitions.

  • Method Details

    • accept

      void accept(MapFrame frame)
      Consumes the next immutable palette frame after freshness and lifecycle validation. Throwing terminates the stream and triggers cleanup.
      Parameters:
      frame - aspect-fitted 128×128 palette with original source evidence

    • status

      default void status(RenderStream.Status status)
      Observes availability and terminal lifecycle transitions. NO_SIGNAL may recover.
      Parameters:
      status - current stream state

    • close

      default void close()
      Releases caller-side resources on the server thread, once per registration during terminal cleanup. Do not remove output owned by other callers.