Перейти до вмісту
Hokusai2.2.2
ivantokar.com

Продуктивність

Hokusai — тонкий шар над libvips, яка передає зображення потоком малими ділянками й використовує ядра процесора. Тому робота над продуктивністю здебільшого полягає в тому, щоб не робити зайвого і обмежувати паралельність. Ця сторінка перелічує важелі з задокументованим ефектом; вимірюйте власні зображення, перш ніж налаштовувати.

  • Зменшуйте рано. Операції перед великим 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 значно повільнішими (параметри входу).

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.