fdray 0.1.12

A Python interface for POV-Ray (Persistence of Vision Raytracer)

fdray - Python Ray Tracing Interface for POV-Ray

fdray is a Python library that provides a clean interface to POV-Ray, making it easy to create and render 3D scenes programmatically.

Features

• Simple Scene Description: Express 3D scenes in clean, readable Python code
• Pythonic API: Natural integration with Python's ecosystem
• POV-Ray Integration: Seamless integration with a high-quality rendering engine
• Jupyter Support: Interactive scene development in Jupyter notebooks

Installation

pip install fdray

Requires POV-Ray to be installed:

• Linux: sudo apt-get install povray
• macOS: brew install povray
• Windows: Download from POV-Ray website

Quick Start

from fdray import Camera, Color, LightSource, Scene, Sphere

# Create a simple scene
scene = Scene(
    Camera(longitude=20, latitude=30),
    LightSource(0, Color("white")),  # 0: at camera location
    Sphere((0, 0, 0), 1, Color("red")),
)

# Render the scene
scene.render(width=800, height=600)

Documentation

For detailed documentation and examples, visit our documentation site.

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.

Acknowledgments

• POV-Ray team for their excellent ray tracing engine
• The Python community for inspiration and support