IpatchDLS2

typedef struct {
  IpatchBase parent_instance;

  /* NOTE: This is not the DLS version! Optional descriptive stamp version */
  guint32 ms_version; /* most significant 32 bits of 64 bit version */
  guint32 ls_version; /* least significant 32 bits of 64 bit version */

  IpatchDLS2Info *info;		/* info strings */
  GSList *insts;		/* list of #IpatchDLS2Inst objects */
  GSList *samples;		/* list of #IpatchDLS2Sample objects */

  guint8 *dlid; /* 16 bytes or NULL - globally unique ID (indicates changes) */
} IpatchDLS2;

enum IpatchDLS2Flags

typedef enum
{
  /* set if the ms_version/ls_version values are valid */
  IPATCH_DLS2_VERSION_SET = 1 << IPATCH_BASE_UNUSED_FLAG_SHIFT
} IpatchDLS2Flags;

IPATCH_DLS2_UNUSED_FLAG_SHIFT

#define IPATCH_DLS2_UNUSED_FLAG_SHIFT (IPATCH_BASE_UNUSED_FLAG_SHIFT + 4)

ipatch_dls2_new ()

IpatchDLS2 *        ipatch_dls2_new                     (void);

Create a new DLS base object.

ipatch_dls2_get_insts()

#define             ipatch_dls2_get_insts(dls)

ipatch_dls2_get_samples()

#define             ipatch_dls2_get_samples(dls)

ipatch_dls2_set_file ()

void                ipatch_dls2_set_file                (IpatchDLS2 *dls,
                                                         IpatchDLSFile *file);

Sets the file object of a DLS object. DLS files are kept open for sample data that references the file. This function sets a DLS object's authoritive file. A convenience function, as ipatch_base_set_file() does the same thing (albeit without more specific type casting).

ipatch_dls2_get_file ()

IpatchDLSFile *     ipatch_dls2_get_file                (IpatchDLS2 *dls);

Gets the file object of a DLS. The returned DLS file object's reference count has been incremented. The caller owns the reference and is responsible for removing it with g_object_unref. A convenience function as ipatch_base_get_file() does the same thing (albeit without more specific type casting).

ipatch_dls2_get_info ()

char *              ipatch_dls2_get_info                (IpatchDLS2 *dls,
                                                         guint32 fourcc);

Get a DLS info string by FOURCC integer ID (integer representation of a 4 character RIFF chunk ID, see IpatchRiff).

ipatch_dls2_set_info ()

void                ipatch_dls2_set_info                (IpatchDLS2 *dls,
                                                         guint32 fourcc,
                                                         const char *val);

Sets an INFO value in a DLS object.

Emits changed signal on DLS object.

ipatch_dls2_make_unique_name ()

char *              ipatch_dls2_make_unique_name        (IpatchDLS2 *dls,
                                                         GType child_type,
                                                         const char *name,
                                                         const IpatchItem *exclude);

Generates a unique name for the given child_type in dls. The name parameter is used as a base and is modified, by appending a number, to make it unique (if necessary). The exclude parameter is used to exclude an existing dls child item from the search.

MT-Note: To ensure that an item is actually unique before being added to a DLS object, ipatch_container_add_unique() should be used.

ipatch_dls2_find_inst ()

IpatchDLS2Inst *    ipatch_dls2_find_inst               (IpatchDLS2 *dls,
                                                         const char *name,
                                                         int bank,
                                                         int program,
                                                         const IpatchDLS2Inst *exclude);

Find a instrument by name or bank:program MIDI numbers. If instrument name and bank:program are specified then match for either condition. If a instrument is found its reference count is incremented before it is returned. The caller is responsible for removing the reference with g_object_unref() when finished with it.

ipatch_dls2_find_sample ()

IpatchDLS2Sample *  ipatch_dls2_find_sample             (IpatchDLS2 *dls,
                                                         const char *name,
                                                         const IpatchDLS2Sample *exclude);

Find a sample by name in a SoundFont. If a sample is found its reference count is incremented before it is returned. The caller is responsible for removing the reference with g_object_unref() when finished with it.

ipatch_dls2_get_region_references ()

IpatchList *        ipatch_dls2_get_region_references   (IpatchDLS2Sample *sample);

Get list of regions referencing an IpatchDLS2Sample.

The "archive-location" property

  "archive-location"         gchar*                : Read / Write

Location where subject is archived.

Default value: NULL

The "artist" property

  "artist"                   gchar*                : Read / Write

Original artist.

Default value: NULL

The "comment" property

  "comment"                  gchar*                : Read / Write

Comments.

Default value: NULL

The "commissioned" property

  "commissioned"             gchar*                : Read / Write

Who commissioned the material.

Default value: NULL

The "copyright" property

  "copyright"                gchar*                : Read / Write

Copyright.

Default value: NULL

The "date" property

  "date"                     gchar*                : Read / Write

Creation date (YYYY-MM-DD).

Default value: NULL

The "engineer" property

  "engineer"                 gchar*                : Read / Write

Engineers separated by "; ".

Default value: NULL

The "genre" property

  "genre"                    gchar*                : Read / Write

Genre.

Default value: NULL

The "keywords" property

  "keywords"                 gchar*                : Read / Write

Keywords (separated by "; ").

Default value: NULL

The "medium" property

  "medium"                   gchar*                : Read / Write

Original medium of the material (record, CD, etc).

Default value: NULL

The "name" property

  "name"                     gchar*                : Read / Write

Name.

Default value: "untitled"

The "product" property

  "product"                  gchar*                : Read / Write

Product intended for.

Default value: NULL

The "software" property

  "software"                 gchar*                : Read / Write

Editor software used.

Default value: NULL

The "source" property

  "source"                   gchar*                : Read / Write

Source of the original material.

Default value: NULL

The "source-form" property

  "source-form"              gchar*                : Read / Write

Original source that was digitized.

Default value: NULL

The "subject" property

  "subject"                  gchar*                : Read / Write

Subject of the material.

Default value: NULL

The "technician" property

  "technician"               gchar*                : Read / Write

Technician who sampled the material.

Default value: NULL

The "version" property

  "version"                  gchar*                : Read / Write

File version "n.n.n.n".

Default value: NULL