|
Blender V4.5
|
#include <algorithm>#include "MEM_guardedalloc.h"#include "DNA_curve_types.h"#include "DNA_curveprofile_types.h"#include "BLI_math_geom.h"#include "BLI_math_vector.h"#include "BLI_rect.h"#include "BLI_utildefines.h"#include "BKE_curve.hh"#include "BKE_curveprofile.h"#include "BLO_read_write.hh"Go to the source code of this file.
Classes | |
| struct | CurvatureSortPoint |
Macros | |
| #define | PROF_TABLE_MAX 512 |
| #define PROF_TABLE_MAX 512 |
Number of points in high resolution table is dynamic up to a maximum.
Definition at line 27 of file curveprofile.cc.
Referenced by BKE_curveprofile_insert(), and BKE_curveprofile_table_size().
|
static |
Helper function for create_samples. Calculates the angle between the handles on the inside of the edge starting at index i. A larger angle means the edge is more curved.
| i_edge | The start index of the edge to calculate the angle for. |
Definition at line 629 of file curveprofile.cc.
References angle_v2v2(), bezt_edge_handle_angle(), sub_v2_v2v2(), and x.
Referenced by bezt_edge_handle_angle(), and create_samples().
| CurveProfile * BKE_curveprofile_add | ( | eCurveProfilePresets | preset | ) |
Returns a pointer to a newly allocated curve profile, using the given preset.
Definition at line 33 of file curveprofile.cc.
References BKE_curveprofile_add(), BKE_curveprofile_reset(), BKE_curveprofile_set_defaults(), BKE_curveprofile_update(), MEM_callocN(), and CurveProfile::preset.
Referenced by BKE_curveprofile_add(), blo_do_versions_280(), blo_update_defaults_scene(), init_data(), and scene_init_data().
| void BKE_curveprofile_blend_read | ( | struct BlendDataReader * | reader, |
| struct CurveProfile * | profile ) |
Expects that the curve profile itself has been read already.
Definition at line 90 of file curveprofile.cc.
References BKE_curveprofile_blend_read(), BKE_curveprofile_init(), BLO_read_struct_array, i, CurveProfile::path, CurveProfile::path_len, CurveProfilePoint::profile, CurveProfile::segments, CurveProfile::segments_len, and CurveProfile::table.
Referenced by BKE_curveprofile_blend_read(), BKE_curveprofile_blend_write(), blend_read(), curve_blend_read_data(), and scene_blend_read_data().
| void BKE_curveprofile_blend_write | ( | BlendWriter * | writer, |
| const CurveProfile * | profile ) |
Definition at line 84 of file curveprofile.cc.
References BKE_curveprofile_blend_write(), BLO_write_struct, BLO_write_struct_array, CurveProfile::path, and CurveProfile::path_len.
| CurveProfile * BKE_curveprofile_copy | ( | const CurveProfile * | profile | ) |
Definition at line 74 of file curveprofile.cc.
References BKE_curveprofile_copy(), BKE_curveprofile_copy_data(), and MEM_dupallocN().
| void BKE_curveprofile_copy_data | ( | CurveProfile * | target, |
| const CurveProfile * | profile ) |
Definition at line 60 of file curveprofile.cc.
References BKE_curveprofile_copy_data(), i, MEM_dupallocN(), CurveProfile::path, CurveProfile::path_len, CurveProfilePoint::profile, CurveProfile::segments, and CurveProfile::table.
| void BKE_curveprofile_evaluate_length_portion | ( | const CurveProfile * | profile, |
| float | length_portion, | ||
| float * | x_out, | ||
| float * | y_out ) |
Definition at line 1021 of file curveprofile.cc.
References BKE_curveprofile_evaluate_length_portion(), BKE_curveprofile_table_size(), curveprofile_distance_to_next_table_point(), curveprofile_total_length(), i, interpf(), CurveProfile::path, printf, CurveProfile::table, CurveProfilePoint::x, and CurveProfilePoint::y.
| void BKE_curveprofile_free | ( | CurveProfile * | profile | ) |
Definition at line 52 of file curveprofile.cc.
References BKE_curveprofile_free(), BKE_curveprofile_free_data(), and MEM_freeN().
Referenced by BKE_curveprofile_free(), BKE_toolsettings_free(), curve_free_data(), and free_data().
| void BKE_curveprofile_free_data | ( | CurveProfile * | profile | ) |
Definition at line 45 of file curveprofile.cc.
References BKE_curveprofile_free_data(), MEM_SAFE_FREE, CurveProfile::path, CurveProfile::segments, and CurveProfile::table.
Referenced by BKE_curveprofile_free(), BKE_curveprofile_free_data(), ui_but_clipboard_free(), ui_but_copy_CurveProfile(), and ui_but_paste_CurveProfile().
| void BKE_curveprofile_init | ( | struct CurveProfile * | profile, |
| short | segments_len ) |
Refreshes the higher resolution table sampled from the input points. A call to this or BKE_curveprofile_update is needed before evaluation functions that use the table. Also sets the number of segments used for the display preview of the locations of the sampled points.
Definition at line 823 of file curveprofile.cc.
References BKE_curveprofile_init(), BKE_curveprofile_update(), CurveProfile::flag, PROF_DIRTY_PRESET, PROF_UPDATE_NONE, and CurveProfile::segments_len.
Referenced by BKE_curveprofile_blend_read(), BKE_curveprofile_init(), BKE_curveprofile_table_size(), and set_profile_spacing().
| CurveProfilePoint * BKE_curveprofile_insert | ( | struct CurveProfile * | profile, |
| float | x, | ||
| float | y ) |
Adds a new point at the specified location. The choice for which points to place the new vertex between is made by checking which control point line segment is closest to the new point and placing the new vertex in between that segment's points.
Definition at line 266 of file curveprofile.cc.
References BKE_curveprofile_insert(), dist_squared_to_line_segment_v2(), distance(), CurveProfilePoint::flag, FLT_MAX, CurveProfilePoint::h1, CurveProfilePoint::h2, HD_AUTO, HD_VECT, i, MEM_freeN(), MEM_malloc_arrayN(), CurveProfile::path, CurveProfile::path_len, point_init(), PROF_SELECT, PROF_TABLE_MAX, CurveProfilePoint::profile, CurveProfilePoint::x, x, CurveProfilePoint::y, and y.
Referenced by BKE_curveprofile_copy(), BKE_curveprofile_insert(), and ui_do_but_CURVEPROFILE().
| bool BKE_curveprofile_move_handle | ( | struct CurveProfilePoint * | point, |
| bool | handle_1, | ||
| bool | snap, | ||
| const float | delta[2] ) |
Move a point's handle, accounting for the alignment of handles with the HD_ALIGN type.
| handle_1 | Whether to move the 1st or 2nd control point. |
| delta | The relative change in the handle's position. |
Definition at line 110 of file curveprofile.cc.
References BKE_curveprofile_move_handle(), copy_v2_v2(), ELEM, equals_v2v2(), CurveProfilePoint::h1, CurveProfilePoint::h1_loc, CurveProfilePoint::h2, CurveProfilePoint::h2_loc, HD_ALIGN, HD_FREE, snap(), CurveProfilePoint::x, and CurveProfilePoint::y.
Referenced by BKE_curveprofile_copy(), BKE_curveprofile_move_handle(), BKE_curveprofile_selected_handle_set(), and ui_numedit_but_CURVEPROFILE().
| bool BKE_curveprofile_move_point | ( | struct CurveProfile * | profile, |
| struct CurveProfilePoint * | point, | ||
| bool | snap, | ||
| const float | delta[2] ) |
Moves a control point, accounting for clipping and snapping, and moving free handles.
| snap | Whether to snap the point to the grid |
| delta | The relative change of the point's location. |
Definition at line 150 of file curveprofile.cc.
References BKE_curveprofile_move_point(), CurveProfile::clip_rect, ELEM, CurveProfile::flag, CurveProfilePoint::h1, CurveProfilePoint::h1_loc, CurveProfilePoint::h2, CurveProfilePoint::h2_loc, HD_ALIGN, HD_FREE, max_ff(), min_ff(), CurveProfile::path, CurveProfile::path_len, PROF_USE_CLIP, snap(), CurveProfilePoint::x, rctf::xmax, rctf::xmin, CurveProfilePoint::y, rctf::ymax, and rctf::ymin.
Referenced by BKE_curveprofile_copy(), BKE_curveprofile_move_point(), and ui_numedit_but_CURVEPROFILE().
| void BKE_curveprofile_remove_by_flag | ( | struct CurveProfile * | profile, |
| short | flag ) |
Removes every point in the widget with the supplied flag set, except for the first and last.
| flag | CurveProfilePoint.flag. |
Definition at line 227 of file curveprofile.cc.
References BKE_curveprofile_remove_by_flag(), CurveProfilePoint::flag, MEM_freeN(), MEM_malloc_arrayN(), CurveProfile::path, and CurveProfile::path_len.
Referenced by BKE_curveprofile_copy(), BKE_curveprofile_remove_by_flag(), CurveProfile_buttons_layout(), and ui_do_but_CURVEPROFILE().
| bool BKE_curveprofile_remove_point | ( | struct CurveProfile * | profile, |
| struct CurveProfilePoint * | point ) |
Removes a specific point from the path of control points.
Definition at line 197 of file curveprofile.cc.
References BKE_curveprofile_remove_point(), BLI_assert, MEM_freeN(), MEM_malloc_arrayN(), CurveProfile::path, and CurveProfile::path_len.
Referenced by BKE_curveprofile_copy(), BKE_curveprofile_remove_point(), and BKE_curveprofile_update().
| void BKE_curveprofile_reset | ( | struct CurveProfile * | profile | ) |
Resets the profile to the current preset.
Definition at line 424 of file curveprofile.cc.
References BKE_curveprofile_reset(), curveprofile_build_steps(), curveprofile_build_supports(), CurveProfile::flag, HD_AUTO, HD_VECT, i, MEM_calloc_arrayN(), MEM_SAFE_FREE, CurveProfile::path, CurveProfile::path_len, point_init(), CurveProfile::preset, PROF_DIRTY_PRESET, PROF_PRESET_CORNICE, PROF_PRESET_CROWN, PROF_PRESET_LINE, PROF_PRESET_STEPS, PROF_PRESET_SUPPORTS, CurveProfilePoint::profile, CurveProfile::segments_len, and CurveProfile::table.
Referenced by BKE_curveprofile_add(), BKE_curveprofile_copy(), BKE_curveprofile_reset(), curve_profile_presets_fn(), curve_profile_tools_fn(), and CurveProfile_buttons_layout().
| void BKE_curveprofile_reset_view | ( | struct CurveProfile * | profile | ) |
Reset the view to the clipping rectangle.
Definition at line 419 of file curveprofile.cc.
References BKE_curveprofile_reset_view(), CurveProfile::clip_rect, and CurveProfile::view_rect.
Referenced by BKE_curveprofile_copy(), BKE_curveprofile_reset_view(), and curve_profile_tools_fn().
| void BKE_curveprofile_reverse | ( | struct CurveProfile * | profile | ) |
Flips the profile across the diagonal so that its orientation is reversed.
Definition at line 343 of file curveprofile.cc.
References BKE_curveprofile_reverse(), BLI_assert, ELEM, CurveProfilePoint::h1, CurveProfilePoint::h1_loc, CurveProfilePoint::h2, CurveProfilePoint::h2_loc, HD_ALIGN, HD_FREE, i, MEM_freeN(), MEM_malloc_arrayN(), mirror_point(), CurveProfile::path, CurveProfile::path_len, and CurveProfilePoint::profile.
Referenced by BKE_curveprofile_copy(), BKE_curveprofile_reverse(), and CurveProfile_buttons_layout().
| void BKE_curveprofile_selected_handle_set | ( | struct CurveProfile * | profile, |
| int | type_1, | ||
| int | type_2 ) |
Sets the handle type of the selected control points.
| type_1,type_2 | Handle type for the first handle. HD_VECT, HD_AUTO, HD_FREE, or HD_ALIGN. |
Definition at line 321 of file curveprofile.cc.
References BKE_curveprofile_move_handle(), BKE_curveprofile_selected_handle_set(), ELEM, CurveProfilePoint::flag, CurveProfilePoint::h1, CurveProfilePoint::h2, HD_ALIGN, i, CurveProfile::path, CurveProfile::path_len, PROF_H1_SELECT, PROF_H2_SELECT, and PROF_SELECT.
Referenced by BKE_curveprofile_copy(), and BKE_curveprofile_selected_handle_set().
| void BKE_curveprofile_set_defaults | ( | struct CurveProfile * | profile | ) |
Sets the default settings and clip range for the profile widget. Does not generate either table.
Definition at line 803 of file curveprofile.cc.
References BKE_curveprofile_set_defaults(), BLI_rctf_init(), CurveProfile::changed_timestamp, CurveProfile::clip_rect, CurveProfile::flag, MEM_calloc_arrayN(), CurveProfile::path, CurveProfile::path_len, PROF_USE_CLIP, CurveProfilePoint::profile, CurveProfile::view_rect, CurveProfilePoint::x, and CurveProfilePoint::y.
Referenced by BKE_curveprofile_add(), and BKE_curveprofile_set_defaults().
| int BKE_curveprofile_table_size | ( | const CurveProfile * | profile | ) |
Number of table points per control point.
Definition at line 521 of file curveprofile.cc.
References BKE_curveprofile_table_size(), CurveProfile::path_len, and PROF_TABLE_MAX.
| void BKE_curveprofile_update | ( | struct CurveProfile * | profile, |
| int | update_flags ) |
Should be called after the widget is changed. Does profile and remove double checks and more importantly, recreates the display / evaluation and segments tables.
| update_flags | Bit-field with fields defined in header file. Controls removing doubles and clipping. |
Definition at line 966 of file curveprofile.cc.
References BKE_curveprofile_remove_point(), BKE_curveprofile_update(), BLI_assert, BLI_rctf_size_x(), BLI_rctf_size_y(), CurveProfile::changed_timestamp, clamp_f(), CurveProfile::clip_rect, curveprofile_make_segments_table(), curveprofile_make_table(), CurveProfile::flag, i, len_squared_v2v2(), CurveProfile::path, CurveProfile::path_len, pow2f(), PROF_UPDATE_CLIP, PROF_UPDATE_REMOVE_DOUBLES, PROF_USE_CLIP, CurveProfile::segments_len, CurveProfile::view_rect, CurveProfilePoint::x, x, rctf::xmax, rctf::xmin, CurveProfilePoint::y, y, rctf::ymax, and rctf::ymin.
Referenced by BKE_curveprofile_add(), BKE_curveprofile_init(), BKE_curveprofile_update(), curve_profile_presets_fn(), curve_profile_tools_fn(), CurveProfile_buttons_layout(), ui_do_but_CURVEPROFILE(), ui_draw_but_CURVEPROFILE(), and ui_numedit_but_CURVEPROFILE().
|
static |
Definition at line 614 of file curveprofile.cc.
References calculate_path_handles(), i, and point_calculate_handle().
Referenced by calculate_path_handles(), and create_samples().
|
static |
Used for sampling curves along the profile's path. Any points more than the number of user-defined points will be evenly distributed among the curved edges. Then the remainders will be distributed to the most curved edges.
| n_segments | The number of segments to sample along the path. Ideally it is higher than the number of points used to define the profile (profile->path_len). |
| sample_straight_edges | Whether to sample points between vector handle control points. If this is true and there are only vector edges the straight edges will still be sampled. |
| r_samples | Return array of points to put the sampled positions. Must have length n_segments. Fill the array with the sampled locations and if the point corresponds to a control point, its handle type. |
Definition at line 677 of file curveprofile.cc.
References bezt_edge_handle_angle(), BKE_curve_forward_diff_bezier(), BLI_assert, calculate_path_handles(), create_samples(), CurveProfilePoint::flag, CurveProfilePoint::h1, CurveProfilePoint::h2, HD_AUTO, i, INT16_MAX, is_curved_edge(), MEM_calloc_arrayN(), MEM_freeN(), CurveProfile::path, CurveProfile::path_len, CurvatureSortPoint::point_curvature, CurvatureSortPoint::point_index, sort_points_curvature(), UNUSED_VARS_NDEBUG, x, and y.
Referenced by create_samples(), curveprofile_make_segments_table(), and curveprofile_make_table().
|
static |
Samples evenly spaced positions along the curve profile's table (generated from path). Fills an entire table at once for a speedup if all of the results are going to be used anyway.
Definition at line 869 of file curveprofile.cc.
References BLI_assert, create_samples_even_spacing(), curveprofile_distance_to_next_table_point(), curveprofile_total_length(), i, interpf(), printf, CurveProfile::table, CurveProfilePoint::x, and CurveProfilePoint::y.
Referenced by create_samples_even_spacing(), and curveprofile_make_segments_table().
|
static |
Puts the widgets control points in a step pattern. Uses vector handles for each point.
Definition at line 396 of file curveprofile.cc.
References curveprofile_build_steps(), HD_VECT, i, CurveProfile::path, CurveProfile::path_len, point_init(), x, and y.
Referenced by BKE_curveprofile_reset(), and curveprofile_build_steps().
|
static |
Builds a quarter circle profile with space on each side for 'support loops.'
Definition at line 377 of file curveprofile.cc.
References cosf, curveprofile_build_supports(), HD_AUTO, HD_VECT, i, M_PI_2, CurveProfile::path, CurveProfile::path_len, point_init(), sinf, x, and y.
Referenced by BKE_curveprofile_reset(), and curveprofile_build_supports().
|
static |
Gives the distance to the next point in the widgets sampled table, in other words the length of the 'i' edge of the table.
Definition at line 840 of file curveprofile.cc.
References BKE_curveprofile_table_size(), BLI_assert, curveprofile_distance_to_next_table_point(), i, len_v2v2(), CurveProfile::table, and CurveProfilePoint::x.
Referenced by BKE_curveprofile_evaluate_length_portion(), create_samples_even_spacing(), and curveprofile_distance_to_next_table_point().
|
static |
Creates the table of points used for displaying a preview of the sampled segment locations on the widget itself.
Definition at line 945 of file curveprofile.cc.
References create_samples(), create_samples_even_spacing(), curveprofile_make_segments_table(), CurveProfile::flag, MEM_calloc_arrayN(), MEM_SAFE_FREE, PROF_SAMPLE_EVEN_LENGTHS, PROF_SAMPLE_STRAIGHT_EDGES, CurveProfile::segments, and CurveProfile::segments_len.
Referenced by BKE_curveprofile_update(), and curveprofile_make_segments_table().
|
static |
Creates a higher resolution table by sampling the curved points. This table is used for display and evenly spaced evaluation.
Definition at line 923 of file curveprofile.cc.
References BKE_curveprofile_table_size(), create_samples(), curveprofile_make_table(), MEM_calloc_arrayN(), MEM_SAFE_FREE, CurveProfile::table, CurveProfilePoint::x, and CurveProfilePoint::y.
Referenced by BKE_curveprofile_update(), and curveprofile_make_table().
|
static |
Calculates the total length of the profile from the curves sampled in the table.
Definition at line 852 of file curveprofile.cc.
References BKE_curveprofile_table_size(), curveprofile_total_length(), i, len_v2v2(), CurveProfile::table, and CurveProfilePoint::x.
Referenced by BKE_curveprofile_evaluate_length_portion(), create_samples_even_spacing(), and curveprofile_total_length().
|
static |
Helper for 'curve_profile_create' samples. Returns whether both handles that make up the edge are vector handles.
Definition at line 534 of file curveprofile.cc.
References HD_VECT, i, and is_curved_edge().
Referenced by create_samples(), and is_curved_edge().
|
static |
Definition at line 336 of file curveprofile.cc.
References CurveProfilePoint::flag, CurveProfilePoint::h1, CurveProfilePoint::h2, mirror_point(), point_init(), CurveProfilePoint::x, and CurveProfilePoint::y.
Referenced by BKE_curveprofile_reverse(), and mirror_point().
|
static |
Used to set bezier handle locations in the sample creation process. Reduced copy of #calchandleNurb_intern code in curve.cc, mostly changed by removing the third dimension.
Definition at line 543 of file curveprofile.cc.
References CurveProfilePoint::h1, CurveProfilePoint::h1_loc, CurveProfilePoint::h2, CurveProfilePoint::h2_loc, HD_AUTO, HD_FREE, HD_VECT, len(), len_v2(), madd_v2_v2v2fl(), point_calculate_handle(), sub_v2_v2v2(), and CurveProfilePoint::x.
Referenced by calculate_path_handles(), and point_calculate_handle().
|
static |
Shorthand helper function for setting location and interpolation of a point.
Definition at line 257 of file curveprofile.cc.
References CurveProfilePoint::flag, CurveProfilePoint::h1, CurveProfilePoint::h2, point_init(), CurveProfilePoint::x, x, CurveProfilePoint::y, and y.
Referenced by BKE_curveprofile_insert(), BKE_curveprofile_reset(), curveprofile_build_steps(), curveprofile_build_supports(), mirror_point(), and point_init().
|
static |
Helper function for create_samples for sorting edges based on curvature.
Definition at line 652 of file curveprofile.cc.
References b, CurvatureSortPoint::point_curvature, and sort_points_curvature().
Referenced by create_samples(), and sort_points_curvature().