| Top |
BtWirePatternBtWirePattern — class for an event pattern of a BtMachine instance |
| void | bt_wire_pattern_blend_column () |
| void | bt_wire_pattern_blend_columns () |
| BtWirePattern * | bt_wire_pattern_copy () |
| void | bt_wire_pattern_delete_column () |
| void | bt_wire_pattern_delete_columns () |
| void | bt_wire_pattern_delete_full_row () |
| void | bt_wire_pattern_delete_row () |
| gboolean | bt_wire_pattern_deserialize_column () |
| void | bt_wire_pattern_flip_column () |
| void | bt_wire_pattern_flip_columns () |
| gchar * | bt_wire_pattern_get_event () |
| GValue * | bt_wire_pattern_get_event_data () |
| void | bt_wire_pattern_insert_full_row () |
| void | bt_wire_pattern_insert_row () |
| BtWirePattern * | bt_wire_pattern_new () |
| void | bt_wire_pattern_randomize_column () |
| void | bt_wire_pattern_randomize_columns () |
| void | bt_wire_pattern_serialize_column () |
| void | bt_wire_pattern_serialize_columns () |
| gboolean | bt_wire_pattern_set_event () |
| gboolean | bt_wire_pattern_test_event () |
| gboolean | bt_wire_pattern_tick_has_data () |
A wire-pattern contains a grid of events. Events are parameter changes in
BtWire objects. The events are stored as GValues. Cells contaning NULL
have no event for the parameter at the time.
The wire-patterns are used in normal BtPattern objects as a group for each input of the BtMachine that is the owner of the pattern.
Wire-patterns synchronize their length to the length of the pattern they belong to.
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
.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
|
param |
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.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
Since 0.3
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().
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
.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
|
param |
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.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
Since 0.6
void bt_wire_pattern_delete_full_row (const BtWirePattern * const self,const gulong tick);
Delete row for all parameters.
Since 0.3
void bt_wire_pattern_delete_row (const BtWirePattern * const self,const gulong tick,const gulong param);
Delete row for given param
.
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
.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
|
param |
the parameter |
|
data |
the source data |
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_flip_column (const BtWirePattern * const self,const gulong start_tick,const gulong end_tick,const gulong param);
Flips values from start_tick
to end_tick
for param
up-side down.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
|
param |
the parameter |
Since 0.6
void bt_wire_pattern_flip_columns (const BtWirePattern * const self,const gulong start_tick,const gulong end_tick);
Flips values from start_tick
to end_tick
for all params up-side down.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
Since 0.6
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.
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 BT_IS_GVALUE(event).
void bt_wire_pattern_insert_full_row (const BtWirePattern * const self,const gulong tick);
Insert one empty row for all parameters.
Since 0.3
void bt_wire_pattern_insert_row (const BtWirePattern * const self,const gulong tick,const gulong param);
Insert one empty row for given param
.
Since 0.3
BtWirePattern * bt_wire_pattern_new (const BtSong * const song,const BtWire * const wire,const BtPattern * const pattern);
Create a new instance.
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
.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
|
param |
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.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
Since 0.3
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
.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
|
param |
the parameter |
|
data |
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
.
self |
the pattern |
|
start_tick |
the start postion for the range |
|
end_tick |
the end postion for the range |
|
data |
the target |
Since 0.6
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.
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.
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.
struct BtWirePattern;
Class that holds a sequence of automation events for a BtWire.
“pattern” property“pattern” BtPattern *
Pattern object, the wire-pattern belongs to.
Flags: Read / Write / Construct Only
“song” property“song” BtSong *
Song object, the pattern belongs to.
Flags: Read / Write / Construct Only
“wire” property“wire” BtWire *
Wire object, the wire-pattern belongs to.
Flags: Read / Write / Construct Only
“param-changed” signalvoid user_function (BtWirePattern *self, gulong tick, BtWire *wire, gulong param, gpointer user_data)
signals that a param of this wire-pattern has been changed
self |
the wire-pattern object that emitted the signal |
|
tick |
the tick position inside the pattern |
|
wire |
the wire for which it changed |
|
param |
the parameter index |
|
user_data |
user data set when the signal handler was connected. |
Flags: No Hooks
“pattern-changed” signalvoid user_function (BtWirePattern *self, gpointer user_data)
signals that this wire-pattern has been changed (more than in one place)
self |
the wire-pattern object that emitted the signal |
|
user_data |
user data set when the signal handler was connected. |
Flags: No Hooks