Merge branch 'master' into blender2.8
[blender.git] / source / blender / makesdna / DNA_ID.h
1 /*
2  * ***** BEGIN GPL LICENSE BLOCK *****
3  *
4  * This program is free software; you can redistribute it and/or
5  * modify it under the terms of the GNU General Public License
6  * as published by the Free Software Foundation; either version 2
7  * of the License, or (at your option) any later version.
8  *
9  * This program is distributed in the hope that it will be useful,
10  * but WITHOUT ANY WARRANTY; without even the implied warranty of
11  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
12  * GNU General Public License for more details.
13  *
14  * You should have received a copy of the GNU General Public License
15  * along with this program; if not, write to the Free Software Foundation,
16  * Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301, USA.
17  *
18  * The Original Code is Copyright (C) 2001-2002 by NaN Holding BV.
19  * All rights reserved.
20  *
21  * The Original Code is: all of this file.
22  *
23  * Contributor(s): none yet.
24  *
25  * ***** END GPL LICENSE BLOCK *****
26  */
27
28 /** \file DNA_ID.h
29  *  \ingroup DNA
30  *  \brief ID and Library types, which are fundamental for sdna.
31  */
32
33 #ifndef __DNA_ID_H__
34 #define __DNA_ID_H__
35
36 #include "DNA_listBase.h"
37
38 #ifdef __cplusplus
39 extern "C" {
40 #endif
41
42 struct Library;
43 struct FileData;
44 struct ID;
45 struct PackedFile;
46 struct GPUTexture;
47
48 typedef struct IDPropertyData {
49         void *pointer;
50         ListBase group;
51         int val, val2;  /* note, we actually fit a double into these two ints */
52 } IDPropertyData;
53
54 typedef struct IDProperty {
55         struct IDProperty *next, *prev;
56         char type, subtype;
57         short flag;
58         char name[64];  /* MAX_IDPROP_NAME */
59
60         /* saved is used to indicate if this struct has been saved yet.
61          * seemed like a good idea as a pad var was needed anyway :) */
62         int saved;
63         IDPropertyData data;  /* note, alignment for 64 bits */
64
65         /* array length, also (this is important!) string length + 1.
66          * the idea is to be able to reuse array realloc functions on strings.*/
67         int len;
68
69         /* Strings and arrays are both buffered, though the buffer isn't saved. */
70         /* totallen is total length of allocated array/string, including a buffer.
71          * Note that the buffering is mild; the code comes from python's list implementation. */
72         int totallen;
73 } IDProperty;
74
75 #define MAX_IDPROP_NAME 64
76 #define DEFAULT_ALLOC_FOR_NULL_STRINGS  64
77
78 /*->type*/
79 enum {
80         IDP_STRING           = 0,
81         IDP_INT              = 1,
82         IDP_FLOAT            = 2,
83         IDP_ARRAY            = 5,
84         IDP_GROUP            = 6,
85         IDP_ID               = 7,
86         IDP_DOUBLE           = 8,
87         IDP_IDPARRAY         = 9,
88         IDP_NUMTYPES         = 10,
89 };
90
91 /*->subtype */
92
93 /* IDP_STRING */
94 enum {
95         IDP_STRING_SUB_UTF8  = 0,  /* default */
96         IDP_STRING_SUB_BYTE  = 1,  /* arbitrary byte array, _not_ null terminated */
97 };
98
99 /* IDP_GROUP */
100 enum {
101         IDP_GROUP_SUB_NONE              = 0,  /* default */
102         IDP_GROUP_SUB_MODE_OBJECT       = 1,  /* object mode settings */
103         IDP_GROUP_SUB_MODE_EDIT         = 2,  /* mesh edit mode settings */
104         IDP_GROUP_SUB_ENGINE_RENDER     = 3,  /* render engine settings */
105         IDP_GROUP_SUB_OVERRIDE          = 4,  /* data override */
106         IDP_GROUP_SUB_MODE_PAINT_WEIGHT = 5,  /* weight paint mode settings */
107         IDP_GROUP_SUB_MODE_PAINT_VERTEX = 6,  /* vertex paint mode settings */
108 };
109
110 /*->flag*/
111 enum {
112         IDP_FLAG_GHOST       = 1 << 7,  /* this means the property is set but RNA will return false when checking
113                                          * 'RNA_property_is_set', currently this is a runtime flag */
114 };
115
116 /* add any future new id property types here.*/
117
118
119 /* Static ID override structs. */
120
121 typedef struct IDOverrideStaticPropertyOperation {
122         struct IDOverrideStaticPropertyOperation *next, *prev;
123
124         /* Type of override. */
125         short operation;
126         short flag;
127         short pad_s1[2];
128
129         /* Sub-item references, if needed (for arrays or collections only).
130          * We need both reference and local values to allow e.g. insertion into collections (constraints, modifiers...).
131          * In collection case, if names are defined, they are used in priority.
132          * Names are pointers (instead of char[64]) to save some space, NULL when unset.
133          * Indices are -1 when unset. */
134         char *subitem_reference_name;
135         char *subitem_local_name;
136         int subitem_reference_index;
137         int subitem_local_index;
138 } IDOverrideStaticPropertyOperation;
139
140 /* IDOverridePropertyOperation->operation. */
141 enum {
142         /* Basic operations. */
143         IDOVERRIDESTATIC_OP_NOOP          =   0,  /* Special value, forbids any overriding. */
144
145         IDOVERRIDESTATIC_OP_REPLACE       =   1,  /* Fully replace local value by reference one. */
146
147         /* Numeric-only operations. */
148         IDOVERRIDESTATIC_OP_ADD           = 101,  /* Add local value to reference one. */
149         /* Subtract local value from reference one (needed due to unsigned values etc.). */
150         IDOVERRIDESTATIC_OP_SUBTRACT      = 102,
151         /* Multiply reference value by local one (more useful than diff for scales and the like). */
152         IDOVERRIDESTATIC_OP_MULTIPLY      = 103,
153
154         /* Collection-only operations. */
155         IDOVERRIDESTATIC_OP_INSERT_AFTER  = 201,  /* Insert after given reference's subitem. */
156         IDOVERRIDESTATIC_OP_INSERT_BEFORE = 202,  /* Insert before given reference's subitem. */
157         /* We can add more if needed (move, delete, ...). */
158 };
159
160 /* IDOverridePropertyOperation->flag. */
161 enum {
162         IDOVERRIDESTATIC_FLAG_MANDATORY     =   1 << 0,  /* User cannot remove that override operation. */
163         IDOVERRIDESTATIC_FLAG_LOCKED        =   1 << 1,  /* User cannot change that override operation. */
164 };
165
166 /* A single overriden property, contain all operations on this one. */
167 typedef struct IDOverrideStaticProperty {
168         struct IDOverrideStaticProperty *next, *prev;
169
170         /* Path from ID to overridden property. *Does not* include indices/names for final arrays/collections items. */
171         char *rna_path;
172
173         ListBase operations;  /* List of overriding operations (IDOverridePropertyOperation) applied to this property. */
174 } IDOverrideStaticProperty;
175
176 /* Main container for all overriding data info of a data-block. */
177 typedef struct IDOverrideStatic {
178         struct ID *reference;  /* Reference linked ID which this one overrides. */
179         ListBase properties;  /* List of IDOverrideProperty structs. */
180
181         /* Read/write data. */
182         /* Temp ID storing extra override data (used for differential operations only currently).
183          * Always NULL outside of read/write context. */
184         struct ID *storage;
185 } IDOverrideStatic;
186
187
188 /* watch it: Sequence has identical beginning. */
189 /**
190  * ID is the first thing included in all serializable types. It
191  * provides a common handle to place all data in double-linked lists.
192  * */
193
194 /* 2 characters for ID code and 64 for actual name */
195 #define MAX_ID_NAME  66
196
197 /* There's a nasty circular dependency here.... 'void *' to the rescue! I
198  * really wonder why this is needed. */
199 typedef struct ID {
200         void *next, *prev;
201         struct ID *newid;
202         struct Library *lib;
203         char name[66]; /* MAX_ID_NAME */
204         /**
205          * LIB_... flags report on status of the datablock this ID belongs to (persistent, saved to and read from .blend).
206          */
207         short flag;
208         /**
209          * LIB_TAG_... tags (runtime only, cleared at read time).
210          */
211         int tag;
212         int us;
213         int icon_id;
214         int recalc;
215         int pad;
216         IDProperty *properties;
217
218         IDOverrideStatic *override_static;  /* Reference linked ID which this one overrides. */
219         void *pad1;
220
221         void *py_instance;
222 } ID;
223
224 /**
225  * For each library file used, a Library struct is added to Main
226  * WARNING: readfile.c, expand_doit() reads this struct without DNA check!
227  */
228 typedef struct Library {
229         ID id;
230         struct FileData *filedata;
231         char name[1024];  /* path name used for reading, can be relative and edited in the outliner */
232
233         /* absolute filepath, this is only for convenience, 'name' is the real path used on file read but in
234          * some cases its useful to access the absolute one.
235          * This is set on file read.
236          * Use BKE_library_filepath_set() rather than setting 'name' directly and it will be kept in sync - campbell */
237         char filepath[1024];
238
239         struct Library *parent; /* set for indirectly linked libs, used in the outliner and while reading */
240         
241         struct PackedFile *packedfile;
242
243         /* Temp data needed by read/write code. */
244         int temp_index;
245         short versionfile, subversionfile;  /* see BLENDER_VERSION, BLENDER_SUBVERSION, needed for do_versions */
246 } Library;
247
248 enum eIconSizes {
249         ICON_SIZE_ICON = 0,
250         ICON_SIZE_PREVIEW = 1,
251
252         NUM_ICON_SIZES
253 };
254
255 /* for PreviewImage->flag */
256 enum ePreviewImage_Flag {
257         PRV_CHANGED          = (1 << 0),
258         PRV_USER_EDITED      = (1 << 1),  /* if user-edited, do not auto-update this anymore! */
259 };
260
261 /* for PreviewImage->tag */
262 enum  {
263         PRV_TAG_DEFFERED           = (1 << 0),  /* Actual loading of preview is deffered. */
264         PRV_TAG_DEFFERED_RENDERING = (1 << 1),  /* Deffered preview is being loaded. */
265         PRV_TAG_DEFFERED_DELETE    = (1 << 2),  /* Deffered preview should be deleted asap. */
266 };
267
268 typedef struct PreviewImage {
269         /* All values of 2 are really NUM_ICON_SIZES */
270         unsigned int w[2];
271         unsigned int h[2];
272         short flag[2];
273         short changed_timestamp[2];
274         unsigned int *rect[2];
275
276         /* Runtime-only data. */
277         struct GPUTexture *gputexture[2];
278         int icon_id;  /* Used by previews outside of ID context. */
279
280         short tag;  /* Runtime data. */
281         char pad[2];
282 } PreviewImage;
283
284 #define PRV_DEFERRED_DATA(prv) \
285         (CHECK_TYPE_INLINE(prv, PreviewImage *), BLI_assert((prv)->tag & PRV_TAG_DEFFERED), (void *)((prv) + 1))
286
287 /**
288  * Defines for working with IDs.
289  *
290  * The tags represent types! This is a dirty way of enabling RTTI. The
291  * sig_byte end endian defines aren't really used much.
292  *
293  **/
294
295 #ifdef __BIG_ENDIAN__
296    /* big endian */
297 #  define MAKE_ID2(c, d)  ((c) << 8 | (d))
298 #else
299    /* little endian  */
300 #  define MAKE_ID2(c, d)  ((d) << 8 | (c))
301 #endif
302
303 /**
304  * ID from database.
305  *
306  * Written to #BHead.code (for file IO)
307  * and the first 2 bytes of #ID.name (for runtime checks, see #GS macro).
308  */
309 typedef enum ID_Type {
310         ID_SCE  = MAKE_ID2('S', 'C'), /* Scene */
311         ID_LI   = MAKE_ID2('L', 'I'), /* Library */
312         ID_OB   = MAKE_ID2('O', 'B'), /* Object */
313         ID_ME   = MAKE_ID2('M', 'E'), /* Mesh */
314         ID_CU   = MAKE_ID2('C', 'U'), /* Curve */
315         ID_MB   = MAKE_ID2('M', 'B'), /* MetaBall */
316         ID_MA   = MAKE_ID2('M', 'A'), /* Material */
317         ID_TE   = MAKE_ID2('T', 'E'), /* Tex (Texture) */
318         ID_IM   = MAKE_ID2('I', 'M'), /* Image */
319         ID_LT   = MAKE_ID2('L', 'T'), /* Lattice */
320         ID_LA   = MAKE_ID2('L', 'A'), /* Lamp */
321         ID_CA   = MAKE_ID2('C', 'A'), /* Camera */
322         ID_IP   = MAKE_ID2('I', 'P'), /* Ipo (depreciated, replaced by FCurves) */
323         ID_KE   = MAKE_ID2('K', 'E'), /* Key (shape key) */
324         ID_WO   = MAKE_ID2('W', 'O'), /* World */
325         ID_SCR  = MAKE_ID2('S', 'R'), /* Screen */
326         ID_VF   = MAKE_ID2('V', 'F'), /* VFont (Vector Font) */
327         ID_TXT  = MAKE_ID2('T', 'X'), /* Text */
328         ID_SPK  = MAKE_ID2('S', 'K'), /* Speaker */
329         ID_SO   = MAKE_ID2('S', 'O'), /* Sound */
330         ID_GR   = MAKE_ID2('G', 'R'), /* Group */
331         ID_AR   = MAKE_ID2('A', 'R'), /* bArmature */
332         ID_AC   = MAKE_ID2('A', 'C'), /* bAction */
333         ID_NT   = MAKE_ID2('N', 'T'), /* bNodeTree */
334         ID_BR   = MAKE_ID2('B', 'R'), /* Brush */
335         ID_PA   = MAKE_ID2('P', 'A'), /* ParticleSettings */
336         ID_GD   = MAKE_ID2('G', 'D'), /* bGPdata, (Grease Pencil) */
337         ID_WM   = MAKE_ID2('W', 'M'), /* WindowManager */
338         ID_MC   = MAKE_ID2('M', 'C'), /* MovieClip */
339         ID_MSK  = MAKE_ID2('M', 'S'), /* Mask */
340         ID_LS   = MAKE_ID2('L', 'S'), /* FreestyleLineStyle */
341         ID_PAL  = MAKE_ID2('P', 'L'), /* Palette */
342         ID_PC   = MAKE_ID2('P', 'C'), /* PaintCurve  */
343         ID_CF   = MAKE_ID2('C', 'F'), /* CacheFile */
344         ID_WS   = MAKE_ID2('W', 'S'), /* WorkSpace */
345         ID_LP   = MAKE_ID2('L', 'P'), /* LightProbe */
346 } ID_Type;
347
348 /* Only used as 'placeholder' in .blend files for directly linked datablocks. */
349 #define ID_ID       MAKE_ID2('I', 'D') /* (internal use only) */
350
351 /* Deprecated. */
352 #define ID_SCRN     MAKE_ID2('S', 'N')
353
354 /* NOTE! Fake IDs, needed for g.sipo->blocktype or outliner */
355 #define ID_SEQ          MAKE_ID2('S', 'Q')
356                         /* constraint */
357 #define ID_CO           MAKE_ID2('C', 'O')
358                         /* pose (action channel, used to be ID_AC in code, so we keep code for backwards compat) */
359 #define ID_PO           MAKE_ID2('A', 'C')
360                         /* used in outliner... */
361 #define ID_NLA          MAKE_ID2('N', 'L')
362                         /* fluidsim Ipo */
363 #define ID_FLUIDSIM     MAKE_ID2('F', 'S')
364
365 #define ID_FAKE_USERS(id) ((((ID *)id)->flag & LIB_FAKEUSER) ? 1 : 0)
366 #define ID_REAL_USERS(id) (((ID *)id)->us - ID_FAKE_USERS(id))
367 #define ID_EXTRA_USERS(id) (((ID *)id)->tag & LIB_TAG_EXTRAUSER ? 1 : 0)
368
369 #define ID_CHECK_UNDO(id) ((GS((id)->name) != ID_SCR) && (GS((id)->name) != ID_WM) && (GS((id)->name) != ID_WS))
370
371 #define ID_BLEND_PATH(_bmain, _id) ((_id)->lib ? (_id)->lib->filepath : (_bmain)->name)
372
373 #define ID_MISSING(_id) (((_id)->tag & LIB_TAG_MISSING) != 0)
374
375 #define ID_IS_LINKED(_id) (((ID *)(_id))->lib != NULL)
376
377 #ifdef GS
378 #  undef GS
379 #endif
380 #define GS(a)   (CHECK_TYPE_ANY(a, char *, const char *, char [66], const char[66]), (ID_Type)(*((const short *)(a))))
381
382 #define ID_NEW_SET(_id, _idn) \
383         (((ID *)(_id))->newid = (ID *)(_idn), ((ID *)(_id))->newid->tag |= LIB_TAG_NEW, (void *)((ID *)(_id))->newid)
384 #define ID_NEW_REMAP(a) if ((a) && (a)->id.newid) (a) = (void *)(a)->id.newid
385
386 /* id->flag (persitent). */
387 enum {
388         LIB_OVERRIDE_STATIC_AUTO    = 1 << 0,  /* Allow automatic generation of overriding rules. */
389         LIB_FAKEUSER                = 1 << 9,
390 };
391
392 /**
393  * id->tag (runtime-only).
394  *
395  * Those flags belong to three different categories, which have different expected handling in code:
396  *
397  *   - RESET_BEFORE_USE: piece of code that wants to use such flag has to ensure they are properly 'reset' first.
398  *   - RESET_AFTER_USE: piece of code that wants to use such flag has to ensure they are properly 'reset' after usage
399  *                      (though 'lifetime' of those flags is a bit fuzzy, e.g. _RECALC ones are reset on depsgraph
400  *                       evaluation...).
401  *   - RESET_NEVER: those flags are 'status' one, and never actually need any reset (except on initialization
402  *                  during .blend file reading).
403  */
404 enum {
405         /* RESET_NEVER Datablock is from current .blend file. */
406         LIB_TAG_LOCAL           = 0,
407         /* RESET_NEVER Datablock is from a library, but is used (linked) directly by current .blend file. */
408         LIB_TAG_EXTERN          = 1 << 0,
409         /* RESET_NEVER Datablock is from a library, and is only used (linked) inderectly through other libraries. */
410         LIB_TAG_INDIRECT        = 1 << 1,
411
412         /* RESET_AFTER_USE Three flags used internally in readfile.c, to mark IDs needing to be read (only done once). */
413         LIB_TAG_NEED_EXPAND     = 1 << 3,
414         LIB_TAG_TESTEXT         = (LIB_TAG_NEED_EXPAND | LIB_TAG_EXTERN),
415         LIB_TAG_TESTIND         = (LIB_TAG_NEED_EXPAND | LIB_TAG_INDIRECT),
416         /* RESET_AFTER_USE Flag used internally in readfile.c, to mark IDs needing to be linked from a library. */
417         LIB_TAG_READ            = 1 << 4,
418         /* RESET_AFTER_USE */
419         LIB_TAG_NEED_LINK       = 1 << 5,
420
421         /* RESET_NEVER tag datablock as a place-holder (because the real one could not be linked from its library e.g.). */
422         LIB_TAG_MISSING         = 1 << 6,
423
424         /* RESET_NEVER tag datablock as being up-to-date regarding its reference. */
425         LIB_TAG_OVERRIDESTATIC_OK = 1 << 9,
426
427         /* tag datablock has having an extra user. */
428         LIB_TAG_EXTRAUSER       = 1 << 2,
429         /* tag datablock has having actually increased usercount for the extra virtual user. */
430         LIB_TAG_EXTRAUSER_SET   = 1 << 7,
431
432         /* RESET_AFTER_USE tag newly duplicated/copied IDs.
433          * Also used internally in readfile.c to mark datablocks needing do_versions. */
434         LIB_TAG_NEW             = 1 << 8,
435         /* RESET_BEFORE_USE free test flag.
436          * TODO make it a RESET_AFTER_USE too. */
437         LIB_TAG_DOIT            = 1 << 10,
438         /* RESET_AFTER_USE tag existing data before linking so we know what is new. */
439         LIB_TAG_PRE_EXISTING    = 1 << 11,
440
441         /* The datablock is a copy-on-write version. */
442         LIB_TAG_COPY_ON_WRITE   = 1 << 12,
443         LIB_TAG_COPY_ON_WRITE_EVAL = 1 << 13,
444
445         /* RESET_NEVER tag datablock for freeing etc. behavior (usually set when copying real one into temp/runtime one). */
446         LIB_TAG_NO_MAIN          = 1 << 14,  /* Datablock is not listed in Main database. */
447         LIB_TAG_NO_USER_REFCOUNT = 1 << 15,  /* Datablock does not refcount usages of other IDs. */
448         /* Datablock was not allocated by standard system (BKE_libblock_alloc), do not free its memory
449          * (usual type-specific freeing is called though). */
450         LIB_TAG_NOT_ALLOCATED     = 1 << 16,
451 };
452
453 enum {
454         /* RESET_AFTER_USE, used by update code (depsgraph). */
455         ID_RECALC       = 1 << 0,
456         ID_RECALC_DATA  = 1 << 1,
457         ID_RECALC_SKIP_ANIM_TAG  = 1 << 2,
458         ID_RECALC_ALL   = (ID_RECALC | ID_RECALC_DATA),
459 };
460
461 /* To filter ID types (filter_id) */
462 /* XXX We cannot put all needed IDs inside an enum...
463  *     We'll have to see whether we can fit all needed ones inside 32 values,
464  *     or if we need to fallback to longlong defines :/
465  */
466 enum {
467         FILTER_ID_AC        = (1 << 0),
468         FILTER_ID_AR        = (1 << 1),
469         FILTER_ID_BR        = (1 << 2),
470         FILTER_ID_CA        = (1 << 3),
471         FILTER_ID_CU        = (1 << 4),
472         FILTER_ID_GD        = (1 << 5),
473         FILTER_ID_GR        = (1 << 6),
474         FILTER_ID_IM        = (1 << 7),
475         FILTER_ID_LA        = (1 << 8),
476         FILTER_ID_LS        = (1 << 9),
477         FILTER_ID_LT        = (1 << 10),
478         FILTER_ID_MA        = (1 << 11),
479         FILTER_ID_MB        = (1 << 12),
480         FILTER_ID_MC        = (1 << 13),
481         FILTER_ID_ME        = (1 << 14),
482         FILTER_ID_MSK       = (1 << 15),
483         FILTER_ID_NT        = (1 << 16),
484         FILTER_ID_OB        = (1 << 17),
485         FILTER_ID_PAL       = (1 << 18),
486         FILTER_ID_PC        = (1 << 19),
487         FILTER_ID_SCE       = (1 << 20),
488         FILTER_ID_SPK       = (1 << 21),
489         FILTER_ID_SO        = (1 << 22),
490         FILTER_ID_TE        = (1 << 23),
491         FILTER_ID_TXT       = (1 << 24),
492         FILTER_ID_VF        = (1 << 25),
493         FILTER_ID_WO        = (1 << 26),
494         FILTER_ID_PA        = (1 << 27),
495         FILTER_ID_CF        = (1 << 28),
496         FILTER_ID_WS        = (1 << 29),
497         FILTER_ID_LP        = (1u << 31),
498 };
499
500 /* IMPORTANT: this enum matches the order currently use in set_listbasepointers,
501  * keep them in sync! */
502 enum {
503         INDEX_ID_LI = 0,
504         INDEX_ID_IP,
505         INDEX_ID_AC,
506         INDEX_ID_KE,
507         INDEX_ID_GD,
508         INDEX_ID_NT,
509         INDEX_ID_IM,
510         INDEX_ID_TE,
511         INDEX_ID_MA,
512         INDEX_ID_VF,
513         INDEX_ID_AR,
514         INDEX_ID_CF,
515         INDEX_ID_ME,
516         INDEX_ID_CU,
517         INDEX_ID_MB,
518         INDEX_ID_LT,
519         INDEX_ID_LA,
520         INDEX_ID_CA,
521         INDEX_ID_TXT,
522         INDEX_ID_SO,
523         INDEX_ID_GR,
524         INDEX_ID_PAL,
525         INDEX_ID_PC,
526         INDEX_ID_BR,
527         INDEX_ID_PA,
528         INDEX_ID_SPK,
529         INDEX_ID_LP,
530         INDEX_ID_WO,
531         INDEX_ID_MC,
532         INDEX_ID_SCR,
533         INDEX_ID_OB,
534         INDEX_ID_LS,
535         INDEX_ID_SCE,
536         INDEX_ID_WS,
537         INDEX_ID_WM,
538         INDEX_ID_MSK,
539         INDEX_ID_NULL,
540 };
541
542 #ifdef __cplusplus
543 }
544 #endif
545
546 #endif