Grupo de Usuarios de Python/pyopengl/Instalar PyOpenGL
De Proyecto Ciencia
Instalando PyOpenGL y PyOpenGLContext
Construir e instalar las dos librerías desde los binarios o las distribuciones de fuentes.
Este documento describe el proceso para instalar PyOpenGL 3.x, cuyos ultimas liberaciones utilizan los disutils de python estándar.
Contenido |
Dependencias
PyOpenGl tiene un número de dependencias que deben estar instaladas antes de instalar PyOpenGl. Aquí le apuntamos todo lo que necesita para poder ejecutar PyOpenGL:
- Python serie 2.x, 2.4+
- ctypes (viene con Python 2.5 y mayores)
- OpenGL 1.1 y GLU (disponibles pre-instalados en la mayoría de los sistemas modernos)
- Si su maquina es muy vieja (Win95) y nunca tuvo un juego OpenGL, o una tarjeta gráfica instalada, es posible que no tenga OpenGL. Obtengalo desde la pagina de Microsoft busque OpenGL95.exe.
Opcionales
- Numpy o Numeric
- Es posible necesitar una librería numérica para cualquier código del mundo real.
- Se recomienda (PyOpengl.org) usar numpy si no va a soportar código viejo escrito para usar con numeric.
- GLUT o FreeGLUT
- Disponible como un rpm/ebuild para las maquinas con GNU/Linux.
- Disponible como un binario para Win32
- El paquete incluye una copia para GLUT 32-bit
- Librería de Imágenes para Python (PIL)
- No es técnicamente necesario, pero puede que la necesite para la mayoría de los proyectos PyOpenGL
- Requerido para OpenGLContext
- GLE
- Use la librería de Protuberancias GL, disponible en la mayoría de las distribuciones GNU/Linux.
- Versiones pre-compiladas de Win32 gle32.zip
- Togl v1.5+
- La necesitara para la versión Tcl/TK de su instalación de Python.
- Solo es requerido si desea usar PyOpenGL con programas basados en el GTK.
Note que el soporte para Togl esta deprecado, aparece aqui para el código de legado (una vez que compile Togl), pero debería escoger una librería para GUI que tenga soporte interno de OpenGL para nuevos desarrollos. El soporte para Togl se detuvo debido a la complejidad de compilación y los problemas de mantenimiento. Existen proyectos que intentar dar soporte a Togl, puede instalar cualquiera de esos con su instalación de Python Tk si necesita el soporte bajo Python.
OpenGLContext
Mas allá de PyOpenGL:
- PyDispatcher
- Provee direccionamiento de eventos e infraestructura para observar de campo para escenografía.
Útiles
- SimpleParse 2.1
- Fuertemente recomendado, provee el parser VRML97
- TTFQuery
- FontTools para numpy
- Provee acceso a fuentes True-Type alojadas en el sistema, usado por los módulos "toolsfont" y "pygamefont" en el paquete de escenografía/texto.
- Este FontTools esta parcheado para soportar numpy.
- wxPuthon
- PyGame
- Ambientes adicionales de contexto/ventanas, sino solo estarían disponibles los contextos de GLUT.
- También provee fuentes con mapas de bits antializados de ser necesario.
- win32all
- win32ui y win32con dan soporte al texto poligonal WGL.
Instalación Estándar
distutils
PyOpenGL usa distutils estándar. Puede descargar los paquetes de fuentes e instalar así:
tar -zxvf PyOpenGL-3.0.0.tar.gz cd PyOpenGl-3.0.0 python setup.py install
Si prefiere usar easy_install, por ejemplo desde dentro de un contenedor virtualenv, necesitara instalr setuptools (ej. ez_setup.py), y ejecutar:
easy_install PyOpenGL
Para actualizar su instalación a la ultima versión de PyOpenGL con una instalación base de easy_inatall:
easy_install -U PyOpenGL
Si desea instalar sus archivos huevo de Python en una ubicación diferente asegúrese de configurar su .pydistutils.cfg para soportar esto antes de instalar los paquetes.
Puede que quiera desinstalar cualquier otra versión de PyOpenGL antes de instalar la nueva, ya que pueden haber conflictos.
setuptools
Si usa setuptools para empaquetar su aplicación, deberá declarar una dependencia en "PyOpenGL" para halar la ultima liberación de PyOpenGL 3.x.
Varios alfas de PyOpenGL 3.0.0 eran dependientes de setuptools. Esto ya no es el caso, ya que el mecanismo de conexión con setuptools estaba causando conflictos con las herramientas de empaquetado de la plataforma (py2exe, pyinstaller).
Instalación BZR (desarrollador)
Si desea contribuir con el desarrollo de PyOpenGL o solo necesita usar tecnología de punta, puede que prefiera trabajar con una salida de código fuente (source-code checkout). Necesitará la herramienta del bazaar (bzr) para trabajar con el repositorio:
bzr branch lp:pyopengl OpenGL-ctypes
Necesitará colocar el directorio de "OpenGL" dentro del directorio de OpenGL-ctypes creado arriba con su PYTHONPATH a través de un enlace simbólico o un archivo .pth.
Para contribuir con sus cambios, puede publicar su rama públicamente (por medio de LaunchPad) o crear una "directiva de unión" para enviar a pyopengl-devel@list.sourceforge.net.
bzr sen -o mis-cambios.diff
Note que deberá suscribirse a pyopengl-devel para colocar los cambios. Si prefiere puede enviarlos a Mike Fletcher directamente.
Construyendo Documentación
El sistema para construir documentación ha sido re-escrito para PyOpenGL 3.x y es mucho mas fácil y rápido de usar (por lo menos en una magnitud de un par de ordenes) que la versión anterior en el docbook processor hecho en java
bzr branch lp:~mcfletch/pyopengl/directdocs cd directdocs ./samples.py ./references.py ./generate.py ./upload.py
El ultimo comando no funcionará a menos que usted sea yo. Necesitará instalar los paquetes lxml.etree y kid para ejecutar el generador (también bzr, svn, PyOpenGL, cvs, etc...).
Construyendo las Liberaciones Anteriores
Si desea construir la liberación 2.x de PyOpenGL, puede ver el documento original de instalación. (ingles)
