setNeedsDisplay(): essenza del metodo e meccanismo di ridisegno in iOS

Cos'è setNeedsDisplay()

setNeedsDisplay() è un metodo di UIView che segnala al sistema che il contenuto della vista è obsoleto e necessita di essere renderizzato nuovamente. Il metodo non accetta parametri e restituisce void. Dopo la chiamata, la vista viene marcata come dirty, e nel ciclo di disegno più vicino il sistema chiama draw(_:) per questa vista.

La caratteristica principale è l'asincronicità. Chiamate consecutive multiple a setNeedsDisplay() per la stessa vista non provocheranno chiamate multiple a draw(_:) — il sistema le combina in un'unica operazione. Questo è criticamente importante per le prestazioni: se una proprietà della vista cambia più volte per frame, draw(_:) viene chiamato una sola volta.

Come funziona il ridisegno differito

Il meccanismo di ridisegno differito si basa sul ciclo di rendering di UIKit. Quando viene chiamato setNeedsDisplay(), il sistema imposta il flag interno layer.needsDisplay su true. Alla fine del run loop corrente, il sistema scorre tutti i layer dirty e chiama draw(_:) per ciascuno.

Run loop e fasi di rendering

Il run loop di UIKit include una fase di aggiornamento durante la quale vengono elaborate le viste dirty. In questa fase, viene chiamato layoutSubviews() se necessario, poi draw(_:) per tutte le viste marcate. Dopo il completamento del disegno, il risultato viene passato alla GPU tramite Core Animation per il compositing.

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

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

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

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

In questo esempio, progressView aggiorna progress e ogni setter chiama automaticamente setNeedsDisplay(). Il sistema attende la fine del run loop e chiama draw(_:) con il valore effettivo di progress. Se progress cambia tre volte per frame, draw(_:) viene eseguito solo una volta — con l'ultimo valore.

setNeedsDisplay() vs setNeedsDisplay(_:)

Il metodo setNeedsDisplay(_:) accetta un parametro rect di tipo CGRect, limitando l'area di ridisegno. Questo consente di ridisegnare solo la parte modificata della vista, invece dell'intera vista. La differenza di prestazioni diventa evidente quando si lavora con viste grandi dove le modifiche interessano una piccola area.

Per grafica complessa, si consiglia di disegnare prima l'intera scena in un contesto offscreen, quindi chiamare setNeedsDisplay(_:) solo per l'area modificata. Questa è una tecnica standard nelle applicazioni di disegno e negli editor grafici su iOS.

displayIfNeeded() contro setNeedsDisplay()

displayIfNeeded() è un metodo sincrono che attiva immediatamente il ridisegno di tutte le viste dirty nella gerarchia, senza attendere la fine del run loop. A differenza di setNeedsDisplay(), che imposta solo un flag, displayIfNeeded() forza l'esecuzione immediata di draw(_:).

Apple raccomanda di utilizzare displayIfNeeded() solo in casi estremi quando il risultato del disegno è necessario immediatamente — ad esempio, prima di fare uno screenshot o durante la generazione sincrona di immagini per UIGraphicsImageRenderer. Negli scenari normali, il modello asincrono tramite setNeedsDisplay() è preferibile poiché non blocca il thread principale.

    // Asincrono — raccomandato
someView.setNeedsDisplay()

    // Sincrono — solo quando necessario
someView.setNeedsDisplay()
someView.displayIfNeeded() // draw(_:) chiamato immediatamente

Chiamare displayIfNeeded() senza un precedente setNeedsDisplay() non avrà effetto — il metodo elabora solo le viste già marcate come dirty. Se nessuna vista necessita di ridisegno, displayIfNeeded() termina senza chiamare draw(_:).

Ottimizzazione delle chiamate a setNeedsDisplay()

Chiamate frequenti a setNeedsDisplay() possono degradare le prestazioni, specialmente durante le animazioni. Esaminiamo le principali strategie di ottimizzazione.

Raggruppamento delle modifiche tramite un modello

Invece di chiamare setNeedsDisplay() ad ogni modifica di una proprietà individuale, accumula le modifiche e chiama il metodo una volta dopo aver applicato tutti gli aggiornamenti. Ad esempio, quando si modificano colore, dimensione e posizione di un elemento — chiama setNeedsDisplay() una volta dopo aver impostato tutte le proprietà.

Utilizzo di CALayer per proprietà animabili

Se una proprietà può essere animata tramite CALayer (backgroundColor, opacity, position, transform), usa Core Animation invece di draw(_:). Le proprietà CALayer vengono aggiornate sulla GPU senza chiamare draw(_:), fornendo 60 FPS senza carico sulla CPU.

Aggiornamento batch tramite CATransaction

Per raggruppare più modifiche in un unico passaggio di rendering, usa CATransaction. Ciò consente di combinare più chiamate setNeedsDisplay() in un'unica operazione draw(_:) alla fine della transazione.

CATransaction.begin()
CATransaction.setDisableActions(true)

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

CATransaction.commit()

Non abusare di displayIfNeeded() — il ridisegno sincrono blocca il thread principale e può causare cadute di fotogrammi. Usalo solo per operazioni in cui il risultato del disegno è critico prima della fine del run loop corrente.