Atualizando para Visual C++ Express

Esta cartilha ir mostrar como configurar, compilar e instalar o SDK da verso recente do DirectX 9 no compilador Visual Studio Express. Esta uma verso gratuita deste compilador da Microsoft. O objetivo deste material fornecer informaes atualizadas para que os leitores possam acompanhar o livro com softwares disponveis atualmente.

Preparando o projeto
O incio do primeiro captulo do livro Programao de Jogos com C++ e DirectX mostra como utilizar o Visual C++ 6.0 para compilar os cdigos de linguagem C++. Este texto mostra como realizar as mesmas tarefas com o Visual C++ Express Edition. Para compilar um programa no Visual C++, isto , converter um cdigo C++ em um arquivo executvel pelo sistema, necessrio antes preparar uma rea de trabalho que organizar todos os elementos utilizados pelo programa. Esta rea de trabalho pode ser chamada de Projeto, ou Workspace.

Tela inicial do Visual C++ Express

Para criar um projeto em C++ padro, abra o compilador e siga os seguintes passos:

1. Clique em File, New > Project...

2. Selecione Win32 Console Appilcation, escolha um nome para o projeto no campo Name: (sugesto OiMundo) e clique em OK.

3. Clique em Next >.

4. Selecione o campo Empty project e clique em Finish.

Se tudo foi feito corretamente, o ttulo escolhido no passo 2 ser exibido no topo da janela, mas a pgina inicial continuar sendo exibida:

Pgina inicial do compilador e projeto criado com sucesso

Nosso projeto foi criado corretamente, mas est vazio, no temos nenhum arquivo onde podemos inserir o cdigo para ser compilado. O passo seguinte criar um arquivo CPP, onde entraremos com o cdigo, manualmente. Clique em Project e Add New Item...

Uma sub-janela ir surgir. No campo Name:, digite um nome qualquer para o arquivo CPP (sugesto: main.cpp), selecione C++ File (.cpp), e clique em Add, como mostra a figura a seguir:

Janela de escolha do tipo de arquivo

Feito isso, o arquivo main.cpp (o nome pode variar), ser criado e adicionado ao nosso Workspace, como mostra a figura a seguir:

Novo arquivo no Workspace

nesse arquivo que iremos inserir o cdigo que ser compilado.

Abrindo o projeto salvo

Para reabrir um workspace (ou projeto) j salvo no computador, clique em File e selecione Open > Project/Solution:

Abrindo um projeto

A janela padro de escolha de arquivos do Windows se abrir. Encontre o diretrio onde o projeto foi salvo (isso pode variar) d um duplo clique sobre o arquivo [nome do projeto].sln, ou selecione-o e clique em Abrir (ou Open). A figura a seguir mostra o arquivo OiMundo.sln, que pertence ao projeto de nome OiMundo.

Abrindo o projeto atravs do arquivo *.sln

Com isso o workspace se abrir e os arquivos pertencentes ao projeto estaro acessveis atravs da barra lateral.

Compilando e executando
Para compilar e executar um programa no Visual C++ Express podemos utilizar a tecla de atalho F5. Para compilar a verso final do programa (Release) clique em Build > Batch Build...:

Compilando o executvel final

Quando uma sub-janela surgir, selecione a caixa da linha Release na coluna Build e clique em Rebuild, como mostra a figura:

Compilando verso final

Problemas de compatibilidade
Esta , provavelmente, a parte mais importante dessa cartilha. Aqui voc ver quais so os problemas de compatibilidade entre o cdigo no livro (Visual C++ 6.0) e o aceito pela verso Express, e aprender como solucion-los.

1 Problema: Cabealhos
Este problema de compatibilidade est no uso do nome iostream.h. Alguns compiladores de C++ antigos aceitam esse arquivo, j o Visual C++ Express no o aceita. Soluo: utilize iostream (sem o .h) e insira a linha using namespace std; aps a incluso do cabealho. Exemplo:
#include <iostream> using namespace std; int main() { cout << "Oi mundo!\n"; return 0; }

2 Problema: O programa abre e fecha imediatamente

Quando o programa em modo Win32 Console Application executado, ele fechado assim que termina de executar todas as suas tarefas, tanto em modo debug como em sua verso final. exatamente o que deve acontecer, pois segue um processo lgico. Isso seria bom se no fosse nossa necessidade de visualizar o que o programa escreveu na tela e quais foram suas sadas e resultados.

Soluo: inclua o cabealho stdlib.h e insira a linha system(pause); Ao final da funo main (antes de return 0). Dessa forma o sistema pedir para que o usurio pressione uma tecla qualquer antes de encerrar o programa. Exemplo:
#include <iostream> #include <stdlib.h> using namespace std; int main() { cout << "Oi mundo!\n"; system("pause"); return 0; }

Essas so as mudanas necessrias para compilar os cdigos-fonte da primeira parte do livro Programao de Jogos com C++ e DirectX no Visual C++ Express.

Instalando o DirectX 9 SDK no Visual C++ Express

O captulo 7 do livro Programao de Jogos com C++ e DirectX mostra como criar um projeto, configurar o SDK e compilar um programa que utilize DirectX no Visual C++ 6.0, esta cartilha traz as informaes relacionadas ao Visual C++ Express 9.0.

Instalando o SDK
Antes de mais nada, tenha certeza de que o Microsoft Visual C++ Express esteja instalado e funcionando corretamente. Este software o compilador que transforma o cdigo C++ em arquivo executvel, e necessrio para desenvolver jogos com DirectX. O Visual C++ Express parte de um pacote de softwares da Microsoft chamado de Visual Studio Express. Que pode ser baixado gratuitamente na internet. Se voc j possui o compilador devidamente instalado, est pronto para instalar o DirectX 9 SDK. Este kit de desenvolvimento contm as ferramentas necessrias para que seja possvel utilizar o Visual C++ em conjunto com o DirectX. Os arquivos de instalao do SDK esto compactados no arquivo dxsdk_apr2007.exe. Para descompactar seu contedo, execute-o e clique em Yes:

Termos de licena do DirectX SDK

Em seguida aguarde alguns instantes at que a seguinte tela aparea:

Opes para descompactao dos arquivos de instalao

Escolha um diretrio qualquer para descompactar os arquivos (ex.: C:\DirectX SDK Install\) e clique em Unzip e aguarde at que o processo termine. Quando terminar, teremos a seguinte pasta:

Arquivos de instalao descompactados

Execute o arquivo Setup.exe para iniciar a instalao do SDK. Tenha certeza de que o Visual C++ Express est instalado nesse computador. Ao iniciar a instalao do SDK, siga os seguintes passos:

1. Clique em Next

2. Selecione I accept e clique em Next

3. Clique em Next novamente para instalar o SDK no diretrio Arquivos de programas (ou equivalente).

4. Aguarde at que a instalao termine.

5. Por fim, clique em Finish para concluir a instalao

Agora que temos o SDK do DirectX devidamente instalado, precisamos nos certificar de que o compilador Visual C++ est devidamente configurado para rodar em conjunto com essa API.

Configurando o SDK
O primeiro passo verificar se o compilador foi configurado para buscar os arquivos de cabealho e biblioteca do DirectX nos diretrios corretos. 1. Abra o compilador 2. Clique no boto Tools (no menu superior) 3. Selecione Options...

A seguinte sub-janela ir abrir-se:

Opes do compilador

Clique no + em Projects and Solutions e selecione VC++ Directories, como mostra a figura a seguir:

10

Lista de diretrios do compilador

Esses nomes que aparecem no lado direito da sub-janela indicam os caminhos para os diretrios onde o compilador busca as informaes necessrias para gerar nossos programas. A ns s interessa os Include files e Library Files. Primeiro selecione Include files na lista que fica abaixo de Show directories for::

Lista de diretrios com arquivos de cabealho

Verifique se existe o diretrio $(DXSDK_DIR)include Caso no haja, clique no boto e entre com o texto $(DXSDK_DIR)include no espao novo que ir abrir. Em seguida, onde Show directories for: indica, selecione Library files:

11

Lista de diretrios de arquivos LIB

Mais uma vez, verifique se h algum nome com prefixo $(DXSDK_DIR). Se no houver, clique novamente no boto e entre com $(DXSDK_DIR)lib\x86. Caso seu Windows seja baseado em um hardware 64-bit, digite $ (DXSDK_DIR)lib\x64. Depois que tudo tiver terminado, clique em OK. O DirectX j est devidamente configurado para o Visual C++ Express.

12

Criando o primeiro projeto

Agora vamos aprender como criar um projeto e configurar o Workspace para criar nossos programas em Direct3D. Abra o compilador e siga os seguintes passos:

1. Clique em File, New > Project...

2. Selecione Win32 Project, escolha um nome para o projeto no campo Name: (sugesto HelloDX9) e clique em OK.

3. Clique em Next >.

4. Selecione o campo Empty project e clique em Finish.

Se tudo foi feito corretamente, o ttulo escolhido no passo 2 ser exibido no topo da janela, mas a pgina inicial continuar sendo exibida:

13

Pgina inicial do compilador e projeto criado com sucesso

Como escolhemos a opo Empty project, agora precisamos criar o arquivo CPP, onde entraremos com o cdigo, manualmente. Clique em Project e Add New Item...

Uma sub-janela ir surgir. No campo Name:, digite um nome qualquer para o arquivo CPP (sugesto: WinMain.cpp), selecione C++ File (.cpp), e clique em Add, como mostra a figura a seguir:

14

Janela de escolha do tipo de arquivo

Feito isso, o ltimo passo configurar a codificao do texto em nosso programa. D um duplo clique no nome do arquivo WinMain.cpp (o nome pode variar de acordo com ttulo dado anteriormente) para abri-lo:

Abrindo o arquivo de cdigo

Clique em Project > [Nome do projeto] Properties...:

15

Em seguida selecione General no menu do lado esquerdo, e no campo Character Set especifique Not Set.

Escolha do tipo de caractere

Pronto, agora temos o projeto criado e um arquivo onde podemos adicionar nosso cdigo.

Mais informaes e ajuda

O pacote Microsoft Visual Studio Express gratuito, pode ser baixado e atualizado pela internet e permite que todo o software desenvolvido nele seja distribudo e/ou vendido livremente. Para mais informaes visite as pginas: Em ingls: http://www.microsoft.com/Express/ Em portugus: http://msdn.microsoft.com/pt-br/express/ Bom cdigo! Andr Santee, asantee.net

16