Falk David
50387964b6
This adds basic support for the transform operators for curves. Differential Revision: https://developer.blender.org/D17063
141 lines
4.6 KiB
C++
141 lines
4.6 KiB
C++
/* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
/** \file
|
|
* \ingroup editors
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
struct bContext;
|
|
struct Curves;
|
|
struct UndoType;
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name C Wrappers
|
|
* \{ */
|
|
|
|
void ED_operatortypes_curves(void);
|
|
void ED_curves_undosys_type(struct UndoType *ut);
|
|
void ED_keymap_curves(struct wmKeyConfig *keyconf);
|
|
|
|
/**
|
|
* Return an owning pointer to an array of point normals the same size as the number of control
|
|
* points. The normals depend on the normal mode for each curve and the "tilt" attribute and may be
|
|
* calculated for the evaluated points and sampled back to the control points.
|
|
*/
|
|
float (*ED_curves_point_normals_array_create(const struct Curves *curves_id))[3];
|
|
|
|
/** \} */
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
#ifdef __cplusplus
|
|
|
|
# include "BKE_attribute.hh"
|
|
# include "BLI_index_mask.hh"
|
|
# include "BLI_vector.hh"
|
|
# include "BLI_vector_set.hh"
|
|
|
|
# include "BKE_curves.hh"
|
|
|
|
namespace blender::ed::curves {
|
|
|
|
bool object_has_editable_curves(const Main &bmain, const Object &object);
|
|
bke::CurvesGeometry primitive_random_sphere(int curves_size, int points_per_curve);
|
|
VectorSet<Curves *> get_unique_editable_curves(const bContext &C);
|
|
void ensure_surface_deformation_node_exists(bContext &C, Object &curves_ob);
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Poll Functions
|
|
* \{ */
|
|
|
|
bool editable_curves_with_surface_poll(bContext *C);
|
|
bool editable_curves_in_edit_mode_poll(bContext *C);
|
|
bool curves_with_surface_poll(bContext *C);
|
|
bool editable_curves_poll(bContext *C);
|
|
bool curves_poll(bContext *C);
|
|
|
|
/** \} */
|
|
|
|
/* -------------------------------------------------------------------- */
|
|
/** \name Selection
|
|
*
|
|
* Selection on curves can be stored on either attribute domain: either per-curve or per-point. It
|
|
* can be stored with a float or boolean data-type. The boolean data-type is faster, smaller, and
|
|
* corresponds better to edit-mode selections, but the float data type is useful for soft selection
|
|
* (like masking) in sculpt mode.
|
|
*
|
|
* The attribute API is used to do the necessary type and domain conversions when necessary, and
|
|
* can handle most interaction with the selection attribute, but these functions implement some
|
|
* helpful utilities on top of that.
|
|
* \{ */
|
|
|
|
void fill_selection_false(GMutableSpan span);
|
|
void fill_selection_true(GMutableSpan span);
|
|
|
|
/**
|
|
* Return true if any element is selected, on either domain with either type.
|
|
*/
|
|
bool has_anything_selected(const bke::CurvesGeometry &curves);
|
|
|
|
/**
|
|
* Find curves that have any point selected (a selection factor greater than zero),
|
|
* or curves that have their own selection factor greater than zero.
|
|
*/
|
|
IndexMask retrieve_selected_curves(const Curves &curves_id, Vector<int64_t> &r_indices);
|
|
|
|
/**
|
|
* Find points that are selected (a selection factor greater than zero),
|
|
* or points in curves with a selection factor greater than zero).
|
|
*/
|
|
IndexMask retrieve_selected_points(const bke::CurvesGeometry &curves, Vector<int64_t> &r_indices);
|
|
IndexMask retrieve_selected_points(const Curves &curves_id, Vector<int64_t> &r_indices);
|
|
|
|
/**
|
|
* If the ".selection" attribute doesn't exist, create it with the requested type (bool or float).
|
|
*/
|
|
bke::GSpanAttributeWriter ensure_selection_attribute(bke::CurvesGeometry &curves,
|
|
const eAttrDomain selection_domain,
|
|
const eCustomDataType create_type);
|
|
|
|
/**
|
|
* (De)select all the curves.
|
|
*
|
|
* \param action: One of SEL_TOGGLE, SEL_SELECT, SEL_DESELECT, or SEL_INVERT. See
|
|
* "ED_select_utils.h".
|
|
*/
|
|
void select_all(bke::CurvesGeometry &curves, const eAttrDomain selection_domain, int action);
|
|
|
|
/**
|
|
* Select the ends (front or back) of all the curves.
|
|
*
|
|
* \param amount: The amount of points to select from the front or back.
|
|
* \param end_points: If true, select the last point(s), if false, select the first point(s).
|
|
*/
|
|
void select_ends(bke::CurvesGeometry &curves,
|
|
const eAttrDomain selection_domain,
|
|
int amount,
|
|
bool end_points);
|
|
|
|
/**
|
|
* Select random points or curves.
|
|
*
|
|
* \param random_seed: The seed for the \a RandomNumberGenerator.
|
|
* \param probability: Determins how likely a point/curve will be selected. If set to 0.0, nothing
|
|
* will be selected, if set to 1.0 everything will be selected.
|
|
*/
|
|
void select_random(bke::CurvesGeometry &curves,
|
|
const eAttrDomain selection_domain,
|
|
uint32_t random_seed,
|
|
float probability);
|
|
/** \} */
|
|
|
|
} // namespace blender::ed::curves
|
|
#endif
|