Leandro Nunes

Dando continuidade ao que foi abordado no outro post (Entendendo a JMonkey Engine), passamos agora uma opção de configuração do ambiente de desenvolvimento (neste caso, NetBeans) para trabalhar com o framework JMonkey.

A configuração é relativamente simples para quem tem experiência com a ferramenta. Destaco que está pode não ser a melhor configuração, com certeza existem outras formas de atingir o mesmo resultado. Ainda assim, ao final deste tutorial, você deve ser capaz de desenvolver e executar suas aplicações com o uso deste framework.

A configuração de divide em duas partes, imprescindíveis, para que voce possa:

• Desenvolver programas com JMonkey Engine
• Rodar aplicações desenvolvidas com a JMonkey Engine em seu sistema operacional

Passo 1: Fazendo o download do software necessário

- Faça o download da JMonkey Engine (quando escrevi isso, usei a versão 1.0), disponível aqui. Esses arquivos contém todas as classes da JMonkey para você compilar seus programas Java que utilizem o  framework.

- Faça o download da LWJGL (enquanto escrevo este post, a versão mais atual é a 1.1.4)…. LWJGL ? sim, você vai precisar dessas bibliotecas tanto para escrever seus programas, quanto para excutá-los… (não sabe o que é a LWJGL ? aqui tem mais informações).

*Para o nosso objetivo você não precisa ser um especialista em LWJGL, mesmo assim, é bom saber que LWJGL é uma biblioteca multiplataforma que faz, entre outras coisas, a comunicação entre seus programas Java, diretamente com o baixo nível de renderização da OpenGL, e que existem implementações para cada plataforma de Sistema Operacional.

- Descompacte os dois arquivos (jme.zip e lwjgl-1.1.4.zip), e vamos para o próximo passo.

Passo 2: Configurando o ambiente e criando um novo projeto com NetBeans

Esse tutorial parte da premissa que você tem JSDK e Netbeans, instalados e funcionando. Realizei os experimentos no meu Ubuntu 8.04, com NetBeans 6.1 e Java 1.6 (OpenJDK 1.6), mas os conceitos valem para este ambiente em qualquer sistema operacional que você estiver executando.

- Crie um novo projeto do NetBeans: “File” > “New Project”

- Selecione as opções: Categories: “Java” e Projects: “Java Application” e clique “Next”.

- Agora você deve dar um nome para seu projeto. Em nosso exemplo, o nome do projeto é JMonkeyTest

Configure como está mostrado na figura abaixo.

- Agora é hora de adicionar as bibliotecas necessárias para criar aplicações com JMonkey. Por uma questão didática, o projeto está configurado para copiar as bibliotecas adicionadas para a pasta do projeto.

Dois conjuntos de bibliotecas devem ser adicionados ao seu projeto: as do JMonkey e as da LWJGL. A ordem que você adiciona não faz diferença. Vamos começar pela JMonkey.

- Clique no seu projeto para expandir os itens “Source Packages”, “Test Packages”, “Libraries” e “Test Libraries”. Em seguida, clique com o botão direito na opção “Libraries”, opção “Add JAR/Folder”. Vá até o diretório onde você descompactou o arquivo jme.zip. Selecione todos os arquivos e marque a opção “Copy to Libraries Folder”(a opção padrão já é seu diretório lib, do raiz de seu projeto). Clique “OK”.

- Faça o mesmo para os arquivos da LWJGL. Desta vez, selecione os arquivos que estão no diretório “jar“, a partir da pasta onde a LWJGL foi descompactada (esta tarefa foi feita no passo 1).

Com esses dois passos simples, você adicionou todas as bibliotecas necessárias para COMPILAR seus programas.

Para executar o que já foi compilado com JMonkey, precisamos informar a localização de algumas bibliotecas que são fornecidas pelo LWJGL, no diretório “native” e que dependem do seu sistema operacional.

IMPORTANTE: Se você não configurar essas bibliotecas nativas, seus programas vão compilar mas não vão rodar.

Para solucionar o problema, vamos informar a localização das bibliotecas como parâmetro para execução. Para isso, clique com o botão direito no seu projeto “JMonkeyTest” OU vá ao menu “File”, opção “JMonkeyTest Properties”. A seguir, clique na opção “Run” e preencha o campo “VM Options”, com o seguinte conteúdo:

-Djava.library.path=[caminho para a pasta LWJGL/native/[seu sistema operacional]]

No meu caso, ficou assim

-Djava.library.path=/home/leandro/Desktop/lwjgl-1.1.4/native/linux

Agora vamos criar um arquivo exemplo e testar tudo isso que foi configurado:

- Com o projeto aberto, crie uma nova classe e dê o nome de “JMonkeyTest”. Será criado um arquivo JMonkeyTest.java.

Aí está minha sugestão de programa de teste, baseada em um exemplo do guia de usuário do JMonkey, que você poderá baixar aqui. Lembre-se que nosso foco agora está em configurar nosso ambiente para desenvolvimento com a JMonkey.

/**
  *  Teste JMonkey Engine
  *
  * @author Leandro Nunes
  * @since 09/21/2008
  */
 import com.jme.app.SimpleGame;
 import com.jme.bounding.BoundingBox;
 import com.jme.math.Vector3f;
 import com.jme.scene.shape.Sphere;

 public class JMonkeyTest extends SimpleGame{

     private Sphere s;

     public static void main(String[] args) {
         JMonkeyTest app = new JMonkeyTest();
         app.setDialogBehaviour(ALWAYS_SHOW_PROPS_DIALOG);
         app.start();
 } 

 protected void simpleUpdate() {
 }

 protected void simpleInitGame() {
    s = new Sphere("Sphere", 63, 50, 25);
    s.setLocalTranslation(new Vector3f(0,0,-40));
    s.setModelBound(new BoundingBox());
    s.updateModelBound();
    rootNode.attachChild(s);
   }
 }

Para rodar o código, pressione <F6>.

Quando você executar, se estiver tudo de acordo com as configurações que passei acima, você deve ver alguma coisa parecida com isso:

Depois de configurar a resolução, aparecerá alguma coisa semelhante a isso:

Se aparecer essa tela, sua configuração foi efetuada com sucesso! Para novos projetos é só seguir a configuração e criar seu próprio código.

Por enquanto é só pessoal.

Mais detalhes podem ser obtidos na documentação oficial (em inglês, claro!) que você poderá baixar aqui.

Cenas dos próximos episódios: uma vez que temos nosso ambiente configurado e sabemos executar as aplicações desenvolvidas, podemos passar ao desenvolvimento de aplicaçõe didáticas simples para iniciar os estudos com JMonkey. Até lá…