Público

Los objetos que dan a la escena lo que hace el público: las encuestas y cuestionarios, la clasificación, los equipos, la sala, los personajes y las zonas vivas. Ninguno dibuja nada por sí mismo: dan Parameter, textos en vivo, barras y condiciones para que diseñes el juego. Fuera de una presentación en vivo siguen al ensayo (scene.rehearsal); al presentar, al relay.

Los métodos de Scene que los crean (poll, quiz, question, leaderboard, teams, audience, rehearsal, character y live_zone) están en Escena. Las guías están en Público en vivo.

Encuestas y cuestionarios

poll = scene.poll("¿Té o café?", ["Té", "Café"], rehearse=[2, 3])
scene.viz.readout(poll.percent(1), format=".0f", suffix=" % café")

scene.geometry.rounded_rect(3.4, 3.4, 0.2).fill(WHITE).no_stroke().move_to(-5, 0)
poll.qr(3.0).move_to(-5, 0)
scene.text(poll.code, size=0.5).move_to(-5, -2.2)

scene.viz.readout(poll.votes(0), format=".0f", prefix="Té: ")
scene.viz.readout(poll.total(), format=".0f", suffix=" votos").move_to(0, -1)

poll.bar(0, length=5, thickness=0.4, radius=0.2).fill(RED).no_stroke().move_to(1, 1)

for i, answer in enumerate(poll.options):
    scene.geometry.rounded_rect(6, 1.4, 0.3).fill(poll.color(i)).no_stroke().move_to(0, 1 - 1.8 * i)
    poll.icon(i, 0.6).fill(WHITE).move_to(-2.2, 1 - 1.8 * i)

quiz = scene.quiz("¿2 + 2?", ["3", "4"], correct=1)
scene.stop(until=quiz.answered(share=0.9) | quiz.time_up())

clock = scene.viz.readout(quiz.remaining(), format=".0f", suffix=" s").move_to(6, 3.5)

quiz = scene.quiz("¿2 + 2?", ["3", "4"], correct=1)
scene.stop()
quiz.reveal()

quiz = scene.quiz("¿2 + 2?", ["3", "4"], correct=1)
shown = quiz.revealed()
for i in range(2):
    scene.viz.readout(quiz.percent(i), format=".0f", suffix="%").move_to(4 * i - 2, 0).opacity(shown)
scene.wait(2)
scene.stop()
quiz.reveal()

Clasificación

board = scene.leaderboard()
for rank in range(3):
    board.name(rank, size=0.5).move_to(-3, 1 - rank)
    scene.viz.readout(board.points(rank), format=".0f").move_to(3, 1 - rank)

board.name(0, size=0.6, align="left").fill(GOLD).move_to(-3, 1)

Equipos

teams = scene.teams(["Rojo", "Azul"], colors=["#ff4f8b", "#2fb8ff"])
for team, x in [(0, -4), (1, 4)]:
    scene.text(teams.names[team], size=0.6).fill(teams.colors[team]).move_to(x, 2)
    scene.viz.readout(teams.score(team), format=".0f", suffix=" pts").move_to(x, 1)

Sala

audience = scene.audience()
for slot in range(8):
    audience.name(slot, size=0.4).move_to(-6 + slot * 1.7, -2)
scene.viz.readout(audience.count(), format=".0f", suffix=" en la sala")

pop = computed(lambda a: min(a / 0.4, 1), inputs=[audience.age(0)])
audience.name(0, size=0.5).scale_to(pop)
scene.stop("sala", until=audience.at_least(5))

Personajes y zonas vivas

hero = scene.character([1, 0, 4, 2, 1], name="Ana").move_to(-3, 0)
hero.express("winner", loop=True)
scene.wait(2)

quiz = scene.quiz("¿2 + 2?", ["3", "4"], correct=1)
scene.stop(until=quiz.answered(share=0.8) | quiz.time_up())

gaanim.live

El módulo gaanim.live tiene lo que usan los comportamientos de una zona viva. Ver la guía Zonas vivas para el subconjunto de Python que se compila.

pose

pose(x, y, *, rotation=0, scale=1, sx=1, sy=1, lean=0, look_x=None,
look_y=None, show_name=True, flip=False, visible=True, express=None,
since=None, loop=False) dice dónde está un personaje y cómo se ve.

El jugador

El comportamiento recibe al jugador p con estos campos:

gaanim.live.Player crea un jugador de muestra con esos campos, para probar un comportamiento en Python: fila(Player(index=2, t=0.5)).

Estado y ayudas

• state(**valores): los siguientes números guardados, como los devuelve una función update; los que no nombra conservan su valor.
• STEP: cada cuánto corre update, 1/60 s. MAX_STATE: cuántos números puede guardar una zona, 8.
• clamp(x, low=0, high=1), lerp(a, b, u) y progress(t, start=0, duration=1).
• Curvas de 0 a 1: smoothstep(u), ease_in(u), ease_out(u), ease_in_out(u) y ease_out_back(u, overshoot=1.7), que se pasa y vuelve.
• Movimiento: spring(t, frequency=2, damping=0.3), un resorte de 0 a 1; wobble(t, amount=1, frequency=3, decay=4), una sacudida que se apaga; impact(t, amount=0.35, ...) y anticipate(t, at, amount=0.25,
duration=0.3), que devuelven (sx, sy) para aplastar al aterrizar y agacharse antes de saltar; ballistic(t, x, y, vx, vy, gravity=9.8), la posición de un tiro parabólico, y landing(vy, drop, gravity=9.8), cuándo cae.
• BehaviorError: lo que lanza scene.live_zone cuando el comportamiento usa algo que no se compila, señalando la línea.

Preguntas en archivos

gaanim.load_questions(path) lee las preguntas de un .md (o .txt) o un .csv, con la ruta relativa al script que lo llama, y devuelve una lista de Question. Un archivo con una pregunta sin respuestas, más de 6 respuestas, una clave desconocida o un valor que no es un número lanza QuestionError con el archivo y la línea. El formato está en Preguntas en un archivo.

scene.question(q) abre la pregunta como cuestionario o encuesta según tenga respuestas correctas.