Introdução à programação
com Processing Modo Python

Como exportar uma imagem

Um frame é o resultado visual produzido na área de desenho do sketch no Processing em um determinado momento. Para salvar um frame em um arquivo bitmap/raster, como por exemplo PNG, TIF ou JPG, usamos a função saveFrame().

Passamos como argumento o nome do arquivo que deve ser salvo, e a extensão de três letras após o ponto no nome do arquivo indica o formato que deve ser salvo. Por exemplo saveFrame("imagem.jpg") salva um arquivo JPG na pasta do sketch. Se utilizarmos alguns caracteres “#” no nome do arquivo eles serão substituídos pelo número do frame.

O código abaixo exemplifica como salvar uma imagem PNG de um frame. Quando uma tecla é pressionada, é executada a função keyPressed() e se for identificada a tecla “s” (key == 's') é execuatada a função saveFrame(), que grava uma imagem na pasta do sketch.

Um exemplo bem simples

O código abaixo exemplifica como salvar uma imagem PNG de um frame. Quando uma tecla é pressionada, é executada a função keyPressed() e se for identificada a tecla “s” (key == 's') é executada a função saveFrame(), que grava uma imagem na pasta do sketch.

def setup():
    size(500, 500)

def draw():
    background(0, 0, 200)
    x, y = random(width), random(height)
    circle(x, y, 100)

def keyPressed():
    if key == 's':
        saveFrame("frame.png")
        print("PNG salvo")

Reulta no aquivo “frame421.png” na pasta do sketch:

frame421.png

saveFrame() dentro do draw()

Usar saveFrame()dentro do laço principal draw() torna o sketch muito mais lento, pois salva uma imagem a cada frame do draw. Acrescentando carateres # no nome do arquivo a ser salvo, um número grande de quadros pode ser salvo em alguns segundos, o que deve ser feito com cuidado (pode entupir o disco do seu computador).

Normalmente é criada uma condição que interrompe o sketch com exit() ou que só permite salvar um certo número de imagens (no exemplo abaixo, um quadro a cada 5 com frameCount % 5 == 0).

def draw():
    # desenho
    ...
    # salva só a cada 5 frames até o frame 100
    if frameCount % 5 == 0 and frameCount <= 100:
        saveFrame("imagem###.png")

Neste outro exemplo, data e horário no nome do arquivo e interrupção do sketch.

nome_output = '{}-{}-{}-{}-{}-{}-frame###.png'.format(year(), month(), day(),
                                                      hour(), minute(), second())
def draw():
    # desenho
    ...
    saveFrame(nome_output)
    if frameCount > 100:
        exit() # interrompe a execução do sketch   

Exportando em resolução maior do que a da tela

Um objeto PGraphics é uma espécie de tela virtual que pode gravar o resultado do desenho em paralelo à área de desenho normal, podendo também receber ajustes especiais aplicados apenas a esse objeto-tela, como .scale() no exemplo abaixo, o que permite exportar uma imagem 10 vezes maior do que a mostrada na tela.

def setup():
    size(50, 50)
    # preparo da gravação
    scale = 10
    f = createGraphics(width * scale, height * scale)
    beginRecord(f) #  início da gravação
    # ajustes que só afetam o arquivo sendo gravado
    f.scale(scale)
    f.strokeWeight(.5)

    # instruções que afentam a tela e o arquivo
    # sem background após o beginRecord o arquivo fica com fundo transparente!
    background(0, 200, 0)  
    circle(6, 6, 10)
    
    # fim da gravação
    endRecord()
    f.save("exportando_imagem_ampliada.png")

Repare que a espessura de linha está sendo ajustada para um valor diferente com f.strokeWeight(). Sem o ajuste ela ficaria 10 vezes maior no arquivo do que na área de desenho normal (acompanhando e resto da imagem) e desta maneira ela fica apenas 5 vezes maior no arquivo.

Exportando apenas parte da tela (e em um local selecionado!)

No exemplo a seguir, vamos usar a estratégia de desenhar em um objeto PGraphics como no exemplo anterior, e demonstrar também as seguintes possibilidades:

Ambos os textos da imagem acima, em preto e em branco, não estarão presentes no arquivo salvo, assim como toda a àrea cinza em volta ou qualquer elemento nela desenhado.

salvar = False

def setup():
    size(500, 500)
    global w, h, offset, f
    # dimensões da imagem e um deslocamento / margem
    w, h, margem = 400, 400, 50
    f = createGraphics(w, h)
    
def draw():   
    global salvar
    translate(margem, margem) # 0, 0 no canto da imagem a ser salva
    # instruções antes do beginRecord só aparecem na tela
    # Se não for criado fundo depois de beginRecord, no arquivo fundo transparente
    background(100)  # fundo geral na tela apenas
    fill(0)
    text(u'Só na tela', 0, -20)
    # início da gravação
    if salvar:
        beginRecord(f) #  início da gravação
    # As instruções aqui aparecem na tela e no arquivo
    noStroke()
    fill(0, 0, 200)
    rect(0, 0, w, h)  # fundo no arquivo usando um retângulo
    fill(0, 200, 0)
    circle(100, 100, 100)
    # fim da gravação
    if salvar:
        # instruções com 'f.' aparecem só na gravação
        f.fill(255, 0, 0)
        f.text(u'Só na gravação', 20, 300)    
        endRecord()
        salvar = False
        # em vez de f.save("arquivo_na_pasta_do_sketch.png")
        # vamos usar esta função selectOtuput que chama por nós salva_arquivo()
        selectOutput("Escolha onde Salvar", "salva_arquivo")
    # instruções depois do endRecord também aparecem só na tela
    fill(255)
    text(u'Também só na tela', 10, 20)

def keyPressed():
    global salvar
    if key == 's':
        salvar = True
        
def salva_arquivo(selection):
    """
    Um alerta: Cuidado! Possíveis 'falhas' nesta função,
    como erros de gravação (por disco cheio, ou falta de
    permissão para gravar em um diretório), mas também
    qualquer outros bugs que você introduzir ampliando
    este código, vão interromper esta linha de execução
    silencionamente, sem mostrar nenhum aviso de erro :(
    """
    if selection is not None:
        # importante usar unicode() em vez de str() aqui!
        nome = unicode(selection)  
        if not nome.lower().endswith('.png'):
            nome += '.png'
        f.save(nome);
        print("Imagem, salva em: " + nome)
    else:
        print("operação de salvar cancelada")

Note o texto em vermelho que só aparece no arquivo salvo.

Assuntos relacionados