MingaEditor.Renderer.Server (Minga v0.1.0)

Copy Markdown View Source

Renderer process wrapper.

All frame, acknowledgement, timeout, and recovery workflows live in focused handler modules. This module exposes the process API and keeps OTP callbacks as routing-only clauses.

Summary

Types

t()

Functions

acknowledgement_state(server \\ __MODULE__)

Returns current recovery generation and acknowledged frame sequence.

cast_snapshot(server \\ __MODULE__, snapshot, frame_seq)

Queues the latest semantic frame intent for asynchronous rendering.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

frame_status(server \\ __MODULE__, status)

Routes a typed frontend frame status to the renderer.

record_adaptation(server \\ __MODULE__, generation, frame_seq, dimension, rejected_value, adapted_value, adapted_intent)

Records one-shot adaptation evidence bound to an outstanding rejected transaction.

render_sync(server, snapshot, frame_seq)

Runs one frame synchronously inside this renderer process.

rendering?(server \\ __MODULE__)

Returns true while rendering or awaiting frontend credit.

request_recovery(server \\ __MODULE__)

Requests recovery of the outstanding renderer transaction.

reset_connection(server \\ __MODULE__, snapshot, frame_seq)

Abandons the old frontend connection and renders a fresh keyframe.

reset_sync(server, intent, frame_seq)

Resets frontend state and renders a synchronous recovery keyframe.

start_link(opts \\ [])
terminal_failure(server \\ __MODULE__)

Returns the visible terminal frontend failure, if one has stopped frame credit.

Types

t()

@type t() :: MingaEditor.Renderer.State.t()

Functions

acknowledgement_state(server \\ __MODULE__)

@spec acknowledgement_state(GenServer.server()) ::
  {non_neg_integer(), non_neg_integer()}

Returns current recovery generation and acknowledged frame sequence.

cast_snapshot(server \\ __MODULE__, snapshot, frame_seq)

@spec cast_snapshot(
  GenServer.server(),
  MingaEditor.RenderPipeline.Input.t() | MingaEditor.RenderPipeline.Intent.t(),
  non_neg_integer()
) :: :ok

Queues the latest semantic frame intent for asynchronous rendering.

child_spec(init_arg)

Returns a specification to start this module under a supervisor.

See Supervisor.

frame_status(server \\ __MODULE__, status)

@spec frame_status(GenServer.server(), MingaEditor.Frontend.Protocol.input_event()) ::
  :ok

Routes a typed frontend frame status to the renderer.

record_adaptation(server \\ __MODULE__, generation, frame_seq, dimension, rejected_value, adapted_value, adapted_intent)

@spec record_adaptation(
  GenServer.server(),
  non_neg_integer(),
  non_neg_integer(),
  MingaEditor.Frontend.ResourcePolicy.dimension(),
  integer(),
  integer(),
  MingaEditor.RenderPipeline.Intent.t()
) :: :ok | :error

Records one-shot adaptation evidence bound to an outstanding rejected transaction.

render_sync(server, snapshot, frame_seq)

@spec render_sync(
  GenServer.server(),
  MingaEditor.RenderPipeline.Input.t() | MingaEditor.RenderPipeline.Intent.t(),
  non_neg_integer()
) :: {:ok, MingaEditor.Renderer.RenderReceipt.t()} | {:error, Exception.t()}

Runs one frame synchronously inside this renderer process.

rendering?(server \\ __MODULE__)

@spec rendering?(GenServer.server()) :: boolean()

Returns true while rendering or awaiting frontend credit.

request_recovery(server \\ __MODULE__)

@spec request_recovery(GenServer.server()) :: :ok

Requests recovery of the outstanding renderer transaction.

reset_connection(server \\ __MODULE__, snapshot, frame_seq)

@spec reset_connection(
  GenServer.server(),
  MingaEditor.RenderPipeline.Input.t() | MingaEditor.RenderPipeline.Intent.t(),
  non_neg_integer()
) :: :ok

Abandons the old frontend connection and renders a fresh keyframe.

reset_sync(server, intent, frame_seq)

@spec reset_sync(
  GenServer.server(),
  MingaEditor.RenderPipeline.Intent.t(),
  non_neg_integer()
) ::
  {:ok, MingaEditor.Renderer.RenderReceipt.t()} | {:error, Exception.t()}

Resets frontend state and renders a synchronous recovery keyframe.

start_link(opts \\ [])

@spec start_link(keyword()) :: GenServer.on_start()

terminal_failure(server \\ __MODULE__)

@spec terminal_failure(GenServer.server()) ::
  MingaEditor.Renderer.RejectionState.terminal() | nil

Returns the visible terminal frontend failure, if one has stopped frame credit.