aiidalab-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>
}

所有对象（Sphere、Box、Plane等，有一些例外）都以相同的方式工作。因此，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]) """