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
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
|
/* SPDX-License-Identifier: GPL-2.0-or-later */
/** \file
* \ingroup DNA
*
* Use API in BKE_workspace.h to edit these.
*/
#pragma once
#include "DNA_ID.h"
#include "DNA_asset_types.h"
#ifdef __cplusplus
extern "C" {
#endif
/** #bToolRef_Runtime.flag */
enum {
/**
* This tool should use the fallback key-map.
* Typically gizmos handle this but some tools (such as the knife tool) don't use a gizmo.
*/
TOOLREF_FLAG_FALLBACK_KEYMAP = (1 << 0),
};
#
#
typedef struct bToolRef_Runtime {
int cursor;
/** One of these 3 must be defined. */
char keymap[64];
char gizmo_group[64];
char data_block[64];
/** Keymap for #bToolRef.idname_fallback, if set. */
char keymap_fallback[64];
/** Use to infer primary operator to use when setting accelerator keys. */
char op[64];
/** Index when a tool is a member of a group. */
int index;
/** Options: `TOOLREF_FLAG_*`. */
int flag;
} bToolRef_Runtime;
/**
* \note Stored per mode.
*/
typedef struct bToolRef {
struct bToolRef *next, *prev;
char idname[64];
/** Optionally use these when not interacting directly with the primary tools gizmo. */
char idname_fallback[64];
/** Use to avoid initializing the same tool multiple times. */
short tag;
/** #bToolKey (spacetype, mode), used in 'WM_api.h' */
short space_type;
/**
* Value depends on the 'space_type', object mode for 3D view, image editor has own mode too.
* RNA needs to handle using item function.
*/
int mode;
/**
* Use for tool options, each group's name must match a tool name:
*
* {"Tool Name": {"SOME_OT_operator": {...}, ..}, ..}
*
* This is done since different tools may call the same operators with their own options.
*/
IDProperty *properties;
/** Variables needed to operate the tool. */
bToolRef_Runtime *runtime;
} bToolRef;
/**
* \brief Wrapper for bScreen.
*
* #bScreens are IDs and thus stored in a main list-base.
* We also want to store a list-base of them within the workspace
* (so each workspace can have its own set of screen-layouts)
* which would mess with the next/prev pointers.
* So we use this struct to wrap a bScreen pointer with another pair of next/prev pointers.
*/
typedef struct WorkSpaceLayout {
struct WorkSpaceLayout *next, *prev;
struct bScreen *screen;
/* The name of this layout, we override the RNA name of the screen with this
* (but not ID name itself) */
/** MAX_NAME. */
char name[64];
} WorkSpaceLayout;
/** Optional tags, which features to use, aligned with #bAddon names by convention. */
typedef struct wmOwnerID {
struct wmOwnerID *next, *prev;
/** MAX_NAME. */
char name[64];
} wmOwnerID;
typedef struct WorkSpace {
ID id;
/** WorkSpaceLayout. */
ListBase layouts;
/* Store for each hook (so for each window) which layout has
* been activated the last time this workspace was visible. */
/** WorkSpaceDataRelation. */
ListBase hook_layout_relations;
/* Feature tagging (use for addons) */
/** #wmOwnerID. */
ListBase owner_ids;
/** List of #bToolRef */
ListBase tools;
char _pad[4];
int object_mode;
/** Enum eWorkSpaceFlags. */
int flags;
/** Number for workspace tab reordering in the UI. */
int order;
/** Info text from modal operators (runtime). */
char *status_text;
/** Workspace-wide active asset library, for asset UIs to use (e.g. asset view UI template). The
* Asset Browser has its own and doesn't use this. */
AssetLibraryReference asset_library_ref;
} WorkSpace;
/**
* Generic (and simple/primitive) struct for storing a history of assignments/relations
* of workspace data to non-workspace data in a listbase inside the workspace.
*
* Using this we can restore the old state of a workspace if the user switches back to it.
*
* Usage
* =====
* When activating a workspace, it should activate the screen-layout that was active in that
* workspace before *in this window*.
* More concretely:
* * There are two windows, win1 and win2.
* * Both show workspace ws1, but both also had workspace ws2 activated at some point before.
* * Last time ws2 was active in win1, screen-layout sl1 was activated.
* * Last time ws2 was active in win2, screen-layout sl2 was activated.
* * When changing from ws1 to ws2 in win1, screen-layout sl1 should be activated again.
* * When changing from ws1 to ws2 in win2, screen-layout sl2 should be activated again.
* So that means we have to store the active screen-layout in a per workspace, per window
* relation. This struct is used to store an active screen-layout for each window within the
* workspace.
* To find the screen-layout to activate for this window-workspace combination, simply lookup
* the WorkSpaceDataRelation with the workspace-hook of the window set as parent.
*/
typedef struct WorkSpaceDataRelation {
struct WorkSpaceDataRelation *next, *prev;
/** The data used to identify the relation
* (e.g. to find screen-layout (= value) from/for a hook).
* NOTE: Now runtime only. */
void *parent;
/** The value for this parent-data/workspace relation. */
void *value;
/** Reference to the actual parent window, wmWindow->winid. Used in read/write code. */
int parentid;
char _pad_0[4];
} WorkSpaceDataRelation;
/**
* Little wrapper to store data that is going to be per window, but coming from the workspace.
* It allows us to keep workspace and window data completely separate.
*/
typedef struct WorkSpaceInstanceHook {
WorkSpace *active;
struct WorkSpaceLayout *act_layout;
/** Needed because we can't change workspaces/layouts in running handler loop,
* it would break context. */
WorkSpace *temp_workspace_store;
struct WorkSpaceLayout *temp_layout_store;
} WorkSpaceInstanceHook;
typedef enum eWorkSpaceFlags {
WORKSPACE_USE_FILTER_BY_ORIGIN = (1 << 1),
} eWorkSpaceFlags;
#ifdef __cplusplus
}
#endif
|
