musix 0.3.5

Music player library for esoteric audio formats (music from C64,Amiga etc)
Documentation 
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94

/**
 * @ingroup   io68_ym_devel
 * @file      io68/ym_io.h
 * @author    Benjamin Gerard
 * @date      1999/03/20
 * @brief     YM-2149 emulator plugin header.
 *
 */

/* $Id: ym_io.h 141 2011-08-07 23:30:20Z benjihan $ */

/* Copyright (C) 1998-2009 Benjamin Gerard */

#ifndef _IO68_YM_IO_H_
#define _IO68_YM_IO_H_

#include "io68_api.h"
#include "emu68/struct68.h"
#include "ymemul.h"

/** @addtogroup  io68_ym_devel
 *  @{
 */

/** @name Yamaha-2149 IO plugin
 *  @{
 */

IO68_EXTERN
/** Initialize YM-2149 library. */
int ymio_init(int * argc, char ** argv);

IO68_EXTERN
/** Shutdown YM-2149 library. */
void ymio_shutdown(void);

IO68_EXTERN
/** Create Yamaha-2149 IO plugin instance.
 *
 *   @param  emu68  68K emulator instance
 *   @param  parms  YM-2149 creation parameters
 *
 *   @return created io instance
 *   @retval 0  Failure
 */
io68_t * ymio_create(emu68_t * const emu68, ym_parms_t * const parms);

IO68_EXTERN
/** Get/Set sampling rate.
 *
 * @param  io  YM IO instance
 * @param  hz  0:read current sampling rate, >0:new requested sampling rate
 *
 * @return actual sampling rate
 *
 */
int ymio_sampling_rate(io68_t * const io, int sampling_rate);

IO68_EXTERN
/** Get ym-2149 emulator instance. */
ym_t * ymio_emulator(io68_t * const io);

IO68_EXTERN
/** Run ym emulator.
 *  @see ym_run()
 */
int ymio_run(const io68_t * const io, s32 * output, const cycle68_t cycles);

IO68_EXTERN
/** Get required sample buffer size.
 *  @see ym_buffersize()
 */
uint68_t ymio_buffersize(const io68_t * const io, const cycle68_t cycles);

IO68_EXTERN
/** Convert a cpu-cycle to ym-cycle. */
cycle68_t ymio_cycle_cpu2ym(const io68_t * const io, const cycle68_t cycles);

IO68_EXTERN
/** Convert a ym-cycle to cpu-cycle. */
cycle68_t ymio_cycle_ym2cpu(const io68_t * const io, const cycle68_t cycles);

IO68_EXTERN
/** Convert a ym-cycle to cpu-cycle. */
int ymio_active_channels(const io68_t * const io, const int clr, const int set);


/** @} */

/**
 *  @}
 */

#endif /* #ifndef _IO68_YM_IO_H_ */