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

Відкладене виконання

Конвеєр Hokusai — це рецепт. Його побудова записує, що робити, і перевіряє параметри; нічого не відкривається й не обчислюється, доки не виконається завершальна операція (data(), write(to:), writeChunks, raw, metadata()). Ця сторінка — ментальна модель, на якій тримаються всі інші.

Час побудови й час виконання

Section titled “Час побудови й час виконання”
Фаза Що відбувається Помилки, що викидаються тут
Побудова (Hokusai(url:), .resize(…), .jpeg(…)) Записується крок; перевіряються параметри (розміри, якість, кольори, діапазони) invalidOption, invalidInput для хибного значення чи непридатного необробленого буфера, unsupported для того, що відомо як недоступне (ядро зміни розміру, відсутня можливість кодувальника)
Завершальна операція Відкриває джерело, виконує кроки, кодує io (відсутній файл), decode (не зображення, обрізане), transform (нативний крок не вдався, напр. extract поза зображенням), resource (ліміт), encode, runtime

Тож Hokusai(url: URL(fileURLWithPath: "missing.png")) успішний; помилка io («file not found») приходить із завершальної операції. Джерело з випадковими байтами також будується без проблем і завершується decode під час виконання. Обробляйте помилки навколо завершальної операції, а не конструктора, і розрізняйте ці два види: invalidOption під час побудови — це помилка програмування чи перевірки запиту; помилка завершальної операції описує вхідні дані.

Незмінність, а отже розгалуження

Section titled “Незмінність, а отже розгалуження”

Кожен крок повертає нове значення й не чіпає джерело. Один конвеєр може живити кілька виводів, паралельно:

let source = try Hokusai(url: photo).autoOrient()
async let card = source.resize(width: 1200, height: 630).webp().data()
async let thumb = source.resize(width: 320).jpeg().data()
let (c, t) = try await (card, thumb)

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

Конвеєр означає саме ті операції, які ви написали, у тому порядку, в якому ви їх написали. Hokusai може змінювати, як він їх виконує, але ніколи — що вони дають, тож застосовує лише короткий перелік перетворень, що зберігають еквівалентність: пропускає операції, що напевно є тотожними (обертання на цілі оберти, накладання без шарів), і в межах однієї завершальної операції будує лише раз джерело чи шар, спільний для кількох частин. Він ніколи не переставляє операції (trim чи розумне обрізання лишається там, де ви його поставили), не зливає зміни розміру, не обирає .sequential замість вас і не зберігає результати між виконаннями. Метадані виводу та вибір кодувальника — не операції над зображенням: перемагає останній .png() / .webp() / metadataPolicy(_:). Видимі наслідки дивіться в розділі Порядок операцій.

Завершальні операції виконуються поза кооперативним виконавцем

Section titled “Завершальні операції виконуються поза кооперативним виконавцем”

Блокувальна нативна робота виконується на планувальнику обчислень Hokusai, а не в кооперативних потоках Swift, тож довге кодування не може заморити непов’язану async-роботу. Обчислення понад ліміт планувальника очікують як призупинені завдання в порядку FIFO (Середовище виконання).

Скасування завдання, що викликає операцію, прибирає обчислення, що чекає, або просить libvips зупинити те, що виконується; в обох випадках завершальна операція викидає CancellationError, а конвеєр можна виконати знову. write(to:), скасований у будь-який момент, лишає наявне призначення точно таким, яким воно було (Завершальні операції виводу).