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
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
180
181
182
183
184
185
186
187
188
189
190
191
192
193
194
195
196
197
198
199
200
201
202
203
204
205
206
207
208
209
210
211
212
213
214
215
216
217
218
219
220
221
222
223
224
225
226
227
228
229
230
231
232
233
234
235
236
237
238
239
240
241
242
243
244
245
246
247
248
249
250
251
252
253
254
255
256
257
258
259
260
261
262
263
264
265
266
267
268
269
270
271
272
273
274
275
276
277
278
279
280
281
282
283
284
285
286
287
288
289
290
291
292
293
294
295
296
297
298
299
300
301
302
303
304
305
306
307
308
309
310
311
312
313
314
315
316
317
318
319
320
321
322
323
324
325
326
327
328
329
330
331
332
333
334
335
336
337
338
339
340
341
342
343
344
345
346
347
348
349
350
351
352
353
354
355
356
357
358
359
360
361
362
363
364
365
366
367
368
369
370
371
372
373
374
375
376
377
378
379
380
381
382
383
384
385
386
387
388
389
390
391
392
393
394
395
396
397
398
399
400
401
402
403
404
405
406
407
408
409
410
411
412
413
|
//-----------------------------------------------------------------------------
//
// File: QCDModDefs.h
//
// About: Module definitions file. Miscellanious definitions used by different
// module types. This file is published with the plugin SDKs.
//
// Authors: Written by Paul Quinn and Richard Carlson.
//
// Copyright:
//
// QCD multimedia player application Software Development Kit Release 1.0.
//
// Copyright (C) 1997-2002 Quinnware
//
// This code is free. If you redistribute it in any form, leave this notice
// here.
//
// This program 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.
//
//-----------------------------------------------------------------------------
#ifndef QCDMODDEFS_H
#define QCDMODDEFS_H
#include <mmreg.h>
#include <windows.h>
#ifdef __cplusplus
#define PLUGIN_API extern "C" __declspec(dllexport)
#else
#define PLUGIN_API __declspec(dllexport)
#endif
// Current plugin version
// use this version for old style API calls (all returned text in native encoding)
#define PLUGIN_API_VERSION 250
// use this version for new style API calls (all returned text in UTF8 encoding on WinNT/2K/XP (native encoding on Win9x))
#define PLUGIN_API_VERSION_WANTUTF8 ((PLUGIN_API_WANTUTF8<<16)|PLUGIN_API_VERSION)
#define PLUGIN_API_WANTUTF8 100
//-----------------------------------------------------------------------------
typedef struct
{
char *moduleString;
char *moduleExtensions;
} QCDModInfo;
//-----------------------------------------------------------------------------
// Services (ops) provided by the Player
//-----------------------------------------------------------------------------
typedef enum
{ //*** below returns numeric info (*buffer not used)
opGetPlayerVersion = 0, // high-order word = major version (eg 3.01 is 3), low-order word = minor (eg 3.01 = 1)
opGetParentWnd = 1, // handle to player window
opGetPlayerInstance = 2, // HINSTANCE to player executable
opGetPlayerState = 9, // get current state of the player (returns: 1 = stopped, 2 = playing, 3 = paused, 0 = failed)
opGetNumTracks = 10, // number of tracks in playlist
opGetCurrentIndex = 11, // index of current track in playlist (0 based)
opGetNextIndex = 12, // get index of next track to play (0 based), param1 = index start index. -1 for after current
opGetTrackNum = 13, // get track number of index, param1 = index of track in playlist, -1 for current
// - 'track number' is the number of the track in it's respective album, as opposed to playlist number
// - the 'track number' for digital files will be 1 if the tag is not set or the file is not identified
opGetTrackLength = 14, // get track length, param1 = index of track in playlist, -1 for current
// param2 = 0 for seconds, 1 for milliseconds
opGetTime = 15, // get time on player, param1 = 0 for time displayed, 1 for track time, 2 for playlist time
// param2 = 0 for elapsed, 1 for remaining
opGetTrackState = 16, // get whether track is marked, param1 = index of track, -1 for current
opGetPlaylistNum = 17, // get playlist number of index, param1 = index of track in playlist, -1 for current
opGetMediaType = 18, // get media type of track, param1 = index if track in playlist, -1 for current
// - see MediaTypes below for return values
opGetAudioInfo = 19, // get format info about currently playing track
// - param1 = 0 for samplerate, 1 for bitrate, 2 for num channels
opGetOffline = 20, // true if client is in Offline Mode
opGetVisTarget = 21, // where is vis being drawn > 0 - internal to skin, 1 - external window, 2 - full screen
opGetAlwaysOnTop = 22, // true if player is set to 'Always on Top'
opGetRepeatState = 23, // returns: 0 - repeat off, 1 - repeat track, 2 - repeat all
opGetShuffleState = 27, // returns: 0 - shuffle off, 1 - shuffle enabled
opGetTimerState = 24, // low-order word: 0 - track ascend, 1 - playlist ascend, 2 - track descend, 3 - playlist descend
// hi-order word: 1 if 'show hours' is set, else 0
opGetVolume = 25, // get master volume level (0 - 100), param1: 0 = combined, 1 = left, 2 = right
opSetVolume = 26, // set master volume level, param1: vol level 0 - 100, param2: balance (-100 left, 0 center, 100 right)
opGetIndexFromPLNum = 28, // get index from playlist number, param1 = playlist number
opGetExtensionWnd = 30, // handle to the draggable window extension (only available on some skins), param1 = extension number (0 - 9)
opGetExtVisWnd = 31, // handle to the external visual window
opGetMusicBrowserWnd = 32, // handle to the music browser window
opGetSkinPreviewWnd = 33, // handle to the skin preview window
opGetPropertiesWnd = 34, // handle to the player properties window
opGetExtInfoWnd = 35, // handle to the extended information window
opGetAboutWnd = 36, // handle to the about window
opGetSegmentsWnd = 37, // handle to the segments window
opGetEQPresetsWnd = 38, // handle to the EQ presets window
opGetVideoWnd = 39, // handle to the video window
opGetVisDimensions = 50, // gets the width and height of visual window (param1 = -1 current vis window, 0 internal vis, 1 external vis, 2 full screen)
// returns: HEIGHT in high word, WIDTH in low word
opShowVideoWindow = 55, // Show or Close video window (param1 = 1 for create, 2 for create and show, 0 for close)
opGetQueriesComplete = 60, // get status on whether all tracks in playlist have been queryied for their info
// playlist manipulation
opDeleteIndex = 90, // delete index from playlist (param1 = index)
opSelectIndex = 91, // mark index as selected (param1 = index, param2 = 1 - set, 0 - unset)
opBlockIndex = 92, // mark index as blocked (param1 = index, param2 = 1 - set, 0 - unset)
opGetMediaInfo = 99, // get the ICddbDisc object for the index specified, param1 = index of track, -1 for current
// param2 = pointer to integer that receives track value
// returns: pointer to ICddbDisc object. Do not release or deallocate this pointer
//*** below returns string info in buffer, param1 = size of buffer
//*** returns 1 on success, 0 on failure
opGetTrackName = 100, // get track name, param2 = index of track in playlist, -1 for current
opGetArtistName = 101, // get artist name, param2 = index of track in playlist, -1 for current
opGetDiscName = 102, // get disc name, param2 = index of track in playlist, -1 for current
opGetTrackFile = 103, // file name of track in playlist, param2 = index of track in playlist, -1 for current
opGetSkinName = 104, // get current skin name
opGetPluginFolder = 105, // get current plugin folder
opGetPluginSettingsFile = 106, // get settings file (plugins.ini) that plugin should save settings to
opGetPluginCacheFile = 107, // get file that describes plugin validity, functions and names
opGetPlayerSettingsFile = 108, // get settings file (qcd.ini) that player saves it settings to (should use for read-only)
opGetMusicFolder = 110, // get current music folder
opGetPlaylistFolder = 111, // get current playlist folder
opGetSkinFolder = 112, // get current skin folder
opGetCDDBCacheFolder = 113, // get current folder for CDDB cached info
opGetCurrentPlaylist = 114, // get full pathname of playlist currently loaded
opGetMediaID = 115, // get media identifier, param2 = index of track in playlist, -1 for current
// - for CD's it's the TOC - for anything else, right now it's 0
opGetSupportedExtensions = 116, // get file extensions supported by the player, param2 = 0 - get all extensions, 1 - get registered extensions
// - returned extensions will be colon delimited
opGetPlaylistString = 117, // get string for index as it appears in playlist, param2 = index
//*** below buffer points to struct or other object
//*** returns 1 on success, 0 on failure
opShowMainMenu = 120, // Display Main QCD Menu (buffer = POINT* - location to display menu)
opGetMainMenu = 121, // Returns copy of HMENU handle to QCD Menu (must use DestroyMenu on handle when complete)
opShowQuickTrack = 125, // Display QuickTrack Menu (buffer = POINT* - location to display menu)
opGetQuickTrack = 126, // Returns copy of HMENU handle to QuickTrack menu (must use DestroyMenu on handle when complete)
// To use if QuickTrack item selected: PostMessage(hwndPlayer, WM_COMMAND, menu_id, 0);
opGetEQVals = 200, // get current EQ levels/on/off (buffer = EQInfo*)
opSetEQVals = 201, // set EQ levels/on/off (buffer = EQInfo*)
opGetProxyInfo = 202, // get proxy info (buffer = ProxyInfo*), returns 0 if proxy not in use
//*** below returns numeric info, buffer used
opGetIndexFromFilename = 210, // get the index of a file that exists in current playlist (buffer = full path of file),
// param1 = startindex (index to start searching on)
// returns -1 if file not in playlist
//*** below send information to player
//*** returns 1 on success, 0 on failure
opSetStatusMessage = 1000, // display message in status area (buffer = msg buffer (null term), param1 = text flags (see below))
opSetBrowserUrl = 1001, // set music browser URL (buffer = url (null term))
// null url buffer - closes browser
// param1 = 0 - normal, 1 - force open
opSetAudioInfo = 1002, // set the current music bitrate/khz (buffer = AudioInfo*, param1 = size of AudioInfo)
opSetTrackAlbum = 1003, // update track ablum name (buffer = album (null term), param1 = (string ptr)file name), param2 = MediaTypes
opSetTrackTitle = 1004, // update track title (buffer = title (null term), param1 = (string ptr)file name), param2 = MediaTypes
opSetTrackArtist = 1005, // update track artist name (buffer = artist (null term), param1 = (string ptr)file name), param2 = MediaTypes
opSetTrackExtents = 1007, // update track TrackExtents info (buffer = &TrackExtents), param1 = (string ptr)file name)
opSetTrackSeekable = 1008, // update track seekable flag (buffer = (string ptr)file name), param1 = TRUE/FALSE
opSetPlayNext = 1009, // set the next index to be played (buffer = NULL, param1 = index, index = -1 unsets playnext)
opSetIndexFilename = 1010, // updates the filename (or stream) that an index in the current playlist refers to, buffer = new filename, param1 = index
opSetPlaylist = 1006, // clear playlist, add files to playlist or reset playlist with new files
// buffer = file list (each file in quotes, string null terminated) Eg; buffer="\"file1.mp3\" \"file2.mp3\"\0" - NULL to clear playlist
// param1 = (string ptr)originating path (can be NULL if paths included with files)
// param2 = 1 - clear playlist flag, 2 - enqueue to top
opInsertPlaylist = 1011, // insert tracks into playlist
// buffer = file list (each file in quotes, string null terminated) Eg; buffer="\"file1.mp3\" \"file2.mp3\"\0"
// param1 = (string ptr)originating path (can be NULL if paths included with files)
// param2 = index location to insert tracks (-1 to insert at end)
opMovePlaylistTrack = 1012, // param1 = index of track to move, param2 = destination index (move shifts tracks between param1 and param2)
opSwapPlaylistTracks = 1013, // param1 = index of first track, param2 = index of second track (swap only switches indecies param1 and param2)
opCreateDiscInfo = 1020, // returns: pointer to ICddbDisc object. Do not release or deallocate this pointer
opSetDiscInfo = 1021, // buffer = ICddbDisc*, param1 = MediaInfo*, param2 = track number
opSetSeekPosition = 1100, // seek to position during playback
// buffer = NULL, param1 = position
// param2 = 0 - position is in seconds, 1 - position is in milliseconds, 2 - position is in percent (use (float)param1))
opSetRepeatState = 1110, // set playlist repeat state, buffer = NULL, param1 = 0 - off, 1 - repeat track, 2 - repeat playlist
opSetShuffleState = 1111, // set playlist shuffle state, buffer = NULL, param1 = 0 - off, 1 - on
//*** below configures custom plugin menu items for the 'plugin menu'
//*** Player will call plugin's configure routine with menu value when menu item selected
//*** returns 1 on success, 0 on failure
opSetPluginMenuItem = 2000, // buffer = HINSTANCE of plugin, param1 = item id, param2 = (string ptr)string to display
// - set param2 = 0 to remove item id from menu
// - set param1 = 0 and param2 = 0 to remove whole menu
opSetPluginMenuState = 2001, // buffer = HINSTANCE of plugin, param1 = item id, param2 = menu flags (same as windows menu flags - eg: MF_CHECKED)
//*** below are services for using the player's filename template editor
//*** returns 1 on success, 0 on failure
opShowTemplateEditor = 2100, // displays template editor dialog, param1 = (HWND)parent window, param2 = modal flag
opLoadTemplate = 2101, // loads saved templates, buffer = (char*)string buf, param1 = bufsize, param2 = index of template (index < 0 for default formats, index >= 0 for user made formats)
opRenderTemplate = 2102, // create string based on template, buffer = (char*)template, param1 = FormatMetaInfo*, param2 = (char*)string buffer (min 260 bytes)
//*** other services
opUTF8toUCS2 = 9000, // convert UTF8 string to UCS2 (Unicode) string, buffer = null terminated utf8 string, param1 = (WCHAR*)result string buffer, param2 = size of result buffer
opUCS2toUTF8 = 9001, // convert UCS2 (Unicode) string to UTF8 string, buffer = null terminated ucs2 string, param1 = (char*)result string buffer, param2 = size of result buffer
opSafeWait = 10000 // plugin's can use this to wait on an object without worrying about deadlocking the player.
// this should only be called by the thread that enters the plugin, not by any plugin-created threads
} PluginServiceOp;
//-----------------------------------------------------------------------------
// Info services api provided by the Player, called by Plugin.
//-----------------------------------------------------------------------------
typedef long (*PluginServiceFunc)(PluginServiceOp op, void *buffer, long param1, long param2);
// Use to retrieve service func for DSP plugins (or other inproc process that doesn't have access to PluginServiceFunc)
// Eg: PluginServiceFunc Service = (PluginServiceFunc)SendMessage(hwndPlayer, WM_GETSERVICEFUNC, 0, 0);
// Set WPARAM = PLUGIN_API_WANTUTF8 for UTF8 string parameters
#define WM_GETSERVICEFUNC (WM_USER + 1)
//-----------------------------------------------------------------------------
typedef struct // for Output Plugin Write callback
{
void *data; // pointer to valid data
int bytelen; // length of data pointed to by 'data' in bytes
UINT numsamples; // number of samples represented by 'data'
UINT bps; // bits per sample
UINT nch; // number of channels
UINT srate; // sample rate
UINT markerstart; // Marker position at start of data (marker is time value of data)
// (set to WAVE_VIS_DATA_ONLY to not have data sent to output plugins)
UINT markerend; // Marker position at end of data (not currently used, set to 0)
} WriteDataStruct;
//-----------------------------------------------------------------------------
typedef struct // for GetTrackExtents Input Plugin callback
{
UINT track; // for CD's, set the track number. Otherwise set to 1.
UINT start; // for CD's or media that doesn't start at the beginning
// of the file, set to start position. Otherwise set to 0.
UINT end; // set to end position of media.
UINT unitpersec; // whatever units are being used for this media, how many
// of them per second.
// (Note: ((end - start) / unitpersecond) = file length
UINT bytesize; // size of file in bytes (if applicable, otherwise 0).
} TrackExtents;
//-----------------------------------------------------------------------------
typedef struct // for opSetAudioInfo service
{
long struct_size; // sizeof(AudioInfo)
long level; // MPEG level (1 for MPEG1, 2 for MPEG2, 3 for MPEG2.5, 7 for MPEGpro)
long layer; // and layer (1, 2 or 3)
long bitrate; // audio bitrate in bits per second
long frequency; // audio freq in Hz
long mode; // 0 for stereo, 1 for joint-stereo, 2 for dual-channel, 3 for mono, 4 for multi-channel
char text[8]; // up to eight characters to identify format (will override level and layer settings)
} AudioInfo;
//-----------------------------------------------------------------------------
// Equalizer Info
//-----------------------------------------------------------------------------
typedef struct // for coming QCD version
{
long struct_size; // sizeof(EQInfo)
char enabled;
char preamp; // -128 to 127, 0 is even
char bands[10]; // -128 to 127, 0 is even
} EQInfo;
//-----------------------------------------------------------------------------
typedef struct
{
long struct_size; // sizeof(ProxyInfo)
char hostname[200];
long port;
char username[100];
char password[100];
} ProxyInfo;
//-----------------------------------------------------------------------------
typedef enum // for MediaInfo.mediaType
{
UNKNOWN_MEDIA = 0,
CD_AUDIO_MEDIA = 1,
DIGITAL_FILE_MEDIA = 2,
DIGITAL_STREAM_MEDIA = 3
} MediaTypes;
//-----------------------------------------------------------------------------
#define MAX_TOC_LEN 2048
typedef struct
{
// media descriptors
CHAR mediaFile[MAX_PATH];
MediaTypes mediaType;
// cd audio media info
CHAR cd_mediaTOC[MAX_TOC_LEN];
int cd_numTracks;
int cd_hasAudio;
// operation info
int op_canSeek;
// not used
int reserved[4];
} MediaInfo;
//-----------------------------------------------------------------------------
typedef struct
{
long struct_size;
LPCWSTR title;
LPCWSTR artalb;
LPCWSTR album;
LPCWSTR genre;
LPCWSTR year;
LPCWSTR tracknum;
LPCWSTR filename;
LPCWSTR arttrk;
long reserved;
} FormatMetaInfo;
//-----------------------------------------------------------------------------
// When subclassing the parent window, a plugin can watch for these messages
// to react to events going on between plugins and player
// DO NOT SEND THESE MESSAGES - can only watch for them
// Plugin to Player Notifiers
#define WM_PN_POSITIONUPDATE (WM_USER + 100) // playback progress updated
#define WM_PN_PLAYSTARTED (WM_USER + 101) // playback has started
#define WM_PN_PLAYSTOPPED (WM_USER + 102) // playback has stopped by user
#define WM_PN_PLAYPAUSED (WM_USER + 103) // playback has been paused
#define WM_PN_PLAYDONE (WM_USER + 104) // playback has finished (track completed)
#define WM_PN_MEDIAEJECTED (WM_USER + 105) // a CD was ejected (CDRom drive letter= 'A' + lParam)
#define WM_PN_MEDIAINSERTED (WM_USER + 106) // a CD was inserted (CDRom drive letter= 'A' + lParam)
#define WM_PN_INFOCHANGED (WM_USER + 107) // track information was updated (lParam = (LPCSTR)medianame)
#define WM_PN_TRACKCHANGED (WM_USER + 109) // current track playing has changed (relevant from CD plugin) (lParam = (LPCSTR)medianame)
// Player to Plugin Notifiers
#define WM_PN_PLAYLISTCHANGED (WM_USER + 200) // playlist has changed in some way (add, delete, sort, shuffle, drag-n-drop, etc...)
// For intercepting main menu display
// (so you can get handle, modify, and display your own)
#define WM_SHOWMAINMENU (WM_USER + 20)
// For intercepting skinned border window commands
#define WM_BORDERWINDOW (WM_USER + 26)
// WM_BORDERWINDOW wParam's
#define BORDERWINDOW_NORMALSIZE 0x100000
#define BORDERWINDOW_DOUBLESIZE 0x200000
#define BORDERWINDOW_FULLSCREEN 0x400000
// send to border window to cause resize
// wParam = LPPOINT lpp; // point x-y is CLIENT area size of window
#define WM_SIZEBORDERWINDOW (WM_USER + 1)
//-----------------------------------------------------------------------------
// To shutdown player, send this command
#define WM_SHUTDOWN (WM_USER + 5)
//-----------------------------------------------------------------------------
// opSetStatusMessage textflags
#define TEXT_DEFAULT 0x0 // message scrolls by in status window
#define TEXT_TOOLTIP 0x1 // message acts as tooltip in status window
#define TEXT_URGENT 0x2 // forces message to appear even if no status window (using msg box)
#define TEXT_HOLD 0x4 // tooltip message stays up (no fade out)
#define TEXT_UNICODE 0x10 // buffer contains a unicode string (multibyte string otherwise)
#endif //QCDMODDEFS_H
|