Escolha o formato por último
Primeiro confira o destino. JPEG e PNG são fallbacks amplos, WebP é prático para web, AVIF e JPEG XL exigem verificação do runtime.
Capacidades dependentes do runtime
Compatibilidade de navegadores do QuokkaPix
O QuokkaPix roda no navegador. Por isso formatos, workers, PDF, ZIP e modelos locais dependem do runtime atual. Esta página explica o que verificar antes de escolher um formato ou automatizar um fluxo.
Matriz de capacidades
A tabela não promete o mesmo comportamento em todos os navegadores. Ela mostra a decisão correta: destino, capabilities ao vivo e só então formato final.
| Área | Desktop | Mobile | Como verificar | Limite |
|---|---|---|---|---|
| JPEG / JPG | Decodificação e exportação comuns; MozJPEG é usado como caminho avançado quando carregado. | Ampla compatibilidade, mas a memória depende do tamanho do arquivo. | Verifique supportedOutputFormats e o estado do encoder avançado. | Edições visuais reexportam; metadata-only cleanup pode usar caminho binário sem perda. |
| PNG | Decodificação e exportação comuns; OxiPNG pode otimizar sem perda. | PNGs transparentes grandes podem consumir muita memória. | Verifique capabilities e o caminho de exportação. | Estrutura de bytes e tamanho podem mudar mantendo os pixels. |
| WebP | Exportação do navegador ou encoder WASM estável, se disponível. | Costuma funcionar em navegadores móveis modernos. | O agente deve ler supportedOutputFormats. | Animated WebP não é um fluxo completo de animação. |
| AVIF | Compatibilidade depende do navegador; o encoder avançado pode ser pesado. | No mobile, disponibilidade e velocidade variam. | Confira capabilities antes de automatizar. | Mais lento que JPEG/WebP e mais delicado em lotes grandes. |
| HEIC / HEIF | Decodificação local via HEIC worker quando disponível. | Útil para fotos de telefone, mas exige margem de memória. | Verifique heicWorkerAvailable. | É um caminho de entrada; a saída é escolhida separadamente. |
| JPEG XL | Exportação avançada experimental. | Visualização JXL no navegador é limitada. | Peça JXL apenas se o encoder estiver disponível. | Não há fallback Canvas. |
| PDF tools | Merge, split e extract funcionam como fluxos PDF locais. | Digitalizações grandes podem exigir mais memória. | Use tool=pdf e pdf-tool. | PDF mode aceita PDF; image-to-PDF continua em Convert. |
| ZIP import | ZIP é descompactado localmente para uploads em lote. | No mobile depende do tamanho do arquivo. | Verifique batch mode e filtro de formatos. | RAR/7z não são aceitos. |
| Agents | window.QuokkaPixAgent expõe contract, state, capabilities e result manifest. | Funciona no mesmo runtime do navegador. | O agente deve ler live capabilities antes de iniciar. | Não há API pública de processamento no servidor. |
Lista de decisão
Separe fluxos pesados
Background AI, exportação AVIF, ZIP grande, PDFs e cenários de várias etapas têm risco de memória diferente de um redimensionamento simples.
Prefira falhas claras
Se um encoder não consegue gerar o formato pedido, é melhor falhar claramente do que criar arquivo com extensão incorreta.
FAQ
Por que não há uma promessa universal?
Porque exportação do navegador, workers, WebGPU, memória móvel e encoders avançados variam por navegador e dispositivo.
O que acontece sem encoder avançado?
Para formatos comuns pode haver fallback Canvas. JPEG XL não tem fallback Canvas.
WebGPU muda a privacidade?
Não. WebGPU é computação local; os arquivos continuam no fluxo do navegador.