griefith/test2
1
0
Fork 0
Code Issues Pull Requests Actions 1 Packages Projects Releases Wiki Activity

- Documentation for the new python API

Browse Source
This commit is contained in:
Joseph Gilbert
2004-05-02 14:29:31 +00:00
parent e7df984c16
commit 5a4e574b81
7 changed files with 1289 additions and 1042 deletions
Download Patch File Download Diff File Expand all files Collapse all files

172
source/blender/python/api2_2x/doc/Armature.py
View File

@@ -78,169 +78,17 @@ class Armature:
if will not be parented. You should set the parent of the bone
before adding to the armature.
"""
class Bone:
"""
The Bone object
===============
This object gives access to Bone-specific data in Blender.
@cvar name: The name of this Bone.
@cvar roll: This Bone's roll value.
@cvar head: This Bone's "head" ending position when in rest state.
@cvar tail: This Bone's "tail" ending position when in rest state.
@cvar loc: This Bone's location.
@cvar size: This Bone's size.
@cvar quat: This Bone's quaternion.
@cvar parent: The parent Bone.
@cvar children: The children bones.
@cvar weight: The bone's weight.
"""
def getName():
def drawAxes(bool):
"""
Get the name of this Bone.
@rtype: string
Set whether or not to draw the armature's axes per bone.
@type bool: boolean (true or false)
@param bool: specifies whether or not to draw axes
"""
def getRoll():
def drawNames(bool):
"""
Get the roll value.
@rtype: float
@warn: Roll values are local to parent's objectspace when
bones are parented.
"""
def getHead():
"""
Get the "head" ending position.
@rtype: list of three floats
"""
def getTail():
"""
Get the "tail" ending position.
@rtype: list of three floats
"""
def getLoc():
"""
Get the location of this Bone.
@rtype: list of three floats
"""
def getSize():
"""
Get the size attribute.
@rtype: list of three floats
"""
def getQuat():
"""
Get this Bone's quaternion.
@rtype: Quaternion object.
"""
def hasParent():
"""
True if this Bone has a parent Bone.
@rtype: true or false
"""
def getParent():
"""
Get this Bone's parent Bone, if available.
@rtype: Blender Bone
"""
def getWeight():
"""
Get the bone's weight.
@rtype: float
"""
def getChildren():
"""
Get this Bone's children Bones, if available.
@rtype: list of Blender Bones
"""
def setName(name):
"""
Rename this Bone.
@type name: string
@param name: The new name.
"""
def setRoll(roll):
"""
Set the roll value.
@type roll: float
@param roll: The new value.
@warn: Roll values are local to parent's objectspace when
bones are parented.
"""
def setHead(x,y,z):
"""
Set the "head" ending position.
@type x: float
@type y: float
@type z: float
@param x: The new x value.
@param y: The new y value.
@param z: The new z value.
"""
def setTail(x,y,z):
"""
Set the "tail" ending position.
@type x: float
@type y: float
@type z: float
@param x: The new x value.
@param y: The new y value.
@param z: The new z value.
"""
def setLoc(x,y,z):
"""
Set the new location for this Bone.
@type x: float
@type y: float
@type z: float
@param x: The new x value.
@param y: The new y value.
@param z: The new z value.
"""
def setSize(x,y,z):
"""
Set the new size for this Bone.
@type x: float
@type y: float
@type z: float
@param x: The new x value.
@param y: The new y value.
@param z: The new z value.
"""
def setQuat(quat):
"""
Set the new quaternion for this Bone.
@type quat: Quaternion object or PyList of floats
@param quat: Can be a Quaternion or PyList of 4 floats.
"""
def setParent(bone):
"""
Set the bones's parent in the armature.
@type bone: PyBone
@param bone: The Python bone that is the parent to this bone.
"""
def setWeight(weight):
"""
Set the bones's weight.
@type weight: float
@param weight: set the the bone's weight.
Set whether or not to draw the armature's names per bone.
@type bool: boolean (true or false)
@param bool: specifies whether or not to draw names
"""

3
source/blender/python/api2_2x/doc/Blender.py
View File

@@ -20,6 +20,8 @@ The Blender Python API Reference
-----------
- L{Armature}
- L{Bone}
- L{NLA} (new)
- L{BGL}
- L{Camera}
- L{Curve}
@@ -38,6 +40,7 @@ The Blender Python API Reference
- L{Object}
- L{Registry}
- L{Scene}
- L{Render} (new)
- L{Text}
- L{Texture}
- L{Types}

261
source/blender/python/api2_2x/doc/Bone.py Normal file
View File

@@ -0,0 +1,261 @@
# Blender.Armature.Bone module and the Bone PyType object
"""
The Blender.Armature.Bone submodule.
Bone
====
This module provides access to B{Bone} objects in Blender. Bones are used to
create armatures.
Example::
import Blender
from Blender import *
from Blender.Armature import *
from Blender.Armature.Bone import *
armObj = Object.New('Armature', "Armature_obj")
armData = Armature.New()
bn1=Blender.Armature.Bone.New("bone1")
bn1.setHead(0.0,0.0,0.0)
bn1.setTail(2.0,1.0,0.0)
bn2=Blender.Armature.Bone.New("bone2")
bn2.setHead(3.0,2.0,1.0)
bn2.setTail(4.0,4.0,1.0)
bn2.setRoll(.5)
bn2.setParent(bn1)
bn3=Blender.Armature.Bone.New("bone3")
bn3.setHead(5.0,6.0,2.0)
bn3.setTail(5.0,8.0,2.0)
bn3.setParent(bn2)
armData.addBone(bn1)
armData.addBone(bn2)
armData.addBone(bn3)
armData.drawAxes(1)
armObj.link(armData)
scn = Blender.Scene.getCurrent()
scn.link(armObj)
armObj.makeDisplayList()
Blender.Window.RedrawAll()
bn2.setPose([ROT,LOC,SIZE])
@var PoseFlags: The available flags for setting keyframed poses.
- ROT - add bone's rotation to keyframe
- LOC - add bone's location to keyframe
- SIZE- add bone's size to keyframe
"""
class Bone:
"""
The Bone object
===============
This object gives access to Bone-specific data in Blender.
@cvar name: The name of this Bone.
@cvar roll: This Bone's roll value.
@cvar head: This Bone's "head" ending position when in rest state.
@cvar tail: This Bone's "tail" ending position when in rest state.
@cvar loc: This Bone's location.
@cvar size: This Bone's size.
@cvar quat: This Bone's quaternion.
@cvar parent: The parent Bone.
@cvar children: The children bones.
@cvar weight: The bone's weight.
"""
def getName():
"""
Get the name of this Bone.
@rtype: string
"""
def getRoll():
"""
Get the roll value.
@rtype: float
@warn: Roll values are local to parent's objectspace when
bones are parented.
"""
def getWeight():
"""
Get the bone's weight..
@rtype: float
"""
def getHead():
"""
Get the "head" ending position.
@rtype: list of three floats
"""
def getTail():
"""
Get the "tail" ending position.
@rtype: list of three floats
"""
def getLoc():
"""
Get the location of this Bone.
@rtype: list of three floats
"""
def getSize():
"""
Get the size attribute.
@rtype: list of three floats
"""
def getQuat():
"""
Get this Bone's quaternion.
@rtype: Quaternion object.
"""
def hasParent():
"""
True if this Bone has a parent Bone.
@rtype: true or false
"""
def getParent():
"""
Get this Bone's parent Bone, if available.
@rtype: Blender Bone
"""
def getWeight():
"""
Get the bone's weight.
@rtype: float
"""
def getChildren():
"""
Get this Bone's children Bones, if available.
@rtype: list of Blender Bones
"""
def setName(name):
"""
Rename this Bone.
@type name: string
@param name: The new name.
"""
def setRoll(roll):
"""
Set the roll value.
@type roll: float
@param roll: The new value.
@warn: Roll values are local to parent's objectspace when
bones are parented.
"""
def setHead(x,y,z):
"""
Set the "head" ending position.
@type x: float
@type y: float
@type z: float
@param x: The new x value.
@param y: The new y value.
@param z: The new z value.
"""
def setTail(x,y,z):
"""
Set the "tail" ending position.
@type x: float
@type y: float
@type z: float
@param x: The new x value.
@param y: The new y value.
@param z: The new z value.
"""
def setLoc(x,y,z):
"""
Set the new location for this Bone.
@type x: float
@type y: float
@type z: float
@param x: The new x value.
@param y: The new y value.
@param z: The new z value.
"""
def setSize(x,y,z):
"""
Set the new size for this Bone.
@type x: float
@type y: float
@type z: float
@param x: The new x value.
@param y: The new y value.
@param z: The new z value.
"""
def setQuat(quat):
"""
Set the new quaternion for this Bone.
@type quat: Quaternion object or PyList of floats
@param quat: Can be a Quaternion or PyList of 4 floats.
"""
def setParent(bone):
"""
Set the bones's parent in the armature.
@type bone: PyBone
@param bone: The Python bone that is the parent to this bone.
"""
def setWeight(weight):
"""
Set the bones's weight.
@type weight: float
@param weight: set the the bone's weight.
"""
def hide():
"""
Hides this bone.
"""
def unhide():
"""
Unhide this bone.
"""
def clearParent():
"""
Attempts to clear the parenting of this bone. Because the bone is no longer parented
it will be set in the armature as a root bone.
"""
def clearChildren():
"""
Attemps to remove all the children of this bone. Because each of the children no longer are
parented they will be set a root bones in the armature.
"""
def setPose(flags, Action):
"""
Set the pose for this bone. The pose will be set at the Scene's current frame.
If an action is passed as the optional second parameter the pose will be added as a keyframe
to that action. Otherwise a default action will be created an the pose set to it.
@type flags: PyList of enums
@param flags: expects ROT, LOC, SIZE in a list. Whichever of these is passed the keyframe generated
will set information about the rotation, and/or location, and/or size of the bone.
@type Action: PyAction
@param Action: a python action that has either been created or returned from an object
"""

132
source/blender/python/api2_2x/doc/NLA.py Normal file
View File

@@ -0,0 +1,132 @@
# Blender.Armature.NLA module and the Action PyType object
"""
The Blender.Armature.NLA submodule.
NLA
===
This module provides access to B{Action} objects in Blender. Actions are a series of keyframes/Ipo curves
that define the movement of a bone. Actions are linked to objects of type armature.
Example::
import Blender
from Blender import *
from Blender.Armature import *
from Blender.Armature.Bone import *
armObj = Object.New('Armature', "Armature_obj")
armData = Armature.New()
bn1=Blender.Armature.Bone.New("bone1")
bn1.setHead(0.0,0.0,0.0)
bn1.setTail(2.0,1.0,0.0)
bn2=Blender.Armature.Bone.New("bone2")
bn2.setHead(3.0,2.0,1.0)
bn2.setTail(4.0,4.0,1.0)
bn2.setRoll(.5)
bn2.setParent(bn1)
armData.addBone(bn1)
armData.addBone(bn2)
armObj.link(armData)
scn = Blender.Scene.getCurrent()
scn.link(armObj)
armObj.makeDisplayList()
Blender.Window.RedrawAll()
action = Blender.Armature.NLA.NewAction()
action.setActive(armObj)
bn2.setPose([ROT,LOC,SIZE])
context = scn.getRenderingContext()
context.currentFrame(2)
quat = Blender.Mathutils.Quaternion([1,2,3,4])
bn2.setQuat(quat)
bn2.setLoc([3,4,5])
bn2.setPose([ROT,LOC,SIZE])
print action.name
action2 = Blender.Armature.NLA.CopyAction(action)
action2.name = "Copy"
"""
def NewAction (name = 'DefaultAction'):
"""
Create a new Action object.
@type name: string
@param name: The Action name.
@rtype: PyAction
"""
def CopyAction (action):
"""
Copy an action and it's keyframes
@type action: PyAction
@param action: The action to be copied.
@rtype: PyAction
@return: A copied action
"""
def GetActions ():
"""
Get all actions and return them as a list.
@rtype: PyList of PyActions
@return: All the actions in blender
"""
class Action:
"""
The Action object
=================
This object gives access to Action-specific data in Blender.
"""
def getName():
"""
Get the name of this Action.
@rtype: string
"""
def setName(name):
"""
Set the name of this Action.
@type name: string
@param name: The new name
"""
def setActive(object):
"""
Set this action as the current action for an object.
@type object: PyObject
@param object: The object whose action is to be set
"""
def getChannelIpo(channel):
"""
Get the Ipo for the named channel in this action
@type channel: string
@param channel: The name of a channel in this action
@rtype: PyIpo
@return: the Ipo for the channel
"""
def removeChannel(channel):
"""
Remove a named channel from this action
@type channel: string
@param channel: The name of a channel in this action to be removed
"""
def getAllChannelIpo():
"""
Get the all the Ipos for this action
@rtype: PyList of PyIpos
@return: the Ipos for all the channels in the action
"""

36
source/blender/python/api2_2x/doc/Object.py
View File

@@ -214,15 +214,15 @@ class Object:
def getEuler():
"""
Returns the object's rotation as Euler rotation vector (rotX, rotY, rotZ). Angles are in radians.
@rtype: A vector triple of floats
@return: (rotX, rotY, rotZ)
@rtype: Py_Euler
@return: A python euler
"""
def getInverseMatrix():
"""
Returns the object's inverse matrix.
@rtype: Blender Matrix object
@return: the inverse of the matrix of the Object
@rtype: Py_Matrix
@return: A python matrix 4x4
"""
def getIpo():
@@ -250,6 +250,13 @@ class Object:
print obj.getLocation()
"""
def getAction():
"""
Returns an action if one is associated with this object (only useful for armature types).
@rtype: Py_Action
@return: a python action.
"""
def getMaterials():
"""
Returns a list of materials assigned to the object.
@@ -260,8 +267,8 @@ class Object:
def getMatrix():
"""
Returns the object matrix.
@rtype: Blender Matrix object.
@return: the matrix of the Object.
@rtype: Py_Matrix
@return: a python matrix 4x4
"""
def getName():
@@ -391,15 +398,11 @@ class Object:
- 5 - Textured
"""
def setEuler(x, y, z):
def setEuler(euler):
"""
Sets the object's rotation according to the specified Euler angles.
@type x: float
@param x: The rotation angle in radians for the X direction.
@type y: float
@param y: The rotation angle in radians for the Y direction.
@type z: float
@param z: The rotation angle in radians for the Z direction.
@type euler: Py_Euler or a list of floats
@param euler: a python euler or x,y,z rotations as floats
"""
def setIpo(ipo):
@@ -427,6 +430,13 @@ class Object:
@param materials: A list of Blender material objects.
"""
def setMatrix(matrix):
"""
Sets the object's matrix and updates it's tranformation.
@type matrix: Py_Matrix 4x4
@param matrix: a python matrix 4x4.
"""
def setName(name):
"""
Sets the name of the object.

854
source/blender/python/api2_2x/doc/Render.py Normal file
View File

@@ -0,0 +1,854 @@
# Blender.Scene.Render module and the RenderData PyType object
"""
The Blender.Scene.Render submodule.
Scene
=====
This module provides access to B{Scene Rendering Contexts} in Blender.
Example::
import Blender
from Blender import Scene
from Blender import Scene.Render
scn = Scene.GetCurrent()
context = scn.getRenderingContext()
Render..enableDispWin()
context.enableExtensions(1)
context.setRenderPath("C:/myRenderdir/")
context.sizePreset(Scene.PC)
context.setImageType(Render.AVIRAW)
context.startFrame(2)
context.endFrame(10)
context.renderAnim()
context.setImageType(Render.TARGA)
context.framesPerSec(15)
context.startFrame(15)
context.endFrame(22)
context.renderAnim()
Render.CloseRenderWindow()
print context.framesPerSec()
print context.currentFrame()
"""
def CloseRenderWindow():
"""
Closes the rendering window.
"""
def EnableDispView():
"""
Render in the 3d View area.
"""
def EnableDispWin():
"""
Render in Render window.
"""
def SetRenderWinPos(locationList):
"""
Set the position of the Render window on the screen.
Possible values are:
- S = south
- N = north
- W = west
- E = east
- C = center
- ne = northeast
- nw = northwest
- se = southeast
- sw = southwest
@type locationList: PyList of strings
@param locationList: a list of strings that together define
the location of the Render window on the screen.
"""
def EnableEdgeShift():
"""
Globally with the unified renderer enabled the outlines of the render
are shifted a bit.
"""
def EnableEdgeAll():
"""
Globally consider transparent faces for edge-rendering with the unified renderer.
"""
class RenderData:
"""
The RenderData object
=====================
This object gives access to Scene rendering contexts in Blender.
"""
def getRenderdir():
"""
@warn: B{Depricated}: use RenderData.getRenderPath()
"""
def getBackbufdir():
"""
@warn: B{Depricated}: use RenderData.getBackbufPath()
"""
def getChildren():
"""
Get all objects linked to this Scene.
@rtype: list of Blender Objects
@return: A list with all Blender Objects linked to this Scene.
"""
def getCurrentCamera():
"""
Get the currently active Camera for this Scene.
@rtype: Blender Camera
@return: The currently active Camera.
"""
def setCurrentCamera(camera):
"""
Set the currently active Camera in this Scene.
@type camera: Blender Camera
@param camera: The new active Camera.
"""
def render():
"""
Render the scene.
"""
def renderAnim():
"""
Render a series of frames to an output directory.
"""
def play():
"""
play animation of rendered images/avi (searches Pics: field).
"""
def setRenderPath(path):
"""
Set the path to where the renderer will write to.
@type path: string
@param path: A directory for that the renderer searches for
both playback and output from the renderAnim function.
"""
def getRenderPath():
"""
Get the path to where the renderer will write to.
@rtype: string
@return: Returns the directory that is used to playback and store rendered
sequences.
"""
def setBackbufPath(path):
"""
Set the path to a background image and load it.
@type path: string
@param path: The path to a background image for loading.
"""
def getBackbufPath():
"""
Get the path to the background image.
@rtype: string
@return: The path to a background image.
"""
def enableBackbuf(toggle):
"""
Enable/disable the backbuf image.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def setFtypePath(path):
"""
Set the path to Ftype file.
@type path: string
@param path: Path to Ftype Image type.
"""
def getFtypePath():
"""
Get the path to the Ftype file
@rtype: string
@return: Path to FtypeImage type.
"""
def enableExtensions(toggle):
"""
Enable/disable windows extensions for output files.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableSequencer(toggle):
"""
Enable/disable Do Sequence.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableRenderDaemon(toggle):
"""
Enable/disable Scene daemon.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableToonShading(toggle):
"""
Enable/disable Edge rendering.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def edgeIntensity(intensity = None):
"""
Get/set edge intensity for toon shading.
@type intensity: int (optional)
@param intensity: must be between 0 - 255
@rtype: int (if prototype is empty)
@return: Current edge intensity for the scene.
"""
def setEdgeColor(red, green, blue):
"""
Set the edge color for toon shading.
@type red: float
@param red: must be between 0 - 1.0
@type green: float
@param green: must be between 0 - 1.0
@type blue: float
@param blue: must be between 0 - 1.0
"""
def getEdgeColor():
"""
Get the edge color for toon shading.
@rtype: string
@return: A string representing the edge color.
"""
def edgeAntiShift(intensity = None):
"""
With the unified renderer, reduce intensity on boundaries.
@type intensity: int (optional)
@param intensity: must be between 0 - 255
@rtype: int (if prototype is empty)
@return: Current edge antishift for the scene.
"""
def enableOversampling(toggle):
"""
Enable/disable oversampling (anit-aliasing).
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def setOversamplingLevel(level):
"""
Set the edge color for toon shading.
@type level: int
@param level: can be either 5, 8, 11, or 16
"""
def enableMotionBlur(toggle):
"""
Enable/disable MBlur.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def motionBlurLevel(level = None):
"""
Get/set the length of shutter time for motion blur.
@type level: float (optional)
@param level: must be between 0.01 - 5.0
@rtype: float (if prototype is empty)
@return: Current MBlur for the scene.
"""
def partsX(parts = None):
"""
Get/set the number of parts to divide the render in the X direction.
@type parts: int (optional)
@param parts: must be between 1 - 64
@rtype: int (if prototype is empty)
@return: Current number of parts in the X for the scene.
"""
def partsY(parts = None):
"""
Get/set the number of parts to divide the render in the Y direction.
@type parts: int (optional)
@param parts: must be between 1 - 64
@rtype: int (if prototype is empty)
@return: Current number of parts in the Y for the scene.
"""
def enableSky():
"""
Enable render background with sky.
"""
def enablePremultiply():
"""
Enable premultiply alpha.
"""
def enableKey():
"""
Enable alpha and colour values remain unchanged.
"""
def enableShadow(toggle):
"""
Enable/disable shadow calculation.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableEnvironmentMap(toggle):
"""
Enable/disable environment map rendering.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableRayTracing(toggle):
"""
Enable/disable ray tracing.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableRadiosityRender(toggle):
"""
Enable/disable radiosity rendering.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enablePanorama(toggle):
"""
Enable/disable panorama rendering (output width is multiplied by Xparts).
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def setRenderWinSize(size):
"""
Set the size of the render window.
@type size: int
@param size: can be 25, 50, 75 or 100 (percent).
"""
def enableFieldRendering(toggle):
"""
Enable/disable field rendering
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableOddFieldFirst(toggle):
"""
Enable/disable Odd field first rendering (Default: Even field).
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableFieldTimeDisable(toggle):
"""
Enable/disable time difference in field calculations.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableGaussFilter(toggle):
"""
Enable/disable Gauss sampling filter for antialiasing.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableBorderRender(toggle):
"""
Enable/disable small cut-out rendering.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableGammaCorrection(toggle):
"""
Enable/disable gamma correction.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def gaussFilterSize(size = None):
"""
Get/sets the Gauss filter size.
@type size: float (optional)
@param size: must be between 0.5 - 1.5
@rtype: float (if prototype is empty)
@return: Current gauss filter size for the scene.
"""
def startFrame(frame = None):
"""
Get/set the starting frame for sequence rendering.
@type frame: int (optional)
@param frame: must be between 1 - 18000
@rtype: int (if prototype is empty)
@return: Current starting frame for the scene.
"""
def endFrame(frame = None):
"""
Get/set the ending frame for sequence rendering.
@type frame: int (optional)
@param frame: must be between 1 - 18000
@rtype: int (if prototype is empty)
@return: Current ending frame for the scene.
"""
def imageSizeX(size = None):
"""
Get/set the image width in pixels.
@type size: int (optional)
@param size: must be between 4 - 10000
@rtype: int (if prototype is empty)
@return: Current image width for the scene.
"""
def imageSizeY(size = None):
"""
Get/set the image height in pixels.
@type size: int (optional)
@param size: must be between 4 - 10000
@rtype: int (if prototype is empty)
@return: Current image height for the scene.
"""
def aspectRatioX(ratio = None):
"""
Get/set the horizontal aspect ratio.
@type ratio: int (optional)
@param ratio: must be between 1 - 200
@rtype: int (if prototype is empty)
@return: Current horizontal aspect ratio for the scene.
"""
def aspectRatioY(ratio = None):
"""
Get/set the vertical aspect ratio.
@type ratio: int (optional)
@param ratio: must be between 1 - 200
@rtype: int (if prototype is empty)
@return: Current vertical aspect ratio for the scene.
"""
def setRenderer(type):
"""
Get/set which renderer to render the output.
@type type: enum constant
@param type: must be one of 2 constants:
- INTERN: Blender's internal renderer
- YAFRAY: Yafray renderer
"""
def enableCropping(toggle):
"""
Enable/disable exclusion of border rendering from total image.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def setImageType(type):
"""
Set the type of image to output from the render.
@type type: enum constant
@param type: must be one of 13 constants:
- AVIRAW: Uncompressed AVI files. AVI is a commonly used format on Windows plattforms
- AVIJPEG: AVI movie w/ Jpeg images
- AVICODEC: AVI using win32 codec
- QUICKTIME: Quicktime movie (if enabled)
- TARGA: Targa files
- RAWTGA: Raw Targa files
- PNG: Png files
- BMP: Bitmap files
- JPEG90: Jpeg files
- HAMX: Hamx files
- IRIS: Iris files
- IRIZ: Iris + z-buffer files
- FTYPE: Ftype file
"""
def quality(qual = None):
"""
Get/set quality get/setting for JPEG images, AVI Jpeg and SGI movies.
@type qual: int (optional)
@param qual: must be between 10 - 100
@rtype: int (if prototype is empty)
@return: Current image quality for the scene.
"""
def framesPerSec(qual = None):
"""
Get/set frames per second.
@type qual: int (optional)
@param qual: must be between 1 - 120
@rtype: int (if prototype is empty)
@return: Current frames per second for the scene.
"""
def enableGrayscale():
"""
Images are saved with BW (grayscale) data.
"""
def enableRGBColor():
"""
Images are saved with RGB (color) data.
"""
def enableRGBAColor():
"""
Images are saved with RGB and Alpha data (if supported).
"""
def sizePreset(type):
"""
Set the renderer to one of a few presets.
@type type: enum constant
@param type: must be one of 8 constants:
- PAL: The European video standard: 720 x 576 pixels, 54 x 51 aspect.
- FULL: For large screens: 1280 x 1024 pixels.
- PREVIEW: For preview rendering: 320 x 256 pixels.
- PAL169: Wide-screen PAL.
- DEFAULT: Like "PAL", but here the render settings are also set.
- PANO: Panorama render.
- NTSC: For TV playback.
- PC: For standard PC graphics: 640 x 480 pixels.
"""
def enableUnifiedRenderer(toggle):
"""
Use the unified renderer.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def setYafrayGIQuality(type):
"""
Set yafray global Illumination quality.
@type type: enum constant
@param type: must be one of 6 constants:
- NONE
- LOW
- MEDIUM
- HIGH
- HIGHER
- BEST
"""
def setYafrayGIMethod(type):
"""
Set yafray global Illumination method.
@type type: enum constant
@param type: must be one of 3 constants:
- NONE: Dont use GI illumination
- SKYDOME: Use Skydome method
- GIFULL: Use Full method
"""
def yafrayGIPower(power = None):
"""
Get/set GI lighting intensity scale.
YafrayMethod must be either SKYDOME or GIFULL.
@type power: float (optional)
@param power: must be between 0.01 - 100.0
@rtype: float (if prototype is empty)
@return: Current yafray global illumination intensity for the scene.
"""
def yafrayGIDepth(depth = None):
"""
Get/set number of bounces of the indirect light.
YafrayMethod must be GIFULL.
@type depth: int (optional)
@param depth: must be between 1 - 8
@rtype: int (if prototype is empty)
@return: Current yafray global illumination light bounces for the scene.
"""
def yafrayGICDepth(depth = None):
"""
Get/set number of bounces inside objects (for caustics).
YafrayMethod must be GIFULL.
@type depth: int (optional)
@param depth: must be between 1 - 8
@rtype: int (if prototype is empty)
@return: Current yafray global illumination inside light bounces for the scene.
"""
def enableYafrayGICache(toggle):
"""
Enable/disable cache irradiance samples (faster).
YafrayMethod must be GIFULL.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableYafrayGIPhotons(toggle):
"""
Enable/disable use of global photons to help in GI.
YafrayMethod must be GIFULL.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def yafrayGIPhotonCount(count = None):
"""
Get/set number of photons to shoot.
YafrayMethod must be GIFULL and Photons enabled.
@type count: int (optional)
@param count: must be between 0 - 10000000
@rtype: int (if prototype is empty)
@return: Current number of photons to shoot for the scene.
"""
def yafrayGIPhotonRadius(radius = None):
"""
Get/set radius to search for photons to mix (blur).
YafrayMethod must be GIFULL and Photons enabled.
@type radius: float (optional)
@param radius: must be between 0.00001 - 100.0
@rtype: float (if prototype is empty)
@return: Current photon search radius for the scene.
"""
def yafrayGIPhotonMixCount(count = None):
"""
Get/set number of photons to keep inside radius.
YafrayMethod must be GIFULL and Photons enabled.
@type count: int (optional)
@param count: must be between 0 - 1000
@rtype: int (if prototype is empty)
@return: Current number of photons to keep inside radius for the scene.
"""
def enableYafrayGITunePhotons(toggle):
"""
Enable/disable show the photonmap directly in the render for tuning.
YafrayMethod must be GIFULL and Photons enabled.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def yafrayGIShadowQuality(qual = None):
"""
Get/set the shadow quality, keep it under 0.95.
YafrayMethod must be GIFULL and Cache enabled.
@type qual: float (optional)
@param qual: must be between 0.01 - 1.0
@rtype: float (if prototype is empty)
@return: Current shadow quality for the scene.
"""
def yafrayGIPixelsPerSample(pixels = None):
"""
Get/set maximum number of pixels without samples, the lower the better and slower.
YafrayMethod must be GIFULL and Cache enabled.
@type pixels: int (optional)
@param pixels: must be between 1 - 50
@rtype: int (if prototype is empty)
@return: Current number of pixels without samples for the scene.
"""
def enableYafrayGIGradient(toggle):
"""
Enable/disable try to smooth lighting using a gradient.
YafrayMethod must be GIFULL and Cache enabled.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def yafrayGIRefinement(refine = None):
"""
Get/set threshold to refine shadows EXPERIMENTAL. 1 = no refinement.
YafrayMethod must be GIFULL and Cache enabled.
@type refine: float (optional)
@param refine: must be between 0.001 - 1.0
@rtype: float (if prototype is empty)
@return: Current threshold to refine shadows for the scene.
"""
def yafrayRayBias(bias = None):
"""
Get/set shadow ray bias to avoid self shadowing.
@type bias: float (optional)
@param bias: must be between 0 - 10.0
@rtype: float (if prototype is empty)
@return: Current ray bias for the scene.
"""
def yafrayRayDepth(depth = None):
"""
Get/set maximum render ray depth from the camera.
@type depth: int (optional)
@param depth: must be between 1 - 80
@rtype: int (if prototype is empty)
@return: Current ray depth for the scene.
"""
def yafrayGamma(gamma = None):
"""
Get/set gamma correction, 1 is off.
@type gamma: float (optional)
@param gamma: must be between 0.001 - 5.0
@rtype: float (if prototype is empty)
@return: Current gamma correction for the scene.
"""
def yafrayExposure(expose = None):
"""
Get/set exposure adjustment, 0 is off.
@type expose: float (optional)
@param expose: must be between 0 - 10.0
@rtype: float (if prototype is empty)
@return: Current exposure adjustment for the scene.
"""
def yafrayProcessorCount(count = None):
"""
Get/set number of processors to use.
@type count: int (optional)
@param count: must be between 1 - 8
@rtype: int (if prototype is empty)
@return: Current number of processors for the scene.
"""
def enableGameFrameStretch():
"""
Enble stretch or squeeze the viewport to fill the display window.
"""
def enableGameFrameExpose():
"""
Enable show the entire viewport in the display window, viewing more
horizontally or vertically.
"""
def enableGameFrameBars():
"""
Enable show the entire viewport in the display window, using bar
horizontally or vertically.
"""
def setGameFrameColor(red, green, blue):
"""
Set the red, green, blue component of the bars.
@type red: float
@param red: must be between 0 - 1.0
@type green: float
@param green: must be between 0 - 1.0
@type blue: float
@param blue: must be between 0 - 1.0
"""
def getGameFrameColor():
"""
Set the red, green, blue component of the bars.
@rtype: string
@return: A string representing the color component of the bars.
"""
def gammaLevel(level = None):
"""
Get/set the gamma value for blending oversampled images (1.0 = no correction).
Unified renderer must be enabled.
@type level: float (optional)
@param level: must be between 0.2 - 5.0
@rtype: float (if prototype is empty)
@return: Current gamma value for the scene.
"""
def postProcessAdd(add = None):
"""
Get/set post processing add.
Unified renderer must be enabled.
@type add: float (optional)
@param add: must be between -1.0 - 1.0
@rtype: float (if prototype is empty)
@return: Current processing add value for the scene.
"""
def postProcessMultiply(mult = None):
"""
Get/set post processing multiply.
Unified renderer must be enabled.
@type mult: float (optional)
@param mult: must be between 0.01 - 4.0
@rtype: float (if prototype is empty)
@return: Current processing multiply value for the scene.
"""
def postProcessGamma(gamma = None):
"""
Get/set post processing gamma.
Unified renderer must be enabled.
@type gamma: float (optional)
@param gamma: must be between 0.2 - 2.0
@rtype: float (if prototype is empty)
@return: Current processing gamma value for the scene.
"""
def SGIMaxsize(size = None):
"""
Get/set maximum size per frame to save in an SGI movie.
SGI must be defined on your machine.
@type size: int (optional)
@param size: must be between 0 - 500
@rtype: int (if prototype is empty)
@return: Current SGI maximum size per frame for the scene.
"""
def enableSGICosmo(toggle):
"""
Enable/disable attempt to save SGI movies using Cosmo hardware
SGI must be defined on your machine.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def oldMapValue(value = None):
"""
Get/set specify old map value in frames.
@type value: int (optional)
@param value: must be between 1 - 900
@rtype: int (if prototype is empty)
@return: Current old map value for the scene.
"""
def newMapValue(value = None):
"""
Get/set specify new map value in frames.
@type value: int (optional)
@param value: must be between 1 - 900
@rtype: int (if prototype is empty)
@return: Current new map value for the scene.
"""

873
source/blender/python/api2_2x/doc/Scene.py
View File

@@ -21,25 +21,6 @@ Example::
scene.link(camobj) # and then link object to scene
scene.makeCurrent() # make this the current scene
Scene.enableDispWin()
scene.enableExtensions(1)
scene.setRenderPath("C:/myRenderdir/")
scene.sizePreset(Scene.PC)
scene.setImageType(Scene.AVIRAW)
scene.startFrame(2)
scene.endFrame(10)
scene.renderAnim()
scene.setImageType(Scene.TARGA)
scene.framesPerSec(15)
scene.startFrame(15)
scene.endFrame(22)
scene.renderAnim()
Scene.CloseRenderWindow()
print scene.framesPerSec()
@warn: as done in the example (*), it's recommended to first link object data to
objects and only after that link objects to scene. This is because if
there is no object data linked to an object ob, scene.link(ob) will
@@ -87,50 +68,6 @@ def Unlink(scene):
@param scene: The Scene to be unlinked.
"""
def CloseRenderWindow():
"""
Closes the rendering window.
"""
def EnableDispView():
"""
Render in the 3d View area.
"""
def EnableDispWin():
"""
Render in Render window.
"""
def SetRenderWinPos(locationList):
"""
Set the position of the Render window on the screen.
Possible values are:
- S = south
- N = north
- W = west
- E = east
- C = center
- ne = northeast
- nw = northwest
- se = southeast
- sw = southwest
@type locationList: PyList of strings
@param locationList: a list of strings that together define
the location of the Render window on the screen.
"""
def EnableEdgeShift():
"""
Globally with the unified renderer enabled the outlines of the render
are shifted a bit.
"""
def EnableEdgeAll():
"""
Globally consider transparent faces for edge-rendering with the unified renderer.
"""
class Scene:
"""
The Scene object
@@ -154,18 +91,12 @@ class Scene:
def getWinSize():
"""
Get the current x,y resolution of the render window. These are the
dimensions of the image created by the Blender Renderer.
@rtype: list of two ints
@return: [width, height].
@warn: B{Depricated}: use RenderData.imageSizeX() and RenderData.imageSizeY()
"""
def setWinSize(dimensions):
"""
Set the width and height of the render window. These are the dimensions
of the image created by the Blender Renderer.
@type dimensions: list of two ints
@param dimensions: The new [width, height] values.
@warn: B{Depricated}: use RenderData.imageSizeX() and RenderData.imageSizeY
"""
def copy(duplicate_objects = 1):
@@ -182,45 +113,22 @@ class Scene:
def startFrame(frame = None):
"""
Get (and optionally set) the start frame value.
@type frame: int
@param frame: The start frame. If None, this method simply returns the
current start frame.
@rtype: int
@return: The start frame value.
@warn: B{Depricated}: use RenderData.startFrame()
"""
def endFrame(frame = None):
"""
Get (and optionally set) the end frame value.
@type frame: int
@param frame: The end frame. If None, this method simply returns the
current end frame.
@rtype: int
@return: The end frame value.
@warn: B{Depricated}: use RenderData.endFrame()
"""
def currentFrame(frame = None):
"""
Get (and optionally set) the current frame value.
@type frame: int
@param frame: The current frame. If None, this method simply returns the
current frame value.
@rtype: int
@return: The current frame value.
@warn: B{Depricated}: use RenderData.currentFrame
"""
def frameSettings(start = None, end = None, current = None):
"""
Get (and optionally set) the start, end and current frame values.
@type start: int
@type end: int
@type current: int
@param start: The start frame value.
@param end: The end frame value.
@param current: The current frame value.
@rtype: tuple
@return: The frame values in a tuple: [start, end, current].
@warn: B{Depricated}: use RenderData.startFrame(), RenderData.endFrame, RenderData.currentFrame
"""
def makeCurrent():
@@ -252,772 +160,3 @@ class Scene:
@type object: Blender Object
@param object: A Blender Object.
"""
def getRenderdir():
"""
Get the current directory where rendered images are saved.
@rtype: string
@return: The path to the current render dir
"""
def getBackbufdir():
"""
Get the location of the backbuffer image.
@rtype: string
@return: The path to the chosen backbuffer image.
"""
def getChildren():
"""
Get all objects linked to this Scene.
@rtype: list of Blender Objects
@return: A list with all Blender Objects linked to this Scene.
"""
def getCurrentCamera():
"""
Get the currently active Camera for this Scene.
@rtype: Blender Camera
@return: The currently active Camera.
"""
def setCurrentCamera(camera):
"""
Set the currently active Camera in this Scene.
@type camera: Blender Camera
@param camera: The new active Camera.
"""
def render():
"""
Render the scene.
"""
def renderAnim():
"""
Render a series of frames to an output directory.
"""
def play():
"""
play animation of rendered images/avi (searches Pics: field).
"""
def setRenderPath(path):
"""
Set the path to where the renderer will write to.
@type path: string
@param path: A directory for that the renderer searches for
both playback and output from the renderAnim function.
"""
def getRenderPath():
"""
Get the path to where the renderer will write to.
@rtype: string
@return: Returns the directory that is used to playback and store rendered
sequences.
"""
def setBackbufPath(path):
"""
Set the path to a background image and load it.
@type path: string
@param path: The path to a background image for loading.
"""
def getBackbufPath():
"""
Get the path to the background image.
@rtype: string
@return: The path to a background image.
"""
def enableBackbuf(toggle):
"""
Enable/disable the backbuf image.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def setFtypePath(path):
"""
Set the path to Ftype file.
@type path: string
@param path: Path to Ftype Image type.
"""
def getFtypePath():
"""
Get the path to the Ftype file
@rtype: string
@return: Path to FtypeImage type.
"""
def enableExtensions(toggle):
"""
Enable/disable windows extensions for output files.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableSequencer(toggle):
"""
Enable/disable Do Sequence.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableRenderDaemon(toggle):
"""
Enable/disable Scene daemon.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableToonShading(toggle):
"""
Enable/disable Edge rendering.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def edgeIntensity(intensity = None):
"""
Get/set edge intensity for toon shading.
@type intensity: int (optional)
@param intensity: must be between 0 - 255
@rtype: int (if prototype is empty)
@return: Current edge intensity for the scene.
"""
def setEdgeColor(red, green, blue):
"""
Set the edge color for toon shading.
@type red: float
@param red: must be between 0 - 1.0
@type green: float
@param green: must be between 0 - 1.0
@type blue: float
@param blue: must be between 0 - 1.0
"""
def getEdgeColor():
"""
Get the edge color for toon shading.
@rtype: string
@return: A string representing the edge color.
"""
def edgeAntiShift(intensity = None):
"""
With the unified renderer, reduce intensity on boundaries.
@type intensity: int (optional)
@param intensity: must be between 0 - 255
@rtype: int (if prototype is empty)
@return: Current edge antishift for the scene.
"""
def enableOversampling(toggle):
"""
Enable/disable oversampling (anit-aliasing).
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def setOversamplingLevel(level):
"""
Set the edge color for toon shading.
@type level: int
@param level: can be either 5, 8, 11, or 16
"""
def enableMotionBlur(toggle):
"""
Enable/disable MBlur.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def motionBlurLevel(level = None):
"""
Get/set the length of shutter time for motion blur.
@type level: float (optional)
@param level: must be between 0.01 - 5.0
@rtype: float (if prototype is empty)
@return: Current MBlur for the scene.
"""
def partsX(parts = None):
"""
Get/set the number of parts to divide the render in the X direction.
@type parts: int (optional)
@param parts: must be between 1 - 64
@rtype: int (if prototype is empty)
@return: Current number of parts in the X for the scene.
"""
def partsY(parts = None):
"""
Get/set the number of parts to divide the render in the Y direction.
@type parts: int (optional)
@param parts: must be between 1 - 64
@rtype: int (if prototype is empty)
@return: Current number of parts in the Y for the scene.
"""
def enableSky():
"""
Enable render background with sky.
"""
def enablePremultiply():
"""
Enable premultiply alpha.
"""
def enableKey():
"""
Enable alpha and colour values remain unchanged.
"""
def enableShadow(toggle):
"""
Enable/disable shadow calculation.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableEnvironmentMap(toggle):
"""
Enable/disable environment map rendering.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableRayTracing(toggle):
"""
Enable/disable ray tracing.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableRadiosityRender(toggle):
"""
Enable/disable radiosity rendering.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enablePanorama(toggle):
"""
Enable/disable panorama rendering (output width is multiplied by Xparts).
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def setRenderWinSize(size):
"""
Set the size of the render window.
@type size: int
@param size: can be 25, 50, 75 or 100 (percent).
"""
def enableFieldRendering(toggle):
"""
Enable/disable field rendering
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableOddFieldFirst(toggle):
"""
Enable/disable Odd field first rendering (Default: Even field).
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableFieldTimeDisable(toggle):
"""
Enable/disable time difference in field calculations.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableGaussFilter(toggle):
"""
Enable/disable Gauss sampling filter for antialiasing.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableBorderRender(toggle):
"""
Enable/disable small cut-out rendering.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableGammaCorrection(toggle):
"""
Enable/disable gamma correction.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def gaussFilterSize(size = None):
"""
Get/sets the Gauss filter size.
@type size: float (optional)
@param size: must be between 0.5 - 1.5
@rtype: float (if prototype is empty)
@return: Current gauss filter size for the scene.
"""
def startFrame(frame = None):
"""
Get/set the starting frame for sequence rendering.
@type frame: int (optional)
@param frame: must be between 1 - 18000
@rtype: int (if prototype is empty)
@return: Current starting frame for the scene.
"""
def endFrame(frame = None):
"""
Get/set the ending frame for sequence rendering.
@type frame: int (optional)
@param frame: must be between 1 - 18000
@rtype: int (if prototype is empty)
@return: Current ending frame for the scene.
"""
def imageSizeX(size = None):
"""
Get/set the image width in pixels.
@type size: int (optional)
@param size: must be between 4 - 10000
@rtype: int (if prototype is empty)
@return: Current image width for the scene.
"""
def imageSizeY(size = None):
"""
Get/set the image height in pixels.
@type size: int (optional)
@param size: must be between 4 - 10000
@rtype: int (if prototype is empty)
@return: Current image height for the scene.
"""
def aspectRatioX(ratio = None):
"""
Get/set the horizontal aspect ratio.
@type ratio: int (optional)
@param ratio: must be between 1 - 200
@rtype: int (if prototype is empty)
@return: Current horizontal aspect ratio for the scene.
"""
def aspectRatioY(ratio = None):
"""
Get/set the vertical aspect ratio.
@type ratio: int (optional)
@param ratio: must be between 1 - 200
@rtype: int (if prototype is empty)
@return: Current vertical aspect ratio for the scene.
"""
def setRenderer(type):
"""
Get/set which renderer to render the output.
@type type: enum constant
@param type: must be one of 2 constants:
- INTERN: Blender's internal renderer
- YAFRAY: Yafray renderer
"""
def enableCropping(toggle):
"""
Enable/disable exclusion of border rendering from total image.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def setImageType(type):
"""
Set the type of image to output from the render.
@type type: enum constant
@param type: must be one of 13 constants:
- AVIRAW: Uncompressed AVI files. AVI is a commonly used format on Windows plattforms
- AVIJPEG: AVI movie w/ Jpeg images
- AVICODEC: AVI using win32 codec
- QUICKTIME: Quicktime movie (if enabled)
- TARGA: Targa files
- RAWTGA: Raw Targa files
- PNG: Png files
- BMP: Bitmap files
- JPEG90: Jpeg files
- HAMX: Hamx files
- IRIS: Iris files
- IRIZ: Iris + z-buffer files
- FTYPE: Ftype file
"""
def quality(qual = None):
"""
Get/set quality get/setting for JPEG images, AVI Jpeg and SGI movies.
@type qual: int (optional)
@param qual: must be between 10 - 100
@rtype: int (if prototype is empty)
@return: Current image quality for the scene.
"""
def framesPerSec(qual = None):
"""
Get/set frames per second.
@type qual: int (optional)
@param qual: must be between 1 - 120
@rtype: int (if prototype is empty)
@return: Current frames per second for the scene.
"""
def enableGrayscale():
"""
Images are saved with BW (grayscale) data.
"""
def enableRGBColor():
"""
Images are saved with RGB (color) data.
"""
def enableRGBAColor():
"""
Images are saved with RGB and Alpha data (if supported).
"""
def sizePreset(type):
"""
Set the renderer to one of a few presets.
@type type: enum constant
@param type: must be one of 8 constants:
- PAL: The European video standard: 720 x 576 pixels, 54 x 51 aspect.
- FULL: For large screens: 1280 x 1024 pixels.
- PREVIEW: For preview rendering: 320 x 256 pixels.
- PAL169: Wide-screen PAL.
- DEFAULT: Like "PAL", but here the render settings are also set.
- PANO: Panorama render.
- NTSC: For TV playback.
- PC: For standard PC graphics: 640 x 480 pixels.
"""
def enableUnifiedRenderer(toggle):
"""
Use the unified renderer.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def setYafrayGIQuality(type):
"""
Set yafray global Illumination quality.
@type type: enum constant
@param type: must be one of 6 constants:
- NONE
- LOW
- MEDIUM
- HIGH
- HIGHER
- BEST
"""
def setYafrayGIMethod(type):
"""
Set yafray global Illumination method.
@type type: enum constant
@param type: must be one of 3 constants:
- NONE: Dont use GI illumination
- SKYDOME: Use Skydome method
- GIFULL: Use Full method
"""
def yafrayGIPower(power = None):
"""
Get/set GI lighting intensity scale.
YafrayMethod must be either SKYDOME or GIFULL.
@type power: float (optional)
@param power: must be between 0.01 - 100.0
@rtype: float (if prototype is empty)
@return: Current yafray global illumination intensity for the scene.
"""
def yafrayGIDepth(depth = None):
"""
Get/set number of bounces of the indirect light.
YafrayMethod must be GIFULL.
@type depth: int (optional)
@param depth: must be between 1 - 8
@rtype: int (if prototype is empty)
@return: Current yafray global illumination light bounces for the scene.
"""
def yafrayGICDepth(depth = None):
"""
Get/set number of bounces inside objects (for caustics).
YafrayMethod must be GIFULL.
@type depth: int (optional)
@param depth: must be between 1 - 8
@rtype: int (if prototype is empty)
@return: Current yafray global illumination inside light bounces for the scene.
"""
def enableYafrayGICache(toggle):
"""
Enable/disable cache irradiance samples (faster).
YafrayMethod must be GIFULL.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def enableYafrayGIPhotons(toggle):
"""
Enable/disable use of global photons to help in GI.
YafrayMethod must be GIFULL.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def yafrayGIPhotonCount(count = None):
"""
Get/set number of photons to shoot.
YafrayMethod must be GIFULL and Photons enabled.
@type count: int (optional)
@param count: must be between 0 - 10000000
@rtype: int (if prototype is empty)
@return: Current number of photons to shoot for the scene.
"""
def yafrayGIPhotonRadius(radius = None):
"""
Get/set radius to search for photons to mix (blur).
YafrayMethod must be GIFULL and Photons enabled.
@type radius: float (optional)
@param radius: must be between 0.00001 - 100.0
@rtype: float (if prototype is empty)
@return: Current photon search radius for the scene.
"""
def yafrayGIPhotonMixCount(count = None):
"""
Get/set number of photons to keep inside radius.
YafrayMethod must be GIFULL and Photons enabled.
@type count: int (optional)
@param count: must be between 0 - 1000
@rtype: int (if prototype is empty)
@return: Current number of photons to keep inside radius for the scene.
"""
def enableYafrayGITunePhotons(toggle):
"""
Enable/disable show the photonmap directly in the render for tuning.
YafrayMethod must be GIFULL and Photons enabled.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def yafrayGIShadowQuality(qual = None):
"""
Get/set the shadow quality, keep it under 0.95.
YafrayMethod must be GIFULL and Cache enabled.
@type qual: float (optional)
@param qual: must be between 0.01 - 1.0
@rtype: float (if prototype is empty)
@return: Current shadow quality for the scene.
"""
def yafrayGIPixelsPerSample(pixels = None):
"""
Get/set maximum number of pixels without samples, the lower the better and slower.
YafrayMethod must be GIFULL and Cache enabled.
@type pixels: int (optional)
@param pixels: must be between 1 - 50
@rtype: int (if prototype is empty)
@return: Current number of pixels without samples for the scene.
"""
def enableYafrayGIGradient(toggle):
"""
Enable/disable try to smooth lighting using a gradient.
YafrayMethod must be GIFULL and Cache enabled.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def yafrayGIRefinement(refine = None):
"""
Get/set threshold to refine shadows EXPERIMENTAL. 1 = no refinement.
YafrayMethod must be GIFULL and Cache enabled.
@type refine: float (optional)
@param refine: must be between 0.001 - 1.0
@rtype: float (if prototype is empty)
@return: Current threshold to refine shadows for the scene.
"""
def yafrayRayBias(bias = None):
"""
Get/set shadow ray bias to avoid self shadowing.
@type bias: float (optional)
@param bias: must be between 0 - 10.0
@rtype: float (if prototype is empty)
@return: Current ray bias for the scene.
"""
def yafrayRayDepth(depth = None):
"""
Get/set maximum render ray depth from the camera.
@type depth: int (optional)
@param depth: must be between 1 - 80
@rtype: int (if prototype is empty)
@return: Current ray depth for the scene.
"""
def yafrayGamma(gamma = None):
"""
Get/set gamma correction, 1 is off.
@type gamma: float (optional)
@param gamma: must be between 0.001 - 5.0
@rtype: float (if prototype is empty)
@return: Current gamma correction for the scene.
"""
def yafrayExposure(expose = None):
"""
Get/set exposure adjustment, 0 is off.
@type expose: float (optional)
@param expose: must be between 0 - 10.0
@rtype: float (if prototype is empty)
@return: Current exposure adjustment for the scene.
"""
def yafrayProcessorCount(count = None):
"""
Get/set number of processors to use.
@type count: int (optional)
@param count: must be between 1 - 8
@rtype: int (if prototype is empty)
@return: Current number of processors for the scene.
"""
def enableGameFrameStretch():
"""
Enble stretch or squeeze the viewport to fill the display window.
"""
def enableGameFrameExpose():
"""
Enable show the entire viewport in the display window, viewing more
horizontally or vertically.
"""
def enableGameFrameBars():
"""
Enable show the entire viewport in the display window, using bar
horizontally or vertically.
"""
def setGameFrameColor(red, green, blue):
"""
Set the red, green, blue component of the bars.
@type red: float
@param red: must be between 0 - 1.0
@type green: float
@param green: must be between 0 - 1.0
@type blue: float
@param blue: must be between 0 - 1.0
"""
def getGameFrameColor():
"""
Set the red, green, blue component of the bars.
@rtype: string
@return: A string representing the color component of the bars.
"""
def gammaLevel(level = None):
"""
Get/set the gamma value for blending oversampled images (1.0 = no correction).
Unified renderer must be enabled.
@type level: float (optional)
@param level: must be between 0.2 - 5.0
@rtype: float (if prototype is empty)
@return: Current gamma value for the scene.
"""
def postProcessAdd(add = None):
"""
Get/set post processing add.
Unified renderer must be enabled.
@type add: float (optional)
@param add: must be between -1.0 - 1.0
@rtype: float (if prototype is empty)
@return: Current processing add value for the scene.
"""
def postProcessMultiply(mult = None):
"""
Get/set post processing multiply.
Unified renderer must be enabled.
@type mult: float (optional)
@param mult: must be between 0.01 - 4.0
@rtype: float (if prototype is empty)
@return: Current processing multiply value for the scene.
"""
def postProcessGamma(gamma = None):
"""
Get/set post processing gamma.
Unified renderer must be enabled.
@type gamma: float (optional)
@param gamma: must be between 0.2 - 2.0
@rtype: float (if prototype is empty)
@return: Current processing gamma value for the scene.
"""
def SGIMaxsize(size = None):
"""
Get/set maximum size per frame to save in an SGI movie.
SGI must be defined on your machine.
@type size: int (optional)
@param size: must be between 0 - 500
@rtype: int (if prototype is empty)
@return: Current SGI maximum size per frame for the scene.
"""
def enableSGICosmo(toggle):
"""
Enable/disable attempt to save SGI movies using Cosmo hardware
SGI must be defined on your machine.
@type toggle: int
@param toggle: pass 1 for on / 0 for off
"""
def oldMapValue(value = None):
"""
Get/set specify old map value in frames.
@type value: int (optional)
@param value: must be between 1 - 900
@rtype: int (if prototype is empty)
@return: Current old map value for the scene.
"""
def newMapValue(value = None):
"""
Get/set specify new map value in frames.
@type value: int (optional)
@param value: must be between 1 - 900
@rtype: int (if prototype is empty)
@return: Current new map value for the scene.
"""