Продуктивність
Hokusai — тонкий шар над libvips, яка передає зображення потоком малими ділянками й використовує ядра процесора. Тому робота над продуктивністю здебільшого полягає в тому, щоб не робити зайвого і обмежувати паралельність. Ця сторінка перелічує важелі з задокументованим ефектом; вимірюйте власні зображення, перш ніж налаштовувати.
Робіть менше
Section titled “Робіть менше”- Зменшуйте рано. Операції перед великим
resizeвиконуються в повному розмірі. СтавтеautoOrient,extractіresizeпершими, а потім коригуйте в розмірі виводу (порядок). - Зменшення під час завантаження. Конвеєр нерухомого JPEG чи WebP, що починається з
resize(за потреби післяautoOrient), масштабується декодером: ті самі розміри виводу, значно менше роботи. На еталонній фікстурі 5760 × 3840 зміна розміру до 200 px завширшки для WebP зайняла приблизно 65 мс замість 89 мс (debug-збірка, найкраще з шести). Усе, що стоїть між джерелом іresize, це вимикає. - Одне декодування, кілька виводів. Побудуйте спільний префікс один раз; кожна завершальна операція виконує свою гілку. Файл-джерело читається знову для кожної завершальної операції, бо Hokusai не тримає власного кешу.
- Пропускайте непотрібне.
autoOrient()нічого не робить для вертикального зображення; тривіальні обертання й порожні накладання пропускаються.
Обирайте кодувальники свідомо
Section titled “Обирайте кодувальники свідомо”Кодування часто є найбільшою вартістю. effort (WebP 0…6, AVIF і HEIF 0…9) обмінює процесорний час на розмір; найповільніші — режими без втрат і великі налаштування AVIF/HEIF (виміряні розміри). Для віддачі «на льоту» зазвичай правильний вибір — JPEG або WebP із помірним зусиллям; зусилля AVIF витрачайте офлайн.
Обмежуйте паралельність і пам’ять
Section titled “Обмежуйте паралельність і пам’ять”maxConcurrentEvaluations— головний важіль пам’яті й затримки під навантаженням;maxQueuedEvaluationsперетворює перевантаження на швидкі збої (Середовище виконання). Одне обчислення саме може використовувати багато потоків libvips (vipsConcurrency).- Обмежуйте вхід:
InputLimits(maxBytes,maxPixels) і, для пікселів, які створює конвеєр,maxOutputPixels. Необмеженийresize(width:)із запиту — це відмова в обслуговуванні. - Потокова передача:
writeChunks/Hokusai(spooling:)обмежують закодовані байти, що тримаються, а не пам’ять декодування (завершальні операції, завантаження). - Режим доступу: лишайте
.random. У бенчмарках Hokusai.sequentialробив сильно зменшувані конвеєри JPEG значно повільнішими (параметри входу).
Вимірюйте через CLI
Section titled “Вимірюйте через CLI”hokusai benchmark run перебирає --evaluations × --vips-concurrency і запускає новий робочий процес для кожної комірки, тож кожне вимірювання має одну зафіксовану конфігурацію середовища. Паралельні запити використовують окремі копії входу, щоб кеш операцій libvips не впливав на результат. Він записує версіонований JSON-результат (коміт, Swift, ОС, ЦП, libvips, Cairo, налаштування середовища, політика кешу, SHA-256 входу, сирі вибірки, p50/p90/p95/p99, пропускна здатність, закодовані байти, піки активних/черги, піковий RSS). hokusai benchmark compare повідомляє різницю за комірками й позначає лише зміни, що перевищують і відносний, і абсолютний поріг; він лише дорадчий. Навантаження: thumbnail-jpeg, cover-webp, blur-webp, resize-png та pdf-a4; профілі — quick і stable. Дивіться CLI.