Sets the average the number of photons shot per light for this MentalRayRenderSettings object.
Returns eOk if successful, or an appropriate error code if not.
The default value for GIPhotonsPerLight == 10,000.