setNeedsDisplay(): esensi metode dan mekanisme penggambaran ulang di iOS

Apa itu setNeedsDisplay()

setNeedsDisplay() — adalah metode UIView yang memberi sinyal ke sistem bahwa konten tampilan sudah usang dan perlu render ulang. Metode ini tidak menerima parameter dan mengembalikan void. Setelah pemanggilan, tampilan ditandai sebagai dirty, dan dalam siklus penggambaran terdekat sistem memanggil draw(_:) untuk tampilan ini.

Fitur utamanya adalah asinkronitas. Beberapa pemanggilan setNeedsDisplay() secara berurutan untuk tampilan yang sama tidak akan menghasilkan beberapa pemanggilan draw(_:) — sistem menggabungkannya menjadi satu operasi. Ini sangat penting untuk kinerja: jika properti tampilan berubah beberapa kali per frame, draw(_:) hanya dipanggil satu kali.

Bagaimana penggambaran ulang yang ditangguhkan bekerja

Mekanisme penggambaran ulang yang ditangguhkan didasarkan pada siklus render UIKit. Ketika setNeedsDisplay() dipanggil, sistem mengatur flag internal layer.needsDisplay menjadi true. Di akhir run loop saat ini, sistem melewati semua layer dirty dan memanggil draw(_:) untuk masing-masing.

Run loop dan langkah-langkah render

UIKit run loop mencakup fase update, di mana tampilan dirty diproses. Dalam fase ini, layoutSubviews() dipanggil jika diperlukan, kemudian draw(_:) untuk semua tampilan yang ditandai. Setelah penggambaran selesai, hasilnya dikirim ke GPU melalui Core Animation untuk komposisi.

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

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

        // Latar belakang
        ctx.setFillColor(UIColor.lightGray.cgColor)
        ctx.fill(rect)

        // Bilah 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)
    }
}

Dalam contoh ini, progressView memperbarui progress, dan setiap setter secara otomatis memanggil setNeedsDisplay(). Sistem akan menunggu akhir run loop dan memanggil draw(_:) dengan nilai progress saat ini. Jika progress berubah tiga kali dalam satu frame, draw(_:) hanya akan dieksekusi satu kali — dengan nilai terakhir.

setNeedsDisplay() vs setNeedsDisplay(_:)

Metode setNeedsDisplay(_:) menerima parameter rect bertipe CGRect, yang membatasi area penggambaran ulang. Ini memungkinkan penggambaran ulang hanya bagian tampilan yang berubah, bukan keseluruhan. Perbedaan kinerja menjadi terlihat saat bekerja dengan tampilan besar di mana perubahan hanya mempengaruhi area kecil.

Untuk grafis kompleks, disarankan untuk menggambar seluruh scene dalam konteks offscreen terlebih dahulu, kemudian memanggil setNeedsDisplay(_:) hanya untuk area yang berubah. Ini adalah teknik standar dalam aplikasi menggambar dan editor grafis di iOS.

displayIfNeeded() vs setNeedsDisplay()

displayIfNeeded() — adalah metode sinkron yang segera memulai penggambaran ulang semua tampilan dirty dalam hierarki, tanpa menunggu akhir run loop. Tidak seperti setNeedsDisplay() yang hanya mengatur flag, displayIfNeeded() memaksa eksekusi segera dari draw(_:).

Apple merekomendasikan penggunaan displayIfNeeded() hanya dalam kasus ekstrem, ketika hasil penggambaran diperlukan segera — misalnya, sebelum membuat screenshot atau saat pembuatan gambar sinkron untuk UIGraphicsImageRenderer. Dalam skenario biasa, model asinkron melalui setNeedsDisplay() lebih disukai karena tidak memblokir thread utama.

    // Asinkron — direkomendasikan
someView.setNeedsDisplay()

    // Sinkron — hanya bila diperlukan
someView.setNeedsDisplay()
someView.displayIfNeeded() // draw(_:) dipanggil segera

Pemanggilan displayIfNeeded() tanpa setNeedsDisplay() sebelumnya tidak akan memberikan efek — metode ini hanya memproses tampilan yang sudah ditandai sebagai dirty. Jika tidak ada tampilan yang memerlukan penggambaran ulang, displayIfNeeded() akan selesai tanpa memanggil draw(_:).

Optimalisasi pemanggilan setNeedsDisplay()

Pemanggilan setNeedsDisplay() yang sering dapat menurunkan kinerja, terutama selama animasi. Mari kita lihat strategi optimalisasi utama.

Menggabungkan perubahan melalui model

Alih-alih memanggil setNeedsDisplay() pada setiap perubahan properti individu, kumpulkan perubahan dan panggil metode satu kali setelah menerapkan semua pembaruan. Misalnya, saat mengubah warna, ukuran, dan posisi elemen — panggil setNeedsDisplay() satu kali setelah mengatur semua properti.

Menggunakan CALayer untuk properti yang dapat dianimasi

Jika properti dapat dianimasi melalui CALayer (backgroundColor, opacity, position, transform), gunakan Core Animation daripada draw(_:). Properti CALayer diperbarui di GPU tanpa memanggil draw(_:), memberikan 60 FPS tanpa membebani CPU.

Pembaruan batch melalui CATransaction

Untuk mengelompokkan beberapa perubahan dalam satu lintasan render, gunakan CATransaction. Ini memungkinkan penggabungan beberapa setNeedsDisplay() menjadi satu operasi draw(_:) di akhir transaksi.

CATransaction.begin()
CATransaction.setDisableActions(true)

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

CATransaction.commit()

Jangan menyalahgunakan displayIfNeeded() — penggambaran ulang sinkron memblokir main thread dan dapat menyebabkan penurunan frame. Gunakan hanya untuk operasi di mana hasil penggambaran sangat penting sebelum akhir run loop saat ini.