This is a pre-production deployment of Warehouse, however changes made here WILL affect the production instance of PyPI.
Latest Version Dependencies status unknown Test status unknown Test coverage unknown
Project Description

oogli

Oogli is Beautiful

Object Oriented Graphics Library Interface written in Python

Motivation:

I was dissatisfied with difficulty in producing easy to read and understand OpenGL code. This small library helps eliminate some of the boilerplate inherent within OpenGL’s API. Oogli greatly simplifies the interface while still providing access to the underlying GLFW3 and OpenGL API.

License:

This package is released as Apache 2.0 license.

However, at your option, you may apply any OSI approved free software license you choose provided that you adhere to the free software license chosen and additionally follow these criteria:

  1. list the author’s name of this software as a contributor to your final product
  2. provide credit to your end user of your product or software without your end user asking for where you obtained your software
  3. notify the author of this software that you are using this software
  4. If you believe there can be some benefit in providing your changes upstream, you’ll submit a change request. While this criteria is completely optional, please consider not being a dick.

Installation:

Oogli was designed with GLFW-CFFI in mind and uses the API provided by GLFW-CFFI. In addition, Oogli uses numpy.

Installing via pip

Install via pip install oogli.

Installing GLFW-CFFI via pip

Install via pip install glfw-cffi.

Installing Numpy via pip

Install via pip install numpy.

Installing GLFW3

GLFW3 is available for several different platforms:

  • Ubuntu/Debian: sudo apt-get install -y libglfw3-dev
  • Fedora/Red Hat: sudo yum install -y libglfw3-dev
  • Mac OS X with Homebrew: brew install glfw3
  • Windows: There is an installer available 64-bit Windows or 32-bit Windows

GLFW3 is relatively new, so some older installations of Linux may not have libglfw directly available. You may check out the travis.yml file within our github repo for more information on setup on older systems.

Usage:

Sample Usage:

This is the required code to produce a shaded triangle using oogli:

import oogli

v_shader = '''
    #version 410
    in vec2 vertices;
    void main () {
        gl_Position = vec4(vertices, 0.0, 1.0);
    }
'''

f_shader = '''
    #version 410
    out vec4 frag_color;
    void main () {
        frag_colour = vec4(0.3, 1.0, 0.3, 1.0);
    }
'''

# Create a program from the shaders
#  Note: This will auto request an OpenGL context of 4.1
program = oogli.Program(v_shader, f_shader)

# Vertices for a 2D Triangle
triangle = [(0.0, 0.5), (-0.5, 0.5), (-0.5, -0.5)]

with oogli.Window('Oogli', 640, 480) as win:
    # Main Loop
    while win.should_run()
        # Render triangle
        program.draw(vertices=triangle)

More complex examples can be found within the examples folder on the github repo.

Contributions:

Contributions are welcome. When opening a PR, please keep the following guidelines in mind:

  • Before implementing, please open an issue for discussion.
  • Make sure you have tests for the new logic.
  • Make sure your code passes flake8
  • Add yourself to contributors at README.md and/or your contributions.

Contributors

Release History

Release History

0.1.0

This version

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

0.1.0.dev0

History Node

TODO: Figure out how to actually get changelog content.

Changelog content for this version goes here.

Donec et mollis dolor. Praesent et diam eget libero egestas mattis sit amet vitae augue. Nam tincidunt congue enim, ut porta lorem lacinia consectetur. Donec ut libero sed arcu vehicula ultricies a non tortor. Lorem ipsum dolor sit amet, consectetur adipiscing elit.

Show More

Download Files

Download Files

TODO: Brief introduction on what you do with files - including link to relevant help section.

File Name & Checksum SHA256 Checksum Help Version File Type Upload Date
oogli-0.1.0.tar.gz (40.4 kB) Copy SHA256 Checksum SHA256 Source Feb 12, 2016

Supported By

WebFaction WebFaction Technical Writing Elastic Elastic Search Pingdom Pingdom Monitoring Dyn Dyn DNS HPE HPE Development Sentry Sentry Error Logging CloudAMQP CloudAMQP RabbitMQ Heroku Heroku PaaS Kabu Creative Kabu Creative UX & Design Fastly Fastly CDN DigiCert DigiCert EV Certificate Rackspace Rackspace Cloud Servers DreamHost DreamHost Log Hosting