Skip to main content

A 3d rendering library written completely in python.

Project description

Build Status

Introduction

I'm creating this repository in January 2018 and it is crazy that the best open source option for rendering 3d scenes remains POV ray. Now, POV ray is a great program, but why can't we have that functionality (rendering 2d, 3d and higher dimensional objects and scenes) in Python, a language that is perhaps the most widely used already and only growing in popularity? This code is a first step towards that goal - have the ability to do everything POV ray does - rendering complex 3d objects and scenes, animations and much more in plain, vanilla Python. I imagine this would find applications in creating videos, video games, physical simulations or just pretty pictures.

While there certainly is a very long way to go before this can be a reality, it won't happen without taking a first step. And of course, I could use help :)

Above all else, I want to emphasize simplicity in this library and minimize the dependence on external libraries so more people can hit the ground running with it.

Installation

To install the library, run (pyray was taken on pypi):

pip install raypy

Make sure you have all the requirements (requirements.txt) installed. If not, you can run:

pip install -r requirements.txt

Alternately, you can fork/download the code and run from the main folder:

python setup.py install

Requirements

I've made every effort to keep the requirements for this project to the bare minimum so most people can get it running with almost no pain. These are - Python Imaging Library (PIL), numpy and scipy. For writing on math equations images using the methods in WriteOnImage.py, you'll need matplotlib and sympy. All of these can be installed quite easily with pip install -r requirements.txt

Usage

To keep things simple and the dependencies minimal, the program simply writes an image or a series of images to the folder ./Images/RotatingCube (this was the first object that was animated with this tool).

You can run any method tagged @MoneyShot to see how this works. For example, you can run the following method from cube.py -

from pyray.shapes.solid.cube import *
cube_with_cuttingplanes(7, popup=True)

and this will generate a colorful 3d cube with diagonal cutting planes shaded in different colors (in the folder where you run it from, file called im0.png). Something like this (click to see what happens) -

Image formed by above method

You can now create a series of them using the following code -

for i in range(3, 15):
	cube_with_cuttingplanes(numTerms = i, im_ind = i-3)

The series of images can then be easily converted to a video using the open source ffmpeg program. For example

ffmpeg -framerate 10 -f image2 -i im%d.png -vb 20M vid.avi

The video can then be converted to a .gif file if required -

ffmpeg -i vid.avi -pix_fmt rgb24 -loop 0 out.gif

For example, something like this:

Image formed by above method

In case you're wondering, you can generate the images used in the gif above via:

from pyray.shapes.twod.plane import *
for i in range(20):
	best_plane_direction(im_ind=i)

If you think this is valuable, please star :)

Contributing

We welcome any kind of contribution, bug report, suggestion, new module, etc. Anything is welcome.

Install pre-commit hooks

The pre-commit hooks will run a set of linters and formmatters automatically against your code when you commit. This enforces a common set of style standards and checks for common, simple mistakes in code. If you have a project-specific set of hooks, install those instead. Otherwise, install the repo-wide hooks. From root:

pip install pre-commit
pre-commit install

Other examples

To create a bouncy sphere or a wavy sphere, run

from pyray.shapes.solid.sphere import *
draw_wavy_sphere_wrapper('.\\im', 66, 1)

Image formed by above method

import numpy as np;from PIL import Image, ImageDraw, ImageFont, ImageMath;from pyray.axes import *
from pyray.rotation import *;from pyray.axes import draw_2d_arrow, Path, ZigZagPath, draw_grid, draw_grey_grid
from pyray.misc import dist

im = draw_grid()
draw = ImageDraw.Draw(im,'RGBA')
pts = np.array([[0,0],[1,1],[5,-3]])
pth = Path(pts)
pth.zg.draw_lines(draw,i/10.0)
im.save("im" + str(i) + ".png")

Image formed by above method

from pyray.shapes.solid.polyhedron import *
basedir = '.\\'
tr = Tetartoid()
for i in range(0, 31):
    im = Image.new("RGB", (2048, 2048), (1,1,1))
    draw = ImageDraw.Draw(im, 'RGBA')
    r = general_rotation(np.array([0,1,0]), 2*np.pi*i/30)
    tr.render_solid_planes(draw, r, shift=np.array([1000, 1000, 0]), scale=750)
    im.save(basedir + "im" + str(i) + ".png")

Image formed by above method

from pyray.shapes.twod.paraboloid import *
draw_paraboloids()

Image formed by above method

from pyray.shapes.zerod.pointswarm import *
points_to_bins()

Image formed by above method

Demonstrations

So far, I've been using this to create YouTube videos for my channel.

Here are some that demonstrate the abilities of this code (also see below for some images created with it) -

  1. Binomial coefficients on hypercubes.

  2. Why does Gradient descent work?

  3. Introduction to Platonic solids

  4. Slice a 4d hypercube (Teserract).

Project details


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

raypy-0.0.3.tar.gz (70.5 kB view details)

Uploaded Source

Built Distribution

raypy-0.0.3-py3-none-any.whl (78.5 kB view details)

Uploaded Python 3

File details

Details for the file raypy-0.0.3.tar.gz.

File metadata

  • Download URL: raypy-0.0.3.tar.gz
  • Upload date:
  • Size: 70.5 kB
  • Tags: Source
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.12

File hashes

Hashes for raypy-0.0.3.tar.gz
Algorithm Hash digest
SHA256 36c4447c5f3acda8c915cf189399356469e618f8e27db33b19761d353c383369
MD5 82e3b39bc070039ecad14d734aed1952
BLAKE2b-256 f9dac03ba754cad0b53ee648beaa20a5bb5efe610f82733d9c8a5d46b5af4067

See more details on using hashes here.

File details

Details for the file raypy-0.0.3-py3-none-any.whl.

File metadata

  • Download URL: raypy-0.0.3-py3-none-any.whl
  • Upload date:
  • Size: 78.5 kB
  • Tags: Python 3
  • Uploaded using Trusted Publishing? No
  • Uploaded via: twine/4.0.2 CPython/3.9.12

File hashes

Hashes for raypy-0.0.3-py3-none-any.whl
Algorithm Hash digest
SHA256 e64b1170d36fd0a54879d058ec0a5b002ad28d3a1893fdbcc45aaeb7a9ffe469
MD5 986120177051c0b423bd8e30e7d95bc2
BLAKE2b-256 fb593ec3616b057b25628d064c71b7350aa008e2d081e0dc7c3feb7c6582e4ab

See more details on using hashes here.

Supported by

AWS AWS Cloud computing and Security Sponsor Datadog Datadog Monitoring Fastly Fastly CDN Google Google Download Analytics Microsoft Microsoft PSF Sponsor Pingdom Pingdom Monitoring Sentry Sentry Error logging StatusPage StatusPage Status page