INSTALACION.txt de Tux Paint Tux Paint - Un programa de dibujo simple para niños. Copyright 2002 por Bill Kendrick bill@newbreedsoftware.com http://www.newbreedsoftware.com/tuxpaint/ 27 de Junio de 2002 - 5 de Noviembre de 2002 Requerimientos: --------------- Usuarios de Windows: -------------------- La versión Windows de Tux Paint viene pre-empacada con todas las bibliotecas necesarias pre-compiladas (en forma de ".DLL"), por lo tanto no se necesita bajar nada extra. libSDL ------ Tux Paint requiere Simple DirectMedia Layer Library (libSDL), una biblioteca de programación multimedia de Código Abierto disponible bajo la licencia GNU Lesser General Public License (LGPL). Junto con libSDL, Tux Paint depende de una cantidad de otras bibliotecas de 'ayuda' de SDL: SDL_Image (para archivos gráficos), SDL_TTF (para el soporte de Fuentes True Type) y, opcionalmente, SDL_Mixer (para efectos de sonido). Usuarios de Linux/Unix: ----------------------- Las bibliotecas SDL están disponibles como código-fuente o como paquetes RPM o Debian para varias distribuciones de Linux. Pueden ser bajadas desde: libSDL: http://www.libsdl.org/ SDL_Image: http://www.libsdl.org/projects/SDL_image/ SDL_TTF: http://www.libsdl.org/projects/SDL_ttf/ SDL_Mixer: http://www.libsdl.org/projects/SDL_mixer/ [OPCIONAL] También suelen estar disponibles con tu distribución Linux (p.ej.: en uno de los CDs de instalación, o disponibles vía programas de mantenimiento de software como el "apt-get" de Debian). NOTA: Al instalar desde paquetes, asegúrate de instalar TAMBIÉN las versiones "-devel" de los paquetes. (Por ejemplo, instala tanto "SDL-1.2.4.rpm" como "SDL-1.2.4-devel.rpm") Otras Bibliotecas: ------------------ Tux Paint también saca partido de varias otras bibliotecas libres bajo licencia LGPL. Bajo Linux, como en el caso de la SDL, ya deberían estar instaladas también, o deberán estar listas para su instalación como parte de tu distribución Linux. libPNG ------ Tux Paint usa el formato PNG (Portable Network Graphics) para sus archivos de información. SDL_image requiere que libPNG esté instalada. http://www.libpng.org/pub/png/libpng.html FreeType2 --------- Tux Paint usa fuentes TTF (True Type Font) para dibujar texto. SDL_ttf requiere la biblioteca FreeType2. http://www.freetype.org/ gettext ------- Tux Paint utiliza las preferencias locales de tu sistema conjuntamente con la biblioteca "gettext" para soportar varios idiomas (p.ej: Español). Necesitarás tener la biblioteca gettext instalada. http://www.gnu.org/software/gettext/ Herramientas NetPBM [OPCIONAL] ------------------------------ Bajo Linux y Unix, las herramientas NetPBM son las actualmente usadas para imprimir. (Una PNG es generada por TuxPaint y convertida a PostScript usando las herramientas de línea de comandos de NetPBM 'pngtopnm' y 'pnmtops'.) http://netpbm.sourceforge.net/ Compilación e Instalación: -------------------------- Tux Paint se entrega bajo la licencia GNU General Public License (GPL) (ver "COPYING.txt" por más detalles) y por lo tanto el 'código fuente' del programa está incluido. Usuarios de Windows: -------------------- Compilación: ------------ Tux Paint viene pre-compilado para Windows, por lo tanto no se necesita compilación. [Eventualmente, pondremos aquí información acerca de como recompilar para Windows. Mientras tanto, estás por las tuyas. ¡Lo sentimos!] Instalación: ----------- Hacer doble clic sobre el ejecutable (archivo .EXE) del instalador del Tux Paint y seguir las instrucciones. En primer lugar se preguntará si se está de acuerdo con la licencia. (Es la Licencia Pública General de GNU (GPL), la cual también está disponible en el archivo "COPIADO.txt".) A continuación se consultará si se desean instalar accesos directos a Tux Paint en el Menú Inicio y en el Escritorio de Windows. (Ambas opciones están habilitadas por defecto.) Luego se consultará sobre dónde se desea instalar el Tux Paint. La opción por defecto debería ser apropiada, en tanto haya espacio disponible. En caso contrario, escoger una ubicación diferente. ¡En este punto, sólo resta hacer clic en 'Install' para instalar Tux Paint! Cambiando las preferencias Utilizando el Acceso Directo: -------------------------------------------------------- Para cambiar las preferencias del programa, hacer clic derecho sobre el acceso directo del TuxPaint y seleccionar 'Propiedades' (abajo). Asegurarse de que la etiqueta 'Acceso directo' esté seleccionada en la ventana que aparece y examinar el campo 'Destino:'. Se debería ver algo como esto: "C:\Archivos de Programa\Tuxpaint\TuxPaint.exe" Ahora es posible agregar opciones de línea de comando, las que entrarán en acción al hacer doble clic sobre el ícono. Por ejemplo, para hacer que el juego funcione a pantalla completa, con figuras simplificadas (sin opción de rotación) y en Español, agregar estas opciones (luego de 'TuxPaint.exe'): "C:\Archivos de Programa\Tuxpaint\TuxPaint.exe" -f -s --lang spanish (Ver "LEEME.txt" para una lista completa de las opciones de línea de comando disponibles.) Si se cometiera un error o si todo desapareciera, utilizar Ctrl-Z para deshacer o simplemente presionar la tecla [ESC] para cerrar el diálogo sin aplicar los cambios (¡a menos que se hubiera presionado el botón "Aplicar"!). Una vez finalizado, hecer clic en "Aceptar". Si Algo Sale Mal ---------------- Si al hacer doble clic en el acceso directo para ejecutar el juego nada sucede, es probable que sea porque algunas de las opciones de línea de comando están mal. Abrir un Explorador como antes y buscar un archivo llamado 'stderr.txt' en la carpeta del TuxPaint. Este contendrá una descripción de lo que estuvo mal. Usualmente será sólo debido a una mayúscula o minúscula incorrecta ('Z' en vez de 'z') o un guión '-' de menos o de más. Usuarios Linux/Unix: -------------------- Compilación: ------------ Nota: Al presente, Tux Paint no utiliza autoconf/automake, por lo que no hay un guión "./configure" que ejecutar. (¡Lo sentimos!) Sin embargo compilarlo no debería presentar complicaciones, asumiendo que todo lo que el Tux Paint necesita esté instalado. Para compilar el programa desde las fuentes, simplemente ejecutar el siguiente comando desde un prompt del shell (p.ej.: "$"): $ make Deshabilitando el Sonido al Compilar: ------------------------------------- Alternativamente, si no hubiera tarjeta de sonido, o si se prefieriera compilar el programa sin soporte para sonido (por lo que SDL_mixer no tendría que ser instalada), se puede ejecutar "make" con "nosound" como 'target': $ make nosound Si aparecen errores: -------------------- Si aparecen errores durante la compilación, asegurarse de tener instaladas las bibliotecas apropiadas (ver arriba). Si se están utilizando versiones empacadas de las bibliotecas (p.ej: RPMs bajo RedHat o DEBs bajo Debian), asegurarse también de obtener los paquetes correspondientes "-dev" o "-devel", ¡de otro modo no será posible compilar Tux Paint (y otros programas) a partir del código fuente! Instalación: ------------ Asumiendo que no hayan ocurrido errores fatales, ahora es posible instalar el programa para que pueda ser ejecutado por los usuarios del sistema. Por defecto, esto debe ser hecho por el usuario "root" ('superusuario'). Volverse "root" ingresando el comando: $ su Ingresar la clave de "root" cuando sea solicitada. Ahora se debería estar en modo "root" (con un prompt así: #). Para instalar el programa y sus archivos de datos, tipear: # make install Finalmente, volver al usuario regular saliendo del modo superusuario: # exit NOTA: Por defecto, "tuxpaint", el programa ejecutable, está ubicado en "/usr/local/bin/". Los archivos de datos (imágenes, sonidos, etc.) están ubicados en "/usr/local/share/tuxpaint/". Chambiando las Cosas de Lugar ----------------------------- Es posible cambiar las cosas de lugar usando las variables 'prefix' al hacer Makefile. "PREFIX" es la base de a donde todos los demás archivos irán, y está fijado por defecto en "/usr/local". Otras variables son: BIN_PREFIX Donde será instalado el binario "tuxpaint". (Fijado por defecto en "$(PREFIX)/bin" - p.ej.: "/usr/local/bin") DATA_PREFIX Donde irán los archivos de datos (sonido, gráficos, pinceles, sellos, fuentes), y donde el Tux Paint los buscará al ejecutarse. (Fijado en "$(PREFIX)/share/tuxpaint") DOC_PREFIX Donde irán los los archivos de texto de la documentación (el directorio "docs"). (Fijado en "$(PREFIX)/share/doc/tuxpaint") MAN_PREFIX Donde irá la página de manual del Tux Paint. (Fijado en "$(PREFIX)/share/man") ICON_PREFIX $(PREFIX)/share/pixmaps X11_ICON_PREFIX $(PREFIX)/X11R6/include/X11/pixmaps GNOME_PREFIX $(PREFIX)/share/gnome/apps/Graphics KDE_PREFIX $(PREFIX)/share/applnk/Graphics Donde irán los íconos y lanzadores (para GNOME y KDE). LOCALE_PREFIX Donde irán los archivos de traducción del Tux Paint, y donde Tux Paint los buscará. (Fijado en "$(PREFIX)/share/locale/") (La ubicación final de un archivo de traducción será bajo el directorio de la respectiva localización [p.ej.: "es" para Español] dentro del subdirectorio "LC_MESSAGES".) Desinstalando Tux Paint: ------------------------ Windows ------- Utilizando el Desinstalador --------------------------- Si se instalaron los accesos directos del Menú Inicio (por defecto), entonces ir a la carpeta del TuxPaint y seleccionar "Uninstall". Un diálogo aparecerá que confirmará que se está a punto de desinstalar Tux Paint y consultará si se lo quiere remover permanentemente, hacer clic en el botón 'Uninstall'. Una vez haya terminado, hacer clic en el botón Cerrar. También es posible utilizar la entrada "TuxPaint (remove only)" en la sección Agregar/Quitar Programas del Panel de Control. NOTA: Como las imágenes creadas con el programa se almacenan dentro de la carpeta del Tux Paint, ésta así como la sub-carpeta 'userdata' NO son removidas. Linux ----- Dentro del directorio de fuentes del Tux Paint (donde se compiló el programa), es posible utilizar un 'target' de 'Makefile' para desinstalar Tux Paint. Por defecto, esto debe ser hecho por el usuario "root" ('superusuario'). (Ver las instrucciones de instalación arriba por más información.) Volverse "root" tipeando el comando: $ su Ingresar la clave de "root" cuando sea solicitada. Ahora se debería estar en modo "root" (con un prompt así: #). Para desinstalar el programa y sus archivos de datos (las imágenes de los sellos incluidos, si hubiera, también serán removidas), tipear: # make uninstall Finalmente, volver al usuario regular saliendo del modo superusuario: # exit