Обирайте формат наприкінці
Спершу визначте місце публікації та вимоги платформи. JPEG і PNG — широкі fallback-формати, WebP корисний для web delivery, AVIF і JPEG XL потребують runtime check.
Можливості, залежні від runtime
QuokkaPix працює у браузері, тому підтримка форматів і важких workflow залежить від поточного runtime. Ця сторінка пояснює, що зазвичай доступно, що треба перевіряти через capabilities і де можливий fallback.
Таблиця показує модель рішення: вимога призначення, live capabilities, а потім вибір формату або режиму.
| Область | Desktop | Mobile | Як перевіряти | Обмеження |
|---|---|---|---|---|
| JPEG / JPG | Звичайне декодирование и экспорт в браузере; MozJPEG используется как advanced path, когда он загружен. | Широко поддерживается, но пам’ять зависит от размера файла. | Перевіряйте supportedOutputFormats и состояние advanced encoder. | Визуальные правки создают новый файл; metadata-only cleanup может идти lossless binary path. |
| PNG | Декодирование и экспорт обычно доступны; OxiPNG может оптимизировать lossless. | Прозрачные большие PNG могут быть тяжёлыми по памяти. | Перевіряйте capabilities и выбранный export path. | Структура байтов и размер файла могут измениться при сохранении тех же пикселей. |
| WebP | Browser export или стабильный WASM encoder, если доступен. | В современных мобильных браузерах обычно работает. | Агент должен читать supportedOutputFormats. | Animated WebP не является полноценным animation workflow. |
| AVIF | Поддержка зависит от браузера; advanced encoder может быть тяжелее. | На мобильных устройствах скорость и доступность различаются. | Перед автоматизацией проверяйте capabilities. | Медленнее JPEG/WebP и рискованнее в больших пакетах. |
| HEIC / HEIF | Локальное декодирование через HEIC worker, когда он доступен. | Полезно для фото с телефона, но требует запаса памяти. | Перевіряйте heicWorkerAvailable. | Это input path; output выбирается отдельно. |
| JPEG XL | Экспериментальный advanced export. | Просмотр JXL в браузерах ограничен. | Запрашивайте JXL только если encoder доступен. | Canvas fallback відсутній. |
| PDF tools | Merge, split и extract работают как локальные PDF workflows. | Большие сканы могут требовать больше памяти. | Используйте tool=pdf и pdf-tool. | PDF mode принимает PDF, а image-to-PDF остаётся в Convert. |
| ZIP import | ZIP распаковывается локально для batch uploads. | На мобильных устройствах зависит от размера архива. | Перевіряйте batch mode и supported file filter. | RAR/7z не принимаются. |
| Agents | window.QuokkaPixAgent отдаёт contract, state, capabilities и result manifest. | Работает через тот же браузерный runtime. | Агент должен читать live capabilities перед запуском. | Немає публічного server-side image API. |
Спершу визначте місце публікації та вимоги платформи. JPEG і PNG — широкі fallback-формати, WebP корисний для web delivery, AVIF і JPEG XL потребують runtime check.
Background AI, AVIF export, великі ZIP, PDF-документи й сценарії мають інший memory risk, ніж одиночна зміна розміру.
Якщо браузер або encoder не може створити формат, потрібна явна помилка або чесний fallback.
Тому що browser export, workers, WebGPU, mobile memory і advanced encoders відрізняються між браузерами та пристроями.
Для звичайних browser-supported форматів можливий Canvas fallback. Для JPEG XL fallback немає.
Ні. Це локальний compute path; файли залишаються в browser workflow.