1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
|
/* String conversion support for graphics terminals.
Copyright (C) 2023-2024 Free Software Foundation, Inc.
This file is part of GNU Emacs.
GNU Emacs is free software: you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation, either version 3 of the License, or (at
your option) any later version.
GNU Emacs is distributed in the hope that it will be useful,
but WITHOUT ANY WARRANTY; without even the implied warranty of
MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
GNU General Public License for more details.
You should have received a copy of the GNU General Public License
along with GNU Emacs. If not, see <https://www.gnu.org/licenses/>. */
#ifndef _TEXTCONV_H_
#include "lisp.h"
#include "frame.h"
/* The function pointers in this structure should be filled out by
each GUI backend interested in supporting text conversion.
Finally, register_texconv_interface must be called at some point
during terminal initialization. */
struct textconv_interface
{
/* Notice that the text conversion context has changed (which can
happen if the window is deleted or switches buffers, or an
unexpected buffer change occurs.) */
void (*reset) (struct frame *);
/* Notice that point or mark has moved in the specified frame's
selected window's selected buffer. The second argument is the
window whose point changed, and the third argument is the
buffer. */
void (*point_changed) (struct frame *, struct window *,
struct buffer *);
/* Notice that the preconversion region has changed without point
being moved. */
void (*compose_region_changed) (struct frame *);
/* Notice that an asynch conversion identified by COUNTER has
completed. */
void (*notify_conversion) (unsigned long);
};
enum textconv_caret_direction
{
TEXTCONV_FORWARD_CHAR,
TEXTCONV_BACKWARD_CHAR,
TEXTCONV_FORWARD_WORD,
TEXTCONV_BACKWARD_WORD,
TEXTCONV_CARET_UP,
TEXTCONV_CARET_DOWN,
TEXTCONV_NEXT_LINE,
TEXTCONV_PREVIOUS_LINE,
TEXTCONV_LINE_START,
TEXTCONV_LINE_END,
TEXTCONV_ABSOLUTE_POSITION,
};
enum textconv_operation
{
TEXTCONV_SUBSTITUTION,
TEXTCONV_RETRIEVAL,
};
/* Structure describing text in a buffer corresponding to a ``struct
textconv_callback_struct''. */
struct textconv_conversion_text
{
/* Length of the text in characters and bytes. */
size_t length, bytes;
/* Pointer to the text data. This must be deallocated by the
caller. */
char *text;
};
/* Structure describing a single query submitted by the input
method. */
struct textconv_callback_struct
{
/* Character position, relative to the current spot location, from
where on text should be returned. */
EMACS_INT position;
/* The type of scanning to perform to determine either the start or
the end of the conversion. */
enum textconv_caret_direction direction;
/* The the number of times for which to repeat the scanning in order
to determine the starting position of the text to return. */
unsigned short factor;
/* The operation to perform upon the current buffer contents.
If this is TEXTCONV_SUBSTITUTION, then the text that is returned
will be deleted from the buffer itself.
Otherwise, the text is simply returned without modifying the
buffer contents. */
enum textconv_operation operation;
/* Structure that will be filled with a description of the resulting
text. */
struct textconv_conversion_text text;
};
#define TEXTCONV_SKIP_CONVERSION_REGION (1 << 0)
extern int textconv_query (struct frame *, struct textconv_callback_struct *,
int);
extern bool detect_conversion_events (void);
extern void handle_pending_conversion_events (void);
extern void start_batch_edit (struct frame *, unsigned long);
extern void end_batch_edit (struct frame *, unsigned long);
extern void commit_text (struct frame *, Lisp_Object, ptrdiff_t,
unsigned long);
extern void finish_composing_text (struct frame *, unsigned long,
bool);
extern void set_composing_text (struct frame *, Lisp_Object,
ptrdiff_t, unsigned long);
extern void set_composing_region (struct frame *, ptrdiff_t, ptrdiff_t,
unsigned long);
extern void textconv_set_point_and_mark (struct frame *, ptrdiff_t,
ptrdiff_t, unsigned long);
extern void delete_surrounding_text (struct frame *, ptrdiff_t,
ptrdiff_t, unsigned long);
extern void request_point_update (struct frame *, unsigned long);
extern void textconv_barrier (struct frame *, unsigned long);
extern void replace_text (struct frame *, ptrdiff_t, ptrdiff_t,
Lisp_Object, ptrdiff_t, unsigned long);
extern char *get_extracted_text (struct frame *, ptrdiff_t, ptrdiff_t *,
ptrdiff_t *, ptrdiff_t *, ptrdiff_t *,
ptrdiff_t *, bool *);
extern char *get_surrounding_text (struct frame *, ptrdiff_t,
ptrdiff_t, ptrdiff_t *,
ptrdiff_t *, ptrdiff_t *,
ptrdiff_t *, ptrdiff_t *);
extern bool conversion_disabled_p (void);
extern void check_postponed_buffers (void);
extern void get_conversion_field (struct frame *, ptrdiff_t *, ptrdiff_t *);
extern void register_textconv_interface (struct textconv_interface *);
#endif /* _TEXTCONV_H_ */
|
