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

/**
 * @ingroup   io68_lib
 * @file      io68/shifter_io.h
 * @author    Benjamin Gerard
 * @date      1999/06/10
 * @brief     shifter IO plugin header.
 *
 */

/* $Id: shifter_io.h 126 2009-07-15 08:58:51Z benjihan $ */

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

#ifndef _IO68_SHIFTER_IO_H_
#define _IO68_SHIFTER_IO_H_

#include "io68_api.h"

/** @defgroup  io68_lib_shifter  Atari-ST shifter (video chip)
 *  @ingroup   io68_lib
 *
 *    Atari-ST shifter emulator is limited to 50/60Hz detection.
 *    It is used by some player to adapt the replay speed.
 *    By default this shifter always claims to be in 50hz.
 *
 *
 *    Video address (Low byte always 0 on STF)
 *
 *    - 8201 : Hi  byte of video address
 *    - 8203 : Mid byte of video address
 *
 *    Video counter (read only)
 *
 *    - 8205 : Hi  byte of video counter
 *    - 8207 : Mid byte of video counter
 *    - 8209 : Low byte of video counter
 *
 *    Syncro mode
 *
 *    - 820A :
 *      - bit-0  0:interne(*) 1:externe
 *      - bit-1  0:60hz 1:50hz
 *
 *    Color table (16 word entries)
 *
 *    - 8240-825E :
 *      - STF 3 bit per componant 0x777
 *      - STE 4 bit per componant 0xFFF but msb is lsb
 *             (for backward compatibility)
 *
 *    Resolution
 *
 *    - 8260 (bit-1 bit-0)
 *      -  0 0 : 320x200x16
 *      -  0 1 : 640x200x2
 *      -  1 0 : 640x400x1 (70hz)
 *      -  1 1 : reserved
 *  @{
 */

IO68_EXTERN
/** Init shifter io library.
 *  @return error-code
 */
int shifterio_init(int * argc, char ** argv);

IO68_EXTERN
/** Shutdown shifter io library.
 */
void shifterio_shutdown(void);

IO68_EXTERN
/** Create shifter io instance.
 *
 *   @param   emu68  68000 emulator instance
 *   @param   hz     Initial frequency (50,60 or 70), default 50
 *
 *   @return  Created shifter instance
 *   @retval  0
 */
io68_t * shifterio_create(emu68_t * const emu68, int hz);

IO68_EXTERN
/** Reset shifter and set new vertical refresh rate. */
int shifterio_reset(io68_t * const io, int hz);

/** @} */

/**
 *  @}
 */

#endif /* #ifndef _IO68_SHIFTER_IO_H_ */