68f8253c71
An operator to allow interactive text selection for 3D Text Objects. This is from the code of Yash Dabhade (yashdabhade) for GSoC 2022 with corrections and simplifications. Also includes double-click for word selection. Pull Request: https://projects.blender.org/blender/blender/pulls/106915
124 lines
3.7 KiB
C
124 lines
3.7 KiB
C
/* SPDX-License-Identifier: GPL-2.0-or-later
|
|
* Copyright 2001-2002 NaN Holding BV. All rights reserved. */
|
|
#pragma once
|
|
|
|
/** \file
|
|
* \ingroup bke
|
|
*/
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
struct CharInfo;
|
|
struct Curve;
|
|
struct Main;
|
|
struct Object;
|
|
struct VFont;
|
|
|
|
struct CharTrans {
|
|
float xof, yof;
|
|
float rot;
|
|
short linenr, charnr;
|
|
char dobreak;
|
|
};
|
|
|
|
typedef struct EditFontSelBox {
|
|
float x, y, w, h;
|
|
float rot;
|
|
} EditFontSelBox;
|
|
|
|
/**
|
|
* Edit data for #Curve (a text curve, with an #Object::type of `OB_FONT`).
|
|
* */
|
|
typedef struct EditFont {
|
|
/** Array of UTF32 code-points. */
|
|
char32_t *textbuf;
|
|
/** Text style info (aligned with `textbuf`). */
|
|
struct CharInfo *textbufinfo;
|
|
|
|
/** Array of rectangles & rotation. */
|
|
float textcurs[4][2];
|
|
EditFontSelBox *selboxes;
|
|
int selboxes_len;
|
|
|
|
/* Positional vars relative to the `textbuf` (not utf8 bytes)
|
|
* a copy of these is kept in Curve, but use these in edit-mode. */
|
|
|
|
/** Length of `textbuf`. */
|
|
int len;
|
|
/** Cursor position of (aligned with `textbuf`). */
|
|
int pos;
|
|
/** Text selection start/end, see #BKE_vfont_select_get. */
|
|
int selstart, selend;
|
|
|
|
/**
|
|
* Combined styles from #CharInfo.flag for the selected range selected
|
|
* (only including values from #CU_CHINFO_STYLE_ALL).
|
|
* A flag will be set only if ALL characters in the selected string have it.
|
|
*/
|
|
int select_char_info_flag;
|
|
|
|
/**
|
|
* ID data is older than edit-mode data.
|
|
* Set #Main.is_memfile_undo_flush_needed when enabling.
|
|
*/
|
|
char needs_flush_to_id;
|
|
|
|
} EditFont;
|
|
|
|
bool BKE_vfont_is_builtin(const struct VFont *vfont);
|
|
void BKE_vfont_builtin_register(const void *mem, int size);
|
|
|
|
void BKE_vfont_free_data(struct VFont *vfont);
|
|
/**
|
|
* Return the built-in #VFont, without adding a user (the user-count may be zero).
|
|
* The caller is responsible for adding a user.
|
|
*/
|
|
struct VFont *BKE_vfont_builtin_get(void);
|
|
struct VFont *BKE_vfont_load(struct Main *bmain, const char *filepath);
|
|
struct VFont *BKE_vfont_load_exists_ex(struct Main *bmain, const char *filepath, bool *r_exists);
|
|
struct VFont *BKE_vfont_load_exists(struct Main *bmain, const char *filepath);
|
|
|
|
bool BKE_vfont_to_curve_ex(struct Object *ob,
|
|
struct Curve *cu,
|
|
int mode,
|
|
struct ListBase *r_nubase,
|
|
const char32_t **r_text,
|
|
int *r_text_len,
|
|
bool *r_text_free,
|
|
struct CharTrans **r_chartransdata);
|
|
bool BKE_vfont_to_curve_nubase(struct Object *ob, int mode, struct ListBase *r_nubase);
|
|
|
|
int BKE_vfont_cursor_to_text_index(struct Object *ob, float cursor_location[2]);
|
|
|
|
/**
|
|
* \warning Expects to have access to evaluated data (i.e. passed object should be evaluated one).
|
|
*/
|
|
bool BKE_vfont_to_curve(struct Object *ob, int mode);
|
|
void BKE_vfont_build_char(struct Curve *cu,
|
|
struct ListBase *nubase,
|
|
unsigned int character,
|
|
struct CharInfo *info,
|
|
float ofsx,
|
|
float ofsy,
|
|
float rot,
|
|
int charidx,
|
|
float fsize);
|
|
|
|
int BKE_vfont_select_get(struct Object *ob, int *r_start, int *r_end);
|
|
void BKE_vfont_select_clamp(struct Object *ob);
|
|
|
|
void BKE_vfont_clipboard_free(void);
|
|
void BKE_vfont_clipboard_set(const char32_t *text_buf,
|
|
const struct CharInfo *info_buf,
|
|
size_t len);
|
|
void BKE_vfont_clipboard_get(char32_t **r_text_buf,
|
|
struct CharInfo **r_info_buf,
|
|
size_t *r_len_utf8,
|
|
size_t *r_len_utf32);
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|