Usar botones

Para mostrar un botón en Pilas, debemos usar un actor de tipo pilas.actores.Boton al que, al menos, le tendremos que pasar como argumento una imagen. De hecho, los botones usan hasta tres imágenes; la imagen normal del botón (que se pasa con el argumento de nombre 'ruta_normal'), la imagen que muestra cuando el ratón pasa sobre él ('ruta_over') y la que muestra cuando se hace click en él ('ruta_press')
Podemos cambiar a cualquiera de esas imágenes usando los métodos predefinidos pintar_normal(), pintar_sobre() y pintar_presionado(). Lo normal para hacerlo es a través de los respectivos eventos. De hecho podemos enlazarlos con la función que deseemos a través de otros tantos métodos predefinidos; conectar_norma()l, conectar_sobre() y conectar_presionado().
Con el siguiente ejemplo, debería quedar claro su uso:

import pilas
 
 
pilas.iniciar()
 
boton = pilas.actores.Boton(ruta_normal="normal.png",
                    ruta_press="click.png",
                    ruta_over="encima.png")
 
 
def normal():
    boton.pintar_normal()
    boton.escala = [1], 0.1
 
 
def sobre():
    boton.pintar_sobre()
    boton.escala = [2], 0.1
 
 
def presionado():
    boton.pintar_presionado()
    pilas.actores.Texto("Hola, caracola", y=200)
 
boton.conectar_normal(normal)
 
boton.conectar_sobre(sobre)
 
boton.conectar_presionado(presionado)
 
 
pilas.ejecutar()