Metadata-Version: 2.1
Name: ogre-python
Version: 13.5.0
Summary: Object-Oriented Graphics Rendering Engine - python package
Home-page: https://www.ogre3d.org
Maintainer: Pavel Rojtberg
License: MIT
Project-URL: Documentation, https://ogrecave.github.io/ogre/api/latest/manual.html
Project-URL: Source code, https://github.com/OGRECave/ogre
Project-URL: Issues, https://github.com/OGRECave/ogre/issues
Project-URL: Funding, https://www.patreon.com/ogre1
Classifier: Development Status :: 5 - Production/Stable
Classifier: Environment :: Console
Classifier: Intended Audience :: Developers
Classifier: Intended Audience :: Education
Classifier: Intended Audience :: Information Technology
Classifier: Intended Audience :: Science/Research
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: MacOS
Classifier: Operating System :: Microsoft :: Windows
Classifier: Operating System :: POSIX
Classifier: Operating System :: Unix
Classifier: Programming Language :: Python
Classifier: Programming Language :: Python :: 3
Classifier: Programming Language :: Python :: 3 :: Only
Classifier: Programming Language :: Python :: 3.8
Classifier: Programming Language :: C++
Classifier: Programming Language :: Python :: Implementation :: CPython
Classifier: Topic :: Scientific/Engineering
Classifier: Topic :: Multimedia :: Graphics :: 3D Rendering
Classifier: Topic :: Software Development
Requires-Python: >=3.6
Description-Content-Type: text/markdown
License-File: LICENSE
License-File: AUTHORS

[![GitHub release](https://img.shields.io/github/release/ogrecave/ogre.svg)](https://github.com/OGRECave/ogre/releases/latest)
[![Join the chat at https://gitter.im/OGRECave/ogre](https://badges.gitter.im/OGRECave/ogre.svg)](https://gitter.im/OGRECave/ogre?utm_source=badge&utm_medium=badge&utm_campaign=pr-badge&utm_content=badge)
[![Patreon](https://img.shields.io/badge/patreon-donate-blue.svg)](https://www.patreon.com/ogre1)

![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/ogre_header.png)

## Summary
**OGRE** (Object-Oriented Graphics Rendering Engine) is a
scene-oriented, flexible 3D engine written in C++ designed to make it
easier and more intuitive for developers to produce games and demos
utilising 3D hardware. The class library abstracts all the details of
using the underlying system libraries like Direct3D and OpenGL and
provides an interface based on world objects and other intuitive
classes.

| Build | Status |
|-------|-----------------|
| Linux, OSX, Android, iOS | [![CI Build](https://github.com/OGRECave/ogre/workflows/CI%20Build/badge.svg?branch=master)](https://github.com/OGRECave/ogre/actions?query=branch%3Amaster) |
| MSVC | [![Build status](https://ci.appveyor.com/api/projects/status/kcki7y0n1ahrggdw/branch/master?svg=true)](https://ci.appveyor.com/project/paroj/ogre-bsrh7/branch/master) |

## Index Of Contents
* [What's New?](https://github.com/OGRECave/ogre/blob/master/Docs/13-Notes.md)
A summary of the new and altered features in this release.
* [Building the core OGRE libraries](https://ogrecave.github.io/ogre/api/latest/building-ogre.html)  
If you're using the full source release, this will help you build it. If you're using a precompiled SDK then most of the work has already been done for you, and you should use the sample projects to see how to compile your own code against OGRE.
* [The OGRE Manual](https://ogrecave.github.io/ogre/api/latest/manual.html)  
A high-level guide to the major parts of the engine and script reference.
* [API Reference](https://ogrecave.github.io/ogre/api/latest/)  
The full OGRE API documentation, as generated from the (heavily!) commented source.
* [The OGRE Tutorials](https://ogrecave.github.io/ogre/api/latest/tutorials.html)  
A gold mine of tutorials, tips and code snippets which will help you get up to speed with the engine.

## Try it
* [Online Emscripten Demo](https://ogrecave.github.io/ogre/emscripten/)
* [Linux Snap Package](https://snapcraft.io/ogre)
* [Android App on F-Droid](https://f-droid.org/packages/org.ogre.browser/)

## Features

For an exhaustive list, see the [features page](http://www.ogre3d.org/about/features) and try our Sample Browser. For a quick overview see below

| Integrated Bump and Offset Mapping | Integrated shadows |
|----|----|
| ![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/screenshots/bumpmap.webp) | ![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/screenshots/shadows.jpg) |

| Physically Based Shading | Particle Effects |
|----|----|
| ![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/screenshots/pbr.webp) | ![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/screenshots/particle.jpg) |

| HW & SW skeletal animation | Multi-layer Terrain |
|----|----|
| ![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/screenshots/skeletal.jpg) | ![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/screenshots/terrain.jpg) |

| Automatic Rendertarget pipelining (Compositors) | Volume Rendering with CSG & Triplanar Texturing |
|----|----|
| ![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/screenshots/compositor.jpg) | ![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/screenshots/volume.jpg) |

| [Dear ImGui](https://github.com/ocornut/imgui) | [Bullet Physics](https://pybullet.org/) Integration |
|----|----|
| ![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/screenshots/imgui.jpg) | ![](https://raw.githubusercontent.com/OGRECave/ogre/master/Other/screenshots/bullet.webp) |

## Who is using it?

**Open Source**
- [Stunt Rally - 3D Racing Game with Track Editor](https://stuntrally.tuxfamily.org/)
- [Rigs of Rods - Soft Body Physics Simulator](https://rigsofrods.org/)
- [Gazebo - Robot simulation](http://gazebosim.org/)
- [OpenCV OVIS visualization module](https://docs.opencv.org/master/d2/d17/group__ovis.html)
- [ROS 3D visualization tool](http://wiki.ros.org/rviz)
- [RAISIM Physics](https://github.com/raisimTech/raisimOgre#news)

**Closed Source**
- [Hob](http://store.steampowered.com/app/404680/Hob/)
- [Torchlight II](http://store.steampowered.com/app/200710/Torchlight_II/)
- [Battlezone 98 Redux](http://store.steampowered.com/app/301650/Battlezone_98_Redux/)

## Contributing
We welcome all contributions to OGRE, be that new
plugins, bugfixes, extensions, tutorials, documentation, example
applications, artwork or pretty much anything else! If you would like
to contribute to the development of OGRE, please create a [pull request](https://github.com/OGRECave/ogre/pulls).

## Getting Support
Please use our [community support forums](http://forums.ogre3d.org/) if you need help or
think you may have found a bug.

## Licensing
Please see the [full license documentation](https://github.com/OGRECave/ogre/blob/master/Docs/License.md) for details.
