mirror of
https://github.com/godotengine/godot.git
synced 2024-11-27 09:16:35 +08:00
ae18928748
"sampling" is a more accurate term than "interpolating" for what's happening when using that function.
312 lines
10 KiB
C++
312 lines
10 KiB
C++
/*************************************************************************/
|
|
/* curve.h */
|
|
/*************************************************************************/
|
|
/* This file is part of: */
|
|
/* GODOT ENGINE */
|
|
/* https://godotengine.org */
|
|
/*************************************************************************/
|
|
/* Copyright (c) 2007-2022 Juan Linietsky, Ariel Manzur. */
|
|
/* Copyright (c) 2014-2022 Godot Engine contributors (cf. AUTHORS.md). */
|
|
/* */
|
|
/* Permission is hereby granted, free of charge, to any person obtaining */
|
|
/* a copy of this software and associated documentation files (the */
|
|
/* "Software"), to deal in the Software without restriction, including */
|
|
/* without limitation the rights to use, copy, modify, merge, publish, */
|
|
/* distribute, sublicense, and/or sell copies of the Software, and to */
|
|
/* permit persons to whom the Software is furnished to do so, subject to */
|
|
/* the following conditions: */
|
|
/* */
|
|
/* The above copyright notice and this permission notice shall be */
|
|
/* included in all copies or substantial portions of the Software. */
|
|
/* */
|
|
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
|
|
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
|
|
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.*/
|
|
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
|
|
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
|
|
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
|
|
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
|
|
/*************************************************************************/
|
|
|
|
#ifndef CURVE_H
|
|
#define CURVE_H
|
|
|
|
#include "core/io/resource.h"
|
|
|
|
// y(x) curve
|
|
class Curve : public Resource {
|
|
GDCLASS(Curve, Resource);
|
|
|
|
public:
|
|
static const int MIN_X = 0.f;
|
|
static const int MAX_X = 1.f;
|
|
|
|
static const char *SIGNAL_RANGE_CHANGED;
|
|
|
|
enum TangentMode {
|
|
TANGENT_FREE = 0,
|
|
TANGENT_LINEAR,
|
|
TANGENT_MODE_COUNT
|
|
};
|
|
|
|
struct Point {
|
|
Vector2 position;
|
|
real_t left_tangent = 0.0;
|
|
real_t right_tangent = 0.0;
|
|
TangentMode left_mode = TANGENT_FREE;
|
|
TangentMode right_mode = TANGENT_FREE;
|
|
|
|
Point() {
|
|
}
|
|
|
|
Point(const Vector2 &p_position,
|
|
real_t p_left = 0.0,
|
|
real_t p_right = 0.0,
|
|
TangentMode p_left_mode = TANGENT_FREE,
|
|
TangentMode p_right_mode = TANGENT_FREE) {
|
|
position = p_position;
|
|
left_tangent = p_left;
|
|
right_tangent = p_right;
|
|
left_mode = p_left_mode;
|
|
right_mode = p_right_mode;
|
|
}
|
|
};
|
|
|
|
Curve();
|
|
|
|
int get_point_count() const { return _points.size(); }
|
|
|
|
void set_point_count(int p_count);
|
|
|
|
int add_point(Vector2 p_position,
|
|
real_t left_tangent = 0,
|
|
real_t right_tangent = 0,
|
|
TangentMode left_mode = TANGENT_FREE,
|
|
TangentMode right_mode = TANGENT_FREE);
|
|
void remove_point(int p_index);
|
|
void clear_points();
|
|
|
|
int get_index(real_t p_offset) const;
|
|
|
|
void set_point_value(int p_index, real_t p_position);
|
|
int set_point_offset(int p_index, real_t p_offset);
|
|
Vector2 get_point_position(int p_index) const;
|
|
|
|
Point get_point(int p_index) const;
|
|
|
|
real_t get_min_value() const { return _min_value; }
|
|
void set_min_value(real_t p_min);
|
|
|
|
real_t get_max_value() const { return _max_value; }
|
|
void set_max_value(real_t p_max);
|
|
|
|
real_t sample(real_t p_offset) const;
|
|
real_t sample_local_nocheck(int p_index, real_t p_local_offset) const;
|
|
|
|
void clean_dupes();
|
|
|
|
void set_point_left_tangent(int p_index, real_t p_tangent);
|
|
void set_point_right_tangent(int p_index, real_t p_tangent);
|
|
void set_point_left_mode(int p_index, TangentMode p_mode);
|
|
void set_point_right_mode(int p_index, TangentMode p_mode);
|
|
|
|
real_t get_point_left_tangent(int p_index) const;
|
|
real_t get_point_right_tangent(int p_index) const;
|
|
TangentMode get_point_left_mode(int p_index) const;
|
|
TangentMode get_point_right_mode(int p_index) const;
|
|
|
|
void update_auto_tangents(int i);
|
|
|
|
Array get_data() const;
|
|
void set_data(Array input);
|
|
|
|
void bake();
|
|
int get_bake_resolution() const { return _bake_resolution; }
|
|
void set_bake_resolution(int p_resolution);
|
|
real_t sample_baked(real_t p_offset) const;
|
|
|
|
void ensure_default_setup(real_t p_min, real_t p_max);
|
|
|
|
bool _set(const StringName &p_name, const Variant &p_value);
|
|
bool _get(const StringName &p_name, Variant &r_ret) const;
|
|
void _get_property_list(List<PropertyInfo> *p_list) const;
|
|
|
|
protected:
|
|
static void _bind_methods();
|
|
|
|
private:
|
|
void mark_dirty();
|
|
int _add_point(Vector2 p_position,
|
|
real_t left_tangent = 0,
|
|
real_t right_tangent = 0,
|
|
TangentMode left_mode = TANGENT_FREE,
|
|
TangentMode right_mode = TANGENT_FREE);
|
|
void _remove_point(int p_index);
|
|
|
|
Vector<Point> _points;
|
|
bool _baked_cache_dirty = false;
|
|
Vector<real_t> _baked_cache;
|
|
int _bake_resolution = 100;
|
|
real_t _min_value = 0.0;
|
|
real_t _max_value = 1.0;
|
|
int _minmax_set_once = 0b00; // Encodes whether min and max have been set a first time, first bit for min and second for max.
|
|
};
|
|
|
|
VARIANT_ENUM_CAST(Curve::TangentMode)
|
|
|
|
class Curve2D : public Resource {
|
|
GDCLASS(Curve2D, Resource);
|
|
|
|
struct Point {
|
|
Vector2 in;
|
|
Vector2 out;
|
|
Vector2 position;
|
|
};
|
|
|
|
Vector<Point> points;
|
|
|
|
struct BakedPoint {
|
|
real_t ofs = 0.0;
|
|
Vector2 point;
|
|
};
|
|
|
|
mutable bool baked_cache_dirty = false;
|
|
mutable PackedVector2Array baked_point_cache;
|
|
mutable Vector<real_t> baked_dist_cache;
|
|
mutable real_t baked_max_ofs = 0.0;
|
|
|
|
void mark_dirty();
|
|
|
|
void _bake() const;
|
|
|
|
real_t bake_interval = 5.0;
|
|
|
|
void _bake_segment2d(RBMap<real_t, Vector2> &r_bake, real_t p_begin, real_t p_end, const Vector2 &p_a, const Vector2 &p_out, const Vector2 &p_b, const Vector2 &p_in, int p_depth, int p_max_depth, real_t p_tol) const;
|
|
Dictionary _get_data() const;
|
|
void _set_data(const Dictionary &p_data);
|
|
|
|
bool _set(const StringName &p_name, const Variant &p_value);
|
|
bool _get(const StringName &p_name, Variant &r_ret) const;
|
|
void _get_property_list(List<PropertyInfo> *p_list) const;
|
|
|
|
void _add_point(const Vector2 &p_position, const Vector2 &p_in = Vector2(), const Vector2 &p_out = Vector2(), int p_atpos = -1);
|
|
void _remove_point(int p_index);
|
|
|
|
protected:
|
|
static void _bind_methods();
|
|
|
|
public:
|
|
int get_point_count() const;
|
|
void set_point_count(int p_count);
|
|
void add_point(const Vector2 &p_position, const Vector2 &p_in = Vector2(), const Vector2 &p_out = Vector2(), int p_atpos = -1);
|
|
void set_point_position(int p_index, const Vector2 &p_position);
|
|
Vector2 get_point_position(int p_index) const;
|
|
void set_point_in(int p_index, const Vector2 &p_in);
|
|
Vector2 get_point_in(int p_index) const;
|
|
void set_point_out(int p_index, const Vector2 &p_out);
|
|
Vector2 get_point_out(int p_index) const;
|
|
void remove_point(int p_index);
|
|
void clear_points();
|
|
|
|
Vector2 sample(int p_index, real_t p_offset) const;
|
|
Vector2 samplef(real_t p_findex) const;
|
|
|
|
void set_bake_interval(real_t p_tolerance);
|
|
real_t get_bake_interval() const;
|
|
|
|
real_t get_baked_length() const;
|
|
Vector2 sample_baked(real_t p_offset, bool p_cubic = false) const;
|
|
PackedVector2Array get_baked_points() const; //useful for going through
|
|
Vector2 get_closest_point(const Vector2 &p_to_point) const;
|
|
real_t get_closest_offset(const Vector2 &p_to_point) const;
|
|
|
|
PackedVector2Array tessellate(int p_max_stages = 5, real_t p_tolerance = 4) const; //useful for display
|
|
|
|
Curve2D();
|
|
};
|
|
|
|
class Curve3D : public Resource {
|
|
GDCLASS(Curve3D, Resource);
|
|
|
|
struct Point {
|
|
Vector3 in;
|
|
Vector3 out;
|
|
Vector3 position;
|
|
real_t tilt = 0.0;
|
|
};
|
|
|
|
Vector<Point> points;
|
|
|
|
struct BakedPoint {
|
|
real_t ofs = 0.0;
|
|
Vector3 point;
|
|
};
|
|
|
|
mutable bool baked_cache_dirty = false;
|
|
mutable PackedVector3Array baked_point_cache;
|
|
mutable Vector<real_t> baked_tilt_cache;
|
|
mutable PackedVector3Array baked_up_vector_cache;
|
|
mutable Vector<real_t> baked_dist_cache;
|
|
mutable real_t baked_max_ofs = 0.0;
|
|
|
|
void mark_dirty();
|
|
|
|
void _bake() const;
|
|
|
|
real_t bake_interval = 0.2;
|
|
bool up_vector_enabled = true;
|
|
|
|
void _bake_segment3d(RBMap<real_t, Vector3> &r_bake, real_t p_begin, real_t p_end, const Vector3 &p_a, const Vector3 &p_out, const Vector3 &p_b, const Vector3 &p_in, int p_depth, int p_max_depth, real_t p_tol) const;
|
|
Dictionary _get_data() const;
|
|
void _set_data(const Dictionary &p_data);
|
|
|
|
bool _set(const StringName &p_name, const Variant &p_value);
|
|
bool _get(const StringName &p_name, Variant &r_ret) const;
|
|
void _get_property_list(List<PropertyInfo> *p_list) const;
|
|
|
|
void _add_point(const Vector3 &p_position, const Vector3 &p_in = Vector3(), const Vector3 &p_out = Vector3(), int p_atpos = -1);
|
|
void _remove_point(int p_index);
|
|
|
|
protected:
|
|
static void _bind_methods();
|
|
|
|
public:
|
|
int get_point_count() const;
|
|
void set_point_count(int p_count);
|
|
void add_point(const Vector3 &p_position, const Vector3 &p_in = Vector3(), const Vector3 &p_out = Vector3(), int p_atpos = -1);
|
|
void set_point_position(int p_index, const Vector3 &p_position);
|
|
Vector3 get_point_position(int p_index) const;
|
|
void set_point_tilt(int p_index, real_t p_tilt);
|
|
real_t get_point_tilt(int p_index) const;
|
|
void set_point_in(int p_index, const Vector3 &p_in);
|
|
Vector3 get_point_in(int p_index) const;
|
|
void set_point_out(int p_index, const Vector3 &p_out);
|
|
Vector3 get_point_out(int p_index) const;
|
|
void remove_point(int p_index);
|
|
void clear_points();
|
|
|
|
Vector3 sample(int p_index, real_t p_offset) const;
|
|
Vector3 samplef(real_t p_findex) const;
|
|
|
|
void set_bake_interval(real_t p_tolerance);
|
|
real_t get_bake_interval() const;
|
|
void set_up_vector_enabled(bool p_enable);
|
|
bool is_up_vector_enabled() const;
|
|
|
|
real_t get_baked_length() const;
|
|
Vector3 sample_baked(real_t p_offset, bool p_cubic = false) const;
|
|
real_t sample_baked_tilt(real_t p_offset) const;
|
|
Vector3 sample_baked_up_vector(real_t p_offset, bool p_apply_tilt = false) const;
|
|
PackedVector3Array get_baked_points() const; //useful for going through
|
|
Vector<real_t> get_baked_tilts() const; //useful for going through
|
|
PackedVector3Array get_baked_up_vectors() const;
|
|
Vector3 get_closest_point(const Vector3 &p_to_point) const;
|
|
real_t get_closest_offset(const Vector3 &p_to_point) const;
|
|
|
|
PackedVector3Array tessellate(int p_max_stages = 5, real_t p_tolerance = 4) const; //useful for display
|
|
|
|
Curve3D();
|
|
};
|
|
|
|
#endif // CURVE_H
|