#include "MEM_guardedalloc.h"
#include "BLI_math_rotation.h"
#include "BLI_math_vector.h"
#include "BLI_string.h"
#include "BLI_string_cursor_utf8.h"
#include "BLI_string_utf8.h"
#include "BLI_utildefines.h"
#include "BLT_translation.hh"
#include "BKE_context.hh"
#include "BKE_report.hh"
#include "BKE_scene.hh"
#include "BKE_unit.hh"
#include "DNA_scene_types.h"
#include "WM_api.hh"
#include "WM_types.hh"
#include "ED_numinput.hh"
#include "UI_interface.hh"

Macros
#define	USE_FAKE_EDIT

Enumerations
enum	{ NUM_EDIT_FULL = (1 << 9) , NUM_FAKE_EDITED = (1 << 10) }

enum	{ NUM_EDITED = (1 << 9) , NUM_INVALID = (1 << 10) , NUM_NEGATE = (1 << 11) , NUM_INVERSE = (1 << 12) }

Functions
void	initNumInput (NumInput *n)

void	outputNumInput (NumInput n, char str, const UnitSettings *unit_settings)

bool	hasNumInput (const NumInput *n)

bool	applyNumInput (NumInput n, float vec)

static void	value_to_editstr (NumInput *n, int idx)

static bool	editstr_insert_at_cursor (NumInput n, const char buf, const int buf_len)

bool	user_string_to_number (bContext C, const char str, const UnitSettings unit, int type, double r_value, const bool use_single_line_error, char **r_error)

static bool	editstr_is_simple_numinput (const char ascii)

bool	handleNumInput (bContext C, NumInput n, const wmEvent *event)

Macro Definition Documentation

◆ USE_FAKE_EDIT

#define USE_FAKE_EDIT

Definition at line 38 of file numinput.cc.

Enumeration Type Documentation

◆ anonymous enum

anonymous enum

NumInput.flag (1 << 8) and below are reserved for public flags!

Enumerator
NUM_EDIT_FULL	Enable full editing, with units and math operators support.
NUM_FAKE_EDITED	Fake edited state (temp, avoids issue with backspace).

Definition at line 44 of file numinput.cc.

◆ anonymous enum

anonymous enum

Enumerator
NUM_EDITED	User has edited this value somehow.
NUM_INVALID	Current expression for this value is invalid.
NUM_NEGATE	Current expression's result has to be negated.
NUM_INVERSE	Current expression's result has to be inverted.

Definition at line 54 of file numinput.cc.

Function Documentation

◆ applyNumInput()

bool applyNumInput	(	NumInput *	n,
		float *	vec )

Warning: vec must be set beforehand otherwise we risk uninitialized vars.

Definition at line 190 of file numinput.cc.

References NumInput::flag, floorf, hasNumInput(), NumInput::idx, NumInput::idx_max, NUM_AFFECT_ALL, NUM_EDITED, NUM_FAKE_EDITED, NUM_NO_FRACTION, NUM_NO_NEGATIVE, NUM_NO_ZERO, NUM_NULL_ONE, NumInput::val, NumInput::val_flag, and NumInput::val_org.

Referenced by apply_shear(), apply_value_impl(), applyBakeTime(), applyBoneEnvelope(), applyBoneRoll(), applyBoneSize(), applyCurveShrinkFatten(), applyEdgeSlide(), applyGPOpacity(), applyGPShrinkFatten(), applyMaskShrinkFatten(), applyNormalRotation(), applyPushPull(), applyResize(), applyRotation(), applySeqSlide(), applyShrinkFatten(), applySkinResize(), applyTilt(), applyTimeScale(), applyTimeSlide(), applyTimeTranslate(), applyToSphere(), applyTrackball(), applyTranslation(), applyVertSlide(), Bend(), ed_marker_move_modal(), edbm_bevel_numinput_set_value(), edbm_inset_modal(), ElementResize(), graph_slider_modal(), blender::ed::sculpt_paint::greasepencil::grease_pencil_interpolate_modal(), handle_number_input(), knifetool_modal(), loopcut_modal(), pose_slide_modal(), and radial_control_modal().

◆ editstr_insert_at_cursor()

static bool editstr_insert_at_cursor	(	NumInput *	n,
		const char *	buf,
		const int	buf_len )

static

Definition at line 249 of file numinput.cc.

References len, NUM_STR_REP_LEN, NumInput::str, and NumInput::str_cur.

Referenced by handleNumInput().

◆ editstr_is_simple_numinput()

static bool editstr_is_simple_numinput ( const char ascii )

static

Definition at line 301 of file numinput.cc.

Referenced by handleNumInput().

◆ handleNumInput()

bool handleNumInput	(	bContext *	C,
		NumInput *	n,
		const wmEvent *	event )

Definition at line 312 of file numinput.cc.

References ATTR_FALLTHROUGH, B_UNIT_ROTATION, BKE_report(), BLI_assert, BLI_str_cursor_step_utf8(), BLI_str_utf8_size_or_error(), copy_v3_v3(), CTX_data_scene(), CTX_wm_reports(), DEG2RAD, editstr_insert_at_cursor(), editstr_is_simple_numinput(), ELEM, error(), EVT_BACKSPACEKEY, EVT_CKEY, EVT_DELKEY, EVT_ENDKEY, EVT_HOMEKEY, EVT_LEFTARROWKEY, EVT_MINUSKEY, EVT_MODAL_MAP, EVT_PADMINUS, EVT_PADPERIOD, EVT_PADSLASHKEY, EVT_PERIODKEY, EVT_RIGHTARROWKEY, EVT_SLASHKEY, EVT_TABKEY, EVT_VKEY, NumInput::flag, float, NumInput::idx, NumInput::idx_max, KM_ALT, KM_CTRL, KM_SHIFT, MEM_freeN(), wmEvent::modifier, NUM_EDIT_FULL, NUM_EDITED, NUM_FAKE_EDITED, NUM_INVALID, NUM_INVERSE, NUM_MODAL_INCREMENT_DOWN, NUM_MODAL_INCREMENT_UP, NUM_NEGATE, printf, RAD2DEG, RPT_ERROR, NumInput::str, NumInput::str_cur, STRCUR_DIR_NEXT, STRCUR_DIR_PREV, STRCUR_JUMP_DELIM, STRCUR_JUMP_NONE, wmEvent::type, Scene::unit, NumInput::unit_type, NumInput::unit_use_radians, UNLIKELY, USER_FLAG_NUMINPUT_ADVANCED, user_string_to_number(), wmEvent::utf8_buf, NumInput::val, wmEvent::val, NumInput::val_flag, NumInput::val_inc, NumInput::val_org, value_to_editstr(), WM_clipboard_text_get_firstline(), WM_clipboard_text_set(), and WM_event_utf8_to_ascii().

Referenced by ed_marker_move_modal(), edbm_bevel_modal(), edbm_inset_modal(), graph_slider_modal(), blender::ed::sculpt_paint::greasepencil::grease_pencil_interpolate_modal(), knifetool_modal(), loopcut_modal(), pose_slide_modal(), radial_control_modal(), sequencer_slip_modal(), and transformEvent().

◆ hasNumInput()

bool hasNumInput ( const NumInput * n )

Definition at line 171 of file numinput.cc.

References NumInput::flag, NumInput::idx_max, NUM_EDITED, NUM_FAKE_EDITED, and NumInput::val_flag.

Referenced by apply_shear(), apply_value_impl(), applyBakeTime(), applyBoneEnvelope(), applyBoneRoll(), applyCurveShrinkFatten(), applyEdgeSlide(), applyGPOpacity(), applyGPShrinkFatten(), applyMaskShrinkFatten(), applyNumInput(), applyPushPull(), applyRotation(), applyShrinkFatten(), applyTilt(), applyToSphere(), applyTrackball(), applyVertSlide(), Bend(), common_draw_status_header(), constraints_rotation_impl(), decimate_draw_status(), ease_draw_status_header(), ed_marker_move_modal(), ed_marker_move_update_header(), edbm_bevel_modal(), edbm_inset_modal(), edbm_inset_update_header(), graph_slider_modal(), blender::ed::sculpt_paint::greasepencil::grease_pencil_interpolate_modal(), blender::ed::sculpt_paint::greasepencil::grease_pencil_interpolate_status_indicators(), headerBoneSize(), headerResize(), headerRotation(), headerSeqSlide(), headerTimeScale(), headerTimeSlide(), headerTimeTranslate(), headerTranslation(), knifetool_modal(), loopcut_init(), loopcut_modal(), pose_slide_draw_status(), pose_slide_modal(), radial_control_modal(), radial_control_update_header(), scale_from_neighbor_draw_status_header(), sequencer_slip_modal(), sequencer_slip_update_header(), shear_draw_status_header(), and transformEvent().

◆ initNumInput()

void initNumInput ( NumInput * n )

There are important things to note here for code using numeric-input:

Values passed to applyNumInput() should be valid and are stored as default ones (val_org), if it is not EDITED.
bool returned by applyNumInput should be used to decide whether to apply numeric-input-specific post-process to data.
Once applyNumInput has been called, hasNumInput returns a valid value to decide whether to use numinput as drawstr source or not (i.e. to call outputNumInput).

Those two steps have to be separated (so do not use a common call to hasNumInput() to do both in the same time!).

Definition at line 70 of file numinput.cc.

References B_UNIT_NONE, copy_vn_fl(), copy_vn_i(), copy_vn_short(), NumInput::flag, NumInput::idx, NumInput::idx_max, NUM_MAX_ELEMENTS, NumInput::str, NumInput::str_cur, NumInput::unit_sys, NumInput::unit_type, NumInput::unit_use_radians, USER_UNIT_NONE, NumInput::val, NumInput::val_flag, NumInput::val_inc, NumInput::val_org, and zero_v3().

Referenced by ed_marker_move_init(), edbm_bevel_init(), edbm_inset_init(), initTransInfo(), knifetool_init(), pose_slide_init(), radial_control_invoke(), ringsel_init(), and sequencer_slip_invoke().

◆ outputNumInput()

void outputNumInput	(	NumInput *	n,
		char *	str,
		const UnitSettings *	unit_settings )

Parameters

str	Must be NUM_STR_REP_LEN * (idx_max + 1) length.

Definition at line 88 of file numinput.cc.

References B_UNIT_ROTATION, BKE_scene_unit_scale(), BKE_unit_value_as_string_adaptive(), BLI_snprintf(), BLI_str_utf8_invalid_strip(), BLI_strncpy(), NumInput::flag, float, NumInput::idx, NumInput::idx_max, NUM_AFFECT_ALL, NUM_EDITED, NUM_INVALID, NUM_INVERSE, NUM_NEGATE, NUM_STR_REP_LEN, RPT_, NumInput::str, str, NumInput::str_cur, STRNCPY, UI_calc_float_precision(), NumInput::unit_sys, NumInput::unit_type, NumInput::unit_use_radians, NumInput::val, and NumInput::val_flag.

Referenced by apply_shear(), apply_value_impl(), applyBakeTime(), applyBoneEnvelope(), applyBoneRoll(), applyCurveShrinkFatten(), applyEdgeSlide(), applyGPOpacity(), applyGPShrinkFatten(), applyMaskShrinkFatten(), applyPushPull(), applyShrinkFatten(), applyTilt(), applyToSphere(), applyTrackball(), applyVertSlide(), Bend(), common_draw_status_header(), decimate_draw_status(), ease_draw_status_header(), ed_marker_move_update_header(), edbm_inset_update_header(), blender::ed::sculpt_paint::greasepencil::grease_pencil_interpolate_status_indicators(), headerBoneSize(), headerResize(), headerRotation(), headerSeqSlide(), headerTimeScale(), headerTimeSlide(), headerTimeTranslate(), headerTranslation(), loopcut_init(), loopcut_modal(), pose_slide_draw_status(), radial_control_update_header(), scale_from_neighbor_draw_status_header(), sequencer_slip_update_header(), and shear_draw_status_header().

◆ user_string_to_number()

bool user_string_to_number	(	bContext *	C,
		const char *	str,
		const UnitSettings *	unit,
		int	type,
		double *	r_value,
		const bool	use_single_line_error,
		char **	r_error )

Definition at line 266 of file numinput.cc.

References BKE_scene_unit_scale(), BKE_unit_apply_preferred_unit(), BKE_unit_replace_string(), BKE_unit_string_contains_unit(), BPY_run_string_as_number(), str, STRNCPY, UNUSED_VARS, and BPy_RunErrInfo::use_single_line_error.

Referenced by handleNumInput(), and ui_number_from_string_units().

◆ value_to_editstr()

static void value_to_editstr	(	NumInput *	n,
		int	idx )

static

Definition at line 236 of file numinput.cc.

References BKE_unit_value_as_string_adaptive(), NUM_STR_REP_LEN, NumInput::str, NumInput::str_cur, NumInput::unit_sys, NumInput::unit_type, and NumInput::val.

Referenced by handleNumInput().

Macros

Enumerations

Functions

Macro Definition Documentation

◆ USE_FAKE_EDIT

Enumeration Type Documentation

◆ anonymous enum

◆ anonymous enum

Function Documentation

◆ applyNumInput()

◆ editstr_insert_at_cursor()

◆ editstr_is_simple_numinput()

◆ handleNumInput()

◆ hasNumInput()

◆ initNumInput()

◆ outputNumInput()

◆ user_string_to_number()

◆ value_to_editstr()