/usr/include/bse/bseitem.h is in libbse-dev 0.7.4-4.
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 167 168 169 170 171 172 173 | /* BSE - Better Sound Engine
* Copyright (C) 1998-2003 Tim Janik
*
* This library is free software; you can redistribute it and/or
* modify it under the terms of the GNU Lesser General Public
* License as published by the Free Software Foundation; either
* version 2.1 of the License, or (at your option) any later version.
*
* This library 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
* Lesser General Public License for more details.
*
* A copy of the GNU Lesser General Public License should ship along
* with this library; if not, see http://www.gnu.org/copyleft/.
*/
#ifndef __BSE_ITEM_H__
#define __BSE_ITEM_H__
#include <bse/bseobject.h>
G_BEGIN_DECLS
/* --- object type macros --- */
#define BSE_TYPE_ITEM (BSE_TYPE_ID (BseItem))
#define BSE_ITEM(object) (G_TYPE_CHECK_INSTANCE_CAST ((object), BSE_TYPE_ITEM, BseItem))
#define BSE_ITEM_CLASS(class) (G_TYPE_CHECK_CLASS_CAST ((class), BSE_TYPE_ITEM, BseItemClass))
#define BSE_IS_ITEM(object) (G_TYPE_CHECK_INSTANCE_TYPE ((object), BSE_TYPE_ITEM))
#define BSE_IS_ITEM_CLASS(class) (G_TYPE_CHECK_CLASS_TYPE ((class), BSE_TYPE_ITEM))
#define BSE_ITEM_GET_CLASS(object) (G_TYPE_INSTANCE_GET_CLASS ((object), BSE_TYPE_ITEM, BseItemClass))
/* --- BseItem member macros --- */
#define BSE_ITEM_SINGLETON(object) ((BSE_OBJECT_FLAGS (object) & BSE_ITEM_FLAG_SINGLETON) != 0)
#define BSE_ITEM_INTERNAL(item) ((BSE_OBJECT_FLAGS (item) & BSE_ITEM_FLAG_INTERN_BRANCH) != 0)
/* --- bse item flags --- */
typedef enum /*< skip >*/
{
BSE_ITEM_FLAG_SINGLETON = 1 << (BSE_OBJECT_FLAGS_USHIFT + 0),
BSE_ITEM_FLAG_INTERN = 1 << (BSE_OBJECT_FLAGS_USHIFT + 1),
BSE_ITEM_FLAG_INTERN_BRANCH = 1 << (BSE_OBJECT_FLAGS_USHIFT + 2)
} BseItemFlags;
#define BSE_ITEM_FLAGS_USHIFT (BSE_OBJECT_FLAGS_USHIFT + 3)
/* --- BseItem object --- */
struct _BseItem
{
BseObject parent_object;
guint use_count;
BseItem *parent;
BseParasite *parasite;
};
struct _BseItemClass
{
BseObjectClass parent_class;
void (*get_candidates) (BseItem *item,
guint param_id,
BsePropertyCandidates *pc,
GParamSpec *pspec);
void (*set_parent) (BseItem *item,
BseItem *parent);
gboolean (*needs_storage) (BseItem *item,
BseStorage *storage);
void (*compat_setup) (BseItem *item,
guint vmajor,
guint vminor,
guint vmicro);
guint (*get_seqid) (BseItem *item);
BseUndoStack* (*get_undo) (BseItem *item);
};
typedef void (*BseItemUncross) (BseItem *owner,
BseItem *link);
typedef gboolean (*BseItemCheckContainer) (BseContainer *container,
BseItem *item,
gpointer data);
typedef gboolean (*BseItemCheckProxy) (BseItem *proxy,
BseItem *item,
gpointer data);
/* --- prototypes --- */
BseItemSeq* bse_item_gather_items (BseItem *item,
BseItemSeq *iseq,
GType base_type,
BseItemCheckContainer ccheck,
BseItemCheckProxy pcheck,
gpointer data);
BseItemSeq* bse_item_gather_items_typed (BseItem *item,
BseItemSeq *iseq,
GType proxy_type,
GType container_type,
gboolean allow_ancestor);
gboolean bse_item_get_candidates (BseItem *item,
const gchar *property,
BsePropertyCandidates *pc);
void bse_item_set_internal (gpointer item,
gboolean internal);
gboolean bse_item_needs_storage (BseItem *item,
BseStorage *storage);
void bse_item_compat_setup (BseItem *item,
guint vmajor,
guint vminor,
guint vmicro);
guint bse_item_get_seqid (BseItem *item);
void bse_item_queue_seqid_changed (BseItem *item);
BseSuper* bse_item_get_super (BseItem *item);
BseSNet* bse_item_get_snet (BseItem *item);
BseProject* bse_item_get_project (BseItem *item);
BseItem* bse_item_get_toplevel (BseItem *item);
gboolean bse_item_has_ancestor (BseItem *item,
BseItem *ancestor);
BseItem* bse_item_common_ancestor (BseItem *item1,
BseItem *item2);
void bse_item_cross_link (BseItem *owner,
BseItem *link,
BseItemUncross uncross_func);
void bse_item_cross_unlink (BseItem *owner,
BseItem *link,
BseItemUncross uncross_func);
void bse_item_uncross_links (BseItem *owner,
BseItem *link);
BseItem* bse_item_use (BseItem *item);
void bse_item_unuse (BseItem *item);
void bse_item_set_parent (BseItem *item,
BseItem *parent);
BseErrorType bse_item_exec (gpointer item,
const gchar *procedure,
...);
BseErrorType bse_item_exec_void (gpointer item,
const gchar *procedure,
...); /* ignore return values */
/* undo-aware functions */
void bse_item_set_valist_undoable (gpointer object,
const gchar *first_property_name,
va_list var_args);
void bse_item_set_undoable (gpointer object,
const gchar *first_property_name,
...) G_GNUC_NULL_TERMINATED;
void bse_item_set_property_undoable (BseItem *self,
const gchar *name,
const GValue *value);
/* undo admin functions */
BseUndoStack* bse_item_undo_open (gpointer item,
const gchar *format,
...) G_GNUC_PRINTF (2, 3);
void bse_item_undo_close (BseUndoStack *ustack);
/* undo helper functions */
void bse_item_push_undo_proc (gpointer item,
const gchar *procedure,
...);
void bse_item_push_redo_proc (gpointer item,
const gchar *procedure,
...);
void bse_item_backup_to_undo (BseItem *self,
BseUndoStack *ustack);
void bse_item_push_undo_storage (BseItem *self,
BseUndoStack *ustack,
BseStorage *storage);
/* convenience */
#define bse_item_set bse_item_set_undoable
#define bse_item_get g_object_get
BseMusicalTuningType bse_item_current_musical_tuning (BseItem *self);
G_END_DECLS
#endif /* __BSE_ITEM_H__ */
|