Documentation
¶
Overview ¶
Package engine implements the bounded manager-side HTML rendering profile. It never imports MCU, panel, transport or credential packages.
Index ¶
- type MonochromeMode
- type Options
- type Renderer
- func (r *Renderer) Render(ctx context.Context, size display.Size, html []byte) (display.Frame, error)
- func (r *Renderer) RenderDetailed(ctx context.Context, size display.Size, html []byte) (display.Frame, []renderdiag.Warning, error)
- func (r *Renderer) RenderRGBA(ctx context.Context, size display.Size, source []byte) (Result, error)
- func (r *Renderer) RenderRGBAWithOptions(ctx context.Context, size display.Size, source []byte, options Options) (Result, error)
- func (r *Renderer) RenderReserved(ctx context.Context, size display.Size, html []byte, area image.Rectangle) (display.Frame, []renderdiag.Warning, error)
- func (r *Renderer) ValidateDocument(ctx context.Context, source []byte) error
- type Result
Constants ¶
This section is empty.
Variables ¶
This section is empty.
Functions ¶
This section is empty.
Types ¶
type MonochromeMode ¶ added in v0.1.1
type MonochromeMode uint8
MonochromeMode controls conversion after all color/alpha composition.
const ( // Threshold preserves solid text and UI fills without a halftone grid. Threshold MonochromeMode = iota // OrderedDither approximates gray tones with a display-anchored 4x4 pattern. OrderedDither )
type Renderer ¶
type Renderer struct {
// contains filtered or unexported fields
}
Renderer owns its embedded fonts and serializes their mutable shaping caches. Documents cannot read host fonts/files or issue network/subprocess requests.
func (*Renderer) Render ¶
func (r *Renderer) Render(ctx context.Context, size display.Size, html []byte) (display.Frame, error)
Render satisfies the manager's ScreenRenderer contract without depending on manager, transports or a particular panel. Logical size precedes rasterization.
func (*Renderer) RenderDetailed ¶
func (r *Renderer) RenderDetailed(ctx context.Context, size display.Size, html []byte) (display.Frame, []renderdiag.Warning, error)
RenderDetailed adds source-free warnings without coupling the engine to a manager implementation. Returned warnings and frame belong to the caller.
func (*Renderer) RenderRGBA ¶
func (r *Renderer) RenderRGBA(ctx context.Context, size display.Size, source []byte) (Result, error)
RenderRGBA returns independently owned pixels, composited before any device quantization. Admission is context-aware; callers cannot race the font cache.
func (*Renderer) RenderRGBAWithOptions ¶
func (r *Renderer) RenderRGBAWithOptions(ctx context.Context, size display.Size, source []byte, options Options) (Result, error)
RenderRGBAWithOptions reserves only explicitly configured device metadata pixels. CSS viewport dimensions remain the complete logical display size.
func (*Renderer) RenderReserved ¶
func (r *Renderer) RenderReserved(ctx context.Context, size display.Size, html []byte, area image.Rectangle) (display.Frame, []renderdiag.Warning, error)
RenderReserved clears only the protected metadata corner before quantization and preserves composition warnings. The manager paints its timestamp later.
func (*Renderer) ValidateDocument ¶
ValidateDocument checks the complete scene and embedded asset bounds before an atomic authoring edit commits. It does not paint or touch the font cache; layout failures still report asynchronously through render diagnostics.
type Result ¶
type Result struct {
Image *image.RGBA
Warnings []renderdiag.Warning
}
func (Result) Frame ¶
Frame quantizes the completed preview into independently owned canonical packed pixels. It never scales, rotates or mutates the preview.
func (Result) FrameWithMode ¶ added in v0.1.1
FrameWithMode lets image-oriented callers explicitly select halftoning. Both modes are pixel-local: an edit cannot propagate error into other rows.
Source Files
¶
- absolute_margins.go
- assets.go
- background_slice.go
- clip_radius.go
- clipping.go
- ellipsis.go
- flow.go
- fonts.go
- inline_baseline.go
- inline_box.go
- inline_object.go
- intrinsic.go
- lists.go
- mono.go
- paint_border.go
- paint_box.go
- paint_image.go
- paint_inline.go
- paint_path.go
- painter.go
- paragraph.go
- position.go
- relative.go
- renderer.go
- reserved.go
- scene.go
- shaping.go
- stacking.go
- surface.go
- text_policy.go
- validate.go
Directories
¶
| Path | Synopsis |
|---|---|
|
Package dom owns the engine's single validated HTML5 tree.
|
Package dom owns the engine's single validated HTML5 tree. |
|
Package geometry computes bounded CSS boxes without fonts, images or hardware.
|
Package geometry computes bounded CSS boxes without fonts, images or hardware. |
|
Package style parses the engine's bounded inline CSS profile into typed values.
|
Package style parses the engine's bounded inline CSS profile into typed values. |