Blame ld10k1/include/liblo10k1lf.h

Packit 427e91
/*
Packit 427e91
 *  EMU10k1 loader lib
Packit 427e91
 *  Copyright (c) 2003,2004 by Peter Zubaj
Packit 427e91
 *
Packit 427e91
 *
Packit 427e91
 *   This library is free software; you can redistribute it and/or modify
Packit 427e91
 *   it under the terms of the GNU Lesser General Public License as
Packit 427e91
 *   published by the Free Software Foundation; either version 2.1 of
Packit 427e91
 *   the License, or (at your option) any later version.
Packit 427e91
 *
Packit 427e91
 *   This program is distributed in the hope that it will be useful,
Packit 427e91
 *   but WITHOUT ANY WARRANTY; without even the implied warranty of
Packit 427e91
 *   MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
Packit 427e91
 *   GNU Lesser General Public License for more details.
Packit 427e91
 *
Packit 427e91
 *   You should have received a copy of the GNU Lesser General Public
Packit 427e91
 *   License along with this library; if not, write to the Free Software
Packit 427e91
 *   Foundation, Inc., 51 Franklin Street, Fifth Floor, Boston, MA  02110-1301  USA
Packit 427e91
 *
Packit 427e91
 */
Packit 427e91
 
Packit 427e91
#ifndef __LIBLO10K1LF_H
Packit 427e91
#define __LIBLO10K1LF_H
Packit 427e91
Packit 427e91
#ifdef __cplusplus
Packit 427e91
extern "C" {
Packit 427e91
#endif
Packit 427e91
Packit 427e91
/* description of structures used in native ld10k1 files */
Packit 427e91
Packit 427e91
typedef struct {
Packit 427e91
	/* asciz string with signature - have to be 
Packit 427e91
	"LD10K1 NATIVE EFFECT FILE      "
Packit 427e91
	 01234567890123456789012345678901 */
Packit 427e91
	char signature[32];
Packit 427e91
	/* don't use this */
Packit 427e91
	char reserved[32];
Packit 427e91
} liblo10k1_file_header_t;
Packit 427e91
Packit 427e91
/* don't use this */
Packit 427e91
#define LD10K1_FP_TYPE_RESERVED 0
Packit 427e91
/* normal part type, part_length is valid */
Packit 427e91
#define LD10K1_FP_TYPE_NORMAL 1
Packit 427e91
/* part start type, part_length have to be 0 */
Packit 427e91
#define LD10K1_FP_TYPE_START 2
Packit 427e91
/* part end type, part_length have to be 0 */
Packit 427e91
#define LD10K1_FP_TYPE_END 3
Packit 427e91
Packit 427e91
/* parts can be nested */
Packit 427e91
typedef struct {
Packit 427e91
	/* don't use this */
Packit 427e91
	unsigned int reserved : 2,
Packit 427e91
	/* part type definition
Packit 427e91
		- normal
Packit 427e91
		- part content start
Packit 427e91
		- part content end */
Packit 427e91
		part_type : 6,
Packit 427e91
		part_id : 24;
Packit 427e91
	/* part data length */
Packit 427e91
	unsigned int part_length;
Packit 427e91
} liblo10k1_file_part_t;
Packit 427e91
Packit 427e91
#define LD10K1_FP_INFO 0
Packit 427e91
#define LD10K1_FP_DSP_SETUP 1
Packit 427e91
#define LD10K1_FP_FX 2
Packit 427e91
#define LD10K1_FP_FX_LIST 3
Packit 427e91
#define LD10K1_FP_IN 4
Packit 427e91
#define LD10K1_FP_IN_LIST 5
Packit 427e91
#define LD10K1_FP_OUT 6
Packit 427e91
#define LD10K1_FP_OUT_LIST 7
Packit 427e91
#define LD10K1_FP_PATCH 8
Packit 427e91
#define LD10K1_FP_PATCH_LIST 9
Packit 427e91
#define LD10K1_FP_PATCH_INFO 10
Packit 427e91
#define LD10K1_FP_PIO 11
Packit 427e91
#define LD10K1_FP_PIN_LIST 12
Packit 427e91
#define LD10K1_FP_POUT_LIST 13
Packit 427e91
#define LD10K1_FP_CS 14
Packit 427e91
#define LD10K1_FP_CONST_LIST 15
Packit 427e91
#define LD10K1_FP_STA_LIST 16
Packit 427e91
#define LD10K1_FP_DYN_LIST 17
Packit 427e91
#define LD10K1_FP_HW 18
Packit 427e91
#define LD10K1_FP_HW_LIST 19
Packit 427e91
#define LD10K1_FP_TRAM 20
Packit 427e91
#define LD10K1_FP_TRAM_LIST 21
Packit 427e91
#define LD10K1_FP_TRAM_ACC 22
Packit 427e91
#define LD10K1_FP_TRAM_ACC_LIST 23
Packit 427e91
#define LD10K1_FP_CTL 24
Packit 427e91
#define LD10K1_FP_CTL_LIST 25
Packit 427e91
#define LD10K1_FP_INSTR 26
Packit 427e91
#define LD10K1_FP_INSTR_LIST 27
Packit 427e91
#define LD10K1_FP_POINT 28
Packit 427e91
#define LD10K1_FP_POINT_LIST 29
Packit 427e91
Packit 427e91
#define LD10K1_FP_FILE_INFO_NAME 30
Packit 427e91
#define LD10K1_FP_FILE_INFO_DESC 31
Packit 427e91
#define LD10K1_FP_FILE_INFO_CREATER 32
Packit 427e91
#define LD10K1_FP_FILE_INFO_AUTHOR 33
Packit 427e91
#define LD10K1_FP_FILE_INFO_COPYRIGHT 34
Packit 427e91
#define LD10K1_FP_FILE_INFO_LICENCE 35
Packit 427e91
Packit 427e91
/* file contains whole dsp config */
Packit 427e91
#define LD10K1_FP_INFO_FILE_TYPE_DSP_SETUP 0
Packit 427e91
/* file contains only 1 patch */
Packit 427e91
#define LD10K1_FP_INFO_FILE_TYPE_PATCH 1
Packit 427e91
Packit 427e91
Packit 427e91
typedef struct {
Packit 427e91
	unsigned int file_type;
Packit 427e91
	/* file version 
Packit 427e91
	   application can ignore this version and read file, 
Packit 427e91
	   but must be prepared to ignore unknown parts */
Packit 427e91
	unsigned int file_version_major : 8,
Packit 427e91
		file_version_minor : 8,
Packit 427e91
		file_version_subminor : 8,
Packit 427e91
		file_version_pad : 8;
Packit 427e91
	/* minimal version of lo10k1/ld10k1 which will load file
Packit 427e91
	   application must be prepared to ignore unknown parts */
Packit 427e91
	unsigned int minimal_reader_version_major : 8,
Packit 427e91
		minimal_reader_version_minor : 8,
Packit 427e91
		minimal_reader_version_subminor : 8,
Packit 427e91
		minimal_reader_version_pad : 8;
Packit 427e91
	/* version of lo10k1/ld10k1 which which created file */
Packit 427e91
	unsigned int creater_version_major : 8,
Packit 427e91
		creater_version_minor : 8,
Packit 427e91
		creater_version_subminor : 8,
Packit 427e91
		creater_version_pad : 8;
Packit 427e91
} liblo10k1_file_part_info_t;
Packit 427e91
Packit 427e91
#define LD10K1_FP_INFO_DSP_TYPE_EMU10K1 0
Packit 427e91
#define LD10K1_FP_INFO_DSP_TYPE_EMU10K2 1
Packit 427e91
typedef struct {
Packit 427e91
	unsigned int dsp_type;
Packit 427e91
	/* tram size to setup */
Packit 427e91
	/* unsigned int externa_tram_size; */
Packit 427e91
	/* used to restore io names */
Packit 427e91
	unsigned int fx_count;
Packit 427e91
	unsigned int in_count;
Packit 427e91
	unsigned int out_count;
Packit 427e91
	/* patch count contained in this file */
Packit 427e91
	unsigned int patch_count;
Packit 427e91
	/* point count contained in this file */
Packit 427e91
	unsigned int point_count;
Packit 427e91
} liblo10k1_file_part_dsp_setup_t;
Packit 427e91
Packit 427e91
Packit 427e91
/* structure used to store and restore config */
Packit 427e91
typedef struct {
Packit 427e91
	unsigned int dsp_type;
Packit 427e91
	/* used to restore io names */
Packit 427e91
	unsigned int fx_count;
Packit 427e91
	liblo10k1_get_io_t *fxs;
Packit 427e91
	unsigned int in_count;
Packit 427e91
	liblo10k1_get_io_t *ins;
Packit 427e91
	unsigned int out_count;
Packit 427e91
	liblo10k1_get_io_t *outs;
Packit 427e91
	/* patch count contained in this file */
Packit 427e91
	unsigned int patch_count;
Packit 427e91
	liblo10k1_dsp_patch_t **patches;
Packit 427e91
	/* point count contained in this file */
Packit 427e91
	unsigned int point_count;
Packit 427e91
	liblo10k1_point_info_t *points;
Packit 427e91
} liblo10k1_file_dsp_setup_t;
Packit 427e91
Packit 427e91
typedef struct {
Packit 427e91
	char patch_name[MAX_NAME_LEN];
Packit 427e91
	unsigned int in_count;
Packit 427e91
	unsigned int out_count;
Packit 427e91
	unsigned int const_count;
Packit 427e91
	unsigned int sta_count;
Packit 427e91
	unsigned int dyn_count;
Packit 427e91
	unsigned int hw_count;
Packit 427e91
	unsigned int tram_count;
Packit 427e91
	unsigned int tram_acc_count;
Packit 427e91
	unsigned int ctl_count;
Packit 427e91
	unsigned int instr_count;
Packit 427e91
} liblo10k1_file_patch_info_t;
Packit 427e91
Packit 427e91
int liblo10k1lf_get_dsp_config(liblo10k1_connection_t *conn, liblo10k1_file_dsp_setup_t **setup);
Packit 427e91
int liblo10k1lf_put_dsp_config(liblo10k1_connection_t *conn, liblo10k1_file_dsp_setup_t *setup);
Packit 427e91
Packit 427e91
liblo10k1_file_dsp_setup_t *liblo10k1lf_dsp_config_alloc();
Packit 427e91
void liblo10k1lf_dsp_config_free(liblo10k1_file_dsp_setup_t *c);
Packit 427e91
Packit 427e91
typedef struct {
Packit 427e91
	/* file name */
Packit 427e91
	char *name;
Packit 427e91
	/* file description */
Packit 427e91
	char *desc;
Packit 427e91
	/* description of creater application - can be anything */
Packit 427e91
	char *creater;
Packit 427e91
	/* author */
Packit 427e91
	char *author;
Packit 427e91
	/* copyright string */
Packit 427e91
	char *copyright;
Packit 427e91
	/* licence use for this file */
Packit 427e91
	char *license;
Packit 427e91
} liblo10k1_file_info_t;
Packit 427e91
Packit 427e91
liblo10k1_file_info_t *liblo10k1lf_file_info_alloc();
Packit 427e91
void liblo10k1lf_file_info_free(liblo10k1_file_info_t *fi);
Packit 427e91
Packit 427e91
int liblo10k1lf_save_dsp_config(liblo10k1_file_dsp_setup_t *c, char *file_name, liblo10k1_file_info_t *fi);
Packit 427e91
int liblo10k1lf_load_dsp_config(liblo10k1_file_dsp_setup_t **c, char *file_name, liblo10k1_file_info_t **fi);
Packit 427e91
Packit 427e91
int liblo10k1lf_save_dsp_patch(liblo10k1_dsp_patch_t *p, char *file_name, liblo10k1_file_info_t *fi);
Packit 427e91
int liblo10k1lf_load_dsp_patch(liblo10k1_dsp_patch_t **p, char *file_name, liblo10k1_file_info_t **fi);
Packit 427e91
Packit 427e91
#define LD10K1_LF_ERR_OPEN -2000
Packit 427e91
#define LD10K1_LF_ERR_WRITE -2001
Packit 427e91
#define LD10K1_LF_ERR_READ -2002
Packit 427e91
#define LD10K1_LF_ERR_SIGNATURE -2003
Packit 427e91
#define LD10K1_LF_ERR_PART_TYPE -2004
Packit 427e91
#define LD10K1_LF_ERR_PART_SIZE -2005
Packit 427e91
#define LD10K1_LF_ERR_VERSION -2006
Packit 427e91
#define LD10K1_LF_ERR_FILE_TYPE -2007
Packit 427e91
Packit 427e91
#ifdef __cplusplus
Packit 427e91
}
Packit 427e91
#endif
Packit 427e91
Packit 427e91
#endif /* __LIBLO10K1LF_H */