# Geometry {% hint style="warning" %} **SHARED FUNCTIONS** {% endhint %} ## distance\_2d Calculates the distance between two 2D points. #### Parameters * p1: `table` * p2: `table` #### Returns * `number` ```lua bdtk.distance_2d(p1, p2) ``` *** ## distance\_3d Calculates the distance between two 3D points. #### Parameters * p1: `table` * p2: `table` #### Returns * `number` ```lua bdtk.distance_3d(p1, p2) ``` *** ## midpoint Returns the midpoint between two 3D points. #### Parameters * p1: `table` * p2: `table` #### Returns * `table` ```lua bdtk.midpoint(p1, p2) ``` *** ## is\_point\_in\_rect Determines if a point is inside a given 2D rectangle boundary. #### Parameters * point: `table` * rect: `table` #### Returns * `boolean` ```lua bdtk.is_point_in_rect(point, rect) ``` *** ## is\_point\_in\_box Determines if a point is inside a given 3D box boundary. #### Parameters * point: `table` * box: `table` #### Returns * `boolean` ```lua bdtk.is_point_in_box(point, box) ``` *** ## is\_point\_on\_line\_segment Determines if a point is on a line segment defined by two 2D points. #### Parameters * point: `table` * line\_start: `table` * line\_end: `table` #### Returns * `boolean` ```lua bdtk.is_point_on_line_segment(point, line_start, line_end) ``` *** ## project\_point\_on\_line Projects a point onto a line segment defined by two 2D points. #### Parameters * p: `table` * p1: `table` * p2: `table` #### Returns * `table` ```lua bdtk.project_point_on_line(p, p1, p2) ``` *** ## calculate\_slope Calculates the slope of a line given two 2D points. #### Parameters * p1: `table` * p2: `table` #### Returns * `number` ```lua bdtk.calculate_slope(p1, p2) ``` *** ## angle\_between\_points Returns the angle between two 2D points in degrees. #### Parameters * p1: `table` * p2: `table` #### Returns * `number` ```lua bdtk.angle_between_points(p1, p2) ``` *** ## angle\_between\_3\_points Calculates the angle between three 3D points (p1, p2 as center, p3). #### Parameters * p1: `table` * p2: `table` * p3: `table` #### Returns * `number` ```lua bdtk.angle_between_3_points(p1, p2, p3) ``` *** ## do\_circles\_intersect Determines if two circles defined by center and radius intersect. #### Parameters * c1\_center: `table` * c1\_radius: `number` * c2\_center: `table` * c2\_radius: `number` #### Returns * `boolean` ```lua bdtk.do_circles_intersect(c1_center, c1_radius, c2_center, c2_radius) ``` *** ## is\_point\_in\_circle Determines if a point is inside a circle defined by center and radius. #### Parameters * point: `table` * circle\_center: `table` * circle\_radius: `number` #### Returns * `boolean` ```lua bdtk.is_point_in_circle(point, circle_center, circle_radius) ``` *** ## do\_lines\_intersect Determines if two 2D line segments intersect. #### Parameters * l1\_start: `table` * l1\_end: `table` * l2\_start: `table` * l2\_end: `table` #### Returns * `boolean` ```lua bdtkbdtk.do_lines_intersect(l1_start, l1_end, l2_start, l2_end) ``` *** ## line\_intersects\_circle Determines if a line segment intersects a circle. #### Parameters * line\_start: `table` * line\_end: `table` * circle\_center: `table` * circle\_radius: `number` #### Returns * `boolean` ```lua bdtk.line_intersects_circle(line_start, line_end, circle_center, circle_radius) ``` *** ## does\_rect\_intersect\_line Determines if a rectangle intersects with a 2D line segment. #### Parameters * rect: `table` * line\_start: `table` * line\_end: `table` #### Returns * `boolean` ```lua bdtk.does_rect_intersect_line(rect, line_start, line_end) ``` *** ## closest\_point\_on\_line\_segment Determines the closest point on a 2D line segment to a given point. #### Parameters * point: `table` * line\_start: `table` * line\_end: `table` #### Returns * `table` ```lua bdtk.closest_point_on_line_segment(point, line_start, line_end) ``` *** ## triangle\_area\_3d Calculates the area of a 3D triangle given three points. #### Parameters * p1: `table` * p2: `table` * p3: `table` #### Returns * `number` ```lua bdtk.triangle_area_3d(p1, p2, p3) ``` *** ## is\_point\_in\_sphere Determines if a point is inside a 3D sphere defined by center and radius. #### Parameters * point: `table` * sphere\_center: `table` * sphere\_radius: `number` #### Returns * `boolean` ```lua bdtk.is_point_in_sphere(point, sphere_center, sphere_radius) ``` *** ## do\_spheres\_intersect Determines if two spheres intersect. #### Parameters * s1\_center: `table` * s1\_radius: `number` * s2\_center: `table` * s2\_radius: `number` #### Returns * `boolean` ```lua bdtk.do_spheres_intersect(s1_center, s1_radius, s2_center, s2_radius) ``` *** ## is\_point\_in\_convex\_polygon Determines if a point is inside a 2D convex polygon. #### Parameters * point: `table` * polygon: `table` #### Returns * `boolean` ```lua bdtk.is_point_in_convex_polygon(point, polygon) ``` *** ## rotate\_point\_around\_point\_2d Rotates a point around another point in 2D by a given angle in degrees. #### Parameters * point: `table` * pivot: `table` * angle\_degrees: `number` #### Returns * `table` ```lua bdtk.rotate_point_around_point_2d(point, pivot, angle_degrees) ``` *** ## distance\_point\_to\_plane Calculates the distance from a point to a plane. #### Parameters * point: `table` * plane\_point: `table` * plane\_normal: `table` #### Returns * `number` ```lua bdtk.distance_point_to_plane(point, plane_point, plane_normal) ``` *** ## rotation\_to\_direction Converts a rotation vector to a direction vector. #### Parameters * rotation: `table` #### Returns * `table` ```lua bdtk.rotation_to_direction(rotation) ``` *** ## rotate\_box Rotates a box around a central point in 3D by a given heading. #### Parameters * center: `table` * width: `number` * length: `number` * heading: `number` #### Returns * `table` ```lua bdtk.rotate_box(center, width, length, heading) ``` *** ## calculate\_rotation\_matrix Calculates a rotation matrix from heading, pitch, and roll. #### Parameters * heading: `number` * pitch: `number` * roll: `number` #### Returns * `table` ```lua geometry.calculate_rotation_matrix(heading, pitch, roll) ``` *** ## translate\_point\_to\_local\_space Translates a point to a box's local coordinate system using a rotation matrix. #### Parameters * point: `table` * box\_origin: `table` * rot\_matrix: `table` #### Returns * `table` ```lua bdtk.translate_point_to_local_space(point, box_origin, rot_matrix) ``` *** ## is\_point\_in\_oriented\_box Determines if a point is inside an oriented 3D box. #### Parameters * point: `table` * box: `table` #### Returns * `boolean` ```lua bdtk.is_point_in_oriented_box(point, box) ``` --- # Agent Instructions: Querying This Documentation If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question. Perform an HTTP GET request on the current page URL with the `ask` query parameter: ``` GET https://docs.boii.dev/fivem-free-resources/bdtk/api/modules/geometry.md?ask= ``` The question should be specific, self-contained, and written in natural language. The response will contain a direct answer to the question and relevant excerpts and sources from the documentation. Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.