Vapory 0.1.2

安装

Vapory应该在具有Python 2.7+或Python 3的任何平台上工作。

您首先需要安装POV-Ray。有关Windows二进制文件的链接，请参阅此处。对于Linux/MacOS，您必须编译源代码（在Ubuntu上进行了测试，很容易）。

如果您已安装PIP，则可以

(sudo) pip install vapory

如果您既未安装setuptools也未安装ez_setup，则上述命令将失败，在这种情况下，在安装之前请输入以下内容

(sudo) pip install ez_setup

您还可以通过在一个目录中解压缩源代码并输入终端中的命令手动安装Vapory

(sudo) python setup.py install

入门指南

在Vapory中，您创建一个场景，然后渲染它

from vapory import *

scene = Scene( camera = mycamera , # a Camera object
           objects= [light, sphere], # POV-Ray objects (items, lights)
           atmospheric = [fog], # Light-interacting objects
           included = ["colors.inc"]) # headers that POV-Ray may need

scene.render("my_scene.png", # output to a PNG image file
  width = 300, height=200, # in pixels. Determines the camera ratio.
  antialiasing = 0.01 # The nearer from zero, the more precise the image.
  quality=1) # quality=1 => no shadow/reflection, quality=10 is 'normal'

# passing 'ipython' as argument at the end of an IPython Notebook cell
# will display the picture in the IPython notebook.
scene.render('ipython', width=300, height=500)

# passing no 'file' arguments returns the rendered image as a RGB numpy array
image = scene.render(width=300, height=500)

通过传递一个参数列表来定义对象

camera = Camera( 'location', [0,2,-3], 'look_at', [0,1,2] )

请注意，此代码片段将随后被转换为POV-Ray代码，通过将每个参数转换为字符串并将它们放置在不同的行上，以创建有效的POV-Ray代码

camera {
    location
    <0,1,0>
    look_at
    <0,0,0>
}

所有对象（球体、盒子、平面等，有一些例外）都按相同的方式工作。因此，Vapory的语法与POV-Ray的语法相同。要了解如何使用不同的对象

• 请查看examples文件夹中的场景

• 查看不同对象的docstring，它提供了一个基本示例。

• 请参阅在线POV-Ray文档，其中将介绍每个对象的所有可能用途（可能有多个！）。该文档可以从Vapory轻松访问，只需输入`Sphere.help()`、`Plane.help()`等，它将在您的浏览器中打开。

• 最后，在网上很容易找到POV-Ray示例，并将它们转录回Vapory。

class Camera(POVRayElement):
    """ Camera([type,]  'location', [x,y,z], 'look_at', [x,y,z]) """