“Olá, Mundo!” com Python no PSP

Como falei no post anterior, comprei um PSP recentemente e entre uma jogatina e outra descobri várias coisas bacanas que se podia fazer nele, incluindo programar em python. Infelizmente só hoje tive tempo de fuçar um pouco sobre o assunto e escrever meu primeiro código em python psp: o famoso "olá, mundo!".

Para rodar python no PSP eu precisei do PSP Stackless Python, um port da linguagem para o PSP feito por um brasileiro: Carlos Eduardo. A última versão do port é  2.5.2, que já dá para fazer bastante coisa.

Infelizmente no site do projeto há pouca documentação disponível (pior ainda se você procurar em pt-br). Como me interessei no assunto, e até para ajudar o Carlos, resolvi criar um tutorial básico mostrando como fiz para escrever um "Olá, Mundo!" na tela do PSP. Obviamente, dá para fazer muito mais que isso. :P

"Instalando" o python

O primeiro passo é "instalar" o PSP Stackless Python no seu PSP. Baixe a versão mais atual no site do projeto. Procure por StacklessPSP-2.5.2_R1.zip:

Descompactando o arquivo baixando você encontra: EBOOT.PBP e python.zip. Tudo o que você precisa fazer é copiar estes dois arquivos para o diretório PSP/GAME, que fica dentro do memory stick. Pronto, a "instalação" foi feita. :-)

NOTA: Recomendo que você crie um sub-diretório em PSP/GAME chamada "python", por exemplo, e coloque os dois arquivos dentro dele. Isso ajuda a manter uma melhor organização.

Para verificar é só ligar seu PSP e ir em GAME -> Memory Stick. Se tudo foi feito corretamente você verá o Stackless Python pronto para ser rodado:

O "Olá, Mundo!"

Sempre que o python for executado, ele procurará um arquivo chamado script.py dentro do mesmo diretório onde estão o EBOOT.PBP e o python.zip. É neste arquivo (script.py) que vamos colocar o nosso código.

Abra seu editor de texto preferido e cole o código abaixo:

# -*- encoding: utf-8 -*-
 
import psp2d
 
def main(mensagem):
 
    tela  = psp2d.Screen()
    fundo = psp2d.Image(480, 272)
    fonte = psp2d.Font('font.png')
 
    tela.blit(fundo)
    fonte.drawText(tela, 0, 0, mensagem)
    tela.swap()
 
    while True:
        joystick = psp2d.Controller()
        if joystick.circle:
            break
 
if __name__ == '__main__':
    try:
        main('Ola, mundo! =)')
    except:
        import traceback
        traceback.print_exc(file = file('erro.txt', 'w'))

Depois é só copiar este arquivo para dentro do mesmo diretório onde está o python e o EBOOT.PBP. PSP/GAME, ou PSP/GAME/python se você criou um subdiretório como eu recomendei.

Agora é só ligar seu PSP novamente, rodar o python e tchã-dan:

Seu primeiro script em python estará rodando. :-) Legal, né?

Entendendo o código

Vou explicar melhor o código. Como o foco aqui não é ensinar a linguagem em si não vou me prender a conceitos da mesma e vou explicar apenas a parte necessária para se imprimir o "Olá, mundo!".

Quem já programa em python já deve estar familiarizado com a estrutura do código (identação, definição de função e tratamento de erros). Se ainda não programa recomendo que entre no site do python brasil e dê uma olhada nos ótimos tutoriais que existem por lá.

Enfim, vamos lá:

import psp2d

Aqui estamos importando o módulo psp2d. Com ele podemos fazer todo tipo de desenho 2d na tela, inclusive escrever o texto que queremos. :-)

Existem outros módulos que você usar como, por exemplo:

• pspnet - Módulo com classes e funções relacionadas à rede
• pspsnd - Módulo que permite o controle de som e música
• pspos - Módulo com funções específicas do PSP

Se quiser uma referência completa destes módulos visite http://python-psp.net/pspdoc/ .

    tela  = psp2d.Screen()

A classe "Screen" representa a tela do PSP e você sempre precisará de uma para poder fazer qualquer coisa.

    fundo = psp2d.Image(480, 272)

Essa linha serve para criar o fundo da tela, com as mesmas dimensões dela. No caso, você está definindo 480 para a largura e 272 para altura.

    fonte = psp2d.Font('font.png')

Aqui estamos instanciando uma Fonte. Precisamos de uma para poder mostrar um texto, claro. Infelizmente não existe nenhuma fonte embutida, então você precisará baixar uma. O tipo da fonte é SFonte.

A font.png que eu usei no exemplo pode ser baixada aqui. Você precisa colocá-la no mesmo diretório do python.

    tela.blit(fundo)

O método blit serve para copiar um objeto para sua instância. No caso, estamos copiando o fundo para a tela.

    fonte.drawText(tela, 0, 0, mensagem)

O método drawText é usado para desenharmos o texto na tela. Seu uso é:

fonte.drawText(tela, posicaoX, posicaoY, mensagem)

No caso estamos desenhando na tela, na posição 0x 0y, o conteúdo da variável mensagem.

    tela.swap()

Para se desenhar na tela são necessários dois buffers. Isso significa que ao invés de termos um buffer representando a tela, temos dois. Um é o buffer da visualização em si (display buffer), e o outro é o buffer do desenho (draw buffer).

Todas as opções de desenho são direcionadas ao buffer de desenho, que não é mostrado na tela. O método "swap" do objeto Screen troca o buffer de desenho e o buffer de visualização, fazendo com que o que desenhos na tela seja, de fato, mostrado nela.

O código mostrado aqui é o referente ao desenho do texto na tela.

  while True:
        joystick = psp2d.Controller()
        if joystick.circle:
            break

Este trecho do código está instanciando a classe Controller, que serve para reconhecer os botões do PSP e, dessa forma, permitir que você possa definir ações. O código acima está basicamente dizendo que se o botão circulo for pressionado é para ele sair do programa. O while True garante que isso fique em loop até que o botão seja pressionado.

if __name__ == '__main__':
    try:
        main('Ola, mundo! =)')
    except:
        import traceback
        traceback.print_exc(file = file('erro.txt', 'w'))

O código acima basicamente faz com que o programa, ao rodar, chame o método main, passando a frase "Ola, mundo! =)" como parâmetro. Caso aconteça algum erro o mesmo deve ser salvo em um arquivo chamado "erro.txt".

Bem, é isso. Vou continuar brincando com o python no PSP e fazer alguns joguinhos. Se você interessou pelo assunto recomendo entrar no sites abaixo para mais informações e tutoriais:

• http://code.google.com/p/pspstacklesspython/
• http://python-psp.net/trac/wiki/Tutorial (Este post é, basicamente, uma tradução deste artigo)
• http://python-psp.net/pspdoc/