__main__.py

"""2026-04-24
Vitral 01
Inspirado em vitrais, sketch com hexágonos e padrões de cores.
ericof.com|https://ericof.com/en/sketches/2023-06-01
png
Sketch,py5,CreativeCoding,Mosaico,Vitral
"""

from random import shuffle
from sketches.utils.draw import canvas
from sketches.utils.draw.formas import gera_hexagono
from sketches.utils.helpers import sketches as helpers

import py5


sketch = helpers.info_for_sketch(__file__, __doc__)

cor_fundo = py5.color(0)


hexagono: py5.Py5Shape | None = None
tamanho = 54
h_diff = 36
pontos: list[tuple[float, float]] = []


def calcula_pontos() -> list[tuple[float, float]]:
    """Calcula a grade escalonada de pontos onde os hexágonos serão posicionados.

    Gera coordenadas em linhas alternadas (com deslocamento horizontal de meia
    célula em linhas ímpares) cobrindo as dimensões externas do canvas, e
    embaralha a ordem para que a renderização por índice produza variação
    cromática não-sequencial.

    :returns: lista de pares ``(x, y)`` com as posições dos hexágonos.
    """
    global pontos
    pontos = []
    for idy, y in enumerate(range(0, helpers.DIMENSOES.external[1], tamanho)):
        buffer_x = 0 if idy % 2 else tamanho // 2
        for x in range(0, helpers.DIMENSOES.external[0], tamanho):
            pontos.append((x + buffer_x, y))
    shuffle(pontos)
    return pontos


def cores_elemento(idx: int, angulo: float) -> tuple[int, int]:
    """Deriva as cores de traço e preenchimento de um hexágono.

    O matiz é calculado a partir do índice deslocado por ``h_diff``. O
    preenchimento usa saturação plena (``s=100``), brilho cíclico no
    índice e transparência proporcional ao ``angulo`` da camada. O traço
    compartilha o mesmo matiz, com saturação remapeada no intervalo
    ``0..20`` e brilho zero — resultando em contorno escuro que reforça
    o efeito de vitral.

    :param idx: índice do ponto na grade embaralhada.
    :param angulo: ângulo, em graus, da camada rotacionada corrente;
        modula a transparência do preenchimento.
    :returns: par ``(traco, cor)`` com os valores ``py5.color`` para
        stroke e fill.
    """
    h = abs(idx % 360 - h_diff)
    s_traco = float(py5.remap(idx % 100, 0, 100, 0, 20))
    s = 100
    b = (idx % 50) * 2
    t = angulo / 6 + 60
    traco = py5.color(h, s_traco, 0)
    cor = py5.color(h, s, b, t)
    return traco, cor


def setup():
    """Inicializa o sketch.

    Define o tamanho do canvas, ativa P3D e o modo de cor HSB, cria o
    hexágono-base e calcula a grade de posicionamento.
    """
    global hexagono
    py5.size(*helpers.DIMENSOES.external, py5.P3D)
    py5.shape_mode(py5.CENTER)
    py5.color_mode(py5.HSB, 360, 100, 100)
    hexagono = gera_hexagono()
    calcula_pontos()


def draw():
    """Desenha o quadro atual.

    Para cada ângulo em passos de 45°, percorre a grade de pontos e
    aplica ao hexágono as cores obtidas via :func:`cores_elemento`,
    produzindo o efeito de sobreposição característico de vitrais. Ao
    final, renderiza a moldura de créditos do sketch.
    """
    py5.background(cor_fundo)
    if hexagono:
        with py5.push():
            py5.translate(*helpers.DIMENSOES.centro, -10)
            for angulo in range(0, 360, 45):
                py5.rotate(py5.radians(angulo))
                for idx, (x, y) in enumerate(pontos):
                    traco, cor = cores_elemento(idx, angulo)
                    hexagono.set_stroke(traco)
                    hexagono.set_stroke_weight(2)
                    hexagono.set_fill(cor)
                    py5.shape(hexagono, x, y, tamanho, tamanho)
    msg = f"T: {tamanho}, H: {h_diff}"
    # Credits and go
    canvas.sketch_frame(
        sketch,
        cor_fundo,
        "large_transparent_white",
        "transparent_white",
        version=2,
        msg=msg,
    )


def key_pressed():
    """Trata atalhos de teclado.

    - ``space``: salva a imagem e encerra o sketch.
    - ``r``: recalcula (reembaralha) a grade de pontos.
    - ``+`` / ``-``: incrementa ou decrementa o tamanho do hexágono em 2px
      e recalcula a grade.
    - ``>`` / ``<``: incrementa ou decrementa a diferença de matiz em 2 unidades
      e recalcula a grade.
    """
    global tamanho, h_diff
    key = py5.key
    match key:
        case " ":
            save_and_close()
        case "r":
            calcula_pontos()
        case "+":
            tamanho += 2
            calcula_pontos()
        case "-":
            tamanho -= 2
            calcula_pontos()
        case ">":
            h_diff += 2
            calcula_pontos()
        case "<":
            h_diff -= 2
            calcula_pontos()


def save_and_close():
    """Pausa o loop, salva o PNG do sketch e encerra a execução."""
    py5.no_loop()
    canvas.save_sketch_image(sketch)
    py5.exit_sketch()


if __name__ == "__main__":
    py5.run_sketch()