Upgrade scripts: multiple_environment_probes


Recommended Posts


I have a problem creeping in during a long upgrade from 2.5 to 2.11. One of the materials has now 

<state name="multiple_environment_probes">1</state>

added to it, while render_transparent_multiple_env_probes ended up as zero in the rendering settings. So, of course, objects with this material are no longer rendered.

Tracking back the changes in your scripts I can see:

		switch(transparent) {
				case 2: // Deferred transparent

in materials.h from upgrade. So this adds multiple_environment_probes to deferred transparent objects. So first question: why ?

Then I can see:


as setting added to render.xml, which, of course, for later versions was (correctly) transformed to:


when later that token name was changed (and its meaning switched from skip to render).

Question 2: is this an error in the upgrade scripts?


Also, unrelated question, why some of the rendering parameters introduced by render.xml don't have the default values. For example render.xml from, has bloom settings as:


While default values are: render_bloom_passes = 6, render_bloom_power = 0.7, render_bloom_scale 0.3 ?


Btw, another bonus bug report, it seems that render_bloom_resolution is not documented at all.


Kind Regards,

Adrian L.


Link to post

Hi Adrian,

Automated script migration sometimes can cause unexpected results (especially on big render changes). It designed that way to minimize the manual editing of materials and nodes after migration. It doesn't know the context of each material setting, so it simply changes one checkbox to another even if it can lead to the bad results. Your artists needs to manually tweak settings after migration for better visuals and performance.

Multiple environment probes makes transparent object to render differently in case if you really need to blend many probes on the same object. More likely this checkbox was enabled in order to get the better visuals on transparent objects with env probe reflections. I don't know why render_transparent_multiple_env_probes is set to 0, probably to save the performance by default. So you can simply enable it if needed.

I also don't have any specific information about bloom settings, more likely it's related to some artists tweaks for default empty world template.



Btw, another bonus bug report, it seems that render_bloom_resolution is not documented at all.

Yeah, it does look like a bug, thanks! Will be fixed ASAP.


How to submit a good bug report
FTP server for test scenes and user uploads:

Link to post