Choisir le format en dernier
Commencez par la destination. JPEG et PNG restent des fallbacks larges, WebP est pratique pour le web, AVIF et JPEG XL demandent une vérification runtime.
Capacités dépendantes du runtime
Compatibilité navigateur de QuokkaPix
QuokkaPix fonctionne dans le navigateur. La prise en charge des formats, workers, PDF, ZIP et modèles locaux dépend donc du runtime actuel. Cette page explique quoi vérifier avant de choisir un format ou d’automatiser un flux.
Matrice des capacités
Le tableau n’est pas une promesse universelle. Il sert à décider : exigence de destination, capabilities en direct, puis format de sortie.
| Zone | Desktop | Mobile | Vérification | Limite |
|---|---|---|---|---|
| JPEG / JPG | Décodage et export habituels ; MozJPEG sert de chemin avancé lorsqu’il est chargé. | Large compatibilité, mais la mémoire dépend de la taille du fichier. | Vérifiez supportedOutputFormats et l’état de l’encodeur avancé. | Les retouches visuelles réexportent ; metadata-only cleanup peut rester lossless. |
| PNG | Décodage et export courants ; OxiPNG peut optimiser sans perte. | Les grands PNG transparents peuvent être lourds en mémoire. | Vérifiez capabilities et le chemin d’export. | La structure des octets et la taille peuvent changer avec les mêmes pixels. |
| WebP | Export navigateur ou encodeur WASM stable si disponible. | Généralement disponible dans les navigateurs mobiles modernes. | L’agent doit lire supportedOutputFormats. | Animated WebP n’est pas un flux complet d’animation. |
| AVIF | La prise en charge dépend du navigateur ; l’encodeur avancé peut être lourd. | Sur mobile, disponibilité et vitesse varient. | Vérifiez capabilities avant automatisation. | Plus lent que JPEG/WebP et plus risqué en gros lots. |
| HEIC / HEIF | Décodage local via HEIC worker lorsque disponible. | Utile pour les photos de téléphone, avec marge mémoire nécessaire. | Vérifiez heicWorkerAvailable. | C’est un chemin d’entrée ; la sortie se choisit séparément. |
| JPEG XL | Export avancé expérimental. | L’affichage JXL dans les navigateurs est limité. | Demandez JXL seulement si l’encodeur est disponible. | Pas de fallback Canvas. |
| PDF tools | Merge, split et extract sont des flux PDF locaux. | Les gros scans peuvent demander plus de mémoire. | Utilisez tool=pdf et pdf-tool. | PDF mode accepte les PDF ; image-to-PDF reste dans Convert. |
| ZIP import | ZIP est décompressé localement pour les lots. | Sur mobile, cela dépend de la taille de l’archive. | Vérifiez batch mode et le filtre des formats. | RAR/7z ne sont pas acceptés. |
| Agents | window.QuokkaPixAgent expose contract, state, capabilities et result manifest. | Cela fonctionne dans le même runtime navigateur. | L’agent doit lire les live capabilities avant de lancer. | Il n’y a pas d’API publique de traitement serveur. |
Liste de décision
Séparer les flux lourds
Background AI, export AVIF, gros ZIP, PDF et scénarios multi-étapes ont un risque mémoire différent d’un simple redimensionnement.
Préférer les erreurs explicites
Si un encodeur ne peut pas produire le format demandé, un échec clair vaut mieux qu’un fichier mal étiqueté.
FAQ
Pourquoi pas une promesse universelle ?
Parce que l’export navigateur, les workers, WebGPU, la mémoire mobile et les encodeurs avancés varient selon le navigateur et l’appareil.
Que se passe-t-il sans encodeur avancé ?
Pour les formats courants, un fallback Canvas peut exister. JPEG XL n’a pas de fallback Canvas.
WebGPU change-t-il la confidentialité ?
Non. WebGPU est un calcul local ; les fichiers restent dans le flux du navigateur.