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