/usr/include/bse/bsestorage.hh is in libbse-dev 0.7.8-1.
This file is owned by root:root, with mode 0o644.
The actual contents of the file can be viewed below.
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 | // Licensed GNU LGPL v2.1 or later: http://www.gnu.org/licenses/lgpl.html
#ifndef __BSE_STORAGE_H__
#define __BSE_STORAGE_H__
#include <bse/bseobject.hh>
#include <bse/gsldefs.hh>
G_BEGIN_DECLS
/* --- object type macros --- */
#define BSE_TYPE_STORAGE (BSE_TYPE_ID (BseStorage))
#define BSE_STORAGE(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), BSE_TYPE_STORAGE, BseStorage))
#define BSE_STORAGE_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), BSE_TYPE_STORAGE, BseStorageClass))
#define BSE_IS_STORAGE(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), BSE_TYPE_STORAGE))
#define BSE_IS_STORAGE_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), BSE_TYPE_STORAGE))
#define BSE_STORAGE_GET_CLASS(object) (G_TYPE_INSTANCE_GET_CLASS ((object), BSE_TYPE_STORAGE, BseStorageClass))
/* --- macros --- */
#define BSE_STORAGE_VERSION(self, vmaj, min, vmic) ( /* whether file uses >=vARGS features */ \
BSE_VERSION_CMP (self->major_version, self->minor_version, self->micro_version, vmaj, min, vmic) >= 0)
#define BSE_STORAGE_COMPAT(self, vmaj, min, vmic) ( /* whether file needs <=vARGS compat code */ \
BSE_VERSION_CMP (self->major_version, self->minor_version, self->micro_version, vmaj, min, vmic) <= 0)
#define BSE_STORAGE_SELF_CONTAINED(st) ((BSE_OBJECT_FLAGS (st) & BSE_STORAGE_SELF_CONTAINED) != 0)
#define BSE_STORAGE_DBLOCK_CONTAINED(st) ((BSE_OBJECT_FLAGS (st) & BSE_STORAGE_DBLOCK_CONTAINED) != 0)
#define BSE_STORAGE_IS_UNDO(st) BSE_STORAGE_DBLOCK_CONTAINED (st)
typedef enum /*< skip >*/
{
BSE_STORAGE_SELF_CONTAINED = 1 << (BSE_OBJECT_FLAGS_USHIFT + 0),
BSE_STORAGE_DBLOCK_CONTAINED = 1 << (BSE_OBJECT_FLAGS_USHIFT + 1)
} BseStorageMode;
#define BSE_STORAGE_FLAGS_USHIFT (BSE_OBJECT_FLAGS_USHIFT + 2)
#define BSE_STORAGE_MODE_MASK (BSE_STORAGE_SELF_CONTAINED | BSE_STORAGE_DBLOCK_CONTAINED)
/* --- compatibility --- */
#define bse_storage_scanner_parse_or_return sfi_scanner_parse_or_return
#define bse_storage_scanner_peek_or_return sfi_scanner_peek_or_return
/* --- BseStorage --- */
typedef struct _BseStorageDBlock BseStorageDBlock;
typedef struct _BseStorageItemLink BseStorageItemLink;
typedef void (*BseStorageRestoreLink) (gpointer data,
BseStorage *storage,
BseItem *from_item,
BseItem *to_item,
const gchar *error);
struct _BseStorage
{
BseObject parent_instance;
/* writing */
SfiWStore *wstore;
SfiPPool *stored_items;
SfiPPool *referenced_items;
/* parsing */
SfiRStore *rstore;
guint major_version;
guint minor_version;
guint micro_version;
GHashTable *path_table;
SfiRing *item_links;
SfiPPool *restorable_objects;
/* internal data */
guint n_dblocks;
BseStorageDBlock *dblocks;
gchar *free_me;
/* compat */ // VERSION-FIXME: needed only for <= 0.5.1
gfloat mix_freq;
gfloat osc_freq;
guint n_channels;
};
struct _BseStorageClass
{
BseObjectClass parent_class;
};
/* --- compatibility file parsing --- */
void bse_storage_compat_dhreset (BseStorage *self);
void bse_storage_compat_dhmixf (BseStorage *self,
gfloat mix_freq);
void bse_storage_compat_dhoscf (BseStorage *self,
gfloat osc_freq);
void bse_storage_compat_dhchannels (BseStorage *self,
guint n_channels);
/* --- prototypes -- */
void bse_storage_reset (BseStorage *self);
void bse_storage_prepare_write (BseStorage *self,
BseStorageMode mode);
void bse_storage_turn_readable (BseStorage *self,
const gchar *storage_name);
BseErrorType bse_storage_input_file (BseStorage *self,
const gchar *file_name);
void bse_storage_input_text (BseStorage *self,
const gchar *text,
const gchar *text_name);
GTokenType bse_storage_restore_item (BseStorage *self,
gpointer item);
void bse_storage_store_item (BseStorage *self,
BseItem *item);
void bse_storage_store_child (BseStorage *self,
BseItem *item);
const gchar* bse_storage_item_get_compat_type (BseItem *item);
/* --- writing --- */
void bse_storage_putf (BseStorage *self,
gfloat vfloat);
void bse_storage_putd (BseStorage *self,
gdouble vdouble);
void bse_storage_putr (BseStorage *self,
SfiReal vreal,
const gchar *hints);
void bse_storage_printf (BseStorage *self,
const gchar *format,
...) G_GNUC_PRINTF (2, 3);
void bse_storage_put_param (BseStorage *self,
const GValue *value,
GParamSpec *pspec);
void bse_storage_put_item_link (BseStorage *self,
BseItem *from_item,
BseItem *to_item);
void bse_storage_put_data_handle (BseStorage *self,
guint significant_bits,
GslDataHandle *dhandle);
void bse_storage_put_xinfos (BseStorage *self,
gchar **xinfos);
BseErrorType bse_storage_flush_fd (BseStorage *self,
gint fd);
/* --- reading --- */
void bse_storage_error (BseStorage *self,
const gchar *format,
...) G_GNUC_PRINTF (2,3);
void bse_storage_warn (BseStorage *self,
const gchar *format,
...) G_GNUC_PRINTF (2,3);
GTokenType bse_storage_warn_skip (BseStorage *self,
const gchar *format,
...) G_GNUC_PRINTF (2,3);
GTokenType bse_storage_parse_param_value (BseStorage *self,
GValue *value,
GParamSpec *pspec);
GTokenType bse_storage_parse_item_link (BseStorage *self,
BseItem *from_item,
BseStorageRestoreLink restore_link,
gpointer data);
void bse_storage_add_restorable (BseStorage *self,
BseObject *object);
void bse_storage_finish_parsing (BseStorage *self);
GTokenType bse_storage_parse_data_handle (BseStorage *self,
GslDataHandle **data_handle_p,
guint *n_channels_p,
gfloat *mix_freq_p,
gfloat *osc_freq_p);
gboolean bse_storage_match_data_handle (BseStorage *self,
GQuark quark);
GTokenType bse_storage_parse_data_handle_rest (BseStorage *self,
GslDataHandle **data_handle_p,
guint *n_channels_p,
gfloat *mix_freq_p,
gfloat *osc_freq_p);
GTokenType bse_storage_parse_xinfos (BseStorage *self,
gchar ***xinfosp);
GTokenType bse_storage_parse_rest (BseStorage *self,
gpointer context_data,
BseTryStatement try_statement,
gpointer user_data);
gboolean bse_storage_check_parse_negate (BseStorage *self);
/* --- short-hands --- */
#define bse_storage_get_scanner(s) ((s)->rstore->scanner)
#define bse_storage_unexp_token(s,et) sfi_rstore_unexp_token ((s)->rstore, et)
#define bse_storage_push_level(s) sfi_wstore_push_level ((s)->wstore)
#define bse_storage_pop_level(s) sfi_wstore_pop_level ((s)->wstore)
#define bse_storage_break(s) sfi_wstore_break ((s)->wstore)
#define bse_storage_putc(s,c) sfi_wstore_putc ((s)->wstore, c)
#define bse_storage_puts(s,b) sfi_wstore_puts ((s)->wstore, b)
G_END_DECLS
#endif /* __BSE_STORAGE_H__ */
|