![]() |
![]() |
![]() |
Buzztard Bt-Core Reference Manual | ![]() |
---|---|---|---|---|
Top | Description | Object Hierarchy | Implemented Interfaces |
BtWirePatternBtWirePattern — class for an event pattern of a BtMachine instance |
#include <libbtcore/core.h> BtWirePattern; BtWirePattern * bt_wire_pattern_new (const BtSong * const song
,const BtWire * const wire
,const BtPattern * const pattern
); BtWirePattern * bt_wire_pattern_copy (const BtWirePattern * const self
,const BtPattern * const pattern
); GValue * bt_wire_pattern_get_event_data (const BtWirePattern * const self
,const gulong tick
,const gulong param
); gboolean bt_wire_pattern_set_event (const BtWirePattern * const self
,const gulong tick
,const gulong param
,const gchar * const value
); gchar * bt_wire_pattern_get_event (const BtWirePattern * const self
,const gulong tick
,const gulong param
); gboolean bt_wire_pattern_test_event (const BtWirePattern * const self
,const gulong tick
,const gulong param
); gboolean bt_wire_pattern_tick_has_data (const BtWirePattern * const self
,const gulong tick
); void bt_wire_pattern_insert_row (const BtWirePattern * const self
,const gulong tick
,const gulong param
); void bt_wire_pattern_insert_full_row (const BtWirePattern * const self
,const gulong tick
); void bt_wire_pattern_delete_row (const BtWirePattern * const self
,const gulong tick
,const gulong param
); void bt_wire_pattern_delete_full_row (const BtWirePattern * const self
,const gulong tick
); void bt_wire_pattern_delete_column (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,const gulong param
); void bt_wire_pattern_delete_columns (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
); void bt_wire_pattern_blend_column (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,const gulong param
); void bt_wire_pattern_blend_columns (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
); void bt_wire_pattern_randomize_column (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,const gulong param
); void bt_wire_pattern_randomize_columns (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
); gboolean bt_wire_pattern_deserialize_column (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,const gulong param
,const gchar *data
); void bt_wire_pattern_serialize_column (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,const gulong param
,GString *data
); void bt_wire_pattern_serialize_columns (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,GString *data
);
A pattern contains a grid of events. Events are parameter changes in BtMachine objects. The events are stored aas GValues.
The patterns are used in the BtSequence to form the score of a song.
typedef struct _BtWirePattern BtWirePattern;
Class that holds a sequence of automation events for a BtWire.
BtWirePattern * bt_wire_pattern_new (const BtSong * const song
,const BtWire * const wire
,const BtPattern * const pattern
);
Create a new instance.
|
the song the new instance belongs to |
|
the wire the pattern belongs to |
|
the pattern that gets extended |
Returns : |
the new instance or NULL in case of an error
|
BtWirePattern * bt_wire_pattern_copy (const BtWirePattern * const self
,const BtPattern * const pattern
);
Create a new instance as a copy of the given instance. This is usualy done in
sync with bt_pattern_copy()
.
|
the wire pattern to create a copy from |
|
the new pattern for the copy |
Returns : |
the new instance or NULL in case of an error
|
GValue * bt_wire_pattern_get_event_data (const BtWirePattern * const self
,const gulong tick
,const gulong param
);
Fetches a cell from the given location in the pattern. If there is no event
there, then the GValue
is uninitialized. Test with G_IS_VALUE(event).
|
the pattern to search for the param |
|
the tick (time) position starting with 0 |
|
the number of the parameter starting with 0 |
Returns : |
the GValue or NULL if out of the pattern range
|
gboolean bt_wire_pattern_set_event (const BtWirePattern * const self
,const gulong tick
,const gulong param
,const gchar * const value
);
Stores the supplied value into the specified pattern cell.
|
the pattern the cell belongs to |
|
the tick (time) position starting with 0 |
|
the number of the parameter starting with 0 |
|
the string representation of the value to store |
Returns : |
TRUE for success
|
gchar * bt_wire_pattern_get_event (const BtWirePattern * const self
,const gulong tick
,const gulong param
);
Returns the string representation of the specified cell. Free it when done.
|
the pattern the cell belongs to |
|
the tick (time) position starting with 0 |
|
the number of the parameter starting with 0 |
Returns : |
a newly allocated string with the data or NULL on error
|
gboolean bt_wire_pattern_test_event (const BtWirePattern * const self
,const gulong tick
,const gulong param
);
Tests if there is an event in the specified cell.
|
the pattern the cell belongs to |
|
the tick (time) position starting with 0 |
|
the number of the parameter starting with 0 |
Returns : |
TRUE if there is an event
|
gboolean bt_wire_pattern_tick_has_data (const BtWirePattern * const self
,const gulong tick
);
Check if there are any event in the given pattern-row.
|
the pattern to check |
|
the tick index in the pattern |
Returns : |
TRUE is there are events, FALSE otherwise
|
void bt_wire_pattern_insert_row (const BtWirePattern * const self
,const gulong tick
,const gulong param
);
Insert one empty row for given param
.
|
the pattern |
|
the postion to insert at |
|
the parameter |
Since 0.3
void bt_wire_pattern_insert_full_row (const BtWirePattern * const self
,const gulong tick
);
Insert one empty row for all parameters.
|
the pattern |
|
the postion to insert at |
Since 0.3
void bt_wire_pattern_delete_row (const BtWirePattern * const self
,const gulong tick
,const gulong param
);
Delete row for given param
.
|
the pattern |
|
the postion to delete |
|
the parameter |
Since 0.3
void bt_wire_pattern_delete_full_row (const BtWirePattern * const self
,const gulong tick
);
Delete row for all parameters.
|
the pattern |
|
the postion to delete |
Since 0.3
void bt_wire_pattern_delete_column (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,const gulong param
);
Randomize values from start_tick
to end_tick
for param
.
|
the pattern |
|
the start postion for the range |
|
the end postion for the range |
|
the parameter |
Since 0.6
void bt_wire_pattern_delete_columns (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
);
Clear values from start_tick
to end_tick
for all params.
|
the pattern |
|
the start postion for the range |
|
the end postion for the range |
Since 0.6
void bt_wire_pattern_blend_column (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,const gulong param
);
Fade values from start_tick
to end_tick
for param
.
|
the pattern |
|
the start postion for the range |
|
the end postion for the range |
|
the parameter |
Since 0.3
void bt_wire_pattern_blend_columns (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
);
Fade values from start_tick
to end_tick
for all params.
|
the pattern |
|
the start postion for the range |
|
the end postion for the range |
Since 0.3
void bt_wire_pattern_randomize_column (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,const gulong param
);
Randomize values from start_tick
to end_tick
for param
.
|
the pattern |
|
the start postion for the range |
|
the end postion for the range |
|
the parameter |
Since 0.3
void bt_wire_pattern_randomize_columns (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
);
Randomize values from start_tick
to end_tick
for all params.
|
the pattern |
|
the start postion for the range |
|
the end postion for the range |
Since 0.3
gboolean bt_wire_pattern_deserialize_column (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,const gulong param
,const gchar *data
);
Deserializes values to start_tick
to end_tick
for param
from data
.
|
the pattern |
|
the start postion for the range |
|
the end postion for the range |
|
the parameter |
|
the source data |
Returns : |
TRUE for success, FALSE e.g. to indicate incompative GType values
for the column specified by param and the data .
|
Since 0.6
void bt_wire_pattern_serialize_column (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,const gulong param
,GString *data
);
Serializes values from start_tick
to end_tick
for param
into data
.
|
the pattern |
|
the start postion for the range |
|
the end postion for the range |
|
the parameter |
|
the target |
Since 0.6
void bt_wire_pattern_serialize_columns (const BtWirePattern * const self
,const gulong start_tick
,const gulong end_tick
,GString *data
);
Serializes values from start_tick
to end_tick
for all params into data
.
|
the pattern |
|
the start postion for the range |
|
the end postion for the range |
|
the target |
Since 0.6