 ______   ___    ___
/\  _  \ /\_ \  /\_ \
\ \ \L\ \\//\ \ \//\ \      __     __   _ __   ___        __    ___      ____
 \ \  __ \ \ \ \  \ \ \   /'__`\ /'_ `\/\`'__\/ __`\    /'__`\ /\__`\  /'___/
  \ \ \/\ \ \_\ \_ \_\ \_/\  __//\ \L\ \ \ \//\ \L\ \__/\ \L\ \\/ __ \/\____`\ 
   \ \_\ \_\/\____\/\____\ \____\ \____ \ \_\\ \____/\_\ \  __//\____/\/\____/
    \/_/\/_/\/____/\/____/\/____/\/___L\ \/_/ \/___/\/_/\ \ \/ \/___/  \/___/
                                   /\____/               \ \_\
     Versin 4.2.alfa1             \_/__/                 \/_/

  Una librera para programar juegos por Burdjia.com, 21 de Noviembre de 2006.

  Vea el archivo "autores.txt" para obtener la lista completa de personas que
  han contribuido directa o indirectamente en el proyecto.



  NOTA:  La versin actual est etiquetada como "(alfa)".  Esto significa que
	 se trata de una versin de evaluacin y que puede no incluir toda la
	 informacin que usted necesite.  Contribuya ayudando a completar este
	 proyecto hacindonos llegar sus sugerencias.  Consulte al final de
	 este archivo para saber cmo contactar con nosotros.



======
ndice
======

 - Introduccin
 - Caractersticas
 - Licencia
 - Instrucciones de instalacin
 - Utilizar la librera
 - Distribuir programas que usan Mingro
 - Se busca colaboracin
 - Cmo contactar con Burdjia y recibir ayuda.



============
Introduccin
============

  Allegro.pas es una envolvente para poder utilizar la librera Allegro con
  compiladores Pascal, como Free Pascal y Delphi.

  La versin actual est etiquetada como "(alfa)".  Se ha hecho as para
  indicar que se trata de una versin previa, sin terminar.  El objetivo de
  esta versin es servir de atalaya para comprobar si se va por el buen camino.
  La forma de saberlo es que las personas que lo usen (como usted) nos enven
  comentarios sobre Mingro:  qu le ha gustado, qu no, si tiene alguna
  sugerencia que puede ayudar a hacerlo todava mejor...  La etiqueta "(alfa)"
  tambin implica que la librera no es para principiantes, puesto que hay
  partes que no estn terminadas o estn sin documentar, y es posible que
  algunas funciones o estructuras cambien drsticamente antes de la versin
  definitiva.



===============
Caractersticas
===============

  Se busca que la librera permita al compilador Pascal acceder a todas las
  caractersticas de la librera Allegro.

  En estos momentos Allegro.pas no permite acceder completamente a Allegro.



========
Licencia
========

  Allegro.pas es un regalo (gift-ware).  Fue creado por un grupo de personas en
  cooperacin, y le es entregado a usted libremente como regalo.  Puede usarla,
  modificarla, distribuirla y, en definitiva, hackearla de cualquier forma que
  desee y no tiene que entregarnos nada a cambio.  Sin embargo, si le gusta
  este producto le rogamos que nos lo agradezca haciendo un regalo a la
  comunidad de Alelgro.  Este puede ser escribir una extensin, facilitar una
  descripcin de errores til, hacer alguna mejora a la librera, o simplemente
  publicar las fuentes de su programa de forma que otras personas puedan
  aprender de l.  Si usted redistribuye partes de este cdigo o hace un juego
  con l, sera estupendo si menciona Allegro en alguna parte de los crditos,
  pero no es necesario que lo haga.  Confiamos que no abusar de nuestra
  generosidad.

Aviso legal

  Esta librera es una Librera de Libre Distribucin;  usted puede
  redistribuirla y/o modificarla bajo los trminos de la "Licencia de Libre
  Distribucin de Libreras (LLDL)".

  Esta librera es distribuida con la esperanza de que le ser til, pero SIN
  NINGUNA GARANTA.  Vea la "Licencia de Libre Distribucin de Libreras" para
  ms detalles.

  Usted debra haber recibido una copia de la "Licencia de Libre Distribucin
  de Libreras" junto con esta Librera, si no es as, escriba a:

  Burdjia, Apdo. 4034 09080 Burgos, Espaa



============================
Instrucciones de instalacin
============================

  Para que Mingro funcione correctamente deber disponer de un compilador
  apropiado.  Nosotros recomendamos Free Pascal (http://www.freepascal.org), ya
  que es el compilador que hemos utilizado nosotros para disearlo, pero podr
  utilizar otros como GNU/Pascal (http://www.gnu.org) o, incluso, Delphi.  Si
  prefiere utilizar el lenguaje C le recomendamos el compilador MinGW32
  (http://www.mingw.org) para el sistema Windows  cualquier compilador C/C++
  de GNU (http://www.gnu.org) para cualquier otro sistema operativo.

  NOTA:  Si se ha descargado la versin "cdigo fuente" necesitar un
	 compilador C para poder construir la librera, independientemente de
	 que vaya a utilizar Pascal u otro lenguaje de programacin para crear
	 sus programas.  Dado que la librera est diseada para aficionados,
	 no explicaremos aqu cmo crear la librera.  Si no sabe cmo hacerlo,
	 descrguese la versin precompilada (para la versin "(alfa)"
	 nicamente existe una versin precompilada para los sistemas Windows).

  Una vez haya instalado el compilador en su sistema, descomprima el contenido
  del paquete en un directorio del disco (por ejemplo, en c:\Mingro).  Busque
  dentro este directorio otro llamado "lib" (siguiendo con el ejemplo,
  c:\Mingro\lib), y dentro de este los archivos "alleg42.dll" y "mingro.dll".
  Cpielos y pguelos en el directorio del sistema
  (normalmente en c:\Windows\system32).

  Despus, si va a usarlo con un compilador Pascal, en el mismo directorio
  "lib" busque el archivo llamado "mingro.pas", cpielo y pgelo en el
  directorio donde se encuentren las unidades de su compilador (por ejemplo,
  en el compilador Free Pascal se suele utilizar el directorio
  c:\FPC\units\rtl).

  Si va a usarlo con un compilador C/C++, busque dentro del directorio donde
  haya descomprimido el paquete un directorio llamado "include" (Por ejemplo,
  c:\Mingro\include) y copie su contenido en el directorio "include" de su
  compilador C (por ejemplo, en el compilador MinGW32 se suele utilizar el
  directoriocC:\MinGW\include).  Despus, del directorio "lib", copie el
  archivo "libmingro.a" en el directorio de libreras de su compilador
  (siguiendo con el ejemplo, c:\MinGW\lib).



====================
Utilizar la librera
====================

  Si est usando Pascal, entre en el IDE de Free Pascal y abra el ejemplo
  "examples/exhello.pas", dentro del directorio donde haya descomprimido
  Mingro.  En este ejemplo encontrar cmo inicializar Mingro, cmo escribir en
  pantalla y cmo finalizar el programa.  En el archivo "examples/leeme.txt"
  encontrar la lista de todos los ejemplos por orden de complejidad (del ms
  simple al ms complejo) con una breve descripcin de cada uno.

  Si est usando C, deber incluir en sus programas el archivo "mingro.h" con
  una lnea al estilo "#include <mingro.h>".  Puesto que Mingro se basa en
  Allegro tambin deber aadir la lnea "END_OF_MAIN()" tras la ltima llave
  de la funcin "main".  Al compilar, deber incluir las libreras
  "-lmingro -lalleg" (NOTA: Esto obliga a tener instalada la librera Allegro
  versin 4.2 en su sistema).

  Para saber cmo se usa cada funcin y estructura deber abrir el archivo
  "docs/index.html" usando su navegador web favorito.



====================================
Distribuir programas que usan Mingro
====================================

  Si va a compartir sus programas escritos usando Mingro con amigos o a travs
  de la red, no olvide incluir los archivos "mingro.dll" y "alleg42.dll" junto
  con los ejecutables y los archivos de datos, de lo contrario su programa no
  funcionar.



=====================
Se busca colaboracin
=====================

  Como ya se ha dicho, esta versin es una versin inacabada.  Si quiere, puede
  colaborar en su finalizacin y aadir su nombre a la lista de autores.
  Necesitamos desde simples probadores hasta personas que nos ayuden a
  completar el manual de programacin, que lo traduzcan a otros idiomas o que
  escriban demos y ejemplos de uso.

  Si desea colaborar, lea la siguiente seccin y pngase en contacto.



=======================
Informacin de contacto
=======================

  Encontrar la informacin referente a Mingro y podr encontrar las ltimas
  versiones liberadas en http://mingro.sourceforge.net.  El sitio del proyecto
  est en http://sourceforge.net/projects/mingro/.   En http://www.burdjia.com
  encontrar un foro pblico donde podr exponer sus dudas y hacer sugerencias.
  Si quiere obtener el mximo provecho, le recomendamos que siga las siguientes
  indicaciones:

    * Antes de hacer cualquier pregunta sobre la librera lea la documentacin.
      Si no encuentra la respuesta en ella o no entiende algo, entonces s,
      dirjase al foro.  Si cree que falta algo en los documentos, no se
      explica correctamente o que hay errores, no se lo calle:  dganoslo para
      que podamos corregirlo y completarlo.
    * Lea atentamente las normas del foro.  Son unas normas muy sencillas, y si
      no las sigue tal vez nadie le conteste.  Incluso puede ser sancionado!
    * Antes de enviar un mensaje compruebe si ya se ha comentado en alguno de
      los hilos.  El foro dispone de un buscador que facilitar la tarea de
      comprobacin.  Recuerde que el repetir las mismas preguntas, aunque sea
      en distintos foros, nicamente asegura que la gente piense que es usted
      un pesado y que no merece respuesta alguna.
    * Ponga en el asunto una frase que resuma su mensaje.  Frases como
      "Necesito ayuda" o "No funciona" tal vez no atraigan la atencin de la
      gente que pueda ayudarle.  Utilize frases como "No se muestra el sprite
      donde quiero" o "No se reproduce el sonido correctamente".
    * Si la consulta se refiere a un programa que ha escrito usted, procure
      incluir el cdigo donde crea que est el problema.  No es preciso que
      incluya todo el programa (a menos que alguien se lo pida expresamente),
      y procure utilizar las etiquetas [code] .. [/code] para enmarcar el
      cdigo.  Por ejemplo, puede escribir:

      Esta parte me da errores de compilacin:
      [code]
        WriteLN ('Copia la imagen');
        mgGetImage (7, x, y, x + Ancho, y + Alto);
      [/code]

      De esta forma se leer mejor dentro del foro, ya lo ver.

  Siguiendo estas sencillas normas tendr ms posibilidades de obtener una
  respuesta rpida y correcta a sus preguntas y adecuada.

