Tutorial

Este é um tutorial sobre como utilizar a biblioteca Processing.gba – uma biblioteca em C que desenvolvemos para poética computacional que funciona em Game Boy Advance. Aqui não temos como intuito fazer um tutorial sobre lógica de programação, como hackear algum console ou como desenvolver algo complexo, sem mesmo como piratear um jogo. Longe disso, aqui temos como finalidade apresentar duas (2) coisas: O que instalar para que as coisas funcionem corretamente; e Primeiros passos para a criação do nosso primeiro “jogo”. Algumas destas coisas já apresentamos página do repositório do projeto, mas creio que seja importante deixar aqui documentado. Antes que alguém comente algo como “você não definiu tal conceito da maneira mais correta”, “eu faço isso de tal outro modo”, “mas eu prefiro tal outro programa”. Já deixo aqui minha resposta: “Estou fazendo isso de maneira simplificada, para que pessoas que não necessariamente são da área consigam entender alguma coisa. Então seria uma boa que você fizesse um tutorial também. Vai agregar mais para a comunidade como um todo. “. 🙂 Ressalto aqui que, mesmo apoiando as iniciativas de software de código livre e aberto, tomo como base que a maioria das pessoas ainda utilizam sistema Windows. Então, mesmo que a maioria das coisas indicadas aqui sirvam para distribuições Linux e MacOS, ainda darei maior foco ao sistema operacional Windows. Tendo apresentado aqui nosso objetivo com essa postagem, creio que podemos dar início ao nosso tutorial. 1. O QUE INSTALAR? Aqui nós vamos precisar basicamente de cinco (5) coisas: DevKitPro, que fornece um terminal com um compilador e uma biblioteca de funções que dão suporte para criação de jogos para GBA e outras plataformas; Algo que nos ajude a editar o código e que destaque diferentes partes como funções, variáveis e etc. Poderíamos utilizar qualquer editor de texto para esse propósito, mas indico aqui o uso de algum Ambiente Integrado de Desenvolvimento (Integrated Development Environment – IDE); Um emulador que suporte jogos de Game Boy Advance – os jogos de GBA normalmente estão em formato .gba, então somente é necessário que seja um emulador capaz de emular tal formato; Um conversor de imagens (formatos .jpeg, .png e entre tantos outros) para linguagem C; e Uma cópia da biblioteca Processing.gba, algo que pode ser encontrado no github do projeto. 1.1 DEVKITPRO Independente da nossa biblioteca, para a criação de qualquer jogo GBA é fundamental ter algum compilador e bibliotecas que auxiliem neste propósito. Pelo o que eu encontrei online, as nossas melhores opções seriam o DevKit Advance e o DevKitPro. Ficaremos aqui com o DevKitPro, pois acredito que tenha instalação e uso mais fácil, além de fornecer um terminal que serve como um compilador (de modo simplificado, seria algo que traduz o nosso código escrito em uma linguagem específica em um programa).  Para as pessoas que utilizam Windows, o download e a instalação podem ser realizados por meio deste repositório: https://github.com/devkitPro/installer/releases Após finalizar o download, é só abrir o instalador e apertar próximo (next) até o final. Já para os que utilizam Linux ou MacOS, sugiro que sigam as instruções deste link: https://github.com/devkitPro/pacman/releases/tag/v6.0.2  Após a instalação teremos o programa MSys2. Ele funciona como um terminal que vamos utilizar para compilar nosso código. Por hora, basta deixa-lo instalado e, mais adiante, quando formos criar nosso primeiro projeto usando a biblioteca, vamos utilizar o programa. 1.2 INSTALAÇÃO DE ALGUMA IDE A edição de um código em um computador pode ser feito até mesmo por um programa de bloco de notas, porém não é algo muito indicado. As IDEs, por sua vez são os ambientes que foram desenvolvidos para o propósito de programar, então elas possuem algumas ferramentas que facilitam nossa vida. A escolha de alguma IDE vai muito da preferência do/a programador/a, assim como dos requisitos da máquina e do sistema operacional. Têm algumas IDEs que são relativamente simples e boas para uso, tal como Notepad++, que é um bloco de notas mais poderoso, ou o Sublime, que é um ambiente que permite o uso de múltiplas linguagens com marcações. Depois de testar várias nos últimos anos, vou recomendar aqui o uso do Visual Studio Code. Não sou fã do uso de software proprietário, mas recomendo o programa fortemente para programadores/as que ainda estão começando, pois é compatível tanto com Windows, MacOS e Linux, têm um instalador fácil, é popular, em vários ambientes acadêmicos e empresas, e, por fim, têm várias ferramentas disponíveis para o desenvolvimento de outros programas além do escopo do uso da nossa biblioteca. Para instalar o Visual Studio, é só acessar o link, baixar e seguir com a instalação: https://visualstudio.microsoft.com/pt-br/ 1.3 EMULADOR DE GBA Tal como na escolha de alguma IDE, escolher um emulador para GBA depende de pessoa para pessoa, pelas suas preferências e familiaridade. Existem múltiplos emuladores que vão fazer o trabalho de rodar o programa que vamos construir. Inclusive, para os que tiverem um adaptador de cartão sd para cartucho GBA e um console, é possível rodar o jogo direto no videogame. Pessoalmente, eu sempre utilizei o Visual Boy Advance. Para usar o Visual Boy Advance, basta fazer o download do programa e extrair o programa em algum diretório do seu computador. Depois é necessário configurar os controles, mudar a escala de tamanho de tela e pronto. É uma boa ideia abrir um arquivo .gba qualquer e deixar o Visual Boy como programa padrão para esse tipo de arquivo. Sitio para download do Visual Boy: https://visualboyadvance.org/   1.4 CONVERSOR DE IMAGENS Tal como nos passos anteriores, também podemos afirmar que existem múltiplos conversores de imagens para código C. Não vamos utilizar para todos os projetos, mas é uma boa já ter um programa a mão para fazer isso. Eu uso o GBA GFX Converter, que está disponível no principal sítio de desenvolvimento de jogos GBA, o GBADEV.org. Link para download do GBA GFX Converter: https://gbadev.org/tools.php?showinfo=147 O 3DSage fez um tutorial de criação de roms para GBA e apresenta um ótimo modo para utilizar o programa de maneira fácil: https://youtu.be/6ecgELrwAnQ?si=F1-216dZbZ7yBPbU 1.5 A BIBLIOTECA PROCESSING.GBA Finalmente, para instalar a biblioteca, somente precisaremos fazer mais algumas coisas