Top | ![]() |
![]() |
![]() |
![]() |
IpatchDLS2Region * | ipatch_dls2_region_new () |
IpatchDLS2Region * | ipatch_dls2_region_first () |
IpatchDLS2Region * | ipatch_dls2_region_next () |
char * | ipatch_dls2_region_get_info () |
void | ipatch_dls2_region_set_info () |
void | ipatch_dls2_region_set_sample () |
IpatchDLS2Sample * | ipatch_dls2_region_get_sample () |
IpatchDLS2Sample * | ipatch_dls2_region_peek_sample () |
void | ipatch_dls2_region_set_note_range () |
void | ipatch_dls2_region_set_velocity_range () |
gboolean | ipatch_dls2_region_in_range () |
void | ipatch_dls2_region_set_param () |
void | ipatch_dls2_region_set_param_array () |
GSList * | ipatch_dls2_region_get_conns () |
void | ipatch_dls2_region_set_conn () |
void | ipatch_dls2_region_unset_conn () |
void | ipatch_dls2_region_unset_all_conns () |
guint | ipatch_dls2_region_conn_count () |
int | ipatch_dls2_region_channel_map_stereo () |
char * | archive-location | Read / Write |
char * | artist | Read / Write |
int | channel | Read / Write |
char * | comment | Read / Write |
char * | commissioned | Read / Write |
char * | copyright | Read / Write |
char * | date | Read / Write |
char * | engineer | Read / Write |
int | fine-tune | Read / Write |
IpatchDLS2SampleFlags | flags | Read / Write |
int | gain | Read / Write |
char * | genre | Read / Write |
int | key-group | Read / Write |
char * | keywords | Read / Write |
int | layer-group | Read / Write |
IpatchDLS2Sample * | link-item | Read / Write |
guint | loop-end | Read / Write |
guint | loop-start | Read / Write |
IpatchSampleLoopType | loop-type | Read / Write |
char * | medium | Read / Write |
gboolean | multi-channel | Read / Write |
char * | name | Read / Write |
IpatchRange * | note-range | Read / Write |
int | phase-group | Read / Write |
gboolean | phase-master | Read / Write |
char * | product | Read / Write |
int | root-note | Read / Write |
gboolean | sample-info-override | Read / Write |
gboolean | self-non-exclusive | Read / Write |
char * | software | Read / Write |
char * | source | Read / Write |
char * | source-form | Read / Write |
char * | subject | Read / Write |
char * | technician | Read / Write |
IpatchRange * | velocity-range | Read / Write |
enum | IpatchDLS2Param |
struct | IpatchDLS2ParamArray |
enum | IpatchDLS2RegionChannelType |
#define | IPATCH_DLS2_REGION_CHANNEL_MONO |
enum | IpatchDLS2RegionFlags |
#define | IPATCH_DLS2_REGION_FLAG_MASK |
#define | IPATCH_DLS2_REGION_UNUSED_FLAG_SHIFT |
DLS regions are child items of IpatchDLSInst objects and define how an individual audio sample is synthesized in an instrument.
IpatchDLS2Region *
ipatch_dls2_region_new (void
);
Create a new DLS region object.
IpatchDLS2Region *
ipatch_dls2_region_first (IpatchIter *iter
);
Gets the first item in a region iterator. A convenience
wrapper for ipatch_iter_first()
.
[skip]
IpatchDLS2Region *
ipatch_dls2_region_next (IpatchIter *iter
);
Gets the next item in a region iterator. A convenience wrapper
for ipatch_iter_next()
.
[skip]
char * ipatch_dls2_region_get_info (IpatchDLS2Region *region
,guint32 fourcc
);
Get a DLS region info string by FOURCC integer ID (integer representation of a 4 character RIFF chunk ID, see IpatchRiff).
void ipatch_dls2_region_set_info (IpatchDLS2Region *region
,guint32 fourcc
,const char *val
);
Sets an INFO value in a DLS region object. Emits changed signal.
void ipatch_dls2_region_set_sample (IpatchDLS2Region *region
,IpatchDLS2Sample *sample
);
Sets the referenced sample of a region.
IpatchDLS2Sample *
ipatch_dls2_region_get_sample (IpatchDLS2Region *region
);
Gets the referenced sample from a region. The returned item's
reference count is incremented and the caller is responsible for
unrefing it with g_object_unref()
.
IpatchDLS2Sample *
ipatch_dls2_region_peek_sample (IpatchDLS2Region *region
);
Like ipatch_dls2_region_get_sample()
but does not add a reference to
the returned item. This function should only be used if a reference
of the returned item is ensured or only the pointer value is of
interest.
[skip]
void ipatch_dls2_region_set_note_range (IpatchDLS2Region *region
,int low
,int high
);
Set the MIDI note range that a region is active on.
void ipatch_dls2_region_set_velocity_range (IpatchDLS2Region *region
,int low
,int high
);
Set the MIDI velocity range that a region is active on.
gboolean ipatch_dls2_region_in_range (IpatchDLS2Region *region
,int note
,int velocity
);
Check if a note and velocity falls in a region's ranges
void ipatch_dls2_region_set_param (IpatchDLS2Region *region
,IpatchDLS2Param param
,gint32 val
);
Sets an effect parameter of a DLS2 Region. DLS2 defines a standard set of connections (effect parameters). Any non-standard connections can be manipulated with the connection related functions.
void ipatch_dls2_region_set_param_array (IpatchDLS2Region *region
,IpatchDLS2ParamArray *array
);
Sets all effect parameters of a DLS2 Region.
GSList *
ipatch_dls2_region_get_conns (IpatchDLS2Region *region
);
Gets a list of connections from a DLS region. List should be freed with
ipatch_dls2_conn_list_free()
(free_conns set to TRUE
) when finished
with it.
New list of connections
(IpatchDLS2Conn) in region
or NULL
if no connections. Remember to free
it when finished.
[element-type IpatchDLS2Conn][transfer full]
void ipatch_dls2_region_set_conn (IpatchDLS2Region *region
,const IpatchDLS2Conn *conn
);
Set a DLS connection in a region. See ipatch_dls2_conn_list_set()
for
more details.
void ipatch_dls2_region_unset_conn (IpatchDLS2Region *region
,const IpatchDLS2Conn *conn
);
Remove a DLS connection from a region. See ipatch_dls2_conn_list_unset()
for more details.
void
ipatch_dls2_region_unset_all_conns (IpatchDLS2Region *region
);
Remove all connections in a region.
guint
ipatch_dls2_region_conn_count (IpatchDLS2Region *region
);
Count number of connections in a region
int
ipatch_dls2_region_channel_map_stereo (IpatchDLS2RegionChannelType chan
);
Map a DLS2 channel steering enumeration (surround sound capable) to stereo steering.
struct IpatchDLS2ParamArray { gint32 values[IPATCH_DLS2_PARAM_COUNT]; };
#define IPATCH_DLS2_REGION_CHANNEL_MONO IPATCH_DLS2_REGION_CHANNEL_LEFT
#define IPATCH_DLS2_REGION_FLAG_MASK (0x0F << IPATCH_ITEM_UNUSED_FLAG_SHIFT)
“archive-location”
property “archive-location” char *
Location where subject is archived.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“artist”
property “artist” char *
Original artist.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“channel”
property “channel” int
DLS audio channel identifier.
Owner: IpatchDLS2Region
Flags: Read / Write
Allowed values: [0,262143]
Default value: 0
“comment”
property “comment” char *
Comments.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“commissioned”
property “commissioned” char *
Who commissioned the material.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“copyright”
property “copyright” char *
Copyright.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“date”
property “date” char *
Creation date (YYYY-MM-DD).
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“engineer”
property “engineer” char *
Engineers separated by "; ".
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“fine-tune”
property “fine-tune” int
Fine tuning in cents.
Owner: IpatchDLS2Region
Flags: Read / Write
Allowed values: [-99,99]
Default value: 0
“flags”
property“flags” IpatchDLS2SampleFlags
Sample flags.
Owner: IpatchDLS2Region
Flags: Read / Write
“gain”
property “gain” int
Gain in DLS relative gain units.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: 0
“genre”
property “genre” char *
Genre.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“key-group”
property “key-group” int
Percussion key group.
Owner: IpatchDLS2Region
Flags: Read / Write
Allowed values: [0,15]
Default value: 0
“keywords”
property “keywords” char *
Keywords (separated by "; ").
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“layer-group”
property “layer-group” int
Layer group.
Owner: IpatchDLS2Region
Flags: Read / Write
Allowed values: [0,65535]
Default value: 0
“link-item”
property“link-item” IpatchDLS2Sample *
Link item.
Owner: IpatchDLS2Region
Flags: Read / Write
“loop-end”
property “loop-end” guint
Loop end in frames (after loop).
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: 0
“loop-start”
property “loop-start” guint
Start of loop in frames.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: 0
“loop-type”
property“loop-type” IpatchSampleLoopType
Loop method type.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: IPATCH_SAMPLE_LOOP_NONE
“medium”
property “medium” char *
Original medium of the material (record, CD, etc).
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“multi-channel”
property “multi-channel” gboolean
Multi channel.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: FALSE
“name”
property “name” char *
Name.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: "untitled"
“note-range”
property“note-range” IpatchRange *
MIDI note range.
Owner: IpatchDLS2Region
Flags: Read / Write
“phase-group”
property “phase-group” int
Phase locked sample group.
Owner: IpatchDLS2Region
Flags: Read / Write
Allowed values: [0,65535]
Default value: 0
“phase-master”
property “phase-master” gboolean
Multi channel phase lock master.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: FALSE
“product”
property “product” char *
Product intended for.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“root-note”
property “root-note” int
Root MIDI note.
Owner: IpatchDLS2Region
Flags: Read / Write
Allowed values: [0,127]
Default value: 60
“sample-info-override”
property “sample-info-override” gboolean
Override sample info.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: FALSE
“self-non-exclusive”
property “self-non-exclusive” gboolean
Self non exclusive.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: FALSE
“software”
property “software” char *
Editor software used.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“source”
property “source” char *
Source of the original material.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“source-form”
property “source-form” char *
Original source that was digitized.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“subject”
property “subject” char *
Subject of the material.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“technician”
property “technician” char *
Technician who sampled the material.
Owner: IpatchDLS2Region
Flags: Read / Write
Default value: NULL
“velocity-range”
property“velocity-range” IpatchRange *
MIDI velocity range.
Owner: IpatchDLS2Region
Flags: Read / Write