#include <cmath>
#include <cstdio>
#include <cstdlib>
#include <cstring>
#include "DNA_object_types.h"
#include "DNA_scene_types.h"
#include "DNA_screen_types.h"
#include "DNA_space_types.h"
#include "DNA_view3d_types.h"
#include "GPU_immediate.hh"
#include "GPU_matrix.hh"
#include "GPU_state.hh"
#include "BLI_math_matrix.h"
#include "BLI_math_rotation.h"
#include "BLI_rect.h"
#include "BLI_string.h"
#include "BLI_utildefines.h"
#include "ED_view3d.hh"
#include "BLT_translation.hh"
#include "UI_resources.hh"
#include "UI_view2d.hh"
#include "transform.hh"
#include "transform_gizmo.hh"
#include "transform_orientations.hh"
#include "transform_snap.hh"
#include "transform_constraints.hh"

Functions
Drawing Constraints
static void	drawObjectConstraint (TransInfo *t)

static void	drawLine (TransInfo *t, const float center[3], const float dir[3], char axis, short options)

void	drawConstraint (TransInfo *t)

void	drawPropCircle (TransInfo *t)

void	drawPropRange (TransInfo *t)

Internal Setup Calls
void	setConstraint (TransInfo *t, int mode, const char text[])

void	setAxisMatrixConstraint (TransInfo *t, int mode, const char text[])

void	setLocalConstraint (TransInfo *t, int mode, const char text[])

void	setUserConstraint (TransInfo *t, int mode, const char text_[])

Start / Stop Constraints
void	startConstraint (TransInfo *t)

void	stopConstraint (TransInfo *t)

Middle Mouse Button Select
void	initSelectConstraint (TransInfo *t)

void	selectConstraint (TransInfo *t)

void	postSelectConstraint (TransInfo *t)

static void	setNearestAxis2d (TransInfo *t)

static void	setNearestAxis3d (TransInfo *t)

void	setNearestAxis (TransInfo *t)

Helper Functions
int	constraintModeToIndex (const TransInfo *t)

bool	isLockConstraint (const TransInfo *t)

int	getConstraintSpaceDimension (const TransInfo *t)

Internal Utilities
#define	CONSTRAIN_EPSILON 0.0001f

static void	projection_matrix_calc (const TransInfo *t, float r_pmtx[3][3])

static void	view_vector_calc (const TransInfo *t, const float focus[3], float r_vec[3])

static void	constraint_plane_normal_calc (const TransInfo *t, float r_plane_no[3])

void	constraintNumInput (TransInfo *t, float vec[3])

static void	viewAxisCorrectCenter (const TransInfo *t, float t_con_center[3])

static void	axisProjection (const TransInfo *t, const float axis[3], const float in[3], float out[3])

static void	constraint_snap_plane_to_edge (const TransInfo *t, const float plane_no[3], float r_out[3])

static void	UNUSED_FUNCTION (constraint_snap_plane_to_face(const TransInfo *t, const float plane[4], float r_out[3]))

void	transform_constraint_snap_axis_to_edge (const TransInfo *t, const float axis[3], float r_out[3])

void	transform_constraint_snap_axis_to_face (const TransInfo *t, const float axis[3], float r_out[3])

static bool	isPlaneProjectionViewAligned (const TransInfo *t, const float plane_no[3])

static void	planeProjection (const TransInfo *t, const float plane_no[3], const float in[3], float out[3])

static short	transform_orientation_or_default (const TransInfo *t)

static const float(*	transform_object_axismtx_get (const TransInfo t, const TransDataContainer , const TransData *td))[3]

void	transform_constraint_get_nearest (const TransInfo *t, const float3 &vec, float r_vec[3])

static void	applyAxisConstraintVec (const TransInfo t, const TransDataContainer , const TransData *td, const float in[3], float out[3])

static void	applyObjectConstraintVec (const TransInfo t, const TransDataContainer tc, const TransData *td, const float in[3], float out[3])

static void	applyAxisConstraintSize (const TransInfo t, const TransDataContainer , const TransData *td, float r_smat[3][3])

static void	applyObjectConstraintSize (const TransInfo t, const TransDataContainer tc, const TransData *td, float r_smat[3][3])

static void	constraints_rotation_impl (const TransInfo t, const float axismtx[3][3], float r_axis[3], float r_angle)

static void	applyAxisConstraintRot (const TransInfo t, const TransDataContainer , const TransData td, float r_axis[3], float r_angle)

static void	applyObjectConstraintRot (const TransInfo t, const TransDataContainer tc, const TransData td, float r_axis[3], float r_angle)

Macro Definition Documentation

◆ CONSTRAIN_EPSILON

#define CONSTRAIN_EPSILON 0.0001f

Definition at line 86 of file transform_constraints.cc.

Referenced by constraint_snap_plane_to_edge(), transform_constraint_snap_axis_to_edge(), transform_constraint_snap_axis_to_face(), and UNUSED_FUNCTION().

Function Documentation

◆ applyAxisConstraintRot()

static void applyAxisConstraintRot	(	const TransInfo *	t,
		const TransDataContainer *	,
		const TransData *	td,
		float	r_axis[3],
		float *	r_angle )

static

Generic callback for constant spatial constraints applied to rotations

The rotation axis is copied into vec.

In the case of single axis constraints, the rotation axis is directly the one constrained to. For planar constraints (2 axis), the rotation axis is the normal of the plane.

The following only applies when CON_NOFLIP is not set. The vector is then modified to always point away from the screen (in global space) This insures that the rotation is always logically following the mouse. (ie: not doing counterclockwise rotations when the mouse moves clockwise).

Definition at line 612 of file transform_constraints.cc.

References TransInfo::con, CON_APPLY, constraints_rotation_impl(), TransCon::mode, and TransInfo::spacemtx.

Referenced by setConstraint().

◆ applyAxisConstraintSize()

static void applyAxisConstraintSize	(	const TransInfo *	t,
		const TransDataContainer *	,
		const TransData *	td,
		float	r_smat[3][3] )

static

Generic callback for constant spatial constraints applied to resize motion.

Definition at line 509 of file transform_constraints.cc.

References TransInfo::con, CON_APPLY, CON_AXIS0, CON_AXIS1, CON_AXIS2, TransCon::mode, mul_m3_m3m3(), TransInfo::spacemtx, and TransInfo::spacemtx_inv.

Referenced by setConstraint().

◆ applyAxisConstraintVec()

static void applyAxisConstraintVec	(	const TransInfo *	t,
		const TransDataContainer *	,
		const TransData *	td,
		const float	in[3],
		float	out[3] )

static

Generic callback for constant spatial constraints applied to linear motion

The in vector in projected into the constrained space and then further projected along the view vector. (in perspective mode, the view vector is relative to the position on screen)

Definition at line 459 of file transform_constraints.cc.

References TransInfo::con, CON_APPLY, copy_v3_v3(), TransCon::mode, and transform_constraint_get_nearest().

Referenced by applyObjectConstraintVec(), and setConstraint().

◆ applyObjectConstraintRot()

static void applyObjectConstraintRot	(	const TransInfo *	t,
		const TransDataContainer *	tc,
		const TransData *	td,
		float	r_axis[3],
		float *	r_angle )

static

Callback for object based spatial constraints applied to rotations

The rotation axis is copied into vec.

In the case of single axis constraints, the rotation axis is directly the one constrained to. For planar constraints (2 axis), the rotation axis is the normal of the plane.

The following only applies when CON_NOFLIP is not set. The vector is then modified to always point away from the screen (in global space) This insures that the rotation is always logically following the mouse. (ie: not doing counterclockwise rotations when the mouse moves clockwise).

Definition at line 636 of file transform_constraints.cc.

References TransData::axismtx, BLI_assert, TransInfo::con, CON_APPLY, constraints_rotation_impl(), TransDataContainer::data, TransInfo::flag, float, TransDataContainer::mat3_unit, TransCon::mode, mul_m3_m3m3(), T_EDIT, TRANS_DATA_CONTAINER_FIRST_OK, and transform_object_axismtx_get().

Referenced by setAxisMatrixConstraint().

◆ applyObjectConstraintSize()

static void applyObjectConstraintSize	(	const TransInfo *	t,
		const TransDataContainer *	tc,
		const TransData *	td,
		float	r_smat[3][3] )

static

Callback for object based spatial constraints applied to resize motion.

Definition at line 535 of file transform_constraints.cc.

References TransInfo::con, CON_APPLY, CON_AXIS0, CON_AXIS1, CON_AXIS2, TransInfo::flag, float, invert_m3_m3(), TransDataContainer::mat3_unit, TransCon::mode, mul_m3_m3m3(), T_EDIT, and transform_object_axismtx_get().

Referenced by setAxisMatrixConstraint().

◆ applyObjectConstraintVec()

static void applyObjectConstraintVec	(	const TransInfo *	t,
		const TransDataContainer *	tc,
		const TransData *	td,
		const float	in[3],
		float	out[3] )

static

Generic callback for object based spatial constraints applied to linear motion

At first, the following is applied without orientation The IN vector in projected into the constrained space and then further projected along the view vector. (in perspective mode, the view vector is relative to the position on screen).

Further down, that vector is mapped to each data's space.

Definition at line 483 of file transform_constraints.cc.

References applyAxisConstraintVec(), TransInfo::con, CON_APPLY, copy_v3_v3(), TransInfo::flag, float, TransDataContainer::mat3_unit, TransCon::mode, mul_m3_v3(), TransInfo::spacemtx_inv, T_EDIT, and transform_object_axismtx_get().

Referenced by setAxisMatrixConstraint().

◆ axisProjection()

static void axisProjection	(	const TransInfo *	t,
		const float	axis[3],
		const float	in[3],
		float	out[3] )

static

Axis calculation taking the view into account, correcting view-aligned axis.

Definition at line 178 of file transform_constraints.cc.

References add_v3_v3v3(), angle(), angle_v3v3(), BLI_assert, TransInfo::center_global, copy_v3_v3(), cross_v3_v3v3(), DEG2RADF, dot_v3v3(), fabsf, float, is_zero_v3(), isect_ray_ray_v3(), M_PI, M_PI_2, mul(), mul_v3_fl(), mul_v3_v3fl(), norm(), normalize_v3_v3_length(), project_v3_v3v3(), sub_v3_v3v3(), v, view_vector_calc(), viewAxisCorrectCenter(), and TransInfo::viewinv.

Referenced by transform_constraint_get_nearest().

◆ constraint_plane_normal_calc()

static void constraint_plane_normal_calc	(	const TransInfo *	t,
		float	r_plane_no[3] )

static

Definition at line 88 of file transform_constraints.cc.

References BLI_assert, TransInfo::con, CON_AXIS0, cross_v3_v3v3(), TransCon::mode, normalize_v3(), and TransInfo::spacemtx.

Referenced by transform_constraint_get_nearest().

◆ constraint_snap_plane_to_edge()

static void constraint_snap_plane_to_edge	(	const TransInfo *	t,
		const float	plane_no[3],
		float	r_out[3] )

static

Snap to the intersection between the edge direction and the constraint plane.

Definition at line 272 of file transform_constraints.cc.

References CONSTRAIN_EPSILON, dot_v3v3(), fabsf, isect_ray_plane_v3_factor(), madd_v3_v3v3fl(), TransSnap::snap_source, TransSnap::snap_target, TransSnap::snapNormal, sub_v3_v3(), and TransInfo::tsnap.

Referenced by transform_constraint_get_nearest().

◆ constraintModeToIndex()

int constraintModeToIndex ( const TransInfo * t )

Definition at line 1228 of file transform_constraints.cc.

References TransInfo::con, CON_APPLY, CON_AXIS0, CON_AXIS1, CON_AXIS2, and TransCon::mode.

Referenced by saveTransform().

◆ constraintNumInput()

void constraintNumInput	(	TransInfo *	t,
		float	vec[3] )

Definition at line 106 of file transform_constraints.cc.

References TransInfo::con, CON_APPLY, CON_AXIS0, CON_AXIS1, CON_AXIS2, TransInfo::flag, getConstraintSpaceDimension(), TransCon::mode, and T_NULL_ONE.

Referenced by applyBoneSize(), applyResize(), and applySkinResize().

◆ constraints_rotation_impl()

static void constraints_rotation_impl	(	const TransInfo *	t,
		const float	axismtx[3][3],
		float	r_axis[3],
		float *	r_angle )

static

Definition at line 565 of file transform_constraints.cc.

References BLI_assert, TransInfo::center_global, TransInfo::con, CON_APPLY, CON_AXIS0, CON_AXIS1, CON_AXIS2, CON_NOFLIP, copy_v3_v3(), dot_v3v3(), TransInfo::flag, hasNumInput(), TransCon::mode, TransInfo::num, T_INPUT_IS_VALUES_FINAL, and view_vector_calc().

Referenced by applyAxisConstraintRot(), and applyObjectConstraintRot().

◆ drawConstraint()

void drawConstraint ( TransInfo * t )

Definition at line 812 of file transform_constraints.cc.

References add_v3_v3(), TransInfo::center_global, TransInfo::con, CON_APPLY, CON_AXIS0, CON_AXIS1, CON_AXIS2, CON_SELECT, convertViewVec(), TransCon::drawExtra, DRAWLIGHT, drawLine(), ELEM, TransInfo::flag, GPU_COMP_F32, GPU_DEPTH_LESS_EQUAL, GPU_DEPTH_NONE, GPU_depth_test(), GPU_depth_test_get(), GPU_FETCH_FLOAT, GPU_PRIM_LINES, GPU_SHADER_3D_LINE_DASHED_UNIFORM_COLOR, GPU_vertformat_attr_add(), GPU_viewport_size_get_f(), immBegin(), immBindBuiltinProgram(), immEnd(), immUnbindProgram(), immUniform1f(), immUniform1i(), immUniform2f(), immUniformColor4f(), immVertex3fv(), immVertexFormat(), MouseInput::imval, TransCon::mode, TransInfo::mouse, TransInfo::mval, SPACE_IMAGE, SPACE_NODE, SPACE_SEQ, SPACE_VIEW3D, TransInfo::spacemtx, TransInfo::spacetype, and T_NO_CONSTRAINT.

Referenced by drawTransformView().

◆ drawLine()

static void drawLine	(	TransInfo *	t,
		const float	center[3],
		const float	dir[3],
		char	axis,
		short	options )

static

◆ drawObjectConstraint()

static void drawObjectConstraint ( TransInfo * t )

static

Definition at line 980 of file transform_constraints.cc.

References TransData::axismtx, TransInfo::con, CON_AXIS0, CON_AXIS1, CON_AXIS2, copy_v3_v3(), CTX_GPENCIL_STROKES, CTX_POSE_BONE, CTX_SEQUENCER_IMAGE, DRAWLIGHT, drawLine(), TransData::factor, TransInfo::flag, float, FOREACH_TRANS_DATA_CONTAINER, TransCon::mode, mul_m3_m3m3(), mul_v3_m4v3(), options, TransInfo::options, T_EDIT, T_PROP_EDIT, and transform_object_axismtx_get().

Referenced by setAxisMatrixConstraint().

◆ drawPropCircle()

void drawPropCircle ( TransInfo * t )

Called from drawview.c, as an extra per-window draw option.

Definition at line 883 of file transform_constraints.cc.

References TransInfo::aspect, TransInfo::center_global, copy_m4_m4(), TransInfo::flag, GPU_blend(), GPU_BLEND_ALPHA, GPU_COMP_F32, GPU_DEPTH_LESS_EQUAL, GPU_DEPTH_NONE, GPU_depth_test(), GPU_depth_test_get(), GPU_FETCH_FLOAT, GPU_matrix_pop(), GPU_matrix_push(), GPU_matrix_scale_2f(), GPU_SHADER_3D_POLYLINE_UNIFORM_COLOR, GPU_vertformat_attr_add(), GPU_viewport_size_get_f(), imm_drawcircball(), immBindBuiltinProgram(), immUnbindProgram(), immUniform1f(), immUniform2fv(), immUniformThemeColorShadeAlpha(), immVertexFormat(), invert_m4_m4(), pos, TransInfo::prop_size, TransInfo::region, ARegion::regiondata, ARegion::regiontype, RGN_TYPE_WINDOW, SPACE_IMAGE, SPACE_VIEW3D, TransInfo::spacetype, T_PROP_EDIT, TH_GRID, unit_m4(), and RegionView3D::viewmat.

Referenced by drawTransformView().

◆ drawPropRange()

void drawPropRange ( TransInfo * t )

Draws two lines to indicate a proportional editing range that is only defined in one axis.

Definition at line 946 of file transform_constraints.cc.

References TransInfo::center_global, View2D::cur, TransInfo::flag, GPU_blend(), GPU_BLEND_ALPHA, GPU_BLEND_NONE, GPU_COMP_F32, GPU_FETCH_FLOAT, GPU_SHADER_3D_POLYLINE_UNIFORM_COLOR, GPU_vertformat_attr_add(), GPU_viewport_size_get_f(), imm_draw_box_wire_3d(), immBindBuiltinProgram(), immUnbindProgram(), immUniform1f(), immUniform2fv(), immUniformThemeColorShadeAlpha(), immVertexFormat(), pos, TransInfo::prop_size, TransInfo::region, T_PROP_EDIT, TH_GRID, ARegion::v2d, rctf::ymax, and rctf::ymin.

Referenced by drawTransformView().

◆ getConstraintSpaceDimension()

int getConstraintSpaceDimension ( const TransInfo * t )

Returns the dimension of the constraint space.

For that reason, the flags always needs to be set to properly evaluate here, even if they aren't actually used in the callback function. (Which could happen for weird constraints not yet designed. Along a path for example.)

Definition at line 1267 of file transform_constraints.cc.

References TransInfo::con, CON_AXIS0, CON_AXIS1, CON_AXIS2, and TransCon::mode.

Referenced by constraintNumInput(), startConstraint(), and transform_constraint_get_nearest().