Extensions:DE/2.6/Py/Scripts/Render/POV-Ray - 版の履歴

Yamyam: 1版をインポートしました

2018-06-28T21:14:23Z

1版をインポートしました

wiki>Maurice: Created page with "
100px

2015-07-02T15:13:04Z

Created page with "<div class="tableNormal"> left|100px <div class="columnThird" style="text-align:center;"> <ul style="font-size:1.1em; list-style-type:none;"><li><fon..."

新規ページ
<div class="tableNormal">
[[File:POVExporterLogo.png|left|100px]]
<div class="columnThird" style="text-align:center;">
<ul style="font-size:1.1em; list-style-type:none;"><li><font size="+2">[[Extensions:2.6/Py/Scripts/Render/POV-Ray|User's page]]</font size="21"></li><li>[http://povray.org POV-Ray Site]</li><li>[[Extensions:2.6/Py/Scripts/Render/POV-Ray#Quick_Start|Exporter Quick Start]]</li><li>[http://povray.org/documentation/3.7.0/ POV-Ray Documentation]</li><li>[http://wiki.blender.org/index.php/Extensions:2.6/Py/Scripts/Render/POV-Ray/Sample_Materials Sample Materials]</li></ul>
</div>
<div class="columnThird" style="text-align:center;">
<ul style="font-size:1.1em; list-style-type:none;"><li><font size="+2">[[Dev:2.6/Py/Scripts/Render/POV-Ray|Developer's page]]</font size="+2"></li>
<li>design ideas</li><li>regression files</li></ul>
</div>
<div class="clearBoth"></div>
<div style="text-align:center; border-top: grey solid 1px;">
<ul style="font-size:1.1em; list-style-type:none;"><li><font size="+2">[http://developer.blender.org/diffusion/BA/history/master/render_povray/ Latest News]</font size="+2"></li>
<li>[http://pipes.yahoo.com/pipes/pipe.run?_id=419de11936366a94e694755bc4723481&_render=rss RSS feed]</li>
<li>[irc://irc.freenode.org/blenderpovray Chat room, IRC: #blenderpovray at freenode]</li>
<li>[http://blenderartists.org/forum/group.php?groupid=79 Forum Group]</li></ul>
</div>
</div>
{{Template:MoreDetails|Features|
Some key features of the exporter include:
* Geometry and modifiers
* Instances
* Hair particles
* Smoke simulations
* HDRI environment mapping
* Material properties such as filtering, emission, translucency, subsurface scattering, glass fog (tinted absorption), blurry/glossy reflections...
* Texture channels: Alpha ; Diffuse ; Bump ; Specular ; Mirror (uses same channel as specular)
* Global Illumination: Radiosity (Indirect Lighting) ; Photons caustics (reflect/refract); meshlights
* Custom POV-Ray code input giving access to any POV-Ray feature not supported by the exporter.

POV-Ray 3.7 features
volumetrics and media (scattering/absorbing); depth of field; non mesh primitives (never show tesselation), etc.
developement version already features motion blur, blurry reflection, etc.
}}
[http://wiki.blender.org/index.php/Extensions:2.6/Py/Scripts/Render/POV-Ray#Stand_Script_Information Standard Script Information] at the bottom of this page.

= POV-Ray 3.7 Exporter for Blender 2.7x =
POV-Ray is an an SDL based (Scene Description Language) rendering engine with a long history that makes it very stable and feature rich. The latest version of POV-Ray 3.7 can be found at: http://www.povray.org/download/<br />
See the [http://wiki.blender.org/index.php/Extensions:2.6/Py/Scripts/Render/POV-Ray/Installation Installation] page for platform specific details on how to get, install or build POV-Ray.
= Usage =
=== Quick Start ===

{| width=100%
| valign=top | '''1.''' Go to the menu {{Menu|File|User Preferences}}
| [[File:Pov_start01.png|thumb|320px|1]]
|-
| valign=top | '''2.''' Choose the {{Menu|Add-Ons}} tab and check POV-Ray 3.7 down the list of render Add-Ons.
| [[File:Pov_start02.png|thumb|600px|2]]
|-
| valign=top | '''3.''' Choose POV-Ray 3.7 from renderer choices. Then you can render as usual with the {{Button|Image}} render button or its shortcut ({{Shortcut|F12}} in default layout)
| [[File:Pov_start03.png|thumb|600px|3]]
|}

[[File:UberPOV.png|left|64px]]

=== Rendering with UberPOV ===

[https://github.com/UberPOV/UberPOV UberPOV] is a development branch of POV-Ray. Just like MegaPOV used to be in the old days.

[https://github.com/UberPOV/UberPOV/releases/tag/v1.37.0.0-beta.7 HERE] you can download a standalone installer that will not interfere with a standard POV-Ray installation and [https://github.com/UberPOV/UberPOV/releases/tag/v1.37.1.0-beta.10 HERE] is an update to the main binary.
{| width=100%
| valign=top | Choose the feature set and just point the renderer path in {{Menu|File|User Preferences}} to the location of the engine you choose to use and you're good to go.
| [[File:RendererPath.png|thumb|600px|1]]
|}
Note that ''Feature Set'' is what features get written in the POV file and the ''Binary Location'' path points Blender at the binary to actually render it with. Whithout any ''Binary Location'' path, Blender will use the environment variables and try to find the most feature rich binary available in that directory. So if you installed UberPOV it's most probably being used for rendering, but you still need to enable its feature set to enjoy specific features, like blurry reflections. And if you want to be sure to use the plain official POV-Ray 3.7 engine instead, just explicitly point the ''Binary Location'' path to it.

UberPOV features are written to the POV file inside the scope of a specific condition to enable the files to be retro compatible with POV-Ray 3.7 syntax:

<source lang="c">
reflection { 1 metallic
#ifdef(unofficial)
#if(unofficial = "patch")
#if(patch("upov-reflection-roughness") > 0)
roughness 0.1
#end
#end
#end
}
</source>
It enables you to export a file for UberPOV while still rendering it with standard POV, but this solution makes files slightly heavier and longer to parse, so it might change in the future: cleaning up exported pov when the features get available in all versions.

=== Going Further: Video Tutorial ===
Here is a demonstration of the exporter by SMcA. This video is currently being worked on and may get replaced in the future.
{| width=100%
<youtube>PD4PmGLMyys</youtube>
|right
|}

==Exported Properties Documentation==
=== Render Properties ===

-'''Radiosity''' in POV-Ray is diffuse inter-reflection which has nothing to do with vertex color based radiosity.

-'''Anti-aliasing''': two sampling methods are supported: recursive and non-recursive, sampling depth, Anti-alias threshold. ([http://wiki.povray.org/content/Documentation:Reference_Section_1.3#Anti-Aliasing_Options POV-Ray Wiki: Anti-Aliasing Options])
{{NiceTip|Depth of Field Without Anti-Aliasing |Using no anti aliasing when camera Depth of field is on will speed up rendering and often provide decent enough images.}}<br />
<br />

-'''Bounding method''' switched to automatic BSP by the exporter as it's generally the most efficient(POV-Ray 3.7 only) but other acceleration methods are available in POV-Ray.

-'''Command line switches''' allow some command line arguments to be passed to POV-Ray. Arguments are separated by spaces. Command line switches consist of a / (Slash), + (plus) or - (minus) sign, followed by one or more alphabetic characters and possibly a numeric value. ([http://wiki.povray.org/content/Documentation:Reference_Section_1#Command-line_Options POV-Ray Wiki: Command line options])
<br />

{| {{Css/prettytable}}
|+ ''Some Commonly Used Commands''
|-
|'''-D'''||'''Hide image while rendering'''<br />
Use the command line switch '''-D''' to not show the rendered image in POV-Ray (slightly faster and lighter on memory). The image will be sent back to Blender after completion (on Linux this is a hidden default switch to avoid OS specific editor problems).}}<br />
|-
|'''+WT'''||'''Limit the number of threads used'''<br />
'''+WT1''' limits POV-Ray to using only one single render thread. (Likewise, +WT2 would instruct POV-Ray to use two render threads.)<br />
|-
|'''+C'''||'''Continue an interrupted render'''<br />
'''+C''' for "Continue trace" is able to recover the point at which your last render stopped and continue it from there (even if you switched off your computer)<br />
|-
|'''/EXIT'''||'''Close POV-Ray after rendering the image'''<br />
There is also an option in POV-Ray for windows interface to do the same:

The "On Completion" option to "Exit POV-Ray for Windows" (in the '''Render Menu''').
<br />
|}
<br />

{{NiceTip|Fast Preview Renders |When first setting up your scene, and for fast preview rendering, turn off anti aliasing, depth of field, photons, Radiosity, expensive material features, and in the scene Shading panel, turn off shadows. (other features might get turned off from this panel in future versions of the exporter)
Alternatively, use the [http://wiki.povray.org/content/Documentation:Reference_Section_1.3#Quality_Settings "quality" command line switches] +q1 to +q11. These allow you to easily disable most of the CPU-intensive features.}}<br />
<br />

-'''Formatting''' of the exported POV-Ray file: Different indentation characters to choose from. Option to add comments to POV-Ray file. Option to write long lists of coordinates in one line for easier browsing of the POV file (and slightly faster parsing by the renderer)

=== Scene Properties ===

=== World Properties ===
-'''Background''' gets exported (sky texture appears a little different because of convoluted workaround used).

{| style="width:100%" border="0"
|[[File:PovStair.png|right|480px|]]
'''Atmospheric Media''' (to create volume lights):<br />
-Number of samples for media calculation<br />
-Atmospheric media color<br />
|}
<br />

=== Object Properties ===

'''Importance sampling''' can be set for Radiosity to shoot more rays at object that require them most.

=== Data Properties ===
-Exports Sky, Lights, Hair particles, Smoke, fluids, Meshes, Blobs (MetaBalls). (Limitation for Blobs: MetaBalls with same naming are not combined the same as in Blender. ''MBall, MBall.001 ...'')

'''Camera'''

-Depth of field Based on Blender UI distance field, not object field. With fixed blur amount for now.

'''Lamp'''

-No Shadows toggle button can be used to deactivate tracing of shadows for specific lamps only

{{NiceTip|For Realistic Light Attenuation|Use Inverse square falloff, and a small falloff distance value with a higher light intensity will give the best results with Povray's implementation of inverse square law. See [http://news.povray.org/povray.general/thread/%3Cweb.4d77b443f36cbfe281c811d20%40news.povray.org%3E/ this discussion]
}}<br />

{| style="width:100%" border="0"
|[[File:BlenderToPovraySmoke.gif|right|480px|]]
'''Smoke'''<br />
- A DF3 file (POV-Ray voxel format) is exported and used with a POV-Ray media container with the same dimension and resolution as Blender smoke Domain
|}
<br />

=== Material Properties ===

-'''Emission''' (new in POV-Ray 3.7)
{{NiceTip|Mesh Lights |When used together with Radiosity, Emit property will allow you to create light bulbs or any luminous form that really illuminates other objects.}}<br />
<br />

-'''SSS''' Note that SSS in POV-Ray (called SSLT) is very sensitive and will give different results if the mesh normals are smooth shaded or flat.

-'''Translucency''' (new in POV-Ray 3.7)

-'''IOR Mirror''' option for using one consistent IOR for raytrace reflection and refraction and not breaking the law of conservation of energy between the two.

-'''Iridescence''' (Newton's thin film coating)

{| style="width:100%" border="0"
|[[File:Caustics.png|right|480px|]]
'''Caustics''':<br />
-Chromatic dispersion for refractive caustics<br />
-Fast fake caustics (somewhat like Blender Raytransp)<br />
-Refractive caustics using photons<br />
-Reflective caustics using photons (high IOR or no mirror IOR for easier effect.)<br />
|}
<br />

{{NiceTip|Faster Photons |To set up some caustics, try moving from the smallest photon depth value to a minimum at which you start to see the effect you are after. Check off the ''Receive Photons'' object property for any object that does not really need it. (A glass object casting caustics often doesn't need to receive any itself.) Then you can balance other parameters to tune photons distribution and smoothing (gathering). Don't set the global spacing too fine in scene settings, because then you can still make it finer on each object using its spacing multiplier. If your system has several threads, they can be used in the photons stage: one thread per light, so you can then complexify your scene lighting without overhead.}}<br />
<br />

{| style="width:100%" border="0"
|'''shaders''' emulation attempted from blender:<br />

-Specular and diffuse toon (no edges yet)<br />

-Phong and Cook Torrence (both the same)<br />

-Blinn (not perfectly matched)<br />

-WardIso<br />

-Fresnel and Minnaert, started but not finished yet<br />
|}
<br />
{{NiceTip|Glass Like Materials |When trying to achieve some glass like material, keep low diffuse value, dark or totally black to avoid dull surface and keep clear transparency.}}<br />
<br />

=== Texture Properties ===

-'''UV coordinates''': best with planar projection for now. (Silvio Falcinelli)

-'''Texture channels''': Alpha ; Diffuse ; Bump ; Specular ; Mirror (uses same channel as specular)
--(No other channel because of POV-Ray non uniform syntax for them)

-'''Custom gamma''' for image textures (read POV-Ray 3.7 doc before using since it generally needs not be used.) ([http://wiki.povray.org/content/Documentation:Tutorial_Section_3.3#Gamma_Handling POV-Ray Wiki: Gamma Handling])<br />
<br />

====Using Texture Image Sequences====
[http://koti.mbnet.fi/mmyllyma/image_sequence.html Link to the original Tutorial by Markku Myllymäki]

Note to the reader: this functionality works in Blender Internal, Cycles (see the end this document) and now it works with POV-Ray render (little change in POV-Ray exporter). For Blender itself it is old feature.

This document assumes that the reader is able to UV unwrap and texture a model and animate with keys.

Also, it is safest to set render engine to POV-RAY at the beginning. Otherwise some datablocks may vanish when you change renderer.

''Image sequences are changing textures. For example, if your 3D scene has a TV set, and you want to animate, what the TV shows, you could use image sequence. There are many uses. Here, we will be using it for facial animation.''

For facial animation, we want to be able to change texture (i.e. facial expression) with a key, so when something happens to a character, the expression changes as a reaction.

======What you need at the beginning======

You need UV mapped model:

[[File:uvmapped.png]]

You need a sequence of images:

[[File:allfacetex.png]]

These are separate images, here together only for illustration.

IMPORTANT NOTE: There is a limitation to how you can name the sequence files. For the exporter to work correctly, use this kind of naming:

filename.001.png filename.002.png ... etc.

For example, I used facetex.001.png etc. here in this example.

The dot, three number sequence and another dot. It is mandatory. The exporter fails otherwise. This also applies to some other image sequences in Blender, and the naming convention is from Blender docs.

Defining the image sequence

You can define the material normally. Also, the texture is defined as normal UV mapped texture:

[[File:uvcoords.png]]

But when you define image name, select first (filename.001.png) image in sequence and change Single Image to Image Sequence:

[[File:sequence.png]]

Now you have image sequence defined!
Using the image sequence in animation

In an animation, you need to be able to to make keys for texture changes. It is useful to set viewport shading to GLSL and put textured mode on, so you can see what happens without rendering the animation.

You can make keys this way:

[[File:i_key.png]]

Set "Frames:" to 1. Set "Start:" to 1. Now you can with "Offset:" change the texture in sequence. You can set keys to animation by hovering over "Offset:" and pressing I-key.

Remember to set key Interpolation Mode to Constant:

[[File:constant.png]]

That's because Blender's default is Bezier. It would change the value of the "Offset:" fractionally and that is not usually a good idea, because usually you want certain texture to show until you define a different one... Constant Interpolation Mode is good for textures.

Now, when you render your animation using POV-Ray, texture changes should work!

Example, frames 1, 5 and 10:

[[File:frame0001.png|250px]]
[[File:frame0005.png|250px]]
[[File:frame0010.png|250px]]

Sidenote: Cycles usage

For those who wonder how Cycles does this (you need to begin from scratch, because Cycles has different datablocks than BI or POV-Ray).

Set renderer to Cycles Render:

[[File:cycles.png]]

This is the material node setting for Cycles. As you can see, you can define image sequence there too!

[[File:cycles_nodes.png]]

=== Custom POV Code ===
POV-Ray files are not just pure data files (unlike with most other renderers).
They are programs, with loops, functions, etc.
This means that no matter how many features this exporter could support, POV-Ray will always have much more under the hood.

You can add custom POV code directly in Blender's text editor, all you have to do is to make sure this pov code has directly or indirectly a #declare keyword, followed by the name of your choice and the pov item you want to use. (Current POV syntax is closer to C than Python, so anything that follows two slash character ( // ) is a comment)

-'''Adding items directly'''
Pov items can be anything but for now only the equivalent of Blender materials can be replaced with this method. In Povray, it is called '''texture {}''' don't get confused, it really includes all the material properties.

Though you can directly specify a texture {} block in POV-Ray files, the #declare directive allows to assign it to a variable and reuse it more easily. The exporter makes use of this feature by default, so you won't be able to use your custom texture, unless you declare it. Here is an example:

<source lang="c">
#declare MyTexture =
texture{
pigment{
brick color rgb< 0.99, 0.99, 0.99> // color mortar
color rgb< 0.75, 0.5, 0.30>0.75 // color brick
brick_size <0.25, 0.0525, 0.125> // format in x ,y and z- direction
mortar 0.01 // size of the mortar
scale 3
} // end of pigment
normal {wrinkles 0.75 scale 0.01}
finish {ambient 0.15 diffuse 0.95 phong 0.2}
rotate<0,0,0> translate< 0.01, 0.00, 0.00>
} // end of texture
</source>

{| width=100%
| valign=top | '''1.''' Navigate the text window menu to display the text properties {{Menu|View|Properties}}
| [[File:Pov_ReplaceWith01.png|thumb|300px|1]]
|-
| valign=top | '''2.''' check Custom POV Code option.
| [[File:Pov_ReplaceWith02.png|thumb|300px|2]]
|-
| valign=top | '''3.''' Then you have to go into the material properties to the {{Button|Custom POV Code}} field, and just type in the name of your declared item to use: MyTexture in the example Given. Then you can render your image normally and the material will be replaced.
| [[File:Pov_ReplaceWith03.png|thumb|300px|3]]
|}

<br />

-'''Adding items indirectly from include files'''
In any Povray scene you can use the #include directive to add items from an external Povray file. It's like the import function in Python. The files to be included have .inc as their name extension. Then in the replacement field, you can type in any of the declared names available in the include file. "Out of the box", Povray ships with a lot of include files.
So you can use them for your textures, but you can also use them for some of their elements. For instance a very often used include file is one that allows to call colors by their names instead of numbers called colors.inc, so the previous example could also be written:

<source lang="c">
#include "colors.inc"
#declare MyTexture =
texture{
pigment{
brick color White0.99 // color mortar
color rgb< 0.75, 0.5, 0.30>0.75 // color brick
brick_size <0.25, 0.0525, 0.125> // format in x ,y and z- direction
mortar 0.01 // size of the mortar
scale 3
} // end of pigment
normal {wrinkles 0.75 scale 0.01}
finish {ambient 0.15 diffuse 0.95 phong 0.2}
rotate<0,0,0> translate< 0.01, 0.00, 0.00>
} // end of texture
</source>

Following this method, more custom objects are planned for future versions of the exporter: In POV-Ray a triangle mesh is just one primitive among many.

Until then You can explore the POV-Ray language by modifying the output file.

====Combining Blender And POV-Ray Animations====
[http://koti.mbnet.fi/mmyllyma/combine_blender_pov.html link to original tutorial]

''While Blender is one of the best modelers in existence, it is primarily a polygon modeler. There are some cases when you want to use something like POV-Ray's CSG features, which are very good at pure, mathematical forms. But compositing POV-Ray and Blender output is hard work. However, there is a way to combine animations to one render with Blender's POV-Ray Exporter!''

Let's make an (very simple) example case: Spaceship flying out of hangar. We wanted to make a dilating door animation in POV-Ray, spaceship animation in Blender and combine them.

=====Preliminary hacking=====

<source lang="python">
def exportCustomCode():
# Write CurrentAnimation Frame for use in Custom POV Code
file.write("#declare CURFRAMENUM = %d;\n" % bpy.context.scene.frame_current)
#Change path and uncomment to add an animated include file by hand:
file.write("#include \"/home/quantum/povray_animation/animation_include_file.inc\"\n")
</source>
The exporter doesn't include an interface to this functionality yet but it's quite usable already.
The folowing lines are from Blender's POV-Ray Exporters file, render.py. The only change you need to do is to write the file path for your own .inc file (which can be named as you want) and check that those two file.write statements are not commented out (i.e. no '#' in the beginning...).

This example uses Linux, so file path is Unix-style, in MS Windows paths are written differently...
======Blender animation======
[[File:blpovfram001.png|500px]]
[[File:blpovfram100.png|500px]]

We defined 100 frame animation in Blender. Basically just move (linearly) the spaceship.

Of course the world paramaters, lighting and objects materials/textures need to be what POV-Ray needs. Here, they are very basic. No image textures, one light, little ambient light.

======POV-Ray animation======

<source lang="c">
#include "colors.inc"

#declare doorpart = difference {
cylinder { <0, 0, -0.1>, <0, 0, 0.1>, 3 }
box { <-10, -10, -10>, <0, 10, 10> rotate <0, 0, (-3CURFRAMENUM+3)> }
box { <-10, -10, -10>, <10, 0, 10> }
}

#declare wall = difference {
box { <-100, -100, -0.2>, <100, 100, 0.2> }
cylinder { <0, 0, -1>, <0, 0, 1>, 2.9 }
}

object {
wall
pigment { Green }
}

#if (CURFRAMENUM<30)
object {
doorpart
rotate <0, 0, 0>
translate <0, 0, 0>
pigment { Green }
}

object {
doorpart
rotate <0, 0, 90>
translate <0, 0, 0>
pigment { Green }
}

object {
doorpart
rotate <0, 0, 180>
translate <0, 0, 0>
pigment { Green }
}

object {
doorpart
rotate <0, 0, 270>
translate <0, 0, 0>
pigment { Green }
}
#end
</source>

We wrote the POV-Ray animation code. This is the ''animation_include_file.inc'' which was included in Python code. Note, that CURFRAMENUM is used. It is the animations current frame number in Blender! This way we can know what should happen and when in POV-Ray code.
Here is the resulting animation:
[[File:CompoAnimPreview.png|center|480px|Click image to see the video.|link=http://wiki.blender.org/uploads/5/52/Povtut2.mp4]]

=== Speed Tests ===

Comparison Blender <-> POV-Ray:
{| style="width:100%" border="0"
|[[File:RenderBranch.jpg|left|thumb|300px|]]
Setup:<br />
i7 720M, 10GB RAM<br />
Blender Internal 64bit: 57 seconds 99<br />
|}

{| style="width:100%" border="0"
|[[File:POV37.jpg|left|thumb|300px|]]
Same setup, <br />
POV-Ray 3.7 beta 38, 64bit ; 35 radiosity (GI) samples: 49 seconds 97<br />
POV-Ray 3.7 RC 7, 64bit ; 35 radiosity (GI) samples: 22 seconds 70<br />
|}
<br />

=== Limitations ===

{{Warning/Important}}'''This version is POV-Ray 3.7 only, it won't work with POV-Ray 3.6'''

-Requires '''Blender''' version '''2.7''' revision or later.

-On every rendering POV-Ray will save an image in the TEMP directory, which couldn't be deleted by the script (tested only on Win7. Same behavior on other OS?).<br />
<br />

=== May Do List ===
See [[Dev:2.5/Py/Scripts/Render/POV-Ray]]
<br />

=Standard Script Information=
{{ScriptInfo
|name= render_povray
|tooltip= Renders scenes with POV-Ray 3.7
|menu= Renderer rolldown menu
|usage= If POV-Ray 3.7 is installed, activate the addon in the menu {{Menu|File|User Preferences}}. Choose it as the renderer and render with {{Shortcut|F12}}.
|version= 0.0.8
|author= Campbell Barton, Silvio Falcinelli, Maurice Raybaud, Constantin Rahn
|blender= 2.57
|category= Render
|license= GPL
|distribution= Release
|note= After May the 10th 2011, some development to the script limited backwards compatibility: If you set up some files prior to that and always use the latest exporter from SVN. It is advised to run the update script and resave your scene with the new version: get to the search bar with {{Shortcut|Space}} and type pov to access this command.
|exe= (Python script)+ POV-Ray 3.7
|download= http://developer.blender.org/diffusion/BA/browse/master/render_povray/
|modules= Used standard Python modules
|deps= POV-Ray 3.7 current beta
|data=
|bugtracker= https://projects.blender.org/tracker/index.php?func=detail&aid=23145
|warning= Both POV-Ray 3.7 and this script are beta.
|link=http://povray.org/
|releaselog= [[Dev:2.5/Py/Scripts/Render/POV-Ray]]
|issues= Currently Important:

}}