Introducción
Basado en posts que vi en foros de ayuda y discusión para el Irrlicht engine pidiendo ayuda para usar Irrlicht en Dev-C++, Decidí se necesitaba un tutorial sobre el tema. Después de chatear brevemente con Niko, escribí este tutorial para ayudar a la gente a comenzar.
Intentare ser lo mas detallado posible también incluí un numero de screenshots. Este tutorial fue escrito alrededor de desarrolladores usando Dev-C++ en sistema operativo Windows (Debido a que es lo que estoy usando). Basandome en comentarios creo que setear Dev-C++ en otras plataformas debería ser bastante similar. Si puedo quizás intente esto en mi maquina con Linux y agregue comentarios adicionales después.
NOTA: Este tutorial asume que tú ya tienes instalado Dev-C++. Te lo puedes bajar aquí si no lo tienes.
Listado debajo están los pasos básicos que seguiré en este tutorial:
1. Descargar y descomprimir Irrlicht
2. Comenzar un Nuevo proyecto en Dev-C++
3. Configurar Dev-C++ para encontrar los headers de Irrlicht que este necesita.
4. Configurar tu proyecto Dev-C++ para encontrar las librerías/objetos Irrlicht que este necesita
5 Configurar tu proyecto Dev-C++ para usar la DLL Irrlicht
6. Escribir, compilar, y ejecutar la aplicación "Hola Mundo" usando Dev-C++
En todo mi trabajo, intento seguir la regla KISS "Keep It Simple Stupid! " (Mantenlo simple estupido!) Yo encuentro esto de gran ayuda dado que la mayoría de nosotros programa a las 2am. Por esta razón, en un esfuerzo para reducir errores y hacer la vida mas fácil no uso un montón de atajos en mi código, o en mis tutoriales. Y comento un montón. Por eso si este tutorial parece sobre detallado, esa es la razón!
Paso 1 –- Descargar y descomprimir Irrlicht
Descarga la ultima versión de Irrlicht aquí. Una vez que hayas descargado el archivo, simplemente descomprímelo a una locacion que recuerdes. Por ejemplo, Yo uso "irrlicht-0.3" en este momento. Esto nos da una locacion constante para acceder las librerías, headers que son necesarias.
Paso 2 – Comenzar un nuevo proyecto Dev-C++
Ahora, estamos listos para comenzar a setear un proyecto en Dev-C++, que usaremos con el Irrlicht engine. Dev-C++ nos da un montón de flexibilidad. Podemos organizar nuestros archivos en directorios y subdirectorios, podemos tirarlos todos en un lugar, podemos usar CVS, etc. Para este tutorial, vamos a nombrar nuestro proyecto y crear un nuevo directorio del mismo nombre, para mantenerlo simple.
Después arrancar Dev-C++, haz click en el menú "File" (o "Archivo") ; luego click en "New" ("Nuevo") ; luego "Project" ("Proyecto"). Una nueva ventana de "New project" ("Nuevo proyecto") se mostrara como en el screenshot de abajo.
Dev-C++ te da algunas opciones, dependiendo del tipo de proyecto que estas creando. Si estas creando una DLL o librería para usar encima del engine puedes elegir este tipo de proyecto, y este creara el esqueleto del proyecto para ti. Cuidado – Dev-C++ es un trabajo en progreso, y por allí quedan algunos bugs. Por ejemplo, yo estoy usando Dev-C++ versión 4.9.8.0, y tiene algunos problemas con el proyecto DLL (Este no setea algunas opciones del compilador, etc.). Yo recomiendo visitar los foros de Dev-C++ para información sobre este tema.
Para el tutorial, seleccionamos "Empty Project"(Proyecto vacio), y luego démosle un nombre. Usare "Irrdemo" para este ejemplo.
Cuando completes ese paso y hagas click en OK, una caja de dialogo de archivos aparecerá, preguntando donde quieres guardar el proyecto. Lo puedes poner casi en cualquier parte. De Nuevo para mantenerlo simple recomiendo un directorio que tenga de nombre el mismo que el del proyecto "Irrdemo".
Ahora, tenemos un proyecto vacio para trabajar.
Paso 3 — Agregar los archivos de cabecera de Irrlicht
En este punto, tenemos un proyecto vacio que no hace nada. Bastante aburrido. Para nuestro próximo truco, vamos a decirle al proyecto de Dev-C++ donde esta el directorio "include". Para hacer esto haz clic en "Project" y luego en "Project Options". Un dialogo similar al que se muestra debajo se abrirá. Haz clic en solapa de "Directories" y luego en "Include Directories".
En orden de agregar el directorio en el cual Irrlicht tiene los archivos de cabecera (en realidad solamente necesitas "irrlicht.h", pero es mas fácil solamente agregar el directorio ) Tu puedes tipearlo en la caja de texto y hacer click en Add (Agregar). O pueden usar la ventana de dialogo de archivos para navegar los directorios, navega por los directorios y haz clic en el botón ".." (circulo rojo en la imagen izquierda de abajo), navega al directorio "include" de Irrlicht ( para mi, esto es "c:\irrlicht-0.3\include"). Presiona okay en el dialogo de archivos y luego presionen "Add", y el directorio será agregado ( vea la imagen de la derecha de abajo).
Paso 4 – Agregar las librerías de Irrlicht
Ahora que tenemos los archivos de cabecera, el próximo paso es agregar las librerías de irrlicht que necesitaremos para compilar y linkear. Afortunadamente, Niko es un buen muchacho, y ha empaquetado estas con la distribución, lo cual hace nuestra vida mucho mas fácil. Importaremos los Fuentes de Irrlicht y lo compilaremos nosotros mismos, pero por que, si no tenemos que hacerlo?
Para el release 0.3, podemos encontrar los archivos que necesitamos en "irrlicht-0.3\lib\DevCpp. Estos son los tres archivos de interés:
- libIrrlicht.a – La librería Irrlicht.
- libjpeg.a – La librería independiente del grupo JPEG
- libz.a – La librería zlib de compresión
Vamos a ir hacia delante y agregar estos tres a nuestro proyecto Dev-C++. Para hacer eso, ve a "Project Options" , y haz click en la solapa de "Parameters". Algo como la ventana de abajo aparecerá. Para agregar cada una de las librerías requeridas simplemente haz clic en el botón "Add Library or Object" ; Use el dialogo de archive para localizar cada una de las librerías listadas debajo, y luego haz click en okay, Una vez que hayas agregado las tres, ya estamos listos, presiona "Ok".
Paso 5 – Usando las DLL de irrlicht en tiempo de ejecución
En orden de correr tu aplicación desde dentro de Dev-C++, para debuguear o solo por el hecho de no tener que ir fuera del IDE para correrla, "irrlicht.dll" que viene con irrlicht debe estar en tu PATH. Con Windows, hay dos maneras simples de hacer esto:
1. Agregar el directorio "irrlicht-0.3\bin" del paso 1 a tu PATH.
2. Copiar "irrlicht.dll" a tu directorio windows\system32 el cual esta en el PATH por defecto.
No estoy seguro de que un método sea mejor que otro – Yo uso el primero en mis programas, pero ambos funcionan.
Paso 6 – "Hola Mundo " con Dev-C++
Esto es una versión simplificada del tutorial "Hola mundo" que Niko escribió. Esto es solamente algo para mostrar una ventana con algo de texto. Si puedes escribir esto, compilar y correrlo, entonces sabrás que seteaste tu proyecto de Dev-C++ correctamente!
// HelloUniverse.cpp
// Include the Irrlicht header
#include "irrlicht.h"
// Irrlicht Namespaces
using namespace irr;
using namespace core;
using namespace scene;
using namespace video;
using namespace io;
using namespace gui;
int main()
{
IrrlichtDevice *irrDevice = createDevice(EDT_SOFTWARE,
dimension2d<s32>(512, 384),
16,
false,
false,
0);
irrDevice->setWindowCaption(L"Dev-C++ and the Irrlicht Engine!");
IVideoDriver* irrDriver = irrDevice->getVideoDriver();
ISceneManager* irrSceneMgr = irrDevice->getSceneManager();
IGUIEnvironment* irrGUIEnv = irrDevice->getGUIEnvironment();
irrGUIEnv->addStaticText(
L"Hello World! This is the Irrlicht software engine!",
rect<int>(10,10,200,30), true, true, 0, -1);
while(irrDevice->run())
{
irrDriver->beginScene(true, true, SColor(0,192,192,192));
irrSceneMgr->drawAll();
irrGUIEnv->drawAll();
irrDriver->endScene();
}
irrDevice->drop();
return(0);
|
Si todo salio de acuerdo con el plan, deberías ver algo como esto cuando corras el programa
