Pular para o conteúdo

API: render

@mosaicoo/svg-engine/render transforma uma árvore de nós em SVG real na tela. É read-only — sem seleção, edição ou interação (isso vive em svg-engine/edit) — o que o torna ideal como visualizador embedável num app de terceiros. Headless: sem Angular Material/CDK.

import { SvgeRenderer, projectDocumentToRenderer } from '@mosaicoo/svg-engine/render';
APIDescriçãoUse para
SvgeRendererO componente <svge-renderer>. Inputs: tree (SvgNode obrigatório), viewBox, width, height, ariaLabel, defs. Expõe svgElement() para acessar o <svg> renderizado.Exibir um documento (ou qualquer subárvore) como visualizador embedável read-only.
projectDocumentToRenderer(doc)Retorna { tree, viewBox } de um SvgDocument, pronto para vincular ao renderer.Ligar um SvgDocument ao <svge-renderer> num único passo.
<svge-renderer [tree]="proj().tree" [viewBox]="proj().viewBox" [defs]="doc().defs ?? null" />
APIDescrição
ViewportServiceEstado reativo de pan/zoom sobre uma content box base, como signals do Angular: contentBox, zoom, panX, panY, minZoom, maxZoom, viewBox, fitScale, displayScale. Métodos setContentBox(), zoomIn(), zoomOut(), pan().

viewBox é a janela visível derivada de contentBox/zoom/pan; use displayScale (pixels CSS por unidade de documento) quando precisar da escala física 1:1 na tela, p.ex. para mostrar a porcentagem de zoom.

APIDescriçãoUse para
NodeRendererRegistryRegistry de componentes de renderização customizados, indexados pelo type do nó: register(type, component), unregister(type), resolve(type), registeredTypes(). Os 10 tipos built-in são despachados diretamente; este é o ponto de extensão para tipos novos.Renderizar tipos de nó customizados introduzidos por um plugin.
APIDescrição
screenToDoc(svg, clientX, clientY)Projeta um pixel de tela no espaço de usuário do documento invertendo o getScreenCTM() ao vivo (lida bem com SSR/jsdom/CTM ausente). Retorna um Point ou null.
renderTransformAttr(transform)Serializa um Transform para o atributo transform do SVG (ex.: matrix(1 0 0 1 10 20)); retorna null na identidade.