Metadata-Version: 2.1
Name: moderngl
Version: 5.6.4
Summary: ModernGL: High performance rendering for Python 3
Home-page: https://github.com/moderngl/moderngl
Author: Szabolcs Dombi
Author-email: cprogrammer1994@gmail.com
License: MIT
Description: 
        
        [![preview](https://github.com/cprogrammer1994/ModernGL/raw/master/.github/preview.png)](#readme)
        
        
        
        # ModernGL
        
        [![pypi](https://badge.fury.io/py/moderngl.svg)](https://pypi.python.org/pypi/moderngl) <img src="https://raw.githubusercontent.com/moderngl/moderngl/master/.github/python-versions.svg?sanitize=true"> [![rtd](https://readthedocs.org/projects/moderngl/badge/?version=latest)](https://moderngl.readthedocs.io)
        
        ModernGL is a python wrapper over OpenGL 3.3+ core that simplifies the creation of simple graphics applications like scientific simulations, games or user interfaces. Usually, acquiring in-depth knowledge of OpenGL requires a steep learning curve. In contrast, ModernGL is easy to learn and use, moreover it is capable of rendering with high performance and quality, with less code written. The majority of the moderngl
        code base is also written in C++ for high performance.
        
        ```sh
        pip install moderngl
        ```
        
        - [Documentation](https://moderngl.readthedocs.io/)
        - [Examples](https://github.com/moderngl/moderngl/tree/master/examples/#readme)
        - [ModernGL on Github](https://github.com/moderngl/moderngl/)
        - [ModernGL on PyPI](https://pypi.org/project/ModernGL/)
        - [ModernGL Discord Server](https://discord.gg/UEMtW8D)
        - [glcontext]
        - [moderngl-window] (Window creation, resource loading, ..)
        
        > **NOTE: From moderngl 5.6 context creation is delegated to the [glcontext] package.
          This makes us able to expand and improve context creation without releasing new
          versions of moderngl. It also makes it possible for users to customize their own
          context creation and the bar for contributing should be lower. New backends
          can be created using ctypes or C++.**
        
        ## Features
        
        - GPU accelerated high quality graphics
        - Rendering modern OpenGL scenes with less headache
        - Simpler and faster than PyOpenGL
        - Can render without a window
        - 100% Pythonic
        
        ## Sample usage
        
        ```py
        >>> import moderngl
        >>> ctx = moderngl.create_standalone_context()
        >>> buf = ctx.buffer(b'Hello World!')  # allocated on the GPU
        >>> buf.read()
        b'Hello World!'
        ```
        
        For complete examples please visit the [Examples](https://github.com/cprogrammer1994/ModernGL/tree/master/examples/#readme).
        
        ## Easy to use with Pillow and Numpy
        
        ```py
        >>> img = Image.open('texture.jpg')
        >>> ctx.texture(img.size, 3, img.tobytes())
        <Texture: 1>
        ```
        
        ```py
        >>> ctx.buffer(np.array([0.0, 0.0, 1.0, 1.0], dtype='f4'))
        <Buffer: 1>
        ```
        
        ## Compared to PyOpenGL
        
        With PyOpenGL, using the original OpenGL API, you have to write three lines to
        achieve a simple task like binding a VBO:
        
        ```py
        vbo1 = glGenBuffers(1)
        GL.glBindBuffer(GL_ARRAY_BUFFER, vbo1)
        GL.glBufferData(GL_ARRAY_BUFFER, b'Hello World!', GL_STATIC_DRAW)
        
        vbo2 = glGenBuffers(1)
        GL.glBindBuffer(GL_ARRAY_BUFFER, vbo2)
        GL.glBufferData(GL_ARRAY_BUFFER, b'\x00' * 1024, GL_DYNAMIC_DRAW)
        ```
        
        With ModernGL you need just one simple line per VBO to achieve the same
        results:
        
        ```py
        vbo1 = ctx.buffer(b'Hello World!')
        vbo2 = ctx.buffer(reserve=1024, dynamic=True)
        ```
        
        ## Build
        
        [![build](https://img.shields.io/travis/moderngl/moderngl/master.svg?label=build)](https://travis-ci.org/moderngl/moderngl)
        [![build](https://img.shields.io/appveyor/ci/cprogrammer1994/moderngl-hbi4t/master.svg?label=build)](https://ci.appveyor.com/project/moderngl/moderngl)
        
        ```sh
        python setup.py build_ext --inplace
        ```
        
        ## FAQ
        
        ### Is ModernGL faster than PyOpenGL?
        
        In many cases **yes**, the core functions of ModernGL are written in C++,
        OpenGL functions are called in quick succession so these calls together
        count as a single python function call.
        
        ### What version of OpenGL is used?
        
        Most of the calls only require **OpenGL 3.3** but Subroutines and Compute
        Shaders require **OpenGL 4.0** and **OpenGL 4.3**
        
        ### Is my old PC supported?
        
        OpenGL 3.3 came out in February 2010. With **up to date drivers** you will
        be able to use the most of the ModernGL functions, even on integrated 
        graphics cards. _(Compute Shaders will likely not work
        depending on how old your PC is.)_
        
        ### Where can I use ModernGL?
        
        **Anywhere where OpenGL is supported.** ModernGL is capable of rendering
        using a [standalone_context] as well. Rendering to a window only requires
        a valid OpenGL context.
        
        [standalone_context]: https://github.com/cprogrammer1994/ModernGL/tree/master/examples/old-examples/standalone
        
        ### Can ModernGL create a Window?
        
        **NO**, but we provide a utility library [moderngl-window] making window
        creation and resource loading very simple.
        
        ### Limitations using ModernGL over PyOpenGL?
        
        All the necessary calls are (or can be) implemented in ModernGL. However
        you can interact with the ModernGL objects from PyOpenGL. If something is
        missing write an [issue](https://github.com/cprogrammer1994/ModernGL/issues)
        or raise a [PR](https://github.com/cprogrammer1994/ModernGL/pulls).
        
        ## Supported platforms
        
        - [x] Windows
        - [x] Linux
        - [x] Mac
        
        ## Installing from source
        
        ### Installing on Ubuntu from source
        
        ```sh
        apt-get install python3-dev libgl1-mesa-dev libx11-dev
        python3 setup.py install
        ```
        
        ### Building the sphinx documentation
        
        ```sh
        pip install -r docs/requirements.txt
        python setup.py build_sphinx
        ```
        
        ### Running tests
        
        ```sh
        pip install -r tests/requirements.txt
        pytest tests
        ```
        
        > Some of the tests may be skipped when the supported OpenGL version is below the requirements of the given test.
        
        ### Headless rendering
        
        ```sh
        apt-get install xvfb
        alias xpy='xvfb-run -s "-screen 0 1x1x24" python3'
        xpy -m moderngl
        ```
        
        ## Code quality
        
        Code is tested with [pep8], [flake8], [prospector] and [pylint]
        
        [pep8]: https://www.python.org/dev/peps/pep-0008/
        [flake8]: http://flake8.pycqa.org/en/latest/
        [prospector]: https://prospector.readthedocs.io/en/master/
        [pylint]: https://www.pylint.org/
        [moderngl-window]: https://github.com/moderngl/moderngl-window
        [glcontext]: https://github.com/moderngl/glcontext
        
        ## Community
        
        - [Code of conduct](https://github.com/cprogrammer1994/ModernGL/blob/master/.github/CODE_OF_CONDUCT.md)
        
        ## Citation
        
        If you need to cite this repository in academic research:
        ```txt
        @Online{Dombi2020,
          author = {Szabolcs Dombi},
          title = {ModernGL, high performance python bindings for OpenGL 3.3+},
          date = {2020-05-01},
          publisher = {GitHub},
          journal = {GitHub repository},
          howpublished = {\url{https://github.com/moderngl/moderngl}},
          commit = {<insert hash if needed>}
        }
        ```
        
        If commit hash is required this can be found per release here:
        https://github.com/moderngl/moderngl/releases
        
        
        ## Contributors
        
        - [Szabolcs Dombi](https://github.com/cprogrammer1994)
        - [SimLeek](https://github.com/SimLeek)
        - [Aljenci](https://github.com/Aljenci)
        - [MinchinWeb](https://github.com/MinchinWeb)
        - [Silexstudio](https://github.com/Silexstudio)
        - [stuaxo](https://github.com/stuaxo)
        - [Tomi Aarnio](https://github.com/toaarnio)
        - [Joshua Reibert](https://github.com/joshua-r)
        - [Einar Forselv](https://github.com/einarf)
        - [Jonathan Hartley](https://github.com/tartley)
        - [yoyonel](https://github.com/yoyonel)
        
        and [many others](https://github.com/cprogrammer1994/ModernGL/graphs/contributors)
        
        Thank You!
        
        Contributions are welcome. _(Please add yourself to the list)_
        
Keywords: ModernGL,OpenGL,PyOpenGL,rendering,graphics,shader,GLSL,GPU,visualization,2D,3D
Platform: any
Classifier: Development Status :: 5 - Production/Stable
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Topic :: Games/Entertainment
Classifier: Topic :: Multimedia :: Graphics
Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
Classifier: Topic :: Scientific/Engineering :: Visualization
Classifier: Programming Language :: Python :: 3 :: Only
Description-Content-Type: text/markdown
