NSGraphicsContext é uma classe fundamental no desenvolvimento de aplicações macOS que permite gerenciar contextos gráficos. Esses contextos são essenciais para desenhar gráficos, imagens e texto em janelas, views e outros componentes de interface do usuário. Neste artigo, vamos explorar como utilizar NSGraphicsContext para criar gráficos personalizados em uma aplicação macOS.

O que é NSGraphicsContext?

NSGraphicsContext é uma classe do framework AppKit que encapsula o estado de um contexto gráfico. Um contexto gráfico é uma área de desenho onde você pode renderizar gráficos, imagens e texto. No macOS, NSGraphicsContext é frequentemente usado em conjunto com NSBezierPath, NSImage, e outras classes gráficas para criar interfaces de usuário ricas e visualmente atraentes.

Criando um Contexto Gráfico

Para começar a desenhar, você precisa criar um contexto gráfico. Isso pode ser feito de várias maneiras, dependendo de onde você deseja desenhar. Aqui está um exemplo básico de como criar um contexto gráfico para desenhar em uma view personalizada:

import Cocoa

class CustomView: NSView {
    override func draw(_ dirtyRect: NSRect) {
        super.draw(dirtyRect)

        // Obtém o contexto gráfico atual
        guard let context = NSGraphicsContext.current?.cgContext else {
            return
        }

        // Configura o contexto gráfico
        context.setLineWidth(2.0)
        context.setStrokeColor(NSColor.red.cgColor)

        // Desenha um retângulo
        let rectangle = NSRect(x: 10, y: 10, width: 100, height: 100)
        context.stroke(rectangle)
    }
}

Neste exemplo, criamos uma subclasse de NSView e sobrescrevemos o método draw(_:). Dentro deste método, obtemos o contexto gráfico atual usando NSGraphicsContext.current?.cgContext e configuramos algumas propriedades, como a largura da linha e a cor de traço. Finalmente, desenhamos um retângulo no contexto gráfico.

Trabalhando com Imagens

Além de desenhar formas básicas, você também pode usar NSGraphicsContext para manipular imagens. Aqui está um exemplo de como desenhar uma imagem em um contexto gráfico:

import Cocoa

class CustomView: NSView {
    override func draw(_ dirtyRect: NSRect) {
        super.draw(dirtyRect)

        // Obtém o contexto gráfico atual
        guard let context = NSGraphicsContext.current?.cgContext else {
            return
        }

        // Carrega uma imagem
        if let image = NSImage(named: "exampleImage") {
            // Desenha a imagem no contexto gráfico
            image.draw(in: NSRect(x: 10, y: 10, width: 100, height: 100))
        }
    }
}

Neste exemplo, carregamos uma imagem chamada "exampleImage" do bundle do aplicativo e a desenhamos na view.

Salvando e Restaurando o Estado do Contexto Gráfico

Às vezes, você pode precisar salvar e restaurar o estado do contexto gráfico para garantir que suas operações de desenho não afetem outras partes do código. Você pode fazer isso usando os métodos saveGraphicsState() e restoreGraphicsState():

import Cocoa

class CustomView: NSView {
    override func draw(_ dirtyRect: NSRect) {
        super.draw(dirtyRect)

        // Obtém o contexto gráfico atual
        guard let context = NSGraphicsContext.current?.cgContext else {
            return
        }

        // Salva o estado atual do contexto gráfico
        context.saveGState()

        // Configura o contexto gráfico
        context.setLineWidth(2.0)
        context.setStrokeColor(NSColor.blue.cgColor)

        // Desenha um círculo
        let circle = NSRect(x: 50, y: 50, width: 100, height: 100)
        context.strokeEllipse(in: circle)

        // Restaura o estado anterior do contexto gráfico
        context.restoreGState()
    }
}

Neste exemplo, salvamos o estado atual do contexto gráfico antes de fazer qualquer alteração e restauramos o estado após desenhar um círculo. Isso garante que quaisquer mudanças feitas no contexto gráfico não afetem outras operações de desenho.

Conclusão

NSGraphicsContext é uma ferramenta poderosa para gerenciar contextos gráficos em aplicações macOS. Com ele, você pode criar gráficos personalizados, manipular imagens e gerenciar o estado do contexto gráfico de forma eficiente. Esperamos que este artigo tenha fornecido uma visão clara de como utilizar NSGraphicsContext em suas próprias aplicações.