environment.cpp 67 KB

12345678910111213141516171819202122232425262728293031323334353637383940414243444546474849505152535455565758596061626364656667686970717273747576777879808182838485868788899091929394959697989910010110210310410510610710810911011111211311411511611711811912012112212312412512612712812913013113213313413513613713813914014114214314414514614714814915015115215315415515615715815916016116216316416516616716816917017117217317417517617717817918018118218318418518618718818919019119219319419519619719819920020120220320420520620720820921021121221321421521621721821922022122222322422522622722822923023123223323423523623723823924024124224324424524624724824925025125225325425525625725825926026126226326426526626726826927027127227327427527627727827928028128228328428528628728828929029129229329429529629729829930030130230330430530630730830931031131231331431531631731831932032132232332432532632732832933033133233333433533633733833934034134234334434534634734834935035135235335435535635735835936036136236336436536636736836937037137237337437537637737837938038138238338438538638738838939039139239339439539639739839940040140240340440540640740840941041141241341441541641741841942042142242342442542642742842943043143243343443543643743843944044144244344444544644744844945045145245345445545645745845946046146246346446546646746846947047147247347447547647747847948048148248348448548648748848949049149249349449549649749849950050150250350450550650750850951051151251351451551651751851952052152252352452552652752852953053153253353453553653753853954054154254354454554654754854955055155255355455555655755855956056156256356456556656756856957057157257357457557657757857958058158258358458558658758858959059159259359459559659759859960060160260360460560660760860961061161261361461561661761861962062162262362462562662762862963063163263363463563663763863964064164264364464564664764864965065165265365465565665765865966066166266366466566666766866967067167267367467567667767867968068168268368468568668768868969069169269369469569669769869970070170270370470570670770870971071171271371471571671771871972072172272372472572672772872973073173273373473573673773873974074174274374474574674774874975075175275375475575675775875976076176276376476576676776876977077177277377477577677777877978078178278378478578678778878979079179279379479579679779879980080180280380480580680780880981081181281381481581681781881982082182282382482582682782882983083183283383483583683783883984084184284384484584684784884985085185285385485585685785885986086186286386486586686786886987087187287387487587687787887988088188288388488588688788888989089189289389489589689789889990090190290390490590690790890991091191291391491591691791891992092192292392492592692792892993093193293393493593693793893994094194294394494594694794894995095195295395495595695795895996096196296396496596696796896997097197297397497597697797897998098198298398498598698798898999099199299399499599699799899910001001100210031004100510061007100810091010101110121013101410151016101710181019102010211022102310241025102610271028102910301031103210331034103510361037103810391040104110421043104410451046104710481049105010511052105310541055105610571058105910601061106210631064106510661067106810691070107110721073107410751076107710781079108010811082108310841085108610871088108910901091109210931094109510961097109810991100110111021103110411051106110711081109111011111112111311141115111611171118111911201121112211231124112511261127112811291130113111321133113411351136113711381139114011411142114311441145114611471148114911501151115211531154115511561157115811591160116111621163116411651166116711681169117011711172117311741175117611771178117911801181118211831184118511861187118811891190119111921193119411951196119711981199120012011202120312041205120612071208120912101211121212131214121512161217121812191220122112221223122412251226122712281229123012311232123312341235123612371238123912401241124212431244124512461247124812491250125112521253125412551256125712581259126012611262126312641265126612671268126912701271127212731274127512761277127812791280128112821283128412851286128712881289129012911292129312941295129612971298129913001301130213031304130513061307130813091310131113121313131413151316131713181319132013211322132313241325132613271328132913301331133213331334133513361337133813391340134113421343134413451346134713481349135013511352135313541355135613571358135913601361136213631364136513661367136813691370137113721373137413751376137713781379138013811382138313841385138613871388138913901391139213931394139513961397139813991400140114021403140414051406140714081409141014111412141314141415141614171418141914201421142214231424142514261427142814291430143114321433143414351436143714381439144014411442144314441445144614471448144914501451145214531454145514561457145814591460146114621463146414651466146714681469147014711472147314741475147614771478147914801481148214831484148514861487148814891490149114921493149414951496149714981499150015011502150315041505150615071508150915101511151215131514151515161517151815191520152115221523152415251526152715281529153015311532153315341535153615371538153915401541154215431544154515461547154815491550155115521553155415551556155715581559156015611562156315641565156615671568156915701571157215731574157515761577157815791580158115821583158415851586158715881589159015911592159315941595159615971598159916001601160216031604160516061607160816091610161116121613161416151616161716181619162016211622162316241625162616271628162916301631163216331634163516361637163816391640
  1. /**************************************************************************/
  2. /* environment.cpp */
  3. /**************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /**************************************************************************/
  8. /* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
  9. /* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
  10. /* */
  11. /* Permission is hereby granted, free of charge, to any person obtaining */
  12. /* a copy of this software and associated documentation files (the */
  13. /* "Software"), to deal in the Software without restriction, including */
  14. /* without limitation the rights to use, copy, modify, merge, publish, */
  15. /* distribute, sublicense, and/or sell copies of the Software, and to */
  16. /* permit persons to whom the Software is furnished to do so, subject to */
  17. /* the following conditions: */
  18. /* */
  19. /* The above copyright notice and this permission notice shall be */
  20. /* included in all copies or substantial portions of the Software. */
  21. /* */
  22. /* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
  23. /* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
  24. /* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
  25. /* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
  26. /* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
  27. /* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
  28. /* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
  29. /**************************************************************************/
  30. #include "environment.h"
  31. #include "core/config/project_settings.h"
  32. #include "scene/resources/gradient_texture.h"
  33. #include "servers/rendering/rendering_server.h"
  34. RID Environment::get_rid() const {
  35. return environment;
  36. }
  37. // Background
  38. void Environment::set_background(BGMode p_bg) {
  39. bg_mode = p_bg;
  40. RS::get_singleton()->environment_set_background(environment, RS::EnvironmentBG(p_bg));
  41. notify_property_list_changed();
  42. if (bg_mode != BG_SKY) {
  43. set_fog_aerial_perspective(0.0);
  44. }
  45. }
  46. Environment::BGMode Environment::get_background() const {
  47. return bg_mode;
  48. }
  49. void Environment::set_sky(const Ref<Sky> &p_sky) {
  50. bg_sky = p_sky;
  51. RID sb_rid;
  52. if (bg_sky.is_valid()) {
  53. sb_rid = bg_sky->get_rid();
  54. }
  55. RS::get_singleton()->environment_set_sky(environment, sb_rid);
  56. }
  57. Ref<Sky> Environment::get_sky() const {
  58. return bg_sky;
  59. }
  60. void Environment::set_sky_custom_fov(float p_scale) {
  61. bg_sky_custom_fov = p_scale;
  62. RS::get_singleton()->environment_set_sky_custom_fov(environment, p_scale);
  63. }
  64. float Environment::get_sky_custom_fov() const {
  65. return bg_sky_custom_fov;
  66. }
  67. void Environment::set_sky_rotation(const Vector3 &p_rotation) {
  68. bg_sky_rotation = p_rotation;
  69. RS::get_singleton()->environment_set_sky_orientation(environment, Basis::from_euler(p_rotation));
  70. }
  71. Vector3 Environment::get_sky_rotation() const {
  72. return bg_sky_rotation;
  73. }
  74. void Environment::set_bg_color(const Color &p_color) {
  75. bg_color = p_color;
  76. RS::get_singleton()->environment_set_bg_color(environment, p_color);
  77. }
  78. Color Environment::get_bg_color() const {
  79. return bg_color;
  80. }
  81. void Environment::set_bg_energy_multiplier(float p_multiplier) {
  82. bg_energy_multiplier = p_multiplier;
  83. _update_bg_energy();
  84. }
  85. float Environment::get_bg_energy_multiplier() const {
  86. return bg_energy_multiplier;
  87. }
  88. void Environment::set_bg_intensity(float p_exposure_value) {
  89. bg_intensity = p_exposure_value;
  90. _update_bg_energy();
  91. }
  92. float Environment::get_bg_intensity() const {
  93. return bg_intensity;
  94. }
  95. void Environment::_update_bg_energy() {
  96. if (GLOBAL_GET_CACHED(bool, "rendering/lights_and_shadows/use_physical_light_units")) {
  97. RS::get_singleton()->environment_set_bg_energy(environment, bg_energy_multiplier, bg_intensity);
  98. } else {
  99. RS::get_singleton()->environment_set_bg_energy(environment, bg_energy_multiplier, 1.0);
  100. }
  101. }
  102. void Environment::set_canvas_max_layer(int p_max_layer) {
  103. bg_canvas_max_layer = p_max_layer;
  104. RS::get_singleton()->environment_set_canvas_max_layer(environment, p_max_layer);
  105. }
  106. int Environment::get_canvas_max_layer() const {
  107. return bg_canvas_max_layer;
  108. }
  109. void Environment::set_camera_feed_id(int p_id) {
  110. bg_camera_feed_id = p_id;
  111. RS::get_singleton()->environment_set_camera_feed_id(environment, bg_camera_feed_id);
  112. }
  113. int Environment::get_camera_feed_id() const {
  114. return bg_camera_feed_id;
  115. }
  116. // Ambient light
  117. void Environment::set_ambient_light_color(const Color &p_color) {
  118. ambient_color = p_color;
  119. _update_ambient_light();
  120. }
  121. Color Environment::get_ambient_light_color() const {
  122. return ambient_color;
  123. }
  124. void Environment::set_ambient_source(AmbientSource p_source) {
  125. ambient_source = p_source;
  126. _update_ambient_light();
  127. notify_property_list_changed();
  128. }
  129. Environment::AmbientSource Environment::get_ambient_source() const {
  130. return ambient_source;
  131. }
  132. void Environment::set_ambient_light_energy(float p_energy) {
  133. ambient_energy = p_energy;
  134. _update_ambient_light();
  135. }
  136. float Environment::get_ambient_light_energy() const {
  137. return ambient_energy;
  138. }
  139. void Environment::set_ambient_light_sky_contribution(float p_ratio) {
  140. // Sky contribution values outside the [0.0; 1.0] range don't make sense and
  141. // can result in negative colors.
  142. ambient_sky_contribution = CLAMP(p_ratio, 0.0, 1.0);
  143. _update_ambient_light();
  144. }
  145. float Environment::get_ambient_light_sky_contribution() const {
  146. return ambient_sky_contribution;
  147. }
  148. void Environment::set_reflection_source(ReflectionSource p_source) {
  149. reflection_source = p_source;
  150. _update_ambient_light();
  151. notify_property_list_changed();
  152. }
  153. Environment::ReflectionSource Environment::get_reflection_source() const {
  154. return reflection_source;
  155. }
  156. void Environment::_update_ambient_light() {
  157. RS::get_singleton()->environment_set_ambient_light(
  158. environment,
  159. ambient_color,
  160. RS::EnvironmentAmbientSource(ambient_source),
  161. ambient_energy,
  162. ambient_sky_contribution, RS::EnvironmentReflectionSource(reflection_source));
  163. }
  164. // Tonemap
  165. void Environment::set_tonemapper(ToneMapper p_tone_mapper) {
  166. tone_mapper = p_tone_mapper;
  167. _update_tonemap();
  168. notify_property_list_changed();
  169. }
  170. Environment::ToneMapper Environment::get_tonemapper() const {
  171. return tone_mapper;
  172. }
  173. void Environment::set_tonemap_exposure(float p_exposure) {
  174. tonemap_exposure = p_exposure;
  175. _update_tonemap();
  176. }
  177. float Environment::get_tonemap_exposure() const {
  178. return tonemap_exposure;
  179. }
  180. void Environment::set_tonemap_white(float p_white) {
  181. tonemap_white = p_white;
  182. _update_tonemap();
  183. }
  184. float Environment::get_tonemap_white() const {
  185. return tonemap_white;
  186. }
  187. void Environment::set_tonemap_agx_white(float p_white) {
  188. tonemap_agx_white = p_white;
  189. _update_tonemap();
  190. }
  191. float Environment::get_tonemap_agx_white() const {
  192. return tonemap_agx_white;
  193. }
  194. void Environment::set_tonemap_agx_contrast(float p_agx_contrast) {
  195. tonemap_agx_contrast = p_agx_contrast;
  196. RS::get_singleton()->environment_set_tonemap_agx_contrast(environment, p_agx_contrast);
  197. }
  198. float Environment::get_tonemap_agx_contrast() const {
  199. return tonemap_agx_contrast;
  200. }
  201. void Environment::_update_tonemap() {
  202. RS::get_singleton()->environment_set_tonemap(
  203. environment,
  204. RS::EnvironmentToneMapper(tone_mapper),
  205. tonemap_exposure,
  206. tone_mapper == TONE_MAPPER_AGX ? tonemap_agx_white : tonemap_white);
  207. }
  208. // SSR
  209. void Environment::set_ssr_enabled(bool p_enabled) {
  210. ssr_enabled = p_enabled;
  211. _update_ssr();
  212. }
  213. bool Environment::is_ssr_enabled() const {
  214. return ssr_enabled;
  215. }
  216. void Environment::set_ssr_max_steps(int p_steps) {
  217. ssr_max_steps = p_steps;
  218. _update_ssr();
  219. }
  220. int Environment::get_ssr_max_steps() const {
  221. return ssr_max_steps;
  222. }
  223. void Environment::set_ssr_fade_in(float p_fade_in) {
  224. ssr_fade_in = MAX(p_fade_in, 0.0f);
  225. _update_ssr();
  226. }
  227. float Environment::get_ssr_fade_in() const {
  228. return ssr_fade_in;
  229. }
  230. void Environment::set_ssr_fade_out(float p_fade_out) {
  231. ssr_fade_out = MAX(p_fade_out, 0.0f);
  232. _update_ssr();
  233. }
  234. float Environment::get_ssr_fade_out() const {
  235. return ssr_fade_out;
  236. }
  237. void Environment::set_ssr_depth_tolerance(float p_depth_tolerance) {
  238. ssr_depth_tolerance = p_depth_tolerance;
  239. _update_ssr();
  240. }
  241. float Environment::get_ssr_depth_tolerance() const {
  242. return ssr_depth_tolerance;
  243. }
  244. void Environment::_update_ssr() {
  245. RS::get_singleton()->environment_set_ssr(
  246. environment,
  247. ssr_enabled,
  248. ssr_max_steps,
  249. ssr_fade_in,
  250. ssr_fade_out,
  251. ssr_depth_tolerance);
  252. }
  253. // SSAO
  254. void Environment::set_ssao_enabled(bool p_enabled) {
  255. ssao_enabled = p_enabled;
  256. _update_ssao();
  257. }
  258. bool Environment::is_ssao_enabled() const {
  259. return ssao_enabled;
  260. }
  261. void Environment::set_ssao_radius(float p_radius) {
  262. ssao_radius = p_radius;
  263. _update_ssao();
  264. }
  265. float Environment::get_ssao_radius() const {
  266. return ssao_radius;
  267. }
  268. void Environment::set_ssao_intensity(float p_intensity) {
  269. ssao_intensity = p_intensity;
  270. _update_ssao();
  271. }
  272. float Environment::get_ssao_intensity() const {
  273. return ssao_intensity;
  274. }
  275. void Environment::set_ssao_power(float p_power) {
  276. ssao_power = p_power;
  277. _update_ssao();
  278. }
  279. float Environment::get_ssao_power() const {
  280. return ssao_power;
  281. }
  282. void Environment::set_ssao_detail(float p_detail) {
  283. ssao_detail = p_detail;
  284. _update_ssao();
  285. }
  286. float Environment::get_ssao_detail() const {
  287. return ssao_detail;
  288. }
  289. void Environment::set_ssao_horizon(float p_horizon) {
  290. ssao_horizon = p_horizon;
  291. _update_ssao();
  292. }
  293. float Environment::get_ssao_horizon() const {
  294. return ssao_horizon;
  295. }
  296. void Environment::set_ssao_sharpness(float p_sharpness) {
  297. ssao_sharpness = p_sharpness;
  298. _update_ssao();
  299. }
  300. float Environment::get_ssao_sharpness() const {
  301. return ssao_sharpness;
  302. }
  303. void Environment::set_ssao_direct_light_affect(float p_direct_light_affect) {
  304. ssao_direct_light_affect = p_direct_light_affect;
  305. _update_ssao();
  306. }
  307. float Environment::get_ssao_direct_light_affect() const {
  308. return ssao_direct_light_affect;
  309. }
  310. void Environment::set_ssao_ao_channel_affect(float p_ao_channel_affect) {
  311. ssao_ao_channel_affect = p_ao_channel_affect;
  312. _update_ssao();
  313. }
  314. float Environment::get_ssao_ao_channel_affect() const {
  315. return ssao_ao_channel_affect;
  316. }
  317. void Environment::_update_ssao() {
  318. RS::get_singleton()->environment_set_ssao(
  319. environment,
  320. ssao_enabled,
  321. ssao_radius,
  322. ssao_intensity,
  323. ssao_power,
  324. ssao_detail,
  325. ssao_horizon,
  326. ssao_sharpness,
  327. ssao_direct_light_affect,
  328. ssao_ao_channel_affect);
  329. }
  330. // SSIL
  331. void Environment::set_ssil_enabled(bool p_enabled) {
  332. ssil_enabled = p_enabled;
  333. _update_ssil();
  334. }
  335. bool Environment::is_ssil_enabled() const {
  336. return ssil_enabled;
  337. }
  338. void Environment::set_ssil_radius(float p_radius) {
  339. ssil_radius = p_radius;
  340. _update_ssil();
  341. }
  342. float Environment::get_ssil_radius() const {
  343. return ssil_radius;
  344. }
  345. void Environment::set_ssil_intensity(float p_intensity) {
  346. ssil_intensity = p_intensity;
  347. _update_ssil();
  348. }
  349. float Environment::get_ssil_intensity() const {
  350. return ssil_intensity;
  351. }
  352. void Environment::set_ssil_sharpness(float p_sharpness) {
  353. ssil_sharpness = p_sharpness;
  354. _update_ssil();
  355. }
  356. float Environment::get_ssil_sharpness() const {
  357. return ssil_sharpness;
  358. }
  359. void Environment::set_ssil_normal_rejection(float p_normal_rejection) {
  360. ssil_normal_rejection = p_normal_rejection;
  361. _update_ssil();
  362. }
  363. float Environment::get_ssil_normal_rejection() const {
  364. return ssil_normal_rejection;
  365. }
  366. void Environment::_update_ssil() {
  367. RS::get_singleton()->environment_set_ssil(
  368. environment,
  369. ssil_enabled,
  370. ssil_radius,
  371. ssil_intensity,
  372. ssil_sharpness,
  373. ssil_normal_rejection);
  374. }
  375. // SDFGI
  376. void Environment::set_sdfgi_enabled(bool p_enabled) {
  377. sdfgi_enabled = p_enabled;
  378. _update_sdfgi();
  379. }
  380. bool Environment::is_sdfgi_enabled() const {
  381. return sdfgi_enabled;
  382. }
  383. void Environment::set_sdfgi_cascades(int p_cascades) {
  384. ERR_FAIL_COND_MSG(p_cascades < 1 || p_cascades > 8, "Invalid number of SDFGI cascades (must be between 1 and 8).");
  385. sdfgi_cascades = p_cascades;
  386. _update_sdfgi();
  387. }
  388. int Environment::get_sdfgi_cascades() const {
  389. return sdfgi_cascades;
  390. }
  391. void Environment::set_sdfgi_min_cell_size(float p_size) {
  392. sdfgi_min_cell_size = p_size;
  393. _update_sdfgi();
  394. }
  395. float Environment::get_sdfgi_min_cell_size() const {
  396. return sdfgi_min_cell_size;
  397. }
  398. void Environment::set_sdfgi_max_distance(float p_distance) {
  399. p_distance /= 64.0;
  400. for (int i = 0; i < sdfgi_cascades; i++) {
  401. p_distance *= 0.5; //halve for each cascade
  402. }
  403. sdfgi_min_cell_size = p_distance;
  404. _update_sdfgi();
  405. }
  406. float Environment::get_sdfgi_max_distance() const {
  407. float md = sdfgi_min_cell_size;
  408. md *= 64.0;
  409. for (int i = 0; i < sdfgi_cascades; i++) {
  410. md *= 2.0;
  411. }
  412. return md;
  413. }
  414. void Environment::set_sdfgi_cascade0_distance(float p_distance) {
  415. sdfgi_min_cell_size = p_distance / 64.0;
  416. _update_sdfgi();
  417. }
  418. float Environment::get_sdfgi_cascade0_distance() const {
  419. return sdfgi_min_cell_size * 64.0;
  420. }
  421. void Environment::set_sdfgi_y_scale(SDFGIYScale p_y_scale) {
  422. sdfgi_y_scale = p_y_scale;
  423. _update_sdfgi();
  424. }
  425. Environment::SDFGIYScale Environment::get_sdfgi_y_scale() const {
  426. return sdfgi_y_scale;
  427. }
  428. void Environment::set_sdfgi_use_occlusion(bool p_enabled) {
  429. sdfgi_use_occlusion = p_enabled;
  430. _update_sdfgi();
  431. }
  432. bool Environment::is_sdfgi_using_occlusion() const {
  433. return sdfgi_use_occlusion;
  434. }
  435. void Environment::set_sdfgi_bounce_feedback(float p_amount) {
  436. sdfgi_bounce_feedback = p_amount;
  437. _update_sdfgi();
  438. }
  439. float Environment::get_sdfgi_bounce_feedback() const {
  440. return sdfgi_bounce_feedback;
  441. }
  442. void Environment::set_sdfgi_read_sky_light(bool p_enabled) {
  443. sdfgi_read_sky_light = p_enabled;
  444. _update_sdfgi();
  445. }
  446. bool Environment::is_sdfgi_reading_sky_light() const {
  447. return sdfgi_read_sky_light;
  448. }
  449. void Environment::set_sdfgi_energy(float p_energy) {
  450. sdfgi_energy = p_energy;
  451. _update_sdfgi();
  452. }
  453. float Environment::get_sdfgi_energy() const {
  454. return sdfgi_energy;
  455. }
  456. void Environment::set_sdfgi_normal_bias(float p_bias) {
  457. sdfgi_normal_bias = p_bias;
  458. _update_sdfgi();
  459. }
  460. float Environment::get_sdfgi_normal_bias() const {
  461. return sdfgi_normal_bias;
  462. }
  463. void Environment::set_sdfgi_probe_bias(float p_bias) {
  464. sdfgi_probe_bias = p_bias;
  465. _update_sdfgi();
  466. }
  467. float Environment::get_sdfgi_probe_bias() const {
  468. return sdfgi_probe_bias;
  469. }
  470. void Environment::_update_sdfgi() {
  471. RS::get_singleton()->environment_set_sdfgi(
  472. environment,
  473. sdfgi_enabled,
  474. sdfgi_cascades,
  475. sdfgi_min_cell_size,
  476. RS::EnvironmentSDFGIYScale(sdfgi_y_scale),
  477. sdfgi_use_occlusion,
  478. sdfgi_bounce_feedback,
  479. sdfgi_read_sky_light,
  480. sdfgi_energy,
  481. sdfgi_normal_bias,
  482. sdfgi_probe_bias);
  483. }
  484. // Glow
  485. void Environment::set_glow_enabled(bool p_enabled) {
  486. glow_enabled = p_enabled;
  487. _update_glow();
  488. }
  489. bool Environment::is_glow_enabled() const {
  490. return glow_enabled;
  491. }
  492. void Environment::set_glow_level(int p_level, float p_intensity) {
  493. ERR_FAIL_INDEX(p_level, RS::MAX_GLOW_LEVELS);
  494. glow_levels.write[p_level] = p_intensity;
  495. _update_glow();
  496. }
  497. float Environment::get_glow_level(int p_level) const {
  498. ERR_FAIL_INDEX_V(p_level, RS::MAX_GLOW_LEVELS, 0.0);
  499. return glow_levels[p_level];
  500. }
  501. void Environment::set_glow_normalized(bool p_normalized) {
  502. glow_normalize_levels = p_normalized;
  503. _update_glow();
  504. }
  505. bool Environment::is_glow_normalized() const {
  506. return glow_normalize_levels;
  507. }
  508. void Environment::set_glow_intensity(float p_intensity) {
  509. glow_intensity = p_intensity;
  510. _update_glow();
  511. }
  512. float Environment::get_glow_intensity() const {
  513. return glow_intensity;
  514. }
  515. void Environment::set_glow_strength(float p_strength) {
  516. glow_strength = p_strength;
  517. _update_glow();
  518. }
  519. float Environment::get_glow_strength() const {
  520. return glow_strength;
  521. }
  522. void Environment::set_glow_mix(float p_mix) {
  523. glow_mix = p_mix;
  524. _update_glow();
  525. }
  526. float Environment::get_glow_mix() const {
  527. return glow_mix;
  528. }
  529. void Environment::set_glow_bloom(float p_threshold) {
  530. glow_bloom = p_threshold;
  531. _update_glow();
  532. }
  533. float Environment::get_glow_bloom() const {
  534. return glow_bloom;
  535. }
  536. void Environment::set_glow_blend_mode(GlowBlendMode p_mode) {
  537. glow_blend_mode = p_mode;
  538. _update_glow();
  539. notify_property_list_changed();
  540. }
  541. Environment::GlowBlendMode Environment::get_glow_blend_mode() const {
  542. return glow_blend_mode;
  543. }
  544. void Environment::set_glow_hdr_bleed_threshold(float p_threshold) {
  545. glow_hdr_bleed_threshold = p_threshold;
  546. _update_glow();
  547. }
  548. float Environment::get_glow_hdr_bleed_threshold() const {
  549. return glow_hdr_bleed_threshold;
  550. }
  551. void Environment::set_glow_hdr_bleed_scale(float p_scale) {
  552. glow_hdr_bleed_scale = p_scale;
  553. _update_glow();
  554. }
  555. float Environment::get_glow_hdr_bleed_scale() const {
  556. return glow_hdr_bleed_scale;
  557. }
  558. void Environment::set_glow_hdr_luminance_cap(float p_amount) {
  559. glow_hdr_luminance_cap = p_amount;
  560. _update_glow();
  561. }
  562. float Environment::get_glow_hdr_luminance_cap() const {
  563. return glow_hdr_luminance_cap;
  564. }
  565. void Environment::set_glow_map_strength(float p_strength) {
  566. glow_map_strength = p_strength;
  567. _update_glow();
  568. }
  569. float Environment::get_glow_map_strength() const {
  570. return glow_map_strength;
  571. }
  572. void Environment::set_glow_map(Ref<Texture> p_glow_map) {
  573. glow_map = p_glow_map;
  574. _update_glow();
  575. }
  576. Ref<Texture> Environment::get_glow_map() const {
  577. return glow_map;
  578. }
  579. void Environment::_update_glow() {
  580. Vector<float> normalized_levels;
  581. if (glow_normalize_levels) {
  582. normalized_levels.resize(7);
  583. float size = 0.0;
  584. for (int i = 0; i < glow_levels.size(); i++) {
  585. size += glow_levels[i];
  586. }
  587. for (int i = 0; i < glow_levels.size(); i++) {
  588. normalized_levels.write[i] = glow_levels[i] / size;
  589. }
  590. } else {
  591. normalized_levels = glow_levels;
  592. }
  593. float _glow_map_strength = 0.0f;
  594. RID glow_map_rid;
  595. if (glow_map.is_valid()) {
  596. glow_map_rid = glow_map->get_rid();
  597. _glow_map_strength = glow_map_strength;
  598. } else {
  599. glow_map_rid = RID();
  600. }
  601. RS::get_singleton()->environment_set_glow(
  602. environment,
  603. glow_enabled,
  604. normalized_levels,
  605. glow_intensity,
  606. glow_strength,
  607. glow_mix,
  608. glow_bloom,
  609. RS::EnvironmentGlowBlendMode(glow_blend_mode),
  610. glow_hdr_bleed_threshold,
  611. glow_hdr_bleed_scale,
  612. glow_hdr_luminance_cap,
  613. _glow_map_strength,
  614. glow_map_rid);
  615. }
  616. // Fog
  617. void Environment::set_fog_enabled(bool p_enabled) {
  618. fog_enabled = p_enabled;
  619. _update_fog();
  620. }
  621. bool Environment::is_fog_enabled() const {
  622. return fog_enabled;
  623. }
  624. void Environment::set_fog_mode(FogMode p_mode) {
  625. if (fog_mode != p_mode && p_mode == FogMode::FOG_MODE_EXPONENTIAL) {
  626. set_fog_density(0.01);
  627. } else {
  628. set_fog_density(1.0);
  629. }
  630. fog_mode = p_mode;
  631. _update_fog();
  632. notify_property_list_changed();
  633. }
  634. Environment::FogMode Environment::get_fog_mode() const {
  635. return fog_mode;
  636. }
  637. void Environment::set_fog_light_color(const Color &p_light_color) {
  638. fog_light_color = p_light_color;
  639. _update_fog();
  640. }
  641. Color Environment::get_fog_light_color() const {
  642. return fog_light_color;
  643. }
  644. void Environment::set_fog_light_energy(float p_amount) {
  645. fog_light_energy = p_amount;
  646. _update_fog();
  647. }
  648. float Environment::get_fog_light_energy() const {
  649. return fog_light_energy;
  650. }
  651. void Environment::set_fog_sun_scatter(float p_amount) {
  652. fog_sun_scatter = p_amount;
  653. _update_fog();
  654. }
  655. float Environment::get_fog_sun_scatter() const {
  656. return fog_sun_scatter;
  657. }
  658. void Environment::set_fog_density(float p_amount) {
  659. fog_density = p_amount;
  660. _update_fog();
  661. }
  662. float Environment::get_fog_density() const {
  663. return fog_density;
  664. }
  665. void Environment::set_fog_height(float p_amount) {
  666. fog_height = p_amount;
  667. _update_fog();
  668. }
  669. float Environment::get_fog_height() const {
  670. return fog_height;
  671. }
  672. void Environment::set_fog_height_density(float p_amount) {
  673. fog_height_density = p_amount;
  674. _update_fog();
  675. }
  676. float Environment::get_fog_height_density() const {
  677. return fog_height_density;
  678. }
  679. void Environment::set_fog_aerial_perspective(float p_aerial_perspective) {
  680. fog_aerial_perspective = p_aerial_perspective;
  681. _update_fog();
  682. }
  683. float Environment::get_fog_aerial_perspective() const {
  684. return fog_aerial_perspective;
  685. }
  686. void Environment::set_fog_sky_affect(float p_sky_affect) {
  687. fog_sky_affect = p_sky_affect;
  688. _update_fog();
  689. }
  690. float Environment::get_fog_sky_affect() const {
  691. return fog_sky_affect;
  692. }
  693. void Environment::_update_fog() {
  694. RS::get_singleton()->environment_set_fog(
  695. environment,
  696. fog_enabled,
  697. fog_light_color,
  698. fog_light_energy,
  699. fog_sun_scatter,
  700. fog_density,
  701. fog_height,
  702. fog_height_density,
  703. fog_aerial_perspective,
  704. fog_sky_affect,
  705. RS::EnvironmentFogMode(fog_mode));
  706. }
  707. // Depth Fog
  708. void Environment::set_fog_depth_curve(float p_curve) {
  709. fog_depth_curve = p_curve;
  710. _update_fog_depth();
  711. }
  712. float Environment::get_fog_depth_curve() const {
  713. return fog_depth_curve;
  714. }
  715. void Environment::set_fog_depth_begin(float p_begin) {
  716. fog_depth_begin = p_begin;
  717. if (fog_depth_begin > fog_depth_end) {
  718. set_fog_depth_end(fog_depth_begin);
  719. }
  720. _update_fog_depth();
  721. }
  722. float Environment::get_fog_depth_begin() const {
  723. return fog_depth_begin;
  724. }
  725. void Environment::set_fog_depth_end(float p_end) {
  726. fog_depth_end = p_end;
  727. if (fog_depth_end < fog_depth_begin) {
  728. set_fog_depth_begin(fog_depth_end);
  729. }
  730. _update_fog_depth();
  731. }
  732. float Environment::get_fog_depth_end() const {
  733. return fog_depth_end;
  734. }
  735. void Environment::_update_fog_depth() {
  736. RS::get_singleton()->environment_set_fog_depth(
  737. environment,
  738. fog_depth_curve,
  739. fog_depth_begin,
  740. fog_depth_end);
  741. }
  742. // Volumetric Fog
  743. void Environment::_update_volumetric_fog() {
  744. RS::get_singleton()->environment_set_volumetric_fog(
  745. environment,
  746. volumetric_fog_enabled,
  747. volumetric_fog_density,
  748. volumetric_fog_albedo,
  749. volumetric_fog_emission,
  750. volumetric_fog_emission_energy,
  751. volumetric_fog_anisotropy,
  752. volumetric_fog_length,
  753. volumetric_fog_detail_spread,
  754. volumetric_fog_gi_inject,
  755. volumetric_fog_temporal_reproject,
  756. volumetric_fog_temporal_reproject_amount,
  757. volumetric_fog_ambient_inject,
  758. volumetric_fog_sky_affect);
  759. }
  760. void Environment::set_volumetric_fog_enabled(bool p_enable) {
  761. volumetric_fog_enabled = p_enable;
  762. _update_volumetric_fog();
  763. }
  764. bool Environment::is_volumetric_fog_enabled() const {
  765. return volumetric_fog_enabled;
  766. }
  767. void Environment::set_volumetric_fog_density(float p_density) {
  768. volumetric_fog_density = p_density;
  769. _update_volumetric_fog();
  770. }
  771. float Environment::get_volumetric_fog_density() const {
  772. return volumetric_fog_density;
  773. }
  774. void Environment::set_volumetric_fog_albedo(Color p_color) {
  775. volumetric_fog_albedo = p_color;
  776. _update_volumetric_fog();
  777. }
  778. Color Environment::get_volumetric_fog_albedo() const {
  779. return volumetric_fog_albedo;
  780. }
  781. void Environment::set_volumetric_fog_emission(Color p_color) {
  782. volumetric_fog_emission = p_color;
  783. _update_volumetric_fog();
  784. }
  785. Color Environment::get_volumetric_fog_emission() const {
  786. return volumetric_fog_emission;
  787. }
  788. void Environment::set_volumetric_fog_emission_energy(float p_begin) {
  789. volumetric_fog_emission_energy = p_begin;
  790. _update_volumetric_fog();
  791. }
  792. float Environment::get_volumetric_fog_emission_energy() const {
  793. return volumetric_fog_emission_energy;
  794. }
  795. void Environment::set_volumetric_fog_anisotropy(float p_anisotropy) {
  796. volumetric_fog_anisotropy = p_anisotropy;
  797. _update_volumetric_fog();
  798. }
  799. float Environment::get_volumetric_fog_anisotropy() const {
  800. return volumetric_fog_anisotropy;
  801. }
  802. void Environment::set_volumetric_fog_length(float p_length) {
  803. volumetric_fog_length = p_length;
  804. _update_volumetric_fog();
  805. }
  806. float Environment::get_volumetric_fog_length() const {
  807. return volumetric_fog_length;
  808. }
  809. void Environment::set_volumetric_fog_detail_spread(float p_detail_spread) {
  810. p_detail_spread = CLAMP(p_detail_spread, 0.5, 6.0);
  811. volumetric_fog_detail_spread = p_detail_spread;
  812. _update_volumetric_fog();
  813. }
  814. float Environment::get_volumetric_fog_detail_spread() const {
  815. return volumetric_fog_detail_spread;
  816. }
  817. void Environment::set_volumetric_fog_gi_inject(float p_gi_inject) {
  818. volumetric_fog_gi_inject = p_gi_inject;
  819. _update_volumetric_fog();
  820. }
  821. float Environment::get_volumetric_fog_gi_inject() const {
  822. return volumetric_fog_gi_inject;
  823. }
  824. void Environment::set_volumetric_fog_ambient_inject(float p_ambient_inject) {
  825. volumetric_fog_ambient_inject = p_ambient_inject;
  826. _update_volumetric_fog();
  827. }
  828. float Environment::get_volumetric_fog_ambient_inject() const {
  829. return volumetric_fog_ambient_inject;
  830. }
  831. void Environment::set_volumetric_fog_sky_affect(float p_sky_affect) {
  832. volumetric_fog_sky_affect = p_sky_affect;
  833. _update_volumetric_fog();
  834. }
  835. float Environment::get_volumetric_fog_sky_affect() const {
  836. return volumetric_fog_sky_affect;
  837. }
  838. void Environment::set_volumetric_fog_temporal_reprojection_enabled(bool p_enable) {
  839. volumetric_fog_temporal_reproject = p_enable;
  840. _update_volumetric_fog();
  841. }
  842. bool Environment::is_volumetric_fog_temporal_reprojection_enabled() const {
  843. return volumetric_fog_temporal_reproject;
  844. }
  845. void Environment::set_volumetric_fog_temporal_reprojection_amount(float p_amount) {
  846. volumetric_fog_temporal_reproject_amount = p_amount;
  847. _update_volumetric_fog();
  848. }
  849. float Environment::get_volumetric_fog_temporal_reprojection_amount() const {
  850. return volumetric_fog_temporal_reproject_amount;
  851. }
  852. // Adjustment
  853. void Environment::set_adjustment_enabled(bool p_enabled) {
  854. adjustment_enabled = p_enabled;
  855. _update_adjustment();
  856. }
  857. bool Environment::is_adjustment_enabled() const {
  858. return adjustment_enabled;
  859. }
  860. void Environment::set_adjustment_brightness(float p_brightness) {
  861. adjustment_brightness = p_brightness;
  862. _update_adjustment();
  863. }
  864. float Environment::get_adjustment_brightness() const {
  865. return adjustment_brightness;
  866. }
  867. void Environment::set_adjustment_contrast(float p_contrast) {
  868. adjustment_contrast = p_contrast;
  869. _update_adjustment();
  870. }
  871. float Environment::get_adjustment_contrast() const {
  872. return adjustment_contrast;
  873. }
  874. void Environment::set_adjustment_saturation(float p_saturation) {
  875. adjustment_saturation = p_saturation;
  876. _update_adjustment();
  877. }
  878. float Environment::get_adjustment_saturation() const {
  879. return adjustment_saturation;
  880. }
  881. void Environment::set_adjustment_color_correction(Ref<Texture> p_color_correction) {
  882. adjustment_color_correction = p_color_correction;
  883. Ref<GradientTexture1D> grad_tex = p_color_correction;
  884. if (grad_tex.is_valid()) {
  885. grad_tex->connect_changed(callable_mp(this, &Environment::_update_adjustment));
  886. }
  887. Ref<Texture2D> adjustment_texture_2d = adjustment_color_correction;
  888. if (adjustment_texture_2d.is_valid()) {
  889. use_1d_color_correction = true;
  890. } else {
  891. use_1d_color_correction = false;
  892. }
  893. _update_adjustment();
  894. }
  895. Ref<Texture> Environment::get_adjustment_color_correction() const {
  896. return adjustment_color_correction;
  897. }
  898. void Environment::_update_adjustment() {
  899. RID color_correction = adjustment_color_correction.is_valid() ? adjustment_color_correction->get_rid() : RID();
  900. RS::get_singleton()->environment_set_adjustment(
  901. environment,
  902. adjustment_enabled,
  903. adjustment_brightness,
  904. adjustment_contrast,
  905. adjustment_saturation,
  906. use_1d_color_correction,
  907. color_correction);
  908. }
  909. // Private methods, constructor and destructor
  910. void Environment::_validate_property(PropertyInfo &p_property) const {
  911. if (!Engine::get_singleton()->is_editor_hint()) {
  912. return;
  913. }
  914. if (p_property.name == "sky" || p_property.name == "sky_custom_fov" || p_property.name == "sky_rotation" || p_property.name == "ambient_light_sky_contribution") {
  915. if (bg_mode != BG_SKY && ambient_source != AMBIENT_SOURCE_SKY && reflection_source != REFLECTION_SOURCE_SKY) {
  916. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  917. }
  918. }
  919. if (p_property.name == "fog_depth_curve" || p_property.name == "fog_depth_begin" || p_property.name == "fog_depth_end") {
  920. if (fog_mode == FOG_MODE_EXPONENTIAL) {
  921. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  922. }
  923. }
  924. if (p_property.name == "ambient_light_color" || p_property.name == "ambient_light_energy") {
  925. if (ambient_source == AMBIENT_SOURCE_DISABLED) {
  926. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  927. }
  928. }
  929. if (p_property.name == "ambient_light_sky_contribution") {
  930. if (ambient_source == AMBIENT_SOURCE_DISABLED || ambient_source == AMBIENT_SOURCE_COLOR) {
  931. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  932. }
  933. }
  934. if (p_property.name == "fog_aerial_perspective") {
  935. if (bg_mode != BG_SKY) {
  936. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  937. }
  938. }
  939. if (p_property.name == "tonemap_white" && (tone_mapper == TONE_MAPPER_LINEAR || tone_mapper == TONE_MAPPER_AGX)) {
  940. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  941. }
  942. if (p_property.name == "tonemap_agx_white" && tone_mapper != TONE_MAPPER_AGX) {
  943. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  944. }
  945. if (p_property.name == "tonemap_agx_contrast" && tone_mapper != TONE_MAPPER_AGX) {
  946. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  947. }
  948. if (p_property.name == "glow_intensity" && glow_blend_mode == GLOW_BLEND_MODE_MIX && OS::get_singleton()->get_current_rendering_method() != "gl_compatibility") {
  949. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  950. }
  951. if (OS::get_singleton()->get_current_rendering_method() == "gl_compatibility") {
  952. // Hide glow properties we do not support in GL Compatibility.
  953. if (p_property.name.begins_with("glow_levels") || p_property.name == "glow_normalized" || p_property.name == "glow_strength" || p_property.name == "glow_mix" || p_property.name == "glow_blend_mode" || p_property.name == "glow_map_strength" || p_property.name == "glow_map") {
  954. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  955. }
  956. } else {
  957. if (p_property.name == "glow_mix" && glow_blend_mode != GLOW_BLEND_MODE_MIX) {
  958. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  959. }
  960. }
  961. if (OS::get_singleton()->get_current_rendering_method() != "forward_plus") {
  962. // Hide SSAO properties that only work in Forward+.
  963. if (p_property.name.begins_with("ssao_")) {
  964. if ((p_property.name != "ssao_enabled") && (p_property.name != "ssao_radius") && (p_property.name != "ssao_intensity")) {
  965. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  966. }
  967. }
  968. }
  969. if (p_property.name == "background_color") {
  970. if (bg_mode != BG_COLOR && ambient_source != AMBIENT_SOURCE_COLOR) {
  971. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  972. }
  973. }
  974. if (p_property.name == "background_canvas_max_layer") {
  975. if (bg_mode != BG_CANVAS) {
  976. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  977. }
  978. }
  979. if (p_property.name == "background_camera_feed_id") {
  980. if (bg_mode != BG_CAMERA_FEED) {
  981. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  982. }
  983. }
  984. if (p_property.name == "background_intensity" && !GLOBAL_GET_CACHED(bool, "rendering/lights_and_shadows/use_physical_light_units")) {
  985. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  986. }
  987. }
  988. #ifndef DISABLE_DEPRECATED
  989. // Kept for compatibility from 3.x to 4.0.
  990. bool Environment::_set(const StringName &p_name, const Variant &p_value) {
  991. if (p_name == "background_sky") {
  992. set_sky(p_value);
  993. return true;
  994. } else if (p_name == "background_sky_custom_fov") {
  995. set_sky_custom_fov(p_value);
  996. return true;
  997. } else if (p_name == "background_sky_orientation") {
  998. Vector3 euler = p_value.operator Basis().get_euler();
  999. set_sky_rotation(euler);
  1000. return true;
  1001. } else {
  1002. return false;
  1003. }
  1004. }
  1005. #endif
  1006. void Environment::_bind_methods() {
  1007. // Background
  1008. ClassDB::bind_method(D_METHOD("set_background", "mode"), &Environment::set_background);
  1009. ClassDB::bind_method(D_METHOD("get_background"), &Environment::get_background);
  1010. ClassDB::bind_method(D_METHOD("set_sky", "sky"), &Environment::set_sky);
  1011. ClassDB::bind_method(D_METHOD("get_sky"), &Environment::get_sky);
  1012. ClassDB::bind_method(D_METHOD("set_sky_custom_fov", "scale"), &Environment::set_sky_custom_fov);
  1013. ClassDB::bind_method(D_METHOD("get_sky_custom_fov"), &Environment::get_sky_custom_fov);
  1014. ClassDB::bind_method(D_METHOD("set_sky_rotation", "euler_radians"), &Environment::set_sky_rotation);
  1015. ClassDB::bind_method(D_METHOD("get_sky_rotation"), &Environment::get_sky_rotation);
  1016. ClassDB::bind_method(D_METHOD("set_bg_color", "color"), &Environment::set_bg_color);
  1017. ClassDB::bind_method(D_METHOD("get_bg_color"), &Environment::get_bg_color);
  1018. ClassDB::bind_method(D_METHOD("set_bg_energy_multiplier", "energy"), &Environment::set_bg_energy_multiplier);
  1019. ClassDB::bind_method(D_METHOD("get_bg_energy_multiplier"), &Environment::get_bg_energy_multiplier);
  1020. ClassDB::bind_method(D_METHOD("set_bg_intensity", "energy"), &Environment::set_bg_intensity);
  1021. ClassDB::bind_method(D_METHOD("get_bg_intensity"), &Environment::get_bg_intensity);
  1022. ClassDB::bind_method(D_METHOD("set_canvas_max_layer", "layer"), &Environment::set_canvas_max_layer);
  1023. ClassDB::bind_method(D_METHOD("get_canvas_max_layer"), &Environment::get_canvas_max_layer);
  1024. ClassDB::bind_method(D_METHOD("set_camera_feed_id", "id"), &Environment::set_camera_feed_id);
  1025. ClassDB::bind_method(D_METHOD("get_camera_feed_id"), &Environment::get_camera_feed_id);
  1026. ADD_GROUP("Background", "background_");
  1027. ADD_PROPERTY(PropertyInfo(Variant::INT, "background_mode", PROPERTY_HINT_ENUM, "Clear Color,Custom Color,Sky,Canvas,Keep,Camera Feed"), "set_background", "get_background");
  1028. ADD_PROPERTY(PropertyInfo(Variant::COLOR, "background_color"), "set_bg_color", "get_bg_color");
  1029. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "background_energy_multiplier", PROPERTY_HINT_RANGE, "0,16,0.01"), "set_bg_energy_multiplier", "get_bg_energy_multiplier");
  1030. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "background_intensity", PROPERTY_HINT_RANGE, "0,100000,0.01,suffix:nt"), "set_bg_intensity", "get_bg_intensity");
  1031. ADD_PROPERTY(PropertyInfo(Variant::INT, "background_canvas_max_layer", PROPERTY_HINT_RANGE, "-1000,1000,1"), "set_canvas_max_layer", "get_canvas_max_layer");
  1032. ADD_PROPERTY(PropertyInfo(Variant::INT, "background_camera_feed_id", PROPERTY_HINT_RANGE, "1,10,1"), "set_camera_feed_id", "get_camera_feed_id");
  1033. ADD_GROUP("Sky", "sky_");
  1034. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "sky", PROPERTY_HINT_RESOURCE_TYPE, "Sky"), "set_sky", "get_sky");
  1035. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "sky_custom_fov", PROPERTY_HINT_RANGE, "0,180,0.1,degrees"), "set_sky_custom_fov", "get_sky_custom_fov");
  1036. ADD_PROPERTY(PropertyInfo(Variant::VECTOR3, "sky_rotation", PROPERTY_HINT_RANGE, "-360,360,0.1,or_less,or_greater,radians_as_degrees"), "set_sky_rotation", "get_sky_rotation");
  1037. // Ambient light
  1038. ClassDB::bind_method(D_METHOD("set_ambient_light_color", "color"), &Environment::set_ambient_light_color);
  1039. ClassDB::bind_method(D_METHOD("get_ambient_light_color"), &Environment::get_ambient_light_color);
  1040. ClassDB::bind_method(D_METHOD("set_ambient_source", "source"), &Environment::set_ambient_source);
  1041. ClassDB::bind_method(D_METHOD("get_ambient_source"), &Environment::get_ambient_source);
  1042. ClassDB::bind_method(D_METHOD("set_ambient_light_energy", "energy"), &Environment::set_ambient_light_energy);
  1043. ClassDB::bind_method(D_METHOD("get_ambient_light_energy"), &Environment::get_ambient_light_energy);
  1044. ClassDB::bind_method(D_METHOD("set_ambient_light_sky_contribution", "ratio"), &Environment::set_ambient_light_sky_contribution);
  1045. ClassDB::bind_method(D_METHOD("get_ambient_light_sky_contribution"), &Environment::get_ambient_light_sky_contribution);
  1046. ClassDB::bind_method(D_METHOD("set_reflection_source", "source"), &Environment::set_reflection_source);
  1047. ClassDB::bind_method(D_METHOD("get_reflection_source"), &Environment::get_reflection_source);
  1048. ADD_GROUP("Ambient Light", "ambient_light_");
  1049. ADD_PROPERTY(PropertyInfo(Variant::INT, "ambient_light_source", PROPERTY_HINT_ENUM, "Background,Disabled,Color,Sky"), "set_ambient_source", "get_ambient_source");
  1050. ADD_PROPERTY(PropertyInfo(Variant::COLOR, "ambient_light_color"), "set_ambient_light_color", "get_ambient_light_color");
  1051. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ambient_light_sky_contribution", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_ambient_light_sky_contribution", "get_ambient_light_sky_contribution");
  1052. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ambient_light_energy", PROPERTY_HINT_RANGE, "0,16,0.01"), "set_ambient_light_energy", "get_ambient_light_energy");
  1053. ADD_GROUP("Reflected Light", "reflected_light_");
  1054. ADD_PROPERTY(PropertyInfo(Variant::INT, "reflected_light_source", PROPERTY_HINT_ENUM, "Background,Disabled,Sky"), "set_reflection_source", "get_reflection_source");
  1055. // Tonemap
  1056. ClassDB::bind_method(D_METHOD("set_tonemapper", "mode"), &Environment::set_tonemapper);
  1057. ClassDB::bind_method(D_METHOD("get_tonemapper"), &Environment::get_tonemapper);
  1058. ClassDB::bind_method(D_METHOD("set_tonemap_exposure", "exposure"), &Environment::set_tonemap_exposure);
  1059. ClassDB::bind_method(D_METHOD("get_tonemap_exposure"), &Environment::get_tonemap_exposure);
  1060. ClassDB::bind_method(D_METHOD("set_tonemap_white", "white"), &Environment::set_tonemap_white);
  1061. ClassDB::bind_method(D_METHOD("get_tonemap_white"), &Environment::get_tonemap_white);
  1062. ClassDB::bind_method(D_METHOD("set_tonemap_agx_white", "white"), &Environment::set_tonemap_agx_white);
  1063. ClassDB::bind_method(D_METHOD("get_tonemap_agx_white"), &Environment::get_tonemap_agx_white);
  1064. ClassDB::bind_method(D_METHOD("set_tonemap_agx_contrast", "contrast"), &Environment::set_tonemap_agx_contrast);
  1065. ClassDB::bind_method(D_METHOD("get_tonemap_agx_contrast"), &Environment::get_tonemap_agx_contrast);
  1066. ADD_GROUP("Tonemap", "tonemap_");
  1067. ADD_PROPERTY(PropertyInfo(Variant::INT, "tonemap_mode", PROPERTY_HINT_ENUM, "Linear,Reinhard,Filmic,ACES,AgX"), "set_tonemapper", "get_tonemapper");
  1068. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "tonemap_exposure", PROPERTY_HINT_RANGE, "0,4,0.01,or_greater"), "set_tonemap_exposure", "get_tonemap_exposure");
  1069. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "tonemap_white", PROPERTY_HINT_RANGE, "1,16,0.01,or_greater"), "set_tonemap_white", "get_tonemap_white");
  1070. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "tonemap_agx_white", PROPERTY_HINT_RANGE, "2,16.5,0.01,or_greater"), "set_tonemap_agx_white", "get_tonemap_agx_white");
  1071. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "tonemap_agx_contrast", PROPERTY_HINT_RANGE, "1.0,2.0,0.01,or_greater"), "set_tonemap_agx_contrast", "get_tonemap_agx_contrast");
  1072. // SSR
  1073. ClassDB::bind_method(D_METHOD("set_ssr_enabled", "enabled"), &Environment::set_ssr_enabled);
  1074. ClassDB::bind_method(D_METHOD("is_ssr_enabled"), &Environment::is_ssr_enabled);
  1075. ClassDB::bind_method(D_METHOD("set_ssr_max_steps", "max_steps"), &Environment::set_ssr_max_steps);
  1076. ClassDB::bind_method(D_METHOD("get_ssr_max_steps"), &Environment::get_ssr_max_steps);
  1077. ClassDB::bind_method(D_METHOD("set_ssr_fade_in", "fade_in"), &Environment::set_ssr_fade_in);
  1078. ClassDB::bind_method(D_METHOD("get_ssr_fade_in"), &Environment::get_ssr_fade_in);
  1079. ClassDB::bind_method(D_METHOD("set_ssr_fade_out", "fade_out"), &Environment::set_ssr_fade_out);
  1080. ClassDB::bind_method(D_METHOD("get_ssr_fade_out"), &Environment::get_ssr_fade_out);
  1081. ClassDB::bind_method(D_METHOD("set_ssr_depth_tolerance", "depth_tolerance"), &Environment::set_ssr_depth_tolerance);
  1082. ClassDB::bind_method(D_METHOD("get_ssr_depth_tolerance"), &Environment::get_ssr_depth_tolerance);
  1083. ADD_GROUP("SSR", "ssr_");
  1084. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "ssr_enabled", PROPERTY_HINT_GROUP_ENABLE), "set_ssr_enabled", "is_ssr_enabled");
  1085. ADD_PROPERTY(PropertyInfo(Variant::INT, "ssr_max_steps", PROPERTY_HINT_RANGE, "32,512,1"), "set_ssr_max_steps", "get_ssr_max_steps");
  1086. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssr_fade_in", PROPERTY_HINT_EXP_EASING, "positive_only"), "set_ssr_fade_in", "get_ssr_fade_in");
  1087. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssr_fade_out", PROPERTY_HINT_EXP_EASING, "positive_only"), "set_ssr_fade_out", "get_ssr_fade_out");
  1088. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssr_depth_tolerance", PROPERTY_HINT_RANGE, "0.01,128,0.1"), "set_ssr_depth_tolerance", "get_ssr_depth_tolerance");
  1089. // SSAO
  1090. ClassDB::bind_method(D_METHOD("set_ssao_enabled", "enabled"), &Environment::set_ssao_enabled);
  1091. ClassDB::bind_method(D_METHOD("is_ssao_enabled"), &Environment::is_ssao_enabled);
  1092. ClassDB::bind_method(D_METHOD("set_ssao_radius", "radius"), &Environment::set_ssao_radius);
  1093. ClassDB::bind_method(D_METHOD("get_ssao_radius"), &Environment::get_ssao_radius);
  1094. ClassDB::bind_method(D_METHOD("set_ssao_intensity", "intensity"), &Environment::set_ssao_intensity);
  1095. ClassDB::bind_method(D_METHOD("get_ssao_intensity"), &Environment::get_ssao_intensity);
  1096. ClassDB::bind_method(D_METHOD("set_ssao_power", "power"), &Environment::set_ssao_power);
  1097. ClassDB::bind_method(D_METHOD("get_ssao_power"), &Environment::get_ssao_power);
  1098. ClassDB::bind_method(D_METHOD("set_ssao_detail", "detail"), &Environment::set_ssao_detail);
  1099. ClassDB::bind_method(D_METHOD("get_ssao_detail"), &Environment::get_ssao_detail);
  1100. ClassDB::bind_method(D_METHOD("set_ssao_horizon", "horizon"), &Environment::set_ssao_horizon);
  1101. ClassDB::bind_method(D_METHOD("get_ssao_horizon"), &Environment::get_ssao_horizon);
  1102. ClassDB::bind_method(D_METHOD("set_ssao_sharpness", "sharpness"), &Environment::set_ssao_sharpness);
  1103. ClassDB::bind_method(D_METHOD("get_ssao_sharpness"), &Environment::get_ssao_sharpness);
  1104. ClassDB::bind_method(D_METHOD("set_ssao_direct_light_affect", "amount"), &Environment::set_ssao_direct_light_affect);
  1105. ClassDB::bind_method(D_METHOD("get_ssao_direct_light_affect"), &Environment::get_ssao_direct_light_affect);
  1106. ClassDB::bind_method(D_METHOD("set_ssao_ao_channel_affect", "amount"), &Environment::set_ssao_ao_channel_affect);
  1107. ClassDB::bind_method(D_METHOD("get_ssao_ao_channel_affect"), &Environment::get_ssao_ao_channel_affect);
  1108. ADD_GROUP("SSAO", "ssao_");
  1109. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "ssao_enabled", PROPERTY_HINT_GROUP_ENABLE), "set_ssao_enabled", "is_ssao_enabled");
  1110. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssao_radius", PROPERTY_HINT_RANGE, "0.01,16,0.01,or_greater"), "set_ssao_radius", "get_ssao_radius");
  1111. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssao_intensity", PROPERTY_HINT_RANGE, "0,16,0.01,or_greater"), "set_ssao_intensity", "get_ssao_intensity");
  1112. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssao_power", PROPERTY_HINT_EXP_EASING, "positive_only"), "set_ssao_power", "get_ssao_power");
  1113. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssao_detail", PROPERTY_HINT_RANGE, "0,5,0.01"), "set_ssao_detail", "get_ssao_detail");
  1114. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssao_horizon", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_ssao_horizon", "get_ssao_horizon");
  1115. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssao_sharpness", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_ssao_sharpness", "get_ssao_sharpness");
  1116. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssao_light_affect", PROPERTY_HINT_RANGE, "0.00,1,0.01"), "set_ssao_direct_light_affect", "get_ssao_direct_light_affect");
  1117. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssao_ao_channel_affect", PROPERTY_HINT_RANGE, "0.00,1,0.01"), "set_ssao_ao_channel_affect", "get_ssao_ao_channel_affect");
  1118. // SSIL
  1119. ClassDB::bind_method(D_METHOD("set_ssil_enabled", "enabled"), &Environment::set_ssil_enabled);
  1120. ClassDB::bind_method(D_METHOD("is_ssil_enabled"), &Environment::is_ssil_enabled);
  1121. ClassDB::bind_method(D_METHOD("set_ssil_radius", "radius"), &Environment::set_ssil_radius);
  1122. ClassDB::bind_method(D_METHOD("get_ssil_radius"), &Environment::get_ssil_radius);
  1123. ClassDB::bind_method(D_METHOD("set_ssil_intensity", "intensity"), &Environment::set_ssil_intensity);
  1124. ClassDB::bind_method(D_METHOD("get_ssil_intensity"), &Environment::get_ssil_intensity);
  1125. ClassDB::bind_method(D_METHOD("set_ssil_sharpness", "sharpness"), &Environment::set_ssil_sharpness);
  1126. ClassDB::bind_method(D_METHOD("get_ssil_sharpness"), &Environment::get_ssil_sharpness);
  1127. ClassDB::bind_method(D_METHOD("set_ssil_normal_rejection", "normal_rejection"), &Environment::set_ssil_normal_rejection);
  1128. ClassDB::bind_method(D_METHOD("get_ssil_normal_rejection"), &Environment::get_ssil_normal_rejection);
  1129. ADD_GROUP("SSIL", "ssil_");
  1130. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "ssil_enabled", PROPERTY_HINT_GROUP_ENABLE), "set_ssil_enabled", "is_ssil_enabled");
  1131. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssil_radius", PROPERTY_HINT_RANGE, "0.01,16,0.01,or_greater,suffix:m"), "set_ssil_radius", "get_ssil_radius");
  1132. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssil_intensity", PROPERTY_HINT_RANGE, "0,16,0.01,or_greater"), "set_ssil_intensity", "get_ssil_intensity");
  1133. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssil_sharpness", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_ssil_sharpness", "get_ssil_sharpness");
  1134. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "ssil_normal_rejection", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_ssil_normal_rejection", "get_ssil_normal_rejection");
  1135. // SDFGI
  1136. ClassDB::bind_method(D_METHOD("set_sdfgi_enabled", "enabled"), &Environment::set_sdfgi_enabled);
  1137. ClassDB::bind_method(D_METHOD("is_sdfgi_enabled"), &Environment::is_sdfgi_enabled);
  1138. ClassDB::bind_method(D_METHOD("set_sdfgi_cascades", "amount"), &Environment::set_sdfgi_cascades);
  1139. ClassDB::bind_method(D_METHOD("get_sdfgi_cascades"), &Environment::get_sdfgi_cascades);
  1140. ClassDB::bind_method(D_METHOD("set_sdfgi_min_cell_size", "size"), &Environment::set_sdfgi_min_cell_size);
  1141. ClassDB::bind_method(D_METHOD("get_sdfgi_min_cell_size"), &Environment::get_sdfgi_min_cell_size);
  1142. ClassDB::bind_method(D_METHOD("set_sdfgi_max_distance", "distance"), &Environment::set_sdfgi_max_distance);
  1143. ClassDB::bind_method(D_METHOD("get_sdfgi_max_distance"), &Environment::get_sdfgi_max_distance);
  1144. ClassDB::bind_method(D_METHOD("set_sdfgi_cascade0_distance", "distance"), &Environment::set_sdfgi_cascade0_distance);
  1145. ClassDB::bind_method(D_METHOD("get_sdfgi_cascade0_distance"), &Environment::get_sdfgi_cascade0_distance);
  1146. ClassDB::bind_method(D_METHOD("set_sdfgi_y_scale", "scale"), &Environment::set_sdfgi_y_scale);
  1147. ClassDB::bind_method(D_METHOD("get_sdfgi_y_scale"), &Environment::get_sdfgi_y_scale);
  1148. ClassDB::bind_method(D_METHOD("set_sdfgi_use_occlusion", "enable"), &Environment::set_sdfgi_use_occlusion);
  1149. ClassDB::bind_method(D_METHOD("is_sdfgi_using_occlusion"), &Environment::is_sdfgi_using_occlusion);
  1150. ClassDB::bind_method(D_METHOD("set_sdfgi_bounce_feedback", "amount"), &Environment::set_sdfgi_bounce_feedback);
  1151. ClassDB::bind_method(D_METHOD("get_sdfgi_bounce_feedback"), &Environment::get_sdfgi_bounce_feedback);
  1152. ClassDB::bind_method(D_METHOD("set_sdfgi_read_sky_light", "enable"), &Environment::set_sdfgi_read_sky_light);
  1153. ClassDB::bind_method(D_METHOD("is_sdfgi_reading_sky_light"), &Environment::is_sdfgi_reading_sky_light);
  1154. ClassDB::bind_method(D_METHOD("set_sdfgi_energy", "amount"), &Environment::set_sdfgi_energy);
  1155. ClassDB::bind_method(D_METHOD("get_sdfgi_energy"), &Environment::get_sdfgi_energy);
  1156. ClassDB::bind_method(D_METHOD("set_sdfgi_normal_bias", "bias"), &Environment::set_sdfgi_normal_bias);
  1157. ClassDB::bind_method(D_METHOD("get_sdfgi_normal_bias"), &Environment::get_sdfgi_normal_bias);
  1158. ClassDB::bind_method(D_METHOD("set_sdfgi_probe_bias", "bias"), &Environment::set_sdfgi_probe_bias);
  1159. ClassDB::bind_method(D_METHOD("get_sdfgi_probe_bias"), &Environment::get_sdfgi_probe_bias);
  1160. ADD_GROUP("SDFGI", "sdfgi_");
  1161. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "sdfgi_enabled", PROPERTY_HINT_GROUP_ENABLE), "set_sdfgi_enabled", "is_sdfgi_enabled");
  1162. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "sdfgi_use_occlusion"), "set_sdfgi_use_occlusion", "is_sdfgi_using_occlusion");
  1163. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "sdfgi_read_sky_light"), "set_sdfgi_read_sky_light", "is_sdfgi_reading_sky_light");
  1164. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "sdfgi_bounce_feedback", PROPERTY_HINT_RANGE, "0,1.99,0.01"), "set_sdfgi_bounce_feedback", "get_sdfgi_bounce_feedback");
  1165. ADD_PROPERTY(PropertyInfo(Variant::INT, "sdfgi_cascades", PROPERTY_HINT_RANGE, "1,8,1"), "set_sdfgi_cascades", "get_sdfgi_cascades");
  1166. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "sdfgi_min_cell_size", PROPERTY_HINT_RANGE, "0.01,64,0.01"), "set_sdfgi_min_cell_size", "get_sdfgi_min_cell_size");
  1167. // Don't store the values of `sdfgi_cascade0_distance` and `sdfgi_max_distance`
  1168. // as they're derived from `sdfgi_min_cell_size`.
  1169. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "sdfgi_cascade0_distance", PROPERTY_HINT_RANGE, "0.1,16384,0.1,or_greater", PROPERTY_USAGE_EDITOR), "set_sdfgi_cascade0_distance", "get_sdfgi_cascade0_distance");
  1170. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "sdfgi_max_distance", PROPERTY_HINT_RANGE, "0.1,16384,0.1,or_greater", PROPERTY_USAGE_EDITOR), "set_sdfgi_max_distance", "get_sdfgi_max_distance");
  1171. ADD_PROPERTY(PropertyInfo(Variant::INT, "sdfgi_y_scale", PROPERTY_HINT_ENUM, "50% (Compact),75% (Balanced),100% (Sparse)"), "set_sdfgi_y_scale", "get_sdfgi_y_scale");
  1172. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "sdfgi_energy"), "set_sdfgi_energy", "get_sdfgi_energy");
  1173. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "sdfgi_normal_bias"), "set_sdfgi_normal_bias", "get_sdfgi_normal_bias");
  1174. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "sdfgi_probe_bias"), "set_sdfgi_probe_bias", "get_sdfgi_probe_bias");
  1175. // Glow
  1176. ClassDB::bind_method(D_METHOD("set_glow_enabled", "enabled"), &Environment::set_glow_enabled);
  1177. ClassDB::bind_method(D_METHOD("is_glow_enabled"), &Environment::is_glow_enabled);
  1178. ClassDB::bind_method(D_METHOD("set_glow_level", "idx", "intensity"), &Environment::set_glow_level);
  1179. ClassDB::bind_method(D_METHOD("get_glow_level", "idx"), &Environment::get_glow_level);
  1180. ClassDB::bind_method(D_METHOD("set_glow_normalized", "normalize"), &Environment::set_glow_normalized);
  1181. ClassDB::bind_method(D_METHOD("is_glow_normalized"), &Environment::is_glow_normalized);
  1182. ClassDB::bind_method(D_METHOD("set_glow_intensity", "intensity"), &Environment::set_glow_intensity);
  1183. ClassDB::bind_method(D_METHOD("get_glow_intensity"), &Environment::get_glow_intensity);
  1184. ClassDB::bind_method(D_METHOD("set_glow_strength", "strength"), &Environment::set_glow_strength);
  1185. ClassDB::bind_method(D_METHOD("get_glow_strength"), &Environment::get_glow_strength);
  1186. ClassDB::bind_method(D_METHOD("set_glow_mix", "mix"), &Environment::set_glow_mix);
  1187. ClassDB::bind_method(D_METHOD("get_glow_mix"), &Environment::get_glow_mix);
  1188. ClassDB::bind_method(D_METHOD("set_glow_bloom", "amount"), &Environment::set_glow_bloom);
  1189. ClassDB::bind_method(D_METHOD("get_glow_bloom"), &Environment::get_glow_bloom);
  1190. ClassDB::bind_method(D_METHOD("set_glow_blend_mode", "mode"), &Environment::set_glow_blend_mode);
  1191. ClassDB::bind_method(D_METHOD("get_glow_blend_mode"), &Environment::get_glow_blend_mode);
  1192. ClassDB::bind_method(D_METHOD("set_glow_hdr_bleed_threshold", "threshold"), &Environment::set_glow_hdr_bleed_threshold);
  1193. ClassDB::bind_method(D_METHOD("get_glow_hdr_bleed_threshold"), &Environment::get_glow_hdr_bleed_threshold);
  1194. ClassDB::bind_method(D_METHOD("set_glow_hdr_bleed_scale", "scale"), &Environment::set_glow_hdr_bleed_scale);
  1195. ClassDB::bind_method(D_METHOD("get_glow_hdr_bleed_scale"), &Environment::get_glow_hdr_bleed_scale);
  1196. ClassDB::bind_method(D_METHOD("set_glow_hdr_luminance_cap", "amount"), &Environment::set_glow_hdr_luminance_cap);
  1197. ClassDB::bind_method(D_METHOD("get_glow_hdr_luminance_cap"), &Environment::get_glow_hdr_luminance_cap);
  1198. ClassDB::bind_method(D_METHOD("set_glow_map_strength", "strength"), &Environment::set_glow_map_strength);
  1199. ClassDB::bind_method(D_METHOD("get_glow_map_strength"), &Environment::get_glow_map_strength);
  1200. ClassDB::bind_method(D_METHOD("set_glow_map", "mode"), &Environment::set_glow_map);
  1201. ClassDB::bind_method(D_METHOD("get_glow_map"), &Environment::get_glow_map);
  1202. ADD_GROUP("Glow", "glow_");
  1203. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "glow_enabled", PROPERTY_HINT_GROUP_ENABLE), "set_glow_enabled", "is_glow_enabled");
  1204. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "glow_levels/1", PROPERTY_HINT_RANGE, "0,16,0.01,or_greater"), "set_glow_level", "get_glow_level", 0);
  1205. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "glow_levels/2", PROPERTY_HINT_RANGE, "0,16,0.01,or_greater"), "set_glow_level", "get_glow_level", 1);
  1206. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "glow_levels/3", PROPERTY_HINT_RANGE, "0,16,0.01,or_greater"), "set_glow_level", "get_glow_level", 2);
  1207. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "glow_levels/4", PROPERTY_HINT_RANGE, "0,16,0.01,or_greater"), "set_glow_level", "get_glow_level", 3);
  1208. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "glow_levels/5", PROPERTY_HINT_RANGE, "0,16,0.01,or_greater"), "set_glow_level", "get_glow_level", 4);
  1209. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "glow_levels/6", PROPERTY_HINT_RANGE, "0,16,0.01,or_greater"), "set_glow_level", "get_glow_level", 5);
  1210. ADD_PROPERTYI(PropertyInfo(Variant::FLOAT, "glow_levels/7", PROPERTY_HINT_RANGE, "0,16,0.01,or_greater"), "set_glow_level", "get_glow_level", 6);
  1211. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "glow_normalized"), "set_glow_normalized", "is_glow_normalized");
  1212. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "glow_intensity", PROPERTY_HINT_RANGE, "0.0,8.0,0.01"), "set_glow_intensity", "get_glow_intensity");
  1213. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "glow_strength", PROPERTY_HINT_RANGE, "0.0,2.0,0.01"), "set_glow_strength", "get_glow_strength");
  1214. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "glow_mix", PROPERTY_HINT_RANGE, "0.0,1.0,0.001"), "set_glow_mix", "get_glow_mix");
  1215. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "glow_bloom", PROPERTY_HINT_RANGE, "0.0,1.0,0.01"), "set_glow_bloom", "get_glow_bloom");
  1216. ADD_PROPERTY(PropertyInfo(Variant::INT, "glow_blend_mode", PROPERTY_HINT_ENUM, "Additive,Screen,Soft Light,Replace,Mix"), "set_glow_blend_mode", "get_glow_blend_mode");
  1217. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "glow_hdr_threshold", PROPERTY_HINT_RANGE, "0.0,4.0,0.01"), "set_glow_hdr_bleed_threshold", "get_glow_hdr_bleed_threshold");
  1218. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "glow_hdr_scale", PROPERTY_HINT_RANGE, "0.0,4.0,0.01"), "set_glow_hdr_bleed_scale", "get_glow_hdr_bleed_scale");
  1219. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "glow_hdr_luminance_cap", PROPERTY_HINT_RANGE, "0.0,256.0,0.01"), "set_glow_hdr_luminance_cap", "get_glow_hdr_luminance_cap");
  1220. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "glow_map_strength", PROPERTY_HINT_RANGE, "0.0,1.0,0.01"), "set_glow_map_strength", "get_glow_map_strength");
  1221. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "glow_map", PROPERTY_HINT_RESOURCE_TYPE, "Texture2D"), "set_glow_map", "get_glow_map");
  1222. // Fog
  1223. ClassDB::bind_method(D_METHOD("set_fog_enabled", "enabled"), &Environment::set_fog_enabled);
  1224. ClassDB::bind_method(D_METHOD("is_fog_enabled"), &Environment::is_fog_enabled);
  1225. ClassDB::bind_method(D_METHOD("set_fog_mode", "mode"), &Environment::set_fog_mode);
  1226. ClassDB::bind_method(D_METHOD("get_fog_mode"), &Environment::get_fog_mode);
  1227. ClassDB::bind_method(D_METHOD("set_fog_light_color", "light_color"), &Environment::set_fog_light_color);
  1228. ClassDB::bind_method(D_METHOD("get_fog_light_color"), &Environment::get_fog_light_color);
  1229. ClassDB::bind_method(D_METHOD("set_fog_light_energy", "light_energy"), &Environment::set_fog_light_energy);
  1230. ClassDB::bind_method(D_METHOD("get_fog_light_energy"), &Environment::get_fog_light_energy);
  1231. ClassDB::bind_method(D_METHOD("set_fog_sun_scatter", "sun_scatter"), &Environment::set_fog_sun_scatter);
  1232. ClassDB::bind_method(D_METHOD("get_fog_sun_scatter"), &Environment::get_fog_sun_scatter);
  1233. ClassDB::bind_method(D_METHOD("set_fog_density", "density"), &Environment::set_fog_density);
  1234. ClassDB::bind_method(D_METHOD("get_fog_density"), &Environment::get_fog_density);
  1235. ClassDB::bind_method(D_METHOD("set_fog_height", "height"), &Environment::set_fog_height);
  1236. ClassDB::bind_method(D_METHOD("get_fog_height"), &Environment::get_fog_height);
  1237. ClassDB::bind_method(D_METHOD("set_fog_height_density", "height_density"), &Environment::set_fog_height_density);
  1238. ClassDB::bind_method(D_METHOD("get_fog_height_density"), &Environment::get_fog_height_density);
  1239. ClassDB::bind_method(D_METHOD("set_fog_aerial_perspective", "aerial_perspective"), &Environment::set_fog_aerial_perspective);
  1240. ClassDB::bind_method(D_METHOD("get_fog_aerial_perspective"), &Environment::get_fog_aerial_perspective);
  1241. ClassDB::bind_method(D_METHOD("set_fog_sky_affect", "sky_affect"), &Environment::set_fog_sky_affect);
  1242. ClassDB::bind_method(D_METHOD("get_fog_sky_affect"), &Environment::get_fog_sky_affect);
  1243. ClassDB::bind_method(D_METHOD("set_fog_depth_curve", "curve"), &Environment::set_fog_depth_curve);
  1244. ClassDB::bind_method(D_METHOD("get_fog_depth_curve"), &Environment::get_fog_depth_curve);
  1245. ClassDB::bind_method(D_METHOD("set_fog_depth_begin", "begin"), &Environment::set_fog_depth_begin);
  1246. ClassDB::bind_method(D_METHOD("get_fog_depth_begin"), &Environment::get_fog_depth_begin);
  1247. ClassDB::bind_method(D_METHOD("set_fog_depth_end", "end"), &Environment::set_fog_depth_end);
  1248. ClassDB::bind_method(D_METHOD("get_fog_depth_end"), &Environment::get_fog_depth_end);
  1249. ADD_GROUP("Fog", "fog_");
  1250. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "fog_enabled", PROPERTY_HINT_GROUP_ENABLE), "set_fog_enabled", "is_fog_enabled");
  1251. ADD_PROPERTY(PropertyInfo(Variant::INT, "fog_mode", PROPERTY_HINT_ENUM, "Exponential,Depth"), "set_fog_mode", "get_fog_mode");
  1252. ADD_PROPERTY(PropertyInfo(Variant::COLOR, "fog_light_color", PROPERTY_HINT_COLOR_NO_ALPHA), "set_fog_light_color", "get_fog_light_color");
  1253. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fog_light_energy", PROPERTY_HINT_RANGE, "0,16,0.01,or_greater"), "set_fog_light_energy", "get_fog_light_energy");
  1254. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fog_sun_scatter", PROPERTY_HINT_RANGE, "0,1,0.01,or_greater"), "set_fog_sun_scatter", "get_fog_sun_scatter");
  1255. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fog_density", PROPERTY_HINT_RANGE, "0,1,0.0001,or_greater"), "set_fog_density", "get_fog_density");
  1256. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fog_aerial_perspective", PROPERTY_HINT_RANGE, "0,1,0.001"), "set_fog_aerial_perspective", "get_fog_aerial_perspective");
  1257. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fog_sky_affect", PROPERTY_HINT_RANGE, "0,1,0.001"), "set_fog_sky_affect", "get_fog_sky_affect");
  1258. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fog_height", PROPERTY_HINT_RANGE, "-1024,1024,0.01,or_less,or_greater,suffix:m"), "set_fog_height", "get_fog_height");
  1259. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fog_height_density", PROPERTY_HINT_RANGE, "-16,16,0.0001,or_less,or_greater"), "set_fog_height_density", "get_fog_height_density");
  1260. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fog_depth_curve", PROPERTY_HINT_EXP_EASING), "set_fog_depth_curve", "get_fog_depth_curve");
  1261. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fog_depth_begin", PROPERTY_HINT_RANGE, "0,4000,0.1,or_greater,or_less,suffix:m"), "set_fog_depth_begin", "get_fog_depth_begin");
  1262. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fog_depth_end", PROPERTY_HINT_RANGE, "0,4000,0.1,or_greater,or_less,suffix:m"), "set_fog_depth_end", "get_fog_depth_end");
  1263. ClassDB::bind_method(D_METHOD("set_volumetric_fog_enabled", "enabled"), &Environment::set_volumetric_fog_enabled);
  1264. ClassDB::bind_method(D_METHOD("is_volumetric_fog_enabled"), &Environment::is_volumetric_fog_enabled);
  1265. ClassDB::bind_method(D_METHOD("set_volumetric_fog_emission", "color"), &Environment::set_volumetric_fog_emission);
  1266. ClassDB::bind_method(D_METHOD("get_volumetric_fog_emission"), &Environment::get_volumetric_fog_emission);
  1267. ClassDB::bind_method(D_METHOD("set_volumetric_fog_albedo", "color"), &Environment::set_volumetric_fog_albedo);
  1268. ClassDB::bind_method(D_METHOD("get_volumetric_fog_albedo"), &Environment::get_volumetric_fog_albedo);
  1269. ClassDB::bind_method(D_METHOD("set_volumetric_fog_density", "density"), &Environment::set_volumetric_fog_density);
  1270. ClassDB::bind_method(D_METHOD("get_volumetric_fog_density"), &Environment::get_volumetric_fog_density);
  1271. ClassDB::bind_method(D_METHOD("set_volumetric_fog_emission_energy", "begin"), &Environment::set_volumetric_fog_emission_energy);
  1272. ClassDB::bind_method(D_METHOD("get_volumetric_fog_emission_energy"), &Environment::get_volumetric_fog_emission_energy);
  1273. ClassDB::bind_method(D_METHOD("set_volumetric_fog_anisotropy", "anisotropy"), &Environment::set_volumetric_fog_anisotropy);
  1274. ClassDB::bind_method(D_METHOD("get_volumetric_fog_anisotropy"), &Environment::get_volumetric_fog_anisotropy);
  1275. ClassDB::bind_method(D_METHOD("set_volumetric_fog_length", "length"), &Environment::set_volumetric_fog_length);
  1276. ClassDB::bind_method(D_METHOD("get_volumetric_fog_length"), &Environment::get_volumetric_fog_length);
  1277. ClassDB::bind_method(D_METHOD("set_volumetric_fog_detail_spread", "detail_spread"), &Environment::set_volumetric_fog_detail_spread);
  1278. ClassDB::bind_method(D_METHOD("get_volumetric_fog_detail_spread"), &Environment::get_volumetric_fog_detail_spread);
  1279. ClassDB::bind_method(D_METHOD("set_volumetric_fog_gi_inject", "gi_inject"), &Environment::set_volumetric_fog_gi_inject);
  1280. ClassDB::bind_method(D_METHOD("get_volumetric_fog_gi_inject"), &Environment::get_volumetric_fog_gi_inject);
  1281. ClassDB::bind_method(D_METHOD("set_volumetric_fog_ambient_inject", "enabled"), &Environment::set_volumetric_fog_ambient_inject);
  1282. ClassDB::bind_method(D_METHOD("get_volumetric_fog_ambient_inject"), &Environment::get_volumetric_fog_ambient_inject);
  1283. ClassDB::bind_method(D_METHOD("set_volumetric_fog_sky_affect", "sky_affect"), &Environment::set_volumetric_fog_sky_affect);
  1284. ClassDB::bind_method(D_METHOD("get_volumetric_fog_sky_affect"), &Environment::get_volumetric_fog_sky_affect);
  1285. ClassDB::bind_method(D_METHOD("set_volumetric_fog_temporal_reprojection_enabled", "enabled"), &Environment::set_volumetric_fog_temporal_reprojection_enabled);
  1286. ClassDB::bind_method(D_METHOD("is_volumetric_fog_temporal_reprojection_enabled"), &Environment::is_volumetric_fog_temporal_reprojection_enabled);
  1287. ClassDB::bind_method(D_METHOD("set_volumetric_fog_temporal_reprojection_amount", "temporal_reprojection_amount"), &Environment::set_volumetric_fog_temporal_reprojection_amount);
  1288. ClassDB::bind_method(D_METHOD("get_volumetric_fog_temporal_reprojection_amount"), &Environment::get_volumetric_fog_temporal_reprojection_amount);
  1289. ADD_GROUP("Volumetric Fog", "volumetric_fog_");
  1290. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "volumetric_fog_enabled", PROPERTY_HINT_GROUP_ENABLE), "set_volumetric_fog_enabled", "is_volumetric_fog_enabled");
  1291. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "volumetric_fog_density", PROPERTY_HINT_RANGE, "0,1,0.0001,or_greater"), "set_volumetric_fog_density", "get_volumetric_fog_density");
  1292. ADD_PROPERTY(PropertyInfo(Variant::COLOR, "volumetric_fog_albedo", PROPERTY_HINT_COLOR_NO_ALPHA), "set_volumetric_fog_albedo", "get_volumetric_fog_albedo");
  1293. ADD_PROPERTY(PropertyInfo(Variant::COLOR, "volumetric_fog_emission", PROPERTY_HINT_COLOR_NO_ALPHA), "set_volumetric_fog_emission", "get_volumetric_fog_emission");
  1294. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "volumetric_fog_emission_energy", PROPERTY_HINT_RANGE, "0,1024,0.01,or_greater"), "set_volumetric_fog_emission_energy", "get_volumetric_fog_emission_energy");
  1295. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "volumetric_fog_gi_inject", PROPERTY_HINT_RANGE, "0.0,16,0.01,exp"), "set_volumetric_fog_gi_inject", "get_volumetric_fog_gi_inject");
  1296. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "volumetric_fog_anisotropy", PROPERTY_HINT_RANGE, "-0.9,0.9,0.01"), "set_volumetric_fog_anisotropy", "get_volumetric_fog_anisotropy");
  1297. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "volumetric_fog_length", PROPERTY_HINT_RANGE, "0.01,1024,0.01,or_greater,suffix:m"), "set_volumetric_fog_length", "get_volumetric_fog_length");
  1298. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "volumetric_fog_detail_spread", PROPERTY_HINT_EXP_EASING, "positive_only"), "set_volumetric_fog_detail_spread", "get_volumetric_fog_detail_spread");
  1299. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "volumetric_fog_ambient_inject", PROPERTY_HINT_RANGE, "0.0,16,0.01,exp"), "set_volumetric_fog_ambient_inject", "get_volumetric_fog_ambient_inject");
  1300. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "volumetric_fog_sky_affect", PROPERTY_HINT_RANGE, "0,1,0.001"), "set_volumetric_fog_sky_affect", "get_volumetric_fog_sky_affect");
  1301. ADD_SUBGROUP("Temporal Reprojection", "volumetric_fog_temporal_reprojection_");
  1302. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "volumetric_fog_temporal_reprojection_enabled"), "set_volumetric_fog_temporal_reprojection_enabled", "is_volumetric_fog_temporal_reprojection_enabled");
  1303. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "volumetric_fog_temporal_reprojection_amount", PROPERTY_HINT_RANGE, "0.5,0.99,0.001"), "set_volumetric_fog_temporal_reprojection_amount", "get_volumetric_fog_temporal_reprojection_amount");
  1304. // Adjustment
  1305. ClassDB::bind_method(D_METHOD("set_adjustment_enabled", "enabled"), &Environment::set_adjustment_enabled);
  1306. ClassDB::bind_method(D_METHOD("is_adjustment_enabled"), &Environment::is_adjustment_enabled);
  1307. ClassDB::bind_method(D_METHOD("set_adjustment_brightness", "brightness"), &Environment::set_adjustment_brightness);
  1308. ClassDB::bind_method(D_METHOD("get_adjustment_brightness"), &Environment::get_adjustment_brightness);
  1309. ClassDB::bind_method(D_METHOD("set_adjustment_contrast", "contrast"), &Environment::set_adjustment_contrast);
  1310. ClassDB::bind_method(D_METHOD("get_adjustment_contrast"), &Environment::get_adjustment_contrast);
  1311. ClassDB::bind_method(D_METHOD("set_adjustment_saturation", "saturation"), &Environment::set_adjustment_saturation);
  1312. ClassDB::bind_method(D_METHOD("get_adjustment_saturation"), &Environment::get_adjustment_saturation);
  1313. ClassDB::bind_method(D_METHOD("set_adjustment_color_correction", "color_correction"), &Environment::set_adjustment_color_correction);
  1314. ClassDB::bind_method(D_METHOD("get_adjustment_color_correction"), &Environment::get_adjustment_color_correction);
  1315. ADD_GROUP("Adjustments", "adjustment_");
  1316. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "adjustment_enabled", PROPERTY_HINT_GROUP_ENABLE), "set_adjustment_enabled", "is_adjustment_enabled");
  1317. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "adjustment_brightness", PROPERTY_HINT_RANGE, "0.0,2.0,0.01,or_greater"), "set_adjustment_brightness", "get_adjustment_brightness");
  1318. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "adjustment_contrast", PROPERTY_HINT_RANGE, "0.75,1.25,0.005,or_less,or_greater"), "set_adjustment_contrast", "get_adjustment_contrast");
  1319. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "adjustment_saturation", PROPERTY_HINT_RANGE, "0.0,2.0,0.01,or_less,or_greater"), "set_adjustment_saturation", "get_adjustment_saturation");
  1320. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "adjustment_color_correction", PROPERTY_HINT_RESOURCE_TYPE, "Texture2D,Texture3D"), "set_adjustment_color_correction", "get_adjustment_color_correction");
  1321. // Constants
  1322. BIND_ENUM_CONSTANT(BG_CLEAR_COLOR);
  1323. BIND_ENUM_CONSTANT(BG_COLOR);
  1324. BIND_ENUM_CONSTANT(BG_SKY);
  1325. BIND_ENUM_CONSTANT(BG_CANVAS);
  1326. BIND_ENUM_CONSTANT(BG_KEEP);
  1327. BIND_ENUM_CONSTANT(BG_CAMERA_FEED);
  1328. BIND_ENUM_CONSTANT(BG_MAX);
  1329. BIND_ENUM_CONSTANT(AMBIENT_SOURCE_BG);
  1330. BIND_ENUM_CONSTANT(AMBIENT_SOURCE_DISABLED);
  1331. BIND_ENUM_CONSTANT(AMBIENT_SOURCE_COLOR);
  1332. BIND_ENUM_CONSTANT(AMBIENT_SOURCE_SKY);
  1333. BIND_ENUM_CONSTANT(REFLECTION_SOURCE_BG);
  1334. BIND_ENUM_CONSTANT(REFLECTION_SOURCE_DISABLED);
  1335. BIND_ENUM_CONSTANT(REFLECTION_SOURCE_SKY);
  1336. BIND_ENUM_CONSTANT(TONE_MAPPER_LINEAR);
  1337. BIND_ENUM_CONSTANT(TONE_MAPPER_REINHARDT);
  1338. BIND_ENUM_CONSTANT(TONE_MAPPER_FILMIC);
  1339. BIND_ENUM_CONSTANT(TONE_MAPPER_ACES);
  1340. BIND_ENUM_CONSTANT(TONE_MAPPER_AGX);
  1341. BIND_ENUM_CONSTANT(GLOW_BLEND_MODE_ADDITIVE);
  1342. BIND_ENUM_CONSTANT(GLOW_BLEND_MODE_SCREEN);
  1343. BIND_ENUM_CONSTANT(GLOW_BLEND_MODE_SOFTLIGHT);
  1344. BIND_ENUM_CONSTANT(GLOW_BLEND_MODE_REPLACE);
  1345. BIND_ENUM_CONSTANT(GLOW_BLEND_MODE_MIX);
  1346. BIND_ENUM_CONSTANT(FOG_MODE_EXPONENTIAL);
  1347. BIND_ENUM_CONSTANT(FOG_MODE_DEPTH);
  1348. BIND_ENUM_CONSTANT(SDFGI_Y_SCALE_50_PERCENT);
  1349. BIND_ENUM_CONSTANT(SDFGI_Y_SCALE_75_PERCENT);
  1350. BIND_ENUM_CONSTANT(SDFGI_Y_SCALE_100_PERCENT);
  1351. }
  1352. Environment::Environment() {
  1353. environment = RS::get_singleton()->environment_create();
  1354. set_camera_feed_id(bg_camera_feed_id);
  1355. glow_levels.resize(7);
  1356. glow_levels.write[0] = 0.0;
  1357. glow_levels.write[1] = 0.8;
  1358. glow_levels.write[2] = 0.4;
  1359. glow_levels.write[3] = 0.1;
  1360. glow_levels.write[4] = 0.0;
  1361. glow_levels.write[5] = 0.0;
  1362. glow_levels.write[6] = 0.0;
  1363. _update_ambient_light();
  1364. _update_tonemap();
  1365. _update_ssr();
  1366. _update_ssao();
  1367. _update_ssil();
  1368. _update_sdfgi();
  1369. _update_glow();
  1370. _update_fog();
  1371. _update_adjustment();
  1372. _update_volumetric_fog();
  1373. _update_bg_energy();
  1374. notify_property_list_changed();
  1375. }
  1376. Environment::~Environment() {
  1377. ERR_FAIL_NULL(RenderingServer::get_singleton());
  1378. RS::get_singleton()->free_rid(environment);
  1379. }