camera_3d.cpp 23 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236237238239240241242243244245246247248249250251252253254255256257258259260261262263264265266267268269270271272273274275276277278279280281282283284285286287288289290291292293294295296297298299300301302303304305306307308309310311312313314315316317318319320321322323324325326327328329330331332333334335336337338339340341342343344345346347348349350351352353354355356357358359360361362363364365366367368369370371372373374375376377378379380381382383384385386387388389390391392393394395396397398399400401402403404405406407408409410411412413414415416417418419420421422423424425426427428429430431432433434435436437438439440441442443444445446447448449450451452453454455456457458459460461462463464465466467468469470471472473474475476477478479480481482483484485486487488489490491492493494495496497498499500501502503504505506507508509510511512513514515516517518519520521522523524525526527528529530531532533534535536537538539540541542543544545546547548549550551552553554555556557558559560561562563564565566567568569570571572573574575576577578579580581582583584585586587588589590591592593594595596597598599600601602603604605606607608609610611612613614615616617618619620621622623624625626627628629630631632633634635636637638639640641642643644645646647648649650651652653654655656657658659660661662663664665666667668669670671672673674675676677678679680681682683684685686687688689690691692693694695696697698699
  1. /*************************************************************************/
  2. /* camera_3d.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_3d.h"
  31. #include "collision_object_3d.h"
  32. #include "core/math/projection.h"
  33. #include "scene/main/viewport.h"
  34. void Camera3D::_update_audio_listener_state() {
  35. }
  36. void Camera3D::_request_camera_update() {
  37. _update_camera();
  38. }
  39. void Camera3D::_update_camera_mode() {
  40. force_change = true;
  41. switch (mode) {
  42. case PROJECTION_PERSPECTIVE: {
  43. set_perspective(fov, near, far);
  44. } break;
  45. case PROJECTION_ORTHOGONAL: {
  46. set_orthogonal(size, near, far);
  47. } break;
  48. case PROJECTION_FRUSTUM: {
  49. set_frustum(size, frustum_offset, near, far);
  50. } break;
  51. }
  52. }
  53. void Camera3D::_validate_property(PropertyInfo &p_property) const {
  54. if (p_property.name == "fov") {
  55. if (mode != PROJECTION_PERSPECTIVE) {
  56. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  57. }
  58. } else if (p_property.name == "size") {
  59. if (mode != PROJECTION_ORTHOGONAL && mode != PROJECTION_FRUSTUM) {
  60. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  61. }
  62. } else if (p_property.name == "frustum_offset") {
  63. if (mode != PROJECTION_FRUSTUM) {
  64. p_property.usage = PROPERTY_USAGE_NO_EDITOR;
  65. }
  66. }
  67. Node3D::_validate_property(p_property);
  68. }
  69. void Camera3D::_update_camera() {
  70. if (!is_inside_tree()) {
  71. return;
  72. }
  73. RenderingServer::get_singleton()->camera_set_transform(camera, get_camera_transform());
  74. if (get_tree()->is_node_being_edited(this) || !is_current()) {
  75. return;
  76. }
  77. get_viewport()->_camera_3d_transform_changed_notify();
  78. }
  79. void Camera3D::_notification(int p_what) {
  80. switch (p_what) {
  81. case NOTIFICATION_ENTER_WORLD: {
  82. // Needs to track the Viewport because it's needed on NOTIFICATION_EXIT_WORLD
  83. // and Spatial will handle it first, including clearing its reference to the Viewport,
  84. // therefore making it impossible to subclasses to access it
  85. viewport = get_viewport();
  86. ERR_FAIL_COND(!viewport);
  87. bool first_camera = viewport->_camera_3d_add(this);
  88. if (current || first_camera) {
  89. viewport->_camera_3d_set(this);
  90. }
  91. } break;
  92. case NOTIFICATION_TRANSFORM_CHANGED: {
  93. _request_camera_update();
  94. if (doppler_tracking != DOPPLER_TRACKING_DISABLED) {
  95. velocity_tracker->update_position(get_global_transform().origin);
  96. }
  97. } break;
  98. case NOTIFICATION_EXIT_WORLD: {
  99. if (!get_tree()->is_node_being_edited(this)) {
  100. if (is_current()) {
  101. clear_current();
  102. current = true; //keep it true
  103. } else {
  104. current = false;
  105. }
  106. }
  107. if (viewport) {
  108. viewport->_camera_3d_remove(this);
  109. viewport = nullptr;
  110. }
  111. } break;
  112. case NOTIFICATION_BECAME_CURRENT: {
  113. if (viewport) {
  114. viewport->find_world_3d()->_register_camera(this);
  115. }
  116. } break;
  117. case NOTIFICATION_LOST_CURRENT: {
  118. if (viewport) {
  119. viewport->find_world_3d()->_remove_camera(this);
  120. }
  121. } break;
  122. }
  123. }
  124. Transform3D Camera3D::get_camera_transform() const {
  125. Transform3D tr = get_global_transform().orthonormalized();
  126. tr.origin += tr.basis.get_column(1) * v_offset;
  127. tr.origin += tr.basis.get_column(0) * h_offset;
  128. return tr;
  129. }
  130. void Camera3D::set_perspective(real_t p_fovy_degrees, real_t p_z_near, real_t p_z_far) {
  131. if (!force_change && fov == p_fovy_degrees && p_z_near == near && p_z_far == far && mode == PROJECTION_PERSPECTIVE) {
  132. return;
  133. }
  134. fov = p_fovy_degrees;
  135. near = p_z_near;
  136. far = p_z_far;
  137. mode = PROJECTION_PERSPECTIVE;
  138. RenderingServer::get_singleton()->camera_set_perspective(camera, fov, near, far);
  139. update_gizmos();
  140. force_change = false;
  141. }
  142. void Camera3D::set_orthogonal(real_t p_size, real_t p_z_near, real_t p_z_far) {
  143. if (!force_change && size == p_size && p_z_near == near && p_z_far == far && mode == PROJECTION_ORTHOGONAL) {
  144. return;
  145. }
  146. size = p_size;
  147. near = p_z_near;
  148. far = p_z_far;
  149. mode = PROJECTION_ORTHOGONAL;
  150. force_change = false;
  151. RenderingServer::get_singleton()->camera_set_orthogonal(camera, size, near, far);
  152. update_gizmos();
  153. }
  154. void Camera3D::set_frustum(real_t p_size, Vector2 p_offset, real_t p_z_near, real_t p_z_far) {
  155. if (!force_change && size == p_size && frustum_offset == p_offset && p_z_near == near && p_z_far == far && mode == PROJECTION_FRUSTUM) {
  156. return;
  157. }
  158. size = p_size;
  159. frustum_offset = p_offset;
  160. near = p_z_near;
  161. far = p_z_far;
  162. mode = PROJECTION_FRUSTUM;
  163. force_change = false;
  164. RenderingServer::get_singleton()->camera_set_frustum(camera, size, frustum_offset, near, far);
  165. update_gizmos();
  166. }
  167. void Camera3D::set_projection(ProjectionType p_mode) {
  168. if (p_mode == PROJECTION_PERSPECTIVE || p_mode == PROJECTION_ORTHOGONAL || p_mode == PROJECTION_FRUSTUM) {
  169. mode = p_mode;
  170. _update_camera_mode();
  171. notify_property_list_changed();
  172. }
  173. }
  174. RID Camera3D::get_camera() const {
  175. return camera;
  176. };
  177. void Camera3D::make_current() {
  178. current = true;
  179. if (!is_inside_tree()) {
  180. return;
  181. }
  182. get_viewport()->_camera_3d_set(this);
  183. }
  184. void Camera3D::clear_current(bool p_enable_next) {
  185. current = false;
  186. if (!is_inside_tree()) {
  187. return;
  188. }
  189. if (get_viewport()->get_camera_3d() == this) {
  190. get_viewport()->_camera_3d_set(nullptr);
  191. if (p_enable_next) {
  192. get_viewport()->_camera_3d_make_next_current(this);
  193. }
  194. }
  195. }
  196. void Camera3D::set_current(bool p_enabled) {
  197. if (p_enabled) {
  198. make_current();
  199. } else {
  200. clear_current();
  201. }
  202. }
  203. bool Camera3D::is_current() const {
  204. if (is_inside_tree() && !get_tree()->is_node_being_edited(this)) {
  205. return get_viewport()->get_camera_3d() == this;
  206. } else {
  207. return current;
  208. }
  209. }
  210. Vector3 Camera3D::project_ray_normal(const Point2 &p_pos) const {
  211. Vector3 ray = project_local_ray_normal(p_pos);
  212. return get_camera_transform().basis.xform(ray).normalized();
  213. };
  214. Vector3 Camera3D::project_local_ray_normal(const Point2 &p_pos) const {
  215. ERR_FAIL_COND_V_MSG(!is_inside_tree(), Vector3(), "Camera is not inside scene.");
  216. Size2 viewport_size = get_viewport()->get_camera_rect_size();
  217. Vector2 cpos = get_viewport()->get_camera_coords(p_pos);
  218. Vector3 ray;
  219. if (mode == PROJECTION_ORTHOGONAL) {
  220. ray = Vector3(0, 0, -1);
  221. } else {
  222. Projection cm;
  223. cm.set_perspective(fov, viewport_size.aspect(), near, far, keep_aspect == KEEP_WIDTH);
  224. Vector2 screen_he = cm.get_viewport_half_extents();
  225. ray = Vector3(((cpos.x / viewport_size.width) * 2.0 - 1.0) * screen_he.x, ((1.0 - (cpos.y / viewport_size.height)) * 2.0 - 1.0) * screen_he.y, -near).normalized();
  226. }
  227. return ray;
  228. };
  229. Vector3 Camera3D::project_ray_origin(const Point2 &p_pos) const {
  230. ERR_FAIL_COND_V_MSG(!is_inside_tree(), Vector3(), "Camera is not inside scene.");
  231. Size2 viewport_size = get_viewport()->get_camera_rect_size();
  232. Vector2 cpos = get_viewport()->get_camera_coords(p_pos);
  233. ERR_FAIL_COND_V(viewport_size.y == 0, Vector3());
  234. if (mode == PROJECTION_PERSPECTIVE) {
  235. return get_camera_transform().origin;
  236. } else {
  237. Vector2 pos = cpos / viewport_size;
  238. real_t vsize, hsize;
  239. if (keep_aspect == KEEP_WIDTH) {
  240. vsize = size / viewport_size.aspect();
  241. hsize = size;
  242. } else {
  243. hsize = size * viewport_size.aspect();
  244. vsize = size;
  245. }
  246. Vector3 ray;
  247. ray.x = pos.x * (hsize)-hsize / 2;
  248. ray.y = (1.0 - pos.y) * (vsize)-vsize / 2;
  249. ray.z = -near;
  250. ray = get_camera_transform().xform(ray);
  251. return ray;
  252. };
  253. };
  254. bool Camera3D::is_position_behind(const Vector3 &p_pos) const {
  255. Transform3D t = get_global_transform();
  256. Vector3 eyedir = -t.basis.get_column(2).normalized();
  257. return eyedir.dot(p_pos - t.origin) < near;
  258. }
  259. Vector<Vector3> Camera3D::get_near_plane_points() const {
  260. ERR_FAIL_COND_V_MSG(!is_inside_tree(), Vector<Vector3>(), "Camera is not inside scene.");
  261. Size2 viewport_size = get_viewport()->get_visible_rect().size;
  262. Projection cm;
  263. if (mode == PROJECTION_ORTHOGONAL) {
  264. cm.set_orthogonal(size, viewport_size.aspect(), near, far, keep_aspect == KEEP_WIDTH);
  265. } else {
  266. cm.set_perspective(fov, viewport_size.aspect(), near, far, keep_aspect == KEEP_WIDTH);
  267. }
  268. Vector3 endpoints[8];
  269. cm.get_endpoints(Transform3D(), endpoints);
  270. Vector<Vector3> points = {
  271. Vector3(),
  272. endpoints[4],
  273. endpoints[5],
  274. endpoints[6],
  275. endpoints[7]
  276. };
  277. return points;
  278. }
  279. Point2 Camera3D::unproject_position(const Vector3 &p_pos) const {
  280. ERR_FAIL_COND_V_MSG(!is_inside_tree(), Vector2(), "Camera is not inside scene.");
  281. Size2 viewport_size = get_viewport()->get_visible_rect().size;
  282. Projection cm;
  283. if (mode == PROJECTION_ORTHOGONAL) {
  284. cm.set_orthogonal(size, viewport_size.aspect(), near, far, keep_aspect == KEEP_WIDTH);
  285. } else {
  286. cm.set_perspective(fov, viewport_size.aspect(), near, far, keep_aspect == KEEP_WIDTH);
  287. }
  288. Plane p(get_camera_transform().xform_inv(p_pos), 1.0);
  289. p = cm.xform4(p);
  290. p.normal /= p.d;
  291. Point2 res;
  292. res.x = (p.normal.x * 0.5 + 0.5) * viewport_size.x;
  293. res.y = (-p.normal.y * 0.5 + 0.5) * viewport_size.y;
  294. return res;
  295. }
  296. Vector3 Camera3D::project_position(const Point2 &p_point, real_t p_z_depth) const {
  297. ERR_FAIL_COND_V_MSG(!is_inside_tree(), Vector3(), "Camera is not inside scene.");
  298. if (p_z_depth == 0 && mode != PROJECTION_ORTHOGONAL) {
  299. return get_global_transform().origin;
  300. }
  301. Size2 viewport_size = get_viewport()->get_visible_rect().size;
  302. Projection cm;
  303. if (mode == PROJECTION_ORTHOGONAL) {
  304. cm.set_orthogonal(size, viewport_size.aspect(), p_z_depth, far, keep_aspect == KEEP_WIDTH);
  305. } else {
  306. cm.set_perspective(fov, viewport_size.aspect(), p_z_depth, far, keep_aspect == KEEP_WIDTH);
  307. }
  308. Vector2 vp_he = cm.get_viewport_half_extents();
  309. Vector2 point;
  310. point.x = (p_point.x / viewport_size.x) * 2.0 - 1.0;
  311. point.y = (1.0 - (p_point.y / viewport_size.y)) * 2.0 - 1.0;
  312. point *= vp_he;
  313. Vector3 p(point.x, point.y, -p_z_depth);
  314. return get_camera_transform().xform(p);
  315. }
  316. void Camera3D::set_environment(const Ref<Environment> &p_environment) {
  317. environment = p_environment;
  318. if (environment.is_valid()) {
  319. RS::get_singleton()->camera_set_environment(camera, environment->get_rid());
  320. } else {
  321. RS::get_singleton()->camera_set_environment(camera, RID());
  322. }
  323. _update_camera_mode();
  324. }
  325. Ref<Environment> Camera3D::get_environment() const {
  326. return environment;
  327. }
  328. void Camera3D::set_effects(const Ref<CameraEffects> &p_effects) {
  329. effects = p_effects;
  330. if (effects.is_valid()) {
  331. RS::get_singleton()->camera_set_camera_effects(camera, effects->get_rid());
  332. } else {
  333. RS::get_singleton()->camera_set_camera_effects(camera, RID());
  334. }
  335. _update_camera_mode();
  336. }
  337. Ref<CameraEffects> Camera3D::get_effects() const {
  338. return effects;
  339. }
  340. void Camera3D::set_keep_aspect_mode(KeepAspect p_aspect) {
  341. keep_aspect = p_aspect;
  342. RenderingServer::get_singleton()->camera_set_use_vertical_aspect(camera, p_aspect == KEEP_WIDTH);
  343. _update_camera_mode();
  344. notify_property_list_changed();
  345. }
  346. Camera3D::KeepAspect Camera3D::get_keep_aspect_mode() const {
  347. return keep_aspect;
  348. }
  349. void Camera3D::set_doppler_tracking(DopplerTracking p_tracking) {
  350. if (doppler_tracking == p_tracking) {
  351. return;
  352. }
  353. doppler_tracking = p_tracking;
  354. if (p_tracking != DOPPLER_TRACKING_DISABLED) {
  355. velocity_tracker->set_track_physics_step(doppler_tracking == DOPPLER_TRACKING_PHYSICS_STEP);
  356. if (is_inside_tree()) {
  357. velocity_tracker->reset(get_global_transform().origin);
  358. }
  359. }
  360. _update_camera_mode();
  361. }
  362. Camera3D::DopplerTracking Camera3D::get_doppler_tracking() const {
  363. return doppler_tracking;
  364. }
  365. void Camera3D::_bind_methods() {
  366. ClassDB::bind_method(D_METHOD("project_ray_normal", "screen_point"), &Camera3D::project_ray_normal);
  367. ClassDB::bind_method(D_METHOD("project_local_ray_normal", "screen_point"), &Camera3D::project_local_ray_normal);
  368. ClassDB::bind_method(D_METHOD("project_ray_origin", "screen_point"), &Camera3D::project_ray_origin);
  369. ClassDB::bind_method(D_METHOD("unproject_position", "world_point"), &Camera3D::unproject_position);
  370. ClassDB::bind_method(D_METHOD("is_position_behind", "world_point"), &Camera3D::is_position_behind);
  371. ClassDB::bind_method(D_METHOD("project_position", "screen_point", "z_depth"), &Camera3D::project_position);
  372. ClassDB::bind_method(D_METHOD("set_perspective", "fov", "z_near", "z_far"), &Camera3D::set_perspective);
  373. ClassDB::bind_method(D_METHOD("set_orthogonal", "size", "z_near", "z_far"), &Camera3D::set_orthogonal);
  374. ClassDB::bind_method(D_METHOD("set_frustum", "size", "offset", "z_near", "z_far"), &Camera3D::set_frustum);
  375. ClassDB::bind_method(D_METHOD("make_current"), &Camera3D::make_current);
  376. ClassDB::bind_method(D_METHOD("clear_current", "enable_next"), &Camera3D::clear_current, DEFVAL(true));
  377. ClassDB::bind_method(D_METHOD("set_current", "enabled"), &Camera3D::set_current);
  378. ClassDB::bind_method(D_METHOD("is_current"), &Camera3D::is_current);
  379. ClassDB::bind_method(D_METHOD("get_camera_transform"), &Camera3D::get_camera_transform);
  380. ClassDB::bind_method(D_METHOD("get_fov"), &Camera3D::get_fov);
  381. ClassDB::bind_method(D_METHOD("get_frustum_offset"), &Camera3D::get_frustum_offset);
  382. ClassDB::bind_method(D_METHOD("get_size"), &Camera3D::get_size);
  383. ClassDB::bind_method(D_METHOD("get_far"), &Camera3D::get_far);
  384. ClassDB::bind_method(D_METHOD("get_near"), &Camera3D::get_near);
  385. ClassDB::bind_method(D_METHOD("set_fov", "fov"), &Camera3D::set_fov);
  386. ClassDB::bind_method(D_METHOD("set_frustum_offset", "offset"), &Camera3D::set_frustum_offset);
  387. ClassDB::bind_method(D_METHOD("set_size", "size"), &Camera3D::set_size);
  388. ClassDB::bind_method(D_METHOD("set_far", "far"), &Camera3D::set_far);
  389. ClassDB::bind_method(D_METHOD("set_near", "near"), &Camera3D::set_near);
  390. ClassDB::bind_method(D_METHOD("get_projection"), &Camera3D::get_projection);
  391. ClassDB::bind_method(D_METHOD("set_projection", "mode"), &Camera3D::set_projection);
  392. ClassDB::bind_method(D_METHOD("set_h_offset", "offset"), &Camera3D::set_h_offset);
  393. ClassDB::bind_method(D_METHOD("get_h_offset"), &Camera3D::get_h_offset);
  394. ClassDB::bind_method(D_METHOD("set_v_offset", "offset"), &Camera3D::set_v_offset);
  395. ClassDB::bind_method(D_METHOD("get_v_offset"), &Camera3D::get_v_offset);
  396. ClassDB::bind_method(D_METHOD("set_cull_mask", "mask"), &Camera3D::set_cull_mask);
  397. ClassDB::bind_method(D_METHOD("get_cull_mask"), &Camera3D::get_cull_mask);
  398. ClassDB::bind_method(D_METHOD("set_environment", "env"), &Camera3D::set_environment);
  399. ClassDB::bind_method(D_METHOD("get_environment"), &Camera3D::get_environment);
  400. ClassDB::bind_method(D_METHOD("set_effects", "env"), &Camera3D::set_effects);
  401. ClassDB::bind_method(D_METHOD("get_effects"), &Camera3D::get_effects);
  402. ClassDB::bind_method(D_METHOD("set_keep_aspect_mode", "mode"), &Camera3D::set_keep_aspect_mode);
  403. ClassDB::bind_method(D_METHOD("get_keep_aspect_mode"), &Camera3D::get_keep_aspect_mode);
  404. ClassDB::bind_method(D_METHOD("set_doppler_tracking", "mode"), &Camera3D::set_doppler_tracking);
  405. ClassDB::bind_method(D_METHOD("get_doppler_tracking"), &Camera3D::get_doppler_tracking);
  406. ClassDB::bind_method(D_METHOD("get_frustum"), &Camera3D::get_frustum);
  407. ClassDB::bind_method(D_METHOD("is_position_in_frustum", "world_point"), &Camera3D::is_position_in_frustum);
  408. ClassDB::bind_method(D_METHOD("get_camera_rid"), &Camera3D::get_camera);
  409. ClassDB::bind_method(D_METHOD("get_pyramid_shape_rid"), &Camera3D::get_pyramid_shape_rid);
  410. ClassDB::bind_method(D_METHOD("set_cull_mask_value", "layer_number", "value"), &Camera3D::set_cull_mask_value);
  411. ClassDB::bind_method(D_METHOD("get_cull_mask_value", "layer_number"), &Camera3D::get_cull_mask_value);
  412. //ClassDB::bind_method(D_METHOD("_camera_make_current"),&Camera::_camera_make_current );
  413. ADD_PROPERTY(PropertyInfo(Variant::INT, "keep_aspect", PROPERTY_HINT_ENUM, "Keep Width,Keep Height"), "set_keep_aspect_mode", "get_keep_aspect_mode");
  414. ADD_PROPERTY(PropertyInfo(Variant::INT, "cull_mask", PROPERTY_HINT_LAYERS_3D_RENDER), "set_cull_mask", "get_cull_mask");
  415. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "environment", PROPERTY_HINT_RESOURCE_TYPE, "Environment"), "set_environment", "get_environment");
  416. ADD_PROPERTY(PropertyInfo(Variant::OBJECT, "effects", PROPERTY_HINT_RESOURCE_TYPE, "CameraEffects"), "set_effects", "get_effects");
  417. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "h_offset", PROPERTY_HINT_NONE, "suffix:m"), "set_h_offset", "get_h_offset");
  418. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "v_offset", PROPERTY_HINT_NONE, "suffix:m"), "set_v_offset", "get_v_offset");
  419. ADD_PROPERTY(PropertyInfo(Variant::INT, "doppler_tracking", PROPERTY_HINT_ENUM, "Disabled,Idle,Physics"), "set_doppler_tracking", "get_doppler_tracking");
  420. ADD_PROPERTY(PropertyInfo(Variant::INT, "projection", PROPERTY_HINT_ENUM, "Perspective,Orthogonal,Frustum"), "set_projection", "get_projection");
  421. ADD_PROPERTY(PropertyInfo(Variant::BOOL, "current"), "set_current", "is_current");
  422. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "fov", PROPERTY_HINT_RANGE, "1,179,0.1,degrees"), "set_fov", "get_fov");
  423. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "size", PROPERTY_HINT_RANGE, "0.001,16384,0.01,suffix:m"), "set_size", "get_size");
  424. ADD_PROPERTY(PropertyInfo(Variant::VECTOR2, "frustum_offset", PROPERTY_HINT_NONE, "suffix:m"), "set_frustum_offset", "get_frustum_offset");
  425. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "near", PROPERTY_HINT_RANGE, "0.001,10,0.001,or_greater,exp,suffix:m"), "set_near", "get_near");
  426. ADD_PROPERTY(PropertyInfo(Variant::FLOAT, "far", PROPERTY_HINT_RANGE, "0.01,4000,0.01,or_greater,exp,suffix:m"), "set_far", "get_far");
  427. BIND_ENUM_CONSTANT(PROJECTION_PERSPECTIVE);
  428. BIND_ENUM_CONSTANT(PROJECTION_ORTHOGONAL);
  429. BIND_ENUM_CONSTANT(PROJECTION_FRUSTUM);
  430. BIND_ENUM_CONSTANT(KEEP_WIDTH);
  431. BIND_ENUM_CONSTANT(KEEP_HEIGHT);
  432. BIND_ENUM_CONSTANT(DOPPLER_TRACKING_DISABLED);
  433. BIND_ENUM_CONSTANT(DOPPLER_TRACKING_IDLE_STEP);
  434. BIND_ENUM_CONSTANT(DOPPLER_TRACKING_PHYSICS_STEP);
  435. }
  436. real_t Camera3D::get_fov() const {
  437. return fov;
  438. }
  439. real_t Camera3D::get_size() const {
  440. return size;
  441. }
  442. real_t Camera3D::get_near() const {
  443. return near;
  444. }
  445. Vector2 Camera3D::get_frustum_offset() const {
  446. return frustum_offset;
  447. }
  448. real_t Camera3D::get_far() const {
  449. return far;
  450. }
  451. Camera3D::ProjectionType Camera3D::get_projection() const {
  452. return mode;
  453. }
  454. void Camera3D::set_fov(real_t p_fov) {
  455. ERR_FAIL_COND(p_fov < 1 || p_fov > 179);
  456. fov = p_fov;
  457. _update_camera_mode();
  458. }
  459. void Camera3D::set_size(real_t p_size) {
  460. ERR_FAIL_COND(p_size < 0.001 || p_size > 16384);
  461. size = p_size;
  462. _update_camera_mode();
  463. }
  464. void Camera3D::set_near(real_t p_near) {
  465. near = p_near;
  466. _update_camera_mode();
  467. }
  468. void Camera3D::set_frustum_offset(Vector2 p_offset) {
  469. frustum_offset = p_offset;
  470. _update_camera_mode();
  471. }
  472. void Camera3D::set_far(real_t p_far) {
  473. far = p_far;
  474. _update_camera_mode();
  475. }
  476. void Camera3D::set_cull_mask(uint32_t p_layers) {
  477. layers = p_layers;
  478. RenderingServer::get_singleton()->camera_set_cull_mask(camera, layers);
  479. _update_camera_mode();
  480. }
  481. uint32_t Camera3D::get_cull_mask() const {
  482. return layers;
  483. }
  484. void Camera3D::set_cull_mask_value(int p_layer_number, bool p_value) {
  485. ERR_FAIL_COND_MSG(p_layer_number < 1, "Render layer number must be between 1 and 20 inclusive.");
  486. ERR_FAIL_COND_MSG(p_layer_number > 20, "Render layer number must be between 1 and 20 inclusive.");
  487. uint32_t mask = get_cull_mask();
  488. if (p_value) {
  489. mask |= 1 << (p_layer_number - 1);
  490. } else {
  491. mask &= ~(1 << (p_layer_number - 1));
  492. }
  493. set_cull_mask(mask);
  494. }
  495. bool Camera3D::get_cull_mask_value(int p_layer_number) const {
  496. ERR_FAIL_COND_V_MSG(p_layer_number < 1, false, "Render layer number must be between 1 and 20 inclusive.");
  497. ERR_FAIL_COND_V_MSG(p_layer_number > 20, false, "Render layer number must be between 1 and 20 inclusive.");
  498. return layers & (1 << (p_layer_number - 1));
  499. }
  500. Vector<Plane> Camera3D::get_frustum() const {
  501. ERR_FAIL_COND_V(!is_inside_world(), Vector<Plane>());
  502. Size2 viewport_size = get_viewport()->get_visible_rect().size;
  503. Projection cm;
  504. if (mode == PROJECTION_PERSPECTIVE) {
  505. cm.set_perspective(fov, viewport_size.aspect(), near, far, keep_aspect == KEEP_WIDTH);
  506. } else {
  507. cm.set_orthogonal(size, viewport_size.aspect(), near, far, keep_aspect == KEEP_WIDTH);
  508. }
  509. return cm.get_projection_planes(get_camera_transform());
  510. }
  511. bool Camera3D::is_position_in_frustum(const Vector3 &p_position) const {
  512. Vector<Plane> frustum = get_frustum();
  513. for (int i = 0; i < frustum.size(); i++) {
  514. if (frustum[i].is_point_over(p_position)) {
  515. return false;
  516. }
  517. }
  518. return true;
  519. }
  520. void Camera3D::set_v_offset(real_t p_offset) {
  521. v_offset = p_offset;
  522. _update_camera();
  523. }
  524. real_t Camera3D::get_v_offset() const {
  525. return v_offset;
  526. }
  527. void Camera3D::set_h_offset(real_t p_offset) {
  528. h_offset = p_offset;
  529. _update_camera();
  530. }
  531. real_t Camera3D::get_h_offset() const {
  532. return h_offset;
  533. }
  534. Vector3 Camera3D::get_doppler_tracked_velocity() const {
  535. if (doppler_tracking != DOPPLER_TRACKING_DISABLED) {
  536. return velocity_tracker->get_tracked_linear_velocity();
  537. } else {
  538. return Vector3();
  539. }
  540. }
  541. RID Camera3D::get_pyramid_shape_rid() {
  542. ERR_FAIL_COND_V_MSG(!is_inside_tree(), RID(), "Camera is not inside scene.");
  543. if (pyramid_shape == RID()) {
  544. pyramid_shape_points = get_near_plane_points();
  545. pyramid_shape = PhysicsServer3D::get_singleton()->convex_polygon_shape_create();
  546. PhysicsServer3D::get_singleton()->shape_set_data(pyramid_shape, pyramid_shape_points);
  547. } else { //check if points changed
  548. Vector<Vector3> local_points = get_near_plane_points();
  549. bool all_equal = true;
  550. for (int i = 0; i < 5; i++) {
  551. if (local_points[i] != pyramid_shape_points[i]) {
  552. all_equal = false;
  553. break;
  554. }
  555. }
  556. if (!all_equal) {
  557. PhysicsServer3D::get_singleton()->shape_set_data(pyramid_shape, local_points);
  558. pyramid_shape_points = local_points;
  559. }
  560. }
  561. return pyramid_shape;
  562. }
  563. Camera3D::Camera3D() {
  564. camera = RenderingServer::get_singleton()->camera_create();
  565. set_perspective(75.0, 0.05, 4000.0);
  566. RenderingServer::get_singleton()->camera_set_cull_mask(camera, layers);
  567. //active=false;
  568. velocity_tracker.instantiate();
  569. set_notify_transform(true);
  570. set_disable_scale(true);
  571. }
  572. Camera3D::~Camera3D() {
  573. RenderingServer::get_singleton()->free(camera);
  574. if (pyramid_shape.is_valid()) {
  575. PhysicsServer3D::get_singleton()->free(pyramid_shape);
  576. }
  577. }