Como usar bibliotecas feitas para o Processing Java

No Processing IDE você as instalava bibliotecas Java desenvolvidas pela comunidade usando o painel Manage Libraries... do IDE, e no antigo modo Python se usava uma função add_library().

Muitas das bibliotecas feitas para o Processing funcionam com o py5, e é possível usar esta função ajudante py5_tools.processing.download_library(), que baixa os arquivos de uma biblioteca cadastrada pela comunidade Processing, como por exemplo a biblioteca PeasyCam cujo exemplo vamos mostrar aqui.

import py5_tools
print(py5_tools.processing.download_library("PeasyCam"))  # o print é opcional, pra ver o resultado

Essa instalação da biblioteca precisa ser feita uma vez só. E caso a biblioteca não esteja no cadastro da Fundação Processing, é possível copiar manulamente os arquivos .jar para a pasta do sketch, ou ainda, indicar onde eles se encontram seguindo instruções na documentação do py5.

Muitas dessas bibliotecas precisam na sua inicialização de uma referência do sketch em execução, que no Java é obtida com a expressão this. Com py5 podemos obter essa referência chamando a função get_current_sketch().

Um exemplo com PeasyCam

from itertools import product    

# No module mode esta intrução precisaria acontecer depois de `import py5`
from peasy import PeasyCam   # é preciso descobrir o nome do módulo, neste caso `peasy`

def setup():
    global cam 
    size(512, 512, P3D)
    this = get_current_sketch() # o equivalnete ao `this` do Java
    cam = PeasyCam(this, 400)
    cam.setMinimumDistance(300);
    cam.setMaximumDistance(500);

def draw():
    background(0)
    color_mode(HSB)
    random_seed(1)
    cs = 32
    for i, j, k in product(range(-3, 4), repeat=3):
        x, y, z = i * cs, j * cs, k * cs 
        bs = random_choice((4, 8, 16, 32))
        fill(bs * 4, 255, 150)
        with push_matrix():
            translate(x, y, z)
            box(bs)
    # exemplo do HUD, desenho de emementos ancorados à tela 
    cam.beginHUD()
    fill(255)
    text_size(20)
    text('PeasyCam demo', 15, 15)
    cam.endHUD()