This commit implements a new modifier key (`B`) for the transform operators. This new key allows changing the 'Snap Base' of a transform by snapping it to a defined point in the scene. Ref #66424 # Implementation Details - This feature is only available in the 3D View. - This feature is only available for the transform modes: - `Move`, - `Rotate`, - `Scale`, - `Vert Slide` and - `Edge Slide`. - The `Snap Base Edit` is enabled while we are transforming and we press the key `B` - The `Snap Base Edit` is confirmed when we press any of the keys: `B`, `LMB`, `Enter` - During um operation, if no snap target is set for an element in the scene (Vertex, Edge...), the snap targets to geometry Vertex, Edge, Face, Center of Edge and Perpendicular of Edge are set automatically. - Constraint or similar modal features are not available during the `Snap Base Edit` mode. - Text input is not available during the `Snap Base Edit` mode. - A prone snap base point is indicated with an small cursor drawing. Pull Request: https://projects.blender.org/blender/blender/pulls/104443
106 lines
3.6 KiB
C
106 lines
3.6 KiB
C
/* SPDX-FileCopyrightText: 2023 Blender Foundation
|
|
*
|
|
* SPDX-License-Identifier: GPL-2.0-or-later */
|
|
|
|
/** \file
|
|
* \ingroup editors
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#define SNAP_MIN_DISTANCE 30
|
|
|
|
/* For enum. */
|
|
#include "DNA_space_types.h"
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
bool peelObjectsTransform(struct TransInfo *t,
|
|
const float mval[2],
|
|
bool use_peel_object,
|
|
/* return args */
|
|
float r_loc[3],
|
|
float r_no[3],
|
|
float *r_thickness);
|
|
|
|
eSnapMode snapObjectsTransform(struct TransInfo *t,
|
|
const float mval[2],
|
|
float *dist_px,
|
|
/* return args */
|
|
float r_loc[3],
|
|
float r_no[3]);
|
|
bool snapNodesTransform(struct TransInfo *t,
|
|
const int mval[2],
|
|
/* return args */
|
|
float r_loc[2],
|
|
float *r_dist_px,
|
|
char *r_node_border);
|
|
|
|
bool transformModeUseSnap(const TransInfo *t);
|
|
|
|
void tranform_snap_target_median_calc(const TransInfo *t, float r_median[3]);
|
|
bool transform_snap_increment_ex(const TransInfo *t, bool use_local_space, float *r_val);
|
|
bool transform_snap_increment(const TransInfo *t, float *val);
|
|
float transform_snap_increment_get(const TransInfo *t);
|
|
|
|
void tranform_snap_source_restore_context(TransInfo *t);
|
|
|
|
void transform_snap_flag_from_modifiers_set(TransInfo *t);
|
|
bool transform_snap_is_active(const TransInfo *t);
|
|
|
|
bool validSnap(const TransInfo *t);
|
|
|
|
void initSnapping(struct TransInfo *t, struct wmOperator *op);
|
|
void freeSnapping(struct TransInfo *t);
|
|
bool transform_snap_project_individual_is_active(const TransInfo *t);
|
|
void transform_snap_project_individual_apply(TransInfo *t);
|
|
void transform_snap_mixed_apply(TransInfo *t, float *vec);
|
|
void resetSnapping(TransInfo *t);
|
|
eRedrawFlag handleSnapping(TransInfo *t, const struct wmEvent *event);
|
|
void drawSnapping(const struct bContext *C, TransInfo *t);
|
|
bool usingSnappingNormal(const TransInfo *t);
|
|
bool validSnappingNormal(const TransInfo *t);
|
|
|
|
void getSnapPoint(const TransInfo *t, float vec[3]);
|
|
void addSnapPoint(TransInfo *t);
|
|
eRedrawFlag updateSelectedSnapPoint(TransInfo *t);
|
|
void removeSnapPoint(TransInfo *t);
|
|
|
|
float transform_snap_distance_len_squared_fn(TransInfo *t, const float p1[3], const float p2[3]);
|
|
|
|
/* transform_snap_sequencer.c */
|
|
|
|
struct TransSeqSnapData *transform_snap_sequencer_data_alloc(const TransInfo *t);
|
|
void transform_snap_sequencer_data_free(struct TransSeqSnapData *data);
|
|
bool transform_snap_sequencer_calc(struct TransInfo *t);
|
|
void transform_snap_sequencer_apply_translate(TransInfo *t, float *vec);
|
|
|
|
/* transform_snap_animation.c */
|
|
|
|
/**
|
|
* This function returns the snapping 'mode' for Animation Editors only.
|
|
* We cannot use the standard snapping due to NLA-strip scaling complexities.
|
|
*
|
|
* TODO: these modifier checks should be accessible from the key-map.
|
|
*/
|
|
short getAnimEdit_SnapMode(TransInfo *t);
|
|
void snapFrameTransform(TransInfo *t,
|
|
eAnimEdit_AutoSnap autosnap,
|
|
float val_initial,
|
|
float val_final,
|
|
float *r_val_final);
|
|
/**
|
|
* This function is used by Animation Editor specific transform functions to do
|
|
* the Snap Keyframe to Nearest Frame/Marker
|
|
*/
|
|
void transform_snap_anim_flush_data(TransInfo *t,
|
|
TransData *td,
|
|
eAnimEdit_AutoSnap autosnap,
|
|
float *r_val_final);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|