Vapory-git 0.1.1

安装

Vapory应该可以在Python2.7+或Python3的任何平台上工作。

首先需要安装pov-ray。有关windows二进制文件，请参见here。对于linux/macos，您必须compile the source（在ubuntu上测试，很容易）。

如果安装了PIP，则可以：

(sudo) pip install vapory

如果您既没有安装setuptools，也没有安装ez_setup，上面的命令将失败，在安装之前是否键入以下命令：

(sudo) pip install ez_setup

Vapory也可以手动安装，方法是将源代码解压缩到一个目录中，然后键入终端：

(sudo) python setup.py install

开始

在vapory中创建一个场景，然后渲染它：

fromvaporyimport*scene=Scene(camera=mycamera,# a Camera objectobjects=[light,sphere],# POV-Ray objects (items, lights)atmospheric=[fog],# Light-interacting objectsincluded=["colors.inc"])# headers that POV-Ray may needscene.render("my_scene.png",# output to a PNG image filewidth=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 arrayimage=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 documentation，它将为您提供每个对象的所有可能用途（可能有很多！）。此文档很容易从vapory访问，只需键入`Sphere.help()、Plane.help()等，它就会在浏览器中打开。
• 最后，很容易在网上找到pov射线的例子并将其转录回vapory。

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