PIXU format

Caminho de encode TECR. Prefira format: 'image/pixu' em compress. O arquivo de saída é sempre WebP ou JPEG com extensão conhecida.

Constantes

import {
  PIXU_MIME_TYPE,   // 'image/pixu' — só opção de encode
  isPixuSupported,
  buildDownloadName,
} from '@pantanal/pixu'

isPixuSupported() // true

PIXU_EXTENSION está depreciado (alias de .webp). Prefira buildDownloadName(name, result.format).

Aliases depreciados ainda exportados: PIX_MIME_TYPE, PIX_EXTENSION, isPixSupported, canvasToPix, estimatePixCompression.

canvasToPixu

function canvasToPixu(
  canvas: HTMLCanvasElement,
  quality?: number,
  options?: {
    progressive?: boolean
    adaptive?: boolean
    chromaSubsampling?: '4:4:4' | '4:2:2' | '4:2:0'
  }
): Promise<Blob>

Retorna um Blob tipado como image/webp (ou fallback image/jpeg). Default quality é 0.85. adaptive default true.

estimatePixuCompression

function estimatePixuCompression(
  originalSize: number,
  quality: number,
  width: number,
  height: number
): number

Retorna uma razão estimada de compressão (cerca de 0.4–0.8).

normalizePixuFormat

function normalizePixuFormat(format: string): string

Mapeia legado 'image/pix' → 'image/pixu'.

Exemplo

import { compress, PIXU_MIME_TYPE, buildDownloadName } from '@pantanal/pixu'

const result = await compress(file, {
  format: PIXU_MIME_TYPE,
  enableSmartQuality: true,
})

// result.format === 'image/webp' | 'image/jpeg'
a.download = buildDownloadName('photo', result.format)
img.src = URL.createObjectURL(result.file)

Helpers de download

import { getOutputExtension, buildDownloadName } from '@pantanal/pixu'

getOutputExtension('image/webp')  // '.webp'
getOutputExtension('image/jpeg')  // '.jpg'
getOutputExtension('image/pixu')  // '.webp' (opção de encode → container padrão)
buildDownloadName('photo', result.format)  // bate com o payload

Helpers de preview legados

Para blobs antigos ainda tipados como image/pixu:

import {
  createPreviewObjectURL,
  pixuToDisplayBlob,
  loadPixuImage,
  detectPixuPayloadMime,
} from '@pantanal/pixu'

Veja Encode PIXU.

Relacionado

• Guide: Formato PIXU
• Guide: Encode PIXU
• Theory: TECR