setNeedsDisplay(): esența metodei și mecanismul de redeseneare în iOS

Ce este setNeedsDisplay()

setNeedsDisplay() — este o metodă UIView care semnalează sistemului că conținutul vederii este învechit și necesită rerandare. Metoda nu acceptă parametri și returnează void. După apel, vederea este marcată ca dirty, iar în cel mai apropiat ciclu de desenare sistemul apelează draw(_:) pentru această vedere.

Caracteristica cheie este asincronitatea. Mai multe apeluri consecutive setNeedsDisplay() pentru aceeași vedere nu vor duce la apeluri multiple draw(_:) — sistemul le combină într-o singură operație. Acest lucru este critic pentru performanță: dacă o proprietate a vederii se schimbă de mai multe ori pe cadru, draw(_:) este apelat o singură dată.

Cum funcționează redesenarea amânată

Mecanismul de redesenare amânată se bazează pe ciclul de randare UIKit. Când setNeedsDisplay() este apelat, sistemul setează flagul intern layer.needsDisplay la true. La sfârșitul run loop curent, sistemul parcurge toate straturile dirty și apelează draw(_:) pentru fiecare.

Run loop și pașii de randare

UIKit run loop include faza update, în care sunt procesate vederile dirty. În această fază, layoutSubviews() este apelat dacă este necesar, apoi draw(_:) pentru toate vederile marcate. După finalizarea desenării, rezultatul este transmis la GPU prin Core Animation pentru compozitare.

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

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

        // Fundal
        ctx.setFillColor(UIColor.lightGray.cgColor)
        ctx.fill(rect)

        // Bara de progres
        let fillRect = CGRect(x: rect.minX, y: rect.minY,
                              width: rect.width * progress, height: rect.height)
        ctx.setFillColor(UIColor.systemGreen.cgColor)
        ctx.fill(fillRect)
    }
}

În acest exemplu, progressView actualizează progress, iar fiecare setter apelează automat setNeedsDisplay(). Sistemul așteaptă sfârșitul run loop și apelează draw(_:) cu valoarea curentă a progress. Dacă progress se schimbă de trei ori într-un cadru, draw(_:) se execută o singură dată — cu ultima valoare.

setNeedsDisplay() vs setNeedsDisplay(_:)

Metoda setNeedsDisplay(_:) acceptă parametrul rect de tip CGRect, care limitează zona de redesenare. Aceasta permite redesenarea doar a părții modificate a vederii, nu a întregului. Diferența de performanță devine vizibilă la lucrul cu vederi mari, unde modificările afectează o zonă mică.

Pentru grafica complexă, se recomandă mai întâi desenarea întregii scene într-un context offscreen, apoi apelarea setNeedsDisplay(_:) doar pentru zona modificată. Aceasta este o tehnică standard în aplicațiile de desenare și editorii grafici pe iOS.

displayIfNeeded() contra setNeedsDisplay()

displayIfNeeded() — este o metodă sincronă care lansează imediat redesenarea tuturor vederilor dirty din ierarhie, fără a aștepta sfârșitul run loop. Spre deosebire de setNeedsDisplay(), care doar setează un flag, displayIfNeeded() forțează executarea imediată a draw(_:).

Apple recomandă utilizarea displayIfNeeded() doar în cazuri extreme, când rezultatul desenării este necesar imediat — de exemplu, înainte de a crea o captură de ecran sau la generarea sincronă a unei imagini pentru UIGraphicsImageRenderer. În scenariile obișnuite, modelul asincron prin setNeedsDisplay() este preferat, deoarece nu blochează thread-ul principal.

    // Asincron — recomandat
someView.setNeedsDisplay()

    // Sincron — doar când este necesar
someView.setNeedsDisplay()
someView.displayIfNeeded() // draw(_:) apelat imediat

Apelul displayIfNeeded() fără un setNeedsDisplay() prealabil nu va avea efect — metoda procesează doar vederile deja marcate ca dirty. Dacă nicio vedere nu necesită redesenare, displayIfNeeded() se încheie fără a apela draw(_:).

Optimizarea apelurilor setNeedsDisplay()

Apelurile frecvente setNeedsDisplay() pot reduce performanța, în special în timpul animației. Să examinăm principalele strategii de optimizare.

Combinarea modificărilor prin model

În loc să apelați setNeedsDisplay() la fiecare modificare a unei proprietăți individuale, acumulați modificările și apelați metoda o dată după aplicarea tuturor actualizărilor. De exemplu, la modificarea culorii, dimensiunii și poziției unui element — apelați setNeedsDisplay() o dată după setarea tuturor proprietăților.

Utilizarea CALayer pentru proprietăți animabile

Dacă o proprietate poate fi animată prin CALayer (backgroundColor, opacity, position, transform), utilizați Core Animation în loc de draw(_:). Proprietățile CALayer sunt actualizate pe GPU fără a apela draw(_:), oferind 60 FPS fără încărcarea CPU.

Actualizare în lot prin CATransaction

Pentru gruparea mai multor modificări într-o singură trecere de randare, utilizați CATransaction. Aceasta permite combinarea mai multor setNeedsDisplay() într-o singură operație draw(_:) la sfârșitul tranzacției.

CATransaction.begin()
CATransaction.setDisableActions(true)

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

CATransaction.commit()

Nu abuzați de displayIfNeeded() — redesenarea sincronă blochează main thread și poate cauza scăderea cadrelor. Utilizați-l doar pentru operațiile unde rezultatul desenării este critic înainte de finalizarea run loop curent.