camera_attributes.cpp 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493
  1. /*************************************************************************/
  2. /* camera_attributes.cpp */
  3. /*************************************************************************/
  4. /* This file is part of: */
  5. /* GODOT ENGINE */
  6. /* https://godotengine.org */
  7. /*************************************************************************/
  8. /* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
  9. /* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
  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 "camera_attributes.h"
  31. #include "core/config/project_settings.h"
  32. #include "servers/rendering_server.h"
  33. void CameraAttributes::set_exposure_multiplier(float p_multiplier) {
  34. exposure_multiplier = p_multiplier;
  35. _update_exposure();
  36. emit_changed();
  37. }
  38. float CameraAttributes::get_exposure_multiplier() const {
  39. return exposure_multiplier;
  40. }
  41. void CameraAttributes::set_exposure_sensitivity(float p_sensitivity) {
  42. exposure_sensitivity = p_sensitivity;
  43. _update_exposure();
  44. emit_changed();
  45. }
  46. float CameraAttributes::get_exposure_sensitivity() const {
  47. return exposure_sensitivity;
  48. }
  49. void CameraAttributes::_update_exposure() {
  50. float exposure_normalization = 1.0;
  51. // Ignore physical properties if not using physical light units.
  52. if (GLOBAL_GET("rendering/lights_and_shadows/use_physical_light_units")) {
  53. exposure_normalization = calculate_exposure_normalization();
  54. }
  55. RS::get_singleton()->camera_attributes_set_exposure(camera_attributes, exposure_multiplier, exposure_normalization);
  56. }
  57. void CameraAttributes::set_auto_exposure_enabled(bool p_enabled) {
  58. auto_exposure_enabled = p_enabled;
  59. _update_auto_exposure();
  60. notify_property_list_changed();
  61. }
  62. bool CameraAttributes::is_auto_exposure_enabled() const {
  63. return auto_exposure_enabled;
  64. }
  65. void CameraAttributes::set_auto_exposure_speed(float p_auto_exposure_speed) {
  66. auto_exposure_speed = p_auto_exposure_speed;
  67. _update_auto_exposure();
  68. }
  69. float CameraAttributes::get_auto_exposure_speed() const {
  70. return auto_exposure_speed;
  71. }
  72. void CameraAttributes::set_auto_exposure_scale(float p_auto_exposure_scale) {
  73. auto_exposure_scale = p_auto_exposure_scale;
  74. _update_auto_exposure();
  75. }
  76. float CameraAttributes::get_auto_exposure_scale() const {
  77. return auto_exposure_scale;
  78. }
  79. RID CameraAttributes::get_rid() const {
  80. return camera_attributes;
  81. }
  82. void CameraAttributes::_validate_property(PropertyInfo &p_property) const {
  83. if (!GLOBAL_GET("rendering/lights_and_shadows/use_physical_light_units") && p_property.name == "exposure_sensitivity") {
  84. p_property.usage = PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL;
  85. return;
  86. }
  87. if (p_property.name.begins_with("auto_exposure_") && p_property.name != "auto_exposure_enabled" && !auto_exposure_enabled) {
  88. p_property.usage = PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL;
  89. return;
  90. }
  91. }
  92. void CameraAttributes::_bind_methods() {
  93. ClassDB::bind_method(D_METHOD("set_exposure_multiplier", "multiplier"), &CameraAttributes::set_exposure_multiplier);
  94. ClassDB::bind_method(D_METHOD("get_exposure_multiplier"), &CameraAttributes::get_exposure_multiplier);
  95. ClassDB::bind_method(D_METHOD("set_exposure_sensitivity", "sensitivity"), &CameraAttributes::set_exposure_sensitivity);
  96. ClassDB::bind_method(D_METHOD("get_exposure_sensitivity"), &CameraAttributes::get_exposure_sensitivity);
  97. ClassDB::bind_method(D_METHOD("set_auto_exposure_enabled", "enabled"), &CameraAttributes::set_auto_exposure_enabled);
  98. ClassDB::bind_method(D_METHOD("is_auto_exposure_enabled"), &CameraAttributes::is_auto_exposure_enabled);
  99. ClassDB::bind_method(D_METHOD("set_auto_exposure_speed", "exposure_speed"), &CameraAttributes::set_auto_exposure_speed);
  100. ClassDB::bind_method(D_METHOD("get_auto_exposure_speed"), &CameraAttributes::get_auto_exposure_speed);
  101. ClassDB::bind_method(D_METHOD("set_auto_exposure_scale", "exposure_grey"), &CameraAttributes::set_auto_exposure_scale);
  102. ClassDB::bind_method(D_METHOD("get_auto_exposure_scale"), &CameraAttributes::get_auto_exposure_scale);
  103. ADD_GROUP("Exposure", "exposure_");
  104. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "exposure_sensitivity", PROPERTY_HINT_RANGE, "0.1,32000.0,0.1,suffix:ISO"), "set_exposure_sensitivity", "get_exposure_sensitivity");
  105. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "exposure_multiplier", PROPERTY_HINT_RANGE, "0.0,2048.0,0.001"), "set_exposure_multiplier", "get_exposure_multiplier");
  106. ADD_GROUP("Auto Exposure", "auto_exposure_");
  107. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "auto_exposure_enabled"), "set_auto_exposure_enabled", "is_auto_exposure_enabled");
  108. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "auto_exposure_scale", PROPERTY_HINT_RANGE, "0.01,64,0.01"), "set_auto_exposure_scale", "get_auto_exposure_scale");
  109. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "auto_exposure_speed", PROPERTY_HINT_RANGE, "0.01,64,0.01"), "set_auto_exposure_speed", "get_auto_exposure_speed");
  110. }
  111. CameraAttributes::CameraAttributes() {
  112. camera_attributes = RS::get_singleton()->camera_attributes_create();
  113. }
  114. CameraAttributes::~CameraAttributes() {
  115. RS::get_singleton()->free(camera_attributes);
  116. }
  117. //////////////////////////////////////////////////////
  118. /* CameraAttributesPractical */
  119. void CameraAttributesPractical::set_dof_blur_far_enabled(bool p_enabled) {
  120. dof_blur_far_enabled = p_enabled;
  121. _update_dof_blur();
  122. notify_property_list_changed();
  123. }
  124. bool CameraAttributesPractical::is_dof_blur_far_enabled() const {
  125. return dof_blur_far_enabled;
  126. }
  127. void CameraAttributesPractical::set_dof_blur_far_distance(float p_distance) {
  128. dof_blur_far_distance = p_distance;
  129. _update_dof_blur();
  130. }
  131. float CameraAttributesPractical::get_dof_blur_far_distance() const {
  132. return dof_blur_far_distance;
  133. }
  134. void CameraAttributesPractical::set_dof_blur_far_transition(float p_distance) {
  135. dof_blur_far_transition = p_distance;
  136. _update_dof_blur();
  137. }
  138. float CameraAttributesPractical::get_dof_blur_far_transition() const {
  139. return dof_blur_far_transition;
  140. }
  141. void CameraAttributesPractical::set_dof_blur_near_enabled(bool p_enabled) {
  142. dof_blur_near_enabled = p_enabled;
  143. _update_dof_blur();
  144. notify_property_list_changed();
  145. }
  146. bool CameraAttributesPractical::is_dof_blur_near_enabled() const {
  147. return dof_blur_near_enabled;
  148. }
  149. void CameraAttributesPractical::set_dof_blur_near_distance(float p_distance) {
  150. dof_blur_near_distance = p_distance;
  151. _update_dof_blur();
  152. }
  153. float CameraAttributesPractical::get_dof_blur_near_distance() const {
  154. return dof_blur_near_distance;
  155. }
  156. void CameraAttributesPractical::set_dof_blur_near_transition(float p_distance) {
  157. dof_blur_near_transition = p_distance;
  158. _update_dof_blur();
  159. }
  160. float CameraAttributesPractical::get_dof_blur_near_transition() const {
  161. return dof_blur_near_transition;
  162. }
  163. void CameraAttributesPractical::set_dof_blur_amount(float p_amount) {
  164. dof_blur_amount = p_amount;
  165. _update_dof_blur();
  166. }
  167. float CameraAttributesPractical::get_dof_blur_amount() const {
  168. return dof_blur_amount;
  169. }
  170. void CameraAttributesPractical::_update_dof_blur() {
  171. RS::get_singleton()->camera_attributes_set_dof_blur(
  172. get_rid(),
  173. dof_blur_far_enabled,
  174. dof_blur_far_distance,
  175. dof_blur_far_transition,
  176. dof_blur_near_enabled,
  177. dof_blur_near_distance,
  178. dof_blur_near_transition,
  179. dof_blur_amount);
  180. }
  181. float CameraAttributesPractical::calculate_exposure_normalization() const {
  182. return exposure_sensitivity / 3072007.0; // Matches exposure normalization for default CameraAttributesPhysical at ISO 100.
  183. }
  184. void CameraAttributesPractical::set_auto_exposure_min_sensitivity(float p_min) {
  185. auto_exposure_min = p_min;
  186. _update_auto_exposure();
  187. }
  188. float CameraAttributesPractical::get_auto_exposure_min_sensitivity() const {
  189. return auto_exposure_min;
  190. }
  191. void CameraAttributesPractical::set_auto_exposure_max_sensitivity(float p_max) {
  192. auto_exposure_max = p_max;
  193. _update_auto_exposure();
  194. }
  195. float CameraAttributesPractical::get_auto_exposure_max_sensitivity() const {
  196. return auto_exposure_max;
  197. }
  198. void CameraAttributesPractical::_update_auto_exposure() {
  199. RS::get_singleton()->camera_attributes_set_auto_exposure(
  200. get_rid(),
  201. auto_exposure_enabled,
  202. auto_exposure_min * ((12.5 / 100.0) / exposure_sensitivity), // Convert from Sensitivity to Luminance
  203. auto_exposure_max * ((12.5 / 100.0) / exposure_sensitivity), // Convert from Sensitivity to Luminance
  204. auto_exposure_speed,
  205. auto_exposure_scale);
  206. emit_changed();
  207. }
  208. void CameraAttributesPractical::_validate_property(PropertyInfo &p_property) const {
  209. if ((!dof_blur_far_enabled && (p_property.name == "dof_blur_far_distance" || p_property.name == "dof_blur_far_transition")) ||
  210. (!dof_blur_near_enabled && (p_property.name == "dof_blur_near_distance" || p_property.name == "dof_blur_near_transition"))) {
  211. p_property.usage = PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL;
  212. }
  213. }
  214. void CameraAttributesPractical::_bind_methods() {
  215. // DOF blur
  216. ClassDB::bind_method(D_METHOD("set_dof_blur_far_enabled", "enabled"), &CameraAttributesPractical::set_dof_blur_far_enabled);
  217. ClassDB::bind_method(D_METHOD("is_dof_blur_far_enabled"), &CameraAttributesPractical::is_dof_blur_far_enabled);
  218. ClassDB::bind_method(D_METHOD("set_dof_blur_far_distance", "distance"), &CameraAttributesPractical::set_dof_blur_far_distance);
  219. ClassDB::bind_method(D_METHOD("get_dof_blur_far_distance"), &CameraAttributesPractical::get_dof_blur_far_distance);
  220. ClassDB::bind_method(D_METHOD("set_dof_blur_far_transition", "distance"), &CameraAttributesPractical::set_dof_blur_far_transition);
  221. ClassDB::bind_method(D_METHOD("get_dof_blur_far_transition"), &CameraAttributesPractical::get_dof_blur_far_transition);
  222. ClassDB::bind_method(D_METHOD("set_dof_blur_near_enabled", "enabled"), &CameraAttributesPractical::set_dof_blur_near_enabled);
  223. ClassDB::bind_method(D_METHOD("is_dof_blur_near_enabled"), &CameraAttributesPractical::is_dof_blur_near_enabled);
  224. ClassDB::bind_method(D_METHOD("set_dof_blur_near_distance", "distance"), &CameraAttributesPractical::set_dof_blur_near_distance);
  225. ClassDB::bind_method(D_METHOD("get_dof_blur_near_distance"), &CameraAttributesPractical::get_dof_blur_near_distance);
  226. ClassDB::bind_method(D_METHOD("set_dof_blur_near_transition", "distance"), &CameraAttributesPractical::set_dof_blur_near_transition);
  227. ClassDB::bind_method(D_METHOD("get_dof_blur_near_transition"), &CameraAttributesPractical::get_dof_blur_near_transition);
  228. ClassDB::bind_method(D_METHOD("set_dof_blur_amount", "amount"), &CameraAttributesPractical::set_dof_blur_amount);
  229. ClassDB::bind_method(D_METHOD("get_dof_blur_amount"), &CameraAttributesPractical::get_dof_blur_amount);
  230. ClassDB::bind_method(D_METHOD("set_auto_exposure_max_sensitivity", "max_sensitivity"), &CameraAttributesPractical::set_auto_exposure_max_sensitivity);
  231. ClassDB::bind_method(D_METHOD("get_auto_exposure_max_sensitivity"), &CameraAttributesPractical::get_auto_exposure_max_sensitivity);
  232. ClassDB::bind_method(D_METHOD("set_auto_exposure_min_sensitivity", "min_sensitivity"), &CameraAttributesPractical::set_auto_exposure_min_sensitivity);
  233. ClassDB::bind_method(D_METHOD("get_auto_exposure_min_sensitivity"), &CameraAttributesPractical::get_auto_exposure_min_sensitivity);
  234. ADD_GROUP("DOF Blur", "dof_blur_");
  235. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "dof_blur_far_enabled"), "set_dof_blur_far_enabled", "is_dof_blur_far_enabled");
  236. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "dof_blur_far_distance", PROPERTY_HINT_RANGE, "0.01,8192,0.01,exp,suffix:m"), "set_dof_blur_far_distance", "get_dof_blur_far_distance");
  237. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "dof_blur_far_transition", PROPERTY_HINT_RANGE, "0.01,8192,0.01,exp"), "set_dof_blur_far_transition", "get_dof_blur_far_transition");
  238. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "dof_blur_near_enabled"), "set_dof_blur_near_enabled", "is_dof_blur_near_enabled");
  239. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "dof_blur_near_distance", PROPERTY_HINT_RANGE, "0.01,8192,0.01,exp,suffix:m"), "set_dof_blur_near_distance", "get_dof_blur_near_distance");
  240. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "dof_blur_near_transition", PROPERTY_HINT_RANGE, "0.01,8192,0.01,exp"), "set_dof_blur_near_transition", "get_dof_blur_near_transition");
  241. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "dof_blur_amount", PROPERTY_HINT_RANGE, "0,1,0.01"), "set_dof_blur_amount", "get_dof_blur_amount");
  242. ADD_GROUP("Auto Exposure", "auto_exposure_");
  243. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "auto_exposure_min_sensitivity", PROPERTY_HINT_RANGE, "0,1600,0.01,or_greater,suffic:ISO"), "set_auto_exposure_min_sensitivity", "get_auto_exposure_min_sensitivity");
  244. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "auto_exposure_max_sensitivity", PROPERTY_HINT_RANGE, "0,64000,0.1,or_greater,suffic:ISO"), "set_auto_exposure_max_sensitivity", "get_auto_exposure_max_sensitivity");
  245. }
  246. CameraAttributesPractical::CameraAttributesPractical() {
  247. _update_dof_blur();
  248. _update_exposure();
  249. set_auto_exposure_min_sensitivity(0.0);
  250. set_auto_exposure_max_sensitivity(800.0);
  251. notify_property_list_changed();
  252. }
  253. CameraAttributesPractical::~CameraAttributesPractical() {
  254. }
  255. //////////////////////////////////////////////////////
  256. /* CameraAttributesPhysical */
  257. void CameraAttributesPhysical::set_aperture(float p_aperture) {
  258. exposure_aperture = p_aperture;
  259. _update_exposure();
  260. _update_frustum();
  261. }
  262. float CameraAttributesPhysical::get_aperture() const {
  263. return exposure_aperture;
  264. }
  265. void CameraAttributesPhysical::set_shutter_speed(float p_shutter_speed) {
  266. exposure_shutter_speed = p_shutter_speed;
  267. _update_exposure();
  268. }
  269. float CameraAttributesPhysical::get_shutter_speed() const {
  270. return exposure_shutter_speed;
  271. }
  272. void CameraAttributesPhysical::set_focal_length(float p_focal_length) {
  273. frustum_focal_length = p_focal_length;
  274. _update_frustum();
  275. emit_changed();
  276. }
  277. float CameraAttributesPhysical::get_focal_length() const {
  278. return frustum_focal_length;
  279. }
  280. void CameraAttributesPhysical::set_focus_distance(float p_focus_distance) {
  281. frustum_focus_distance = p_focus_distance;
  282. _update_frustum();
  283. }
  284. float CameraAttributesPhysical::get_focus_distance() const {
  285. return frustum_focus_distance;
  286. }
  287. void CameraAttributesPhysical::set_near(real_t p_near) {
  288. frustum_near = p_near;
  289. _update_frustum();
  290. emit_changed();
  291. }
  292. real_t CameraAttributesPhysical::get_near() const {
  293. return frustum_near;
  294. }
  295. void CameraAttributesPhysical::set_far(real_t p_far) {
  296. frustum_far = p_far;
  297. _update_frustum();
  298. emit_changed();
  299. }
  300. real_t CameraAttributesPhysical::get_far() const {
  301. return frustum_far;
  302. }
  303. real_t CameraAttributesPhysical::get_fov() const {
  304. return frustum_fov;
  305. }
  306. void CameraAttributesPhysical::_update_frustum() {
  307. //https://en.wikipedia.org/wiki/Circle_of_confusion#Circle_of_confusion_diameter_limit_based_on_d/1500
  308. Vector2i sensor_size = Vector2i(36, 24); // Matches high-end DSLR, could be made variable if there is demand.
  309. float CoC = sensor_size.length() / 1500.0;
  310. frustum_fov = Math::rad_to_deg(2 * atan(sensor_size.height / (2 * frustum_focal_length)));
  311. // Based on https://en.wikipedia.org/wiki/Depth_of_field.
  312. float u = MAX(frustum_focus_distance * 1000.0, frustum_focal_length + 1.0); // Focus distance expressed in mm and clamped to at least 1 mm away from lens.
  313. float hyperfocal_length = frustum_focal_length + ((frustum_focal_length * frustum_focal_length) / (exposure_aperture * CoC));
  314. // This computes the start and end of the depth of field. Anything between these two points has a Circle of Confusino so small
  315. // that it is not picked up by the camera sensors.
  316. // To be properly physically-based, we would run the DoF shader at all depths. To be efficient, we are only running it where the CoC
  317. // will be visible, this introduces some value shifts in the near field that we have to compensate for below.
  318. float near = ((hyperfocal_length * u) / (hyperfocal_length + (u - frustum_focal_length))) / 1000.0; // In meters.
  319. float far = ((hyperfocal_length * u) / (hyperfocal_length - (u - frustum_focal_length))) / 1000.0; // In meters.
  320. float scale = (frustum_focal_length / (u - frustum_focal_length)) * (frustum_focal_length / exposure_aperture);
  321. bool use_far = (far < frustum_far) && (far > 0.0);
  322. bool use_near = near > frustum_near;
  323. RS::get_singleton()->camera_attributes_set_dof_blur(
  324. get_rid(),
  325. use_far,
  326. u / 1000.0, // Focus distance clampd to focal length expressed in meters.
  327. -1.0, // Negative to tell Bokeh effect to use physically-based scaling.
  328. use_near,
  329. u / 1000.0,
  330. -1.0,
  331. scale / 5.0); // Arbitrary scaling to get close to how much blur there should be.
  332. }
  333. float CameraAttributesPhysical::calculate_exposure_normalization() const {
  334. const float e = (exposure_aperture * exposure_aperture) * exposure_shutter_speed * (100.0 / exposure_sensitivity);
  335. return 1.0 / (e * 1.2);
  336. }
  337. void CameraAttributesPhysical::set_auto_exposure_min_exposure_value(float p_min) {
  338. auto_exposure_min = p_min;
  339. _update_auto_exposure();
  340. }
  341. float CameraAttributesPhysical::get_auto_exposure_min_exposure_value() const {
  342. return auto_exposure_min;
  343. }
  344. void CameraAttributesPhysical::set_auto_exposure_max_exposure_value(float p_max) {
  345. auto_exposure_max = p_max;
  346. _update_auto_exposure();
  347. }
  348. float CameraAttributesPhysical::get_auto_exposure_max_exposure_value() const {
  349. return auto_exposure_max;
  350. }
  351. void CameraAttributesPhysical::_update_auto_exposure() {
  352. RS::get_singleton()->camera_attributes_set_auto_exposure(
  353. get_rid(),
  354. auto_exposure_enabled,
  355. pow(2.0, auto_exposure_min) * (12.5 / exposure_sensitivity), // Convert from EV100 to Luminance
  356. pow(2.0, auto_exposure_max) * (12.5 / exposure_sensitivity), // Convert from EV100 to Luminance
  357. auto_exposure_speed,
  358. auto_exposure_scale);
  359. emit_changed();
  360. }
  361. void CameraAttributesPhysical::_validate_property(PropertyInfo &property) const {
  362. if (!GLOBAL_GET("rendering/lights_and_shadows/use_physical_light_units") && (property.name == "exposure_aperture" || property.name == "exposure_shutter_speed")) {
  363. property.usage = PROPERTY_USAGE_NO_EDITOR | PROPERTY_USAGE_INTERNAL;
  364. return;
  365. }
  366. }
  367. void CameraAttributesPhysical::_bind_methods() {
  368. ClassDB::bind_method(D_METHOD("set_aperture", "aperture"), &CameraAttributesPhysical::set_aperture);
  369. ClassDB::bind_method(D_METHOD("get_aperture"), &CameraAttributesPhysical::get_aperture);
  370. ClassDB::bind_method(D_METHOD("set_shutter_speed", "shutter_speed"), &CameraAttributesPhysical::set_shutter_speed);
  371. ClassDB::bind_method(D_METHOD("get_shutter_speed"), &CameraAttributesPhysical::get_shutter_speed);
  372. ClassDB::bind_method(D_METHOD("set_focal_length", "focal_length"), &CameraAttributesPhysical::set_focal_length);
  373. ClassDB::bind_method(D_METHOD("get_focal_length"), &CameraAttributesPhysical::get_focal_length);
  374. ClassDB::bind_method(D_METHOD("set_focus_distance", "focus_distance"), &CameraAttributesPhysical::set_focus_distance);
  375. ClassDB::bind_method(D_METHOD("get_focus_distance"), &CameraAttributesPhysical::get_focus_distance);
  376. ClassDB::bind_method(D_METHOD("set_near", "near"), &CameraAttributesPhysical::set_near);
  377. ClassDB::bind_method(D_METHOD("get_near"), &CameraAttributesPhysical::get_near);
  378. ClassDB::bind_method(D_METHOD("set_far", "far"), &CameraAttributesPhysical::set_far);
  379. ClassDB::bind_method(D_METHOD("get_far"), &CameraAttributesPhysical::get_far);
  380. ClassDB::bind_method(D_METHOD("get_fov"), &CameraAttributesPhysical::get_fov);
  381. ClassDB::bind_method(D_METHOD("set_auto_exposure_max_exposure_value", "exposure_value_max"), &CameraAttributesPhysical::set_auto_exposure_max_exposure_value);
  382. ClassDB::bind_method(D_METHOD("get_auto_exposure_max_exposure_value"), &CameraAttributesPhysical::get_auto_exposure_max_exposure_value);
  383. ClassDB::bind_method(D_METHOD("set_auto_exposure_min_exposure_value", "exposure_value_min"), &CameraAttributesPhysical::set_auto_exposure_min_exposure_value);
  384. ClassDB::bind_method(D_METHOD("get_auto_exposure_min_exposure_value"), &CameraAttributesPhysical::get_auto_exposure_min_exposure_value);
  385. ADD_GROUP("Frustum", "frustum_");
  386. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "frustum_focus_distance", PROPERTY_HINT_RANGE, "0.01,4000.0,0.01,suffix:m"), "set_focus_distance", "get_focus_distance");
  387. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "frustum_focal_length", PROPERTY_HINT_RANGE, "1.0,800.0,0.01,exp,suffix:mm"), "set_focal_length", "get_focal_length");
  388. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "frustum_near", PROPERTY_HINT_RANGE, "0.001,10,0.001,or_greater,exp,suffix:m"), "set_near", "get_near");
  389. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "frustum_far", PROPERTY_HINT_RANGE, "0.01,4000,0.01,or_greater,exp,suffix:m"), "set_far", "get_far");
  390. ADD_GROUP("Exposure", "exposure_");
  391. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "exposure_aperture", PROPERTY_HINT_RANGE, "0.5,64.0,0.01,exp,suffix:f-stop"), "set_aperture", "get_aperture");
  392. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "exposure_shutter_speed", PROPERTY_HINT_RANGE, "0.1,8000.0,0.001,suffix:1/s"), "set_shutter_speed", "get_shutter_speed");
  393. ADD_GROUP("Auto Exposure", "auto_exposure_");
  394. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "auto_exposure_min_exposure_value", PROPERTY_HINT_RANGE, "-16.0,16.0,0.01,or_greater,suffix:EV100"), "set_auto_exposure_min_exposure_value", "get_auto_exposure_min_exposure_value");
  395. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "auto_exposure_max_exposure_value", PROPERTY_HINT_RANGE, "-16.0,16.0,0.01,or_greater,suffix:EV100"), "set_auto_exposure_max_exposure_value", "get_auto_exposure_max_exposure_value");
  396. };
  397. CameraAttributesPhysical::CameraAttributesPhysical() {
  398. _update_exposure();
  399. _update_frustum();
  400. set_auto_exposure_min_exposure_value(-8);
  401. set_auto_exposure_max_exposure_value(10); // Use a wide range by default to feel more like a real camera.
  402. notify_property_list_changed();
  403. }
  404. CameraAttributesPhysical::~CameraAttributesPhysical() {
  405. }