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

Необроблені пікселі

Коли пікселі вже є в пам’яті (кадр камери, відтворена діаграма, тестові дані), Hokusai(raw:width:height:format:rowStride:premultiplied:limits:) будує з них конвеєр, а raw(_:premultiplied:background:) повертає пікселі як RawImage. Необроблені й закодовані конвеєри мають спільні всі перетворення.

Вибірки чергуються (RGBRGB…), беззнакові, без заповнення між пікселями. Кольорові канали йдуть першими, а альфа, якщо є, останньою. 16-бітні вибірки використовують порядок байтів машини, тобто little-endian на кожній підтримуваній платформі. Колір — sRGB; сіре — та сама крива передачі з одним каналом. До необроблених пікселів жоден колірний профіль не застосовується.

Формат Канали Байтів на піксель
gray8 сірий 1
grayAlpha8 сірий, альфа 2
rgb8 червоний, зелений, синій 3
rgba8 червоний, зелений, синій, альфа 4
gray16 сірий 2
grayAlpha16 сірий, альфа 4
rgb16 червоний, зелений, синій 6
rgba16 червоний, зелений, синій, альфа 8

Параметри: data, width і height (1…2 147 483 647), format, необов’язковий rowStride (байти між початками рядків; nil означає щільно упаковано, width × bytesPerPixel), premultiplied (чи кольорові канали вже було помножено на альфу; їх ділять на завантаженні, тож кожна наступна операція бачить пряму альфу; ігнорується для форматів без альфи) і limits. Розміри, крок і кількість байтів перевіряються з виявленням переповнення до будь-якого нативного виклику, тож брехливий заголовок не може «обернутися».

// Raw pixels you already hold: here, a 4 × 2 RGBA image drawn by hand.
var pixels = Data()
for y in 0..<2 {
for x in 0..<4 {
pixels.append(contentsOf: [UInt8(x * 80), UInt8(y * 200), 128, 255]) // R G B A
}
}
let tiny = try Hokusai(raw: pixels, width: 4, height: 2, format: .rgba8)
// Every transformation works on it; nearest keeps the pixels visible.
try await tiny.resize(width: 200, kernel: .nearest).png().write(to: URL(fileURLWithPath: "tiny.png"))
// And pixels come back out as RawImage: the format, size, stride and alpha convention are stated.
let frame = try await Hokusai(url: URL(fileURLWithPath: "emblem.png")).resize(width: 64).raw(.rgb8)
print("raw out:", frame.width, "×", frame.height, "stride", frame.rowStride, "bytes", frame.byteCount, "format", frame.format)
// A wrong byte count is rejected before any native work.
do { _ = try Hokusai(raw: Data(count: 10), width: 4, height: 2, format: .rgba8) } catch { print("bad count →", error) }
  • Крихітне зображення 4 на 2, зібране вручну з необроблених пікселів і збільшене методом найближчого сусіда: вісім кольорових блоків.
    4 × 2 → 200PNG · 200 × 100 · 1 KB

raw(_ format:premultiplied:background:) (типово .rgba8, false, .white) повертає RawImage, що вказує все потрібне для читання: data, width, height, format, rowStride, premultiplied, byteCount. Рядки йдуть згори донизу, а пікселі — зліва направо. Власний вивід Hokusai щільно упакований (rowStride == width × bytesPerPixel, а приклад вивів крок 192 і 12 288 байтів для кадру rgb8 64 × 64). Передайте RawImage назад у Hokusai(raw:) без змін, щоб пройти цикл. background заповнює прозорість, коли формат не має альфи.

raw не має кодувальника: виклик на конвеєрі з обраним кодувальником викидає invalidOption («an encoder is selected; raw output has no encoder, so use data() for an encoded image»).

Ситуація Результат
Кількість байтів не відповідає геометрії invalidInput: «raw data is 10 bytes; a 4×2 rgba8 image with a row stride of 16 needs 32»
Недопустимий чи завеликий розмір, замалий крок або рядок, що переповнюється invalidOption, викидається ініціалізатором
Перевищено ліміти resource