libinstpatch-dev 1.0.0-7 / usr / include / libinstpatch-1.0 / libinstpatch / IpatchSF2.h

/*
 * libInstPatch
 * Copyright (C) 1999-2010 Joshua "Element" Green <jgreen@users.sourceforge.net>
 *
 * This program is free software; you can redistribute it and/or
 * modify it under the terms of the GNU Lesser General Public License
 * as published by the Free Software Foundation; version 2.1
 * of the License only.
 *
 * This library is distributed in the hope that it will be useful,
 * but WITHOUT ANY WARRANTY; without even the implied warranty of
 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 * GNU Lesser General Public License for more details.
 *
 * You should have received a copy of the GNU Lesser General Public License
 * along with this program; if not, write to the Free Software
 * Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA
 * 02110-1301, USA or on the web at http://www.gnu.org.
 */
/**
 * SECTION: IpatchSF2
 * @short_description: SoundFont instrument file object
 * @see_also: #IpatchSF2Preset, #IpatchSF2Inst, #IpatchSF2Sample
 * @stability: Stable
 *
 * SoundFont version 2 instrument file object.  Parent to #IpatchSF2Preset,
 * #IpatchSF2Inst and #IpatchSF2Sample objects.
 */
#ifndef __IPATCH_SF2_H__
#define __IPATCH_SF2_H__

#include <glib.h>
#include <glib-object.h>
#include <libinstpatch/IpatchBase.h>
#include <libinstpatch/IpatchSF2Preset.h>
#include <libinstpatch/IpatchSF2Inst.h>
#include <libinstpatch/IpatchSF2Sample.h>
#include <libinstpatch/IpatchSF2File.h>

/* forward type declarations */

typedef struct _IpatchSF2 IpatchSF2;
typedef struct _IpatchSF2Class IpatchSF2Class;

#define IPATCH_TYPE_SF2   (ipatch_sf2_get_type ())
#define IPATCH_SF2(obj) \
  (G_TYPE_CHECK_INSTANCE_CAST ((obj), IPATCH_TYPE_SF2, IpatchSF2))
#define IPATCH_SF2_CLASS(klass) \
  (G_TYPE_CHECK_CLASS_CAST ((klass), IPATCH_TYPE_SF2, IpatchSF2Class))
#define IPATCH_IS_SF2(obj) \
  (G_TYPE_CHECK_INSTANCE_TYPE ((obj), IPATCH_TYPE_SF2))
#define IPATCH_IS_SF2_CLASS(klass) \
  (G_TYPE_CHECK_CLASS_TYPE ((klass), IPATCH_TYPE_SF2))
#define IPATCH_SF2_GET_CLASS(obj) \
  (G_TYPE_INSTANCE_GET_CLASS ((obj), IPATCH_TYPE_SF2, IpatchSF2Class))

/* SoundFont object */
struct _IpatchSF2
{
  /*< public >*/
  IpatchBase parent_instance;

  guint16 ver_major, ver_minor;	/* SoundFont version */
  guint16 romver_major, romver_minor; /* ROM version (if any) */

  GHashTable *info;		/* hash of info strings by 4 char ID */
  GSList *presets;		/* list of #IpatchSF2Preset structures */
  GSList *insts;		/* list of #IpatchSF2Inst structures */
  GSList *samples;		/* list of #IpatchSF2Sample structures */
};

/* SoundFont class */
struct _IpatchSF2Class
{
  IpatchBaseClass parent_class;
};

typedef enum
{
  /* SoundFont 24 bit samples enabled flag */
  IPATCH_SF2_SAMPLES_24BIT = 1 << IPATCH_BASE_UNUSED_FLAG_SHIFT
} IpatchSF2Flags;

/* we reserve a couple flags for backwards compatible expansion */
#define IPATCH_SF2_UNUSED_FLAG_SHIFT (IPATCH_BASE_UNUSED_FLAG_SHIFT + 3)


/* SoundFont INFO enums (keep order synced with IpatchSF2.c) */
typedef enum
{
  IPATCH_SF2_UNKNOWN,		/* unknown chunk ("NULL" value) */
  IPATCH_SF2_VERSION = IPATCH_SFONT_FOURCC_IFIL, /* SoundFont version */
  IPATCH_SF2_ENGINE = IPATCH_SFONT_FOURCC_ISNG,/* target sound engine */
  IPATCH_SF2_NAME = IPATCH_SFONT_FOURCC_INAM, /* SoundFont name */
  IPATCH_SF2_ROM_NAME = IPATCH_SFONT_FOURCC_IROM, /* ROM name */
  IPATCH_SF2_ROM_VERSION = IPATCH_SFONT_FOURCC_IVER, /* ROM version */
  IPATCH_SF2_DATE = IPATCH_SFONT_FOURCC_ICRD, /* creation date */
  IPATCH_SF2_AUTHOR = IPATCH_SFONT_FOURCC_IENG,/* sound designers/engineers */
  IPATCH_SF2_PRODUCT = IPATCH_SFONT_FOURCC_IPRD, /* product intended for */
  IPATCH_SF2_COPYRIGHT = IPATCH_SFONT_FOURCC_ICOP, /* copyright message */
  IPATCH_SF2_COMMENT = IPATCH_SFONT_FOURCC_ICMT, /* comments */
  IPATCH_SF2_SOFTWARE = IPATCH_SFONT_FOURCC_ISFT /* software "create:modify" */
}IpatchSF2InfoType;

#define IPATCH_SF2_INFO_COUNT 11

#define IPATCH_SF2_DEFAULT_ENGINE "EMU8000"

/* structure used for ipatch_sf2_get_info_array */
typedef struct
{
  guint32 id;			/* FOURCC info id */
  char *val;			/* info string value */
} IpatchSF2Info;

GType ipatch_sf2_get_type (void);
IpatchSF2 *ipatch_sf2_new (void);

#define ipatch_sf2_get_presets(sfont) \
    ipatch_container_get_children (IPATCH_CONTAINER (sfont), \
				   IPATCH_TYPE_SF2_PRESET)
#define ipatch_sf2_get_insts(sfont) \
    ipatch_container_get_children (IPATCH_CONTAINER (sfont), \
				   IPATCH_TYPE_SF2_INST)
#define ipatch_sf2_get_samples(sfont) \
    ipatch_container_get_children (IPATCH_CONTAINER (sfont), \
				   IPATCH_TYPE_SF2_SAMPLE)

void ipatch_sf2_set_file (IpatchSF2 *sf, IpatchSF2File *file);
IpatchSF2File *ipatch_sf2_get_file (IpatchSF2 *sf);

char *ipatch_sf2_get_info (IpatchSF2 *sf, IpatchSF2InfoType id);
void ipatch_sf2_set_info (IpatchSF2 *sf, IpatchSF2InfoType id,
			  const char *val);
IpatchSF2Info *ipatch_sf2_get_info_array (IpatchSF2 *sf);
void ipatch_sf2_free_info_array (IpatchSF2Info *array);
gboolean ipatch_sf2_info_id_is_valid (guint32 id);
int ipatch_sf2_get_info_max_size (IpatchSF2InfoType infotype);

IpatchSF2Preset *ipatch_sf2_find_preset (IpatchSF2 *sf, const char *name,
					 int bank, int program,
					 const IpatchSF2Preset *exclude);
IpatchSF2Inst *ipatch_sf2_find_inst (IpatchSF2 *sf, const char *name,
				     const IpatchSF2Inst *exclude);
IpatchSF2Sample *ipatch_sf2_find_sample (IpatchSF2 *sf, const char *name,
					 const IpatchSF2Sample *exclude);
IpatchList *ipatch_sf2_get_zone_references (IpatchItem *item);

char *ipatch_sf2_make_unique_name (IpatchSF2 *sfont, GType child_type,
				   const char *name,
				   const IpatchItem *exclude);
#endif