setNeedsDisplay(): суть методу та механізм перемалювання в iOS

Що таке setNeedsDisplay()

setNeedsDisplay() — це метод UIView, який сигналізує системі, що вміст в’ю застарів і потребує повторного рендерингу. Метод не приймає параметрів і повертає void. Після виклику в’ю позначається як dirty, і в найближчому циклі відтворення система викликає draw(_:) для цієї в’ю.

Ключова особливість — асинхронність. Кілька послідовних викликів setNeedsDisplay() для однієї в’ю не призведуть до множинних викликів draw(_:) — система об’єднує їх в одну операцію. Це критично важливо для продуктивності: якщо властивість в’ю змінюється кілька разів за кадр, draw(_:) викликається лише один раз.

Як працює відкладене перемалювання

Механізм відкладеного перемалювання базується на циклі рендерингу UIKit. Коли викликається setNeedsDisplay(), система встановлює внутрішній прапорець layer.needsDisplay у true. Наприкінці поточного run loop система проходить по всіх dirty-шарах і викликає draw(_:) для кожного.

Run loop та кроки рендерингу

UIKit run loop включає фазу оновлення, під час якої обробляються dirty в’ю. На цій фазі відбувається виклик layoutSubviews() за потреби, потім draw(_:) для всіх позначених в’ю. Після завершення відтворення результат передається на GPU через Core Animation для композитингу.

class ProgressView: UIView {
    var progress: CGFloat = 0 {
        didSet {
            setNeedsDisplay()
        }
    }

    override func draw(_ rect: CGRect) {
        super.draw(rect)
        guard let ctx = UIGraphicsGetCurrentContext() else { return }

        // Фон
        ctx.setFillColor(UIColor.lightGray.cgColor)
        ctx.fill(rect)

        // Панель прогресу
        let fillRect = CGRect(x: rect.minX, y: rect.minY,
                              width: rect.width * progress, height: rect.height)
        ctx.setFillColor(UIColor.systemGreen.cgColor)
        ctx.fill(fillRect)
    }
}

У цьому прикладі progressView оновлює progress, і кожен сетер автоматично викликає setNeedsDisplay(). Система дочекається кінця run loop і викличе draw(_:) з актуальним значенням progress. Якщо progress зміниться тричі за кадр, draw(_:) виконається лише один раз — з останнім значенням.

setNeedsDisplay() vs setNeedsDisplay(_:)

Метод setNeedsDisplay(_:) приймає параметр rect типу CGRect, що обмежує область перемалювання. Це дозволяє перемальовувати лише змінену частину в’ю, а не все цілком. Різниця в продуктивності стає помітною під час роботи з великими в’ю, де зміни зачіпають малу область.

Для складної графіки рекомендується спочатку малювати всю сцену в offscreen контекст, а потім викликати setNeedsDisplay(_:) лише для зміненої області. Це стандартна техніка в додатках для малювання та графічних редакторах на iOS.

displayIfNeeded() проти setNeedsDisplay()

displayIfNeeded() — це синхронний метод, який негайно запускає перемалювання всіх dirty в’ю в ієрархії, не чекаючи кінця run loop. На відміну від setNeedsDisplay(), який лише встановлює прапорець, displayIfNeeded() форсує негайне виконання draw(_:).

Apple рекомендує використовувати displayIfNeeded() лише в крайніх випадках, коли результат відтворення потрібен негайно — наприклад, перед створенням скріншота або при синхронній генерації зображення для UIGraphicsImageRenderer. У звичайних сценаріях асинхронна модель через setNeedsDisplay() є кращою, оскільки не блокує головний потік.

    // Асинхронний — рекомендовано
someView.setNeedsDisplay()

    // Синхронний — лише коли необхідно
someView.setNeedsDisplay()
someView.displayIfNeeded() // draw(_:) викликано негайно

Виклик displayIfNeeded() без попереднього setNeedsDisplay() не дасть ефекту — метод обробляє лише вже позначені як dirty в’ю. Якщо жодна в’ю не потребує перемалювання, displayIfNeeded() завершиться без виклику draw(_:).

Оптимізація викликів setNeedsDisplay()

Часті виклики setNeedsDisplay() можуть знизити продуктивність, особливо під час анімації. Розглянемо основні стратегії оптимізації.

Об’єднання змін через модель

Замість виклику setNeedsDisplay() при кожній зміні окремої властивості накопичуйте зміни та викликайте метод один раз після застосування всіх оновлень. Наприклад, при зміні кольору, розміру та позиції елемента — викличте setNeedsDisplay() один раз після встановлення всіх властивостей.

Використання CALayer для анімованих властивостей

Якщо властивість може бути анімована через CALayer (backgroundColor, opacity, position, transform), використовуйте Core Animation замість draw(_:). Властивості CALayer оновлюються на GPU без виклику draw(_:), що забезпечує 60 FPS без навантаження на CPU.

Пакетне оновлення через CATransaction

Для групування кількох змін в один прохід рендерингу використовуйте CATransaction. Це дозволяє об’єднати кілька setNeedsDisplay() в одну операцію draw(_:) в кінці транзакції.

CATransaction.begin()
CATransaction.setDisableActions(true)

view1.setNeedsDisplay()
view2.setNeedsDisplay()
view3.setNeedsDisplay()

CATransaction.commit()

Не зловживайте displayIfNeeded() — синхронне перемалювання блокує main thread і може викликати дроп кадрів. Використовуйте її лише для операцій, де результат відтворення критично важливий до завершення поточного run loop.