bse-structures(3)
NAME
BSE-Structures - BSE Structure Reference
Document Revised: Wed May 25 23:38:24 2005
SYNOPSIS
record BseCategory; record BseDot; record BseGConfig; record BseIcon; record BseMessage; record BseMidiChannelEvent; record BseNoteDescription; record BseNoteSequence; record BsePartControl; record BsePartLink; record BsePartNote; record BseProbe; record BseProbeFeatures; record BseProbeRequest; record BsePropertyCandidates; record BseSampleFileInfo; record BseSongTiming; record BseThreadInfo; record BseThreadTotals; record BseTrackPart; sequence BseCategorySeq; sequence BseDotSeq; sequence BseIntSeq; sequence BseItemSeq; sequence BseNoteSeq; sequence BsePartControlSeq; sequence BsePartLinkSeq; sequence BsePartNoteSeq; sequence BseProbeRequestSeq; sequence BseProbeSeq; sequence BseStringSeq; sequence BseThreadInfoSeq; sequence BseTrackPartSeq; sequence BseTypeSeq;
DESCRIPTION
- sequence BseThreadInfoSeq {
- guint n_thread_infos; C language
- specific number of elements
BseThreadInfo** thread_infos; thread-infos - };
- sequence BseTrackPartSeq {
- guint n_tparts; C language specific
- number of elements
BseTrackPart** tparts; tparts - };
- sequence BsePartLinkSeq {
- guint n_plinks; C language specific
- number of elements
BsePartLink** plinks; plinks - };
- sequence BseDotSeq {
- guint n_dots; C language specific number of
- elements
BseDot** dots; dots - };
- sequence BseCategorySeq {
- guint n_cats; C language specific num
- ber of elements
BseCategory** cats; cats - };
- sequence BsePartControlSeq {
- guint n_pcontrols; C language spe
- cific number of elements
BsePartControl** pcontrols; pcontrols - };
A list of part control events- sequence BsePartNoteSeq {
- guint n_pnotes; C language specific
- number of elements
BsePartNote** pnotes; pnotes - };
A list of part notes- sequence BseItemSeq {
- guint n_items; C language specific number
- of elements
SfiProxy* items; items - };
A list of BSE items or derived types.- sequence BseNoteSeq {
- guint n_notes; C language specific number of
- elements
SfiInt* notes; Note - };
- sequence BseStringSeq {
- guint n_strings; C language specific
- number of elements
const gchar** strings; strings - };
- sequence BseTypeSeq {
- guint n_types; C language specific
- number of elements
const gchar** types; types - };
- sequence BseIntSeq {
- guint n_ints; C language specific number of
- elements
SfiInt* ints; ints - };
- record BseGConfig {
- const gchar* sample_path; Search path
- of directories, seperated by ":", used to find audio samples.
const gchar* effect_path; Search path - of directories, seperated by ":", used to find BSE effect files.
const gchar* instrument_path; Search path - of directories, seperated by ":", used to find BSE instrument
- files.
const gchar* script_path; Search path - of directories, seperated by ":", used to find BSE scheme
- scripts.
const gchar* plugin_path; Search path - of directories, seperated by ":", used to find BSE plugins. This
- path is searched for in addition to the standard BSE plugin loca
- tion on this system.
const gchar* ladspa_path; Search path - of directories, seperated by ":", used to find LADSPA plugins.
- This path is searched for in addition to the standard LADSPA lo
- cation on this system. LADSPA is the Linux Audio Developer's Sim
- ple Plugin API, more informations about LADSPA plugins can be
- found at http://www.ladspa.org/.
SfiInt synth_latency; Processing - duration between input and output of a single sample, smaller
- values increase CPU load
SfiInt synth_mixing_freq; Synthesis - mixing frequency, common values are: 22050, 44100, 48000
SfiInt synth_control_freq; Frequency at - which control values are evaluated, should be much smaller than
- Synth Mixing Frequency to reduce CPU load
SfiBool invert_sustain; Invert the - state of sustain (damper) pedal so on/off meanings are reversed
SfiReal step_volume_d_b; Step width - for volume in decibel
SfiInt step_bpm; Step width - for beats per minute
- };
- record BseThreadTotals {
- BseThreadInfo* main; main BseThreadInfo* sequencer; sequencer BseThreadInfoSeq* synthesis; synthesis
- };
- record BseThreadInfo {
- const gchar* name; Thread Name SfiChoice state; The execution state of
- the thread
SfiInt thread_id; A unique number iden - tifying this thread
SfiInt priority; The nice value of a - thread, -20 indicates a high priority thread and +19 a low prior
- ity one that is 'nice' to others
SfiInt processor; The processor that - this thread is currently being executed on
SfiInt utime; The CPU time spent ex - ecuting instructions of this thread
SfiInt stime; The CPU time spent in - the system for this thread
SfiInt cutime; The CPU time spent ex - ecuting instructions of children of this thread
SfiInt cstime; The CPU time spent in - the system for children of this thread
- };
- record BseMessage {
- const gchar* log_domain; log-domain
SfiChoice type; type
const gchar* ident; ident const gchar* label; label const gchar* title; title const gchar* primary; primary const gchar* secondary; secondary const gchar* details; details const gchar* config_check; config-check SfiProxy janitor; janitor const gchar* process; process SfiInt pid; pid - };
- record BseSampleFileInfo {
- const gchar* file; Filename
SfiInt size; File Size
SfiNum mtime; Modification Time const gchar* loader; Loader BseStringSeq* waves; waves SfiInt error; BseErrorType - };
- record BseSongTiming {
- SfiInt tick; Current tick
SfiReal bpm; Beats per minute
SfiInt numerator; Number of notes per mea - sure
SfiInt denominator; Type of notes counted per - measure
SfiInt tpqn; Ticks per quarter note SfiInt tpt; Ticks per tact
SfiReal stamp_ticks; Ticks per stamp increment - (valid only during playback)
- };
- record BseTrackPart {
- SfiInt tick; Tick
SfiProxy part; part
SfiInt duration; Duration - };
- record BsePartLink {
- SfiProxy track; track
SfiInt tick; Tick
SfiProxy part; part
SfiInt duration; Duration - };
- record BseDot {
- SfiReal x; x
SfiReal y; y - };
- record BseCategory {
- SfiInt category_id; Category ID
const gchar* category; category
SfiInt mindex; mindex
SfiInt lindex; lindex
const gchar* type; type BseIcon* icon; icon - };
- record BseIcon {
- SfiInt bytes_per_pixel; Bytes Per Pixel
- (3:RGB, 4:RGBA, 0:NONE)
SfiInt width; Width in pixels or - 0 for no icon
SfiInt height; Height in pixels - or 0 for no icon
SfiBBlock* pixels; Pixel array of - width*height*bytes_per_pixel bytes
- };
BSE icon representation.- record BseNoteSequence {
- SfiInt offset; Center/base note BseNoteSeq* notes; Sequence of notes
- };
- record BseNoteDescription {
- SfiInt note; Note
SfiInt octave; Octave SfiReal freq; Frequency SfiInt fine_tune; Fine Tune SfiInt semitone; Semitone SfiBool upshift; upshift SfiInt letter; International ab - breviation letter for this note
const gchar* name; Name SfiInt max_fine_tune; Max Fine Tune SfiInt kammer_note; Kammer Note - };
A note description provides all necessary details- about a specific note. Various procedures exist to retrieve a
- note description; given different key values. The max_fine_tune
- and kammer_note fields are constants; which are provided for com
- patibility reasons and will vanish in future APIs.
- record BsePartControl {
- SfiInt id; ID
SfiInt tick; Tick
SfiChoice control_type; control-type SfiReal value; Value
SfiBool selected; Selected - };
Part specific control event representation- record BsePartNote {
- SfiInt id; ID
SfiInt channel; Channel
SfiInt tick; Tick
SfiInt duration; Duration in number of ticks SfiInt note; Note
SfiInt fine_tune; Fine Tune SfiReal velocity; Velocity
SfiBool selected; Selected - };
Part specific note representation- record BsePropertyCandidates {
- const gchar* label; label const gchar* tooltip; tooltip BseItemSeq* items; items BseTypeSeq* partitions; List of types which
- may logically partition the list of items by type discrimination
- };
A strcuture describing tentative property values.- record BseMidiChannelEvent {
- SfiChoice event_type; event-type
SfiInt channel; Channel
SfiNum tick_stamp; Time Stamp SfiReal frequency; Frequency SfiReal velocity; Velocity SfiInt control; Control Number SfiReal value; Value
SfiInt program; Program
SfiReal intensity; Intensity SfiReal pitch_bend; Pitch Bend SfiInt song_pointer; Song Pointer SfiInt song_number; Song Number - };
- sequence BseProbeRequestSeq {
- guint n_probe_requests; C language
- specific number of elements
BseProbeRequest** probe_requests; probe-re - quests
- };
- sequence BseProbeSeq {
- guint n_probes; C language specific num
- ber of elements
BseProbe** probes; probes - };
- record BseProbeRequest {
- SfiProxy source; source SfiInt channel_id; channel-id SfiInt block_size; block-size BseProbeFeatures* probe_features; probe-fea
- tures
- };
- record BseProbe {
- SfiInt channel_id; channel-id SfiNum block_stamp; block-stamp BseProbeFeatures* probe_features; probe-fea
- tures
SfiReal mix_freq; mix-freq SfiReal min; min
SfiReal max; max
SfiReal energie; energie SfiFBlock* sample_data; sample-data SfiFBlock* fft_data; fft-data - };
- record BseProbeFeatures {
- SfiBool probe_range; probe-range SfiBool probe_energie; probe-energie SfiBool probe_samples; probe-samples SfiBool probe_fft; probe-fft
- };
SEE ALSO
BSE Procedures (bse-procs(3))
- Document Revised: Wed May 25 23:38:24 2005
- BEAST-0.6.6 25 May 2005 BSE