[Bf-python] RenderData - lacking functions

[Ken Hughes]

Juho Vepsäläinen wrote:
> Hi
> 
> I began to make a script to alter the rendered result after rendering 
> and came by the following lacks in the RenderData module:
> 
> There's no way to find out if the user has set OSA on so I propose the 
> addon of getOversampling() which returns bool.

Updated API will contain boolean rc.oversampling attribute

> There's no way to find out which image type the user has selected so I 
> propose the addon of getImageType() which return string that contains 
> the type. The types are same as in setImageType().

Updated API will contain integer rc.imageType attribute; gets and sets 
int constants found in Scene.Render module such as AVIRAW (note: I would 
prefer to duplicate these into a const dict, just so it's easier to see 
what constants are intended for which attributes).

> There's no easy way to swap the image in the render window after 
> rendering. I propose the addon of swapDispWinImage(image) which could 
> return bool telling if swapping was okay or it could throw an exception 
> in the case of bad swap. Also swap method for the secondary part of the 
> render window (accessible via j key) could be considered. If both 
> methods were to be added, they could be named 
> swapDispWinImagePrimary(image) and swapDispWinImageSecondary(image).

Not sure what you mean by "swap the image".

> Also it would be useful if you could get the image formats that Blender 
> supports. I propose addon of getSupportedImageTypes() that returns the 
> supported image types in an array. The array could contain pairs which 
> contain the name in human compatible format (as seen in Blender 
> rendering panel) and part that is useable with setImageType(type).

Not sure that the Render API is the place for this, although I can't 
think of another place off-hand.

> Further it would help a lot if there was a way to toggle Ambient 
> Occlusion on/off. I looked at the World module but couldn't find such a 
> switch.

This is actually done with the getMode()/setMode() methods in the World 
module, but is API documentation is wrong.  I'll correct that.

> getRenderOutput() could be added to the Render module. It returns in 
> which place the image is rendered. (dispView|dispWin)

Updated API will contain boolean rc.displayMode attribute

> yafrayGIEmitPower(power) could be added to the RenderData module. It 
> works like yafrayGIPower except it alters the emit value.

I haven't looked at yafray stuff get.  Unfortunately for the tp_getset 
update, some of the preferred attribute names are already used by 
methods, including most of the yafray code.

Ken