Winamp 5.55 SDK

[shaneh]

Yes I'm pretty sure I am using IPC_GET_EXTENDED_FILE_INFOW_HOOKABLE correctly, it formats every other tag fine. It just fails to format %rating% and %playcount% even though these are formatted fine in the playlist. It seems the ML isn't hooking these calls.

Some other tag functions I wouldnt mind implementing are $color and $font for Toaster, although whether thats necessary depends on whether I decide to use HTML or not.

[Benski]

Originally posted by shaneh
Yes I'm pretty sure I am using IPC_GET_EXTENDED_FILE_INFOW_HOOKABLE correctly, it formats every other tag fine. It just fails to format %rating% and %playcount% even though these are formatted fine in the playlist. It seems the ML isn't hooking these calls.

Some other tag functions I wouldnt mind implementing are $color and $font for Toaster, although whether thats necessary depends on whether I decide to use HTML or not.

Quick question before I debug this. In Prefs->Local Media, is "Use Library title information for Playlist Item Formatting" checked or not?

[shaneh]

Yep its enabled. The playlist allows using %rating% etc fine so I suspect its being used.

[Benski]

Looks like it's a bug in ml_local and not in the IPC_FORMAT_TITLE_EXTENDED API. It will be fixed in the next version. Thanks for the heads up and sorry about the confusion.

For reference, here's an example of how to use IPC_FORMAT_TITLE_EXTENDED

code:


static wchar_t *TagFunc(const wchar_t * tag, void * p)

{

	if (!lstrcmpiW(tag, L"test"))

	{

		return L"<<WORKING>>";

	}

	else

		return 0;

}

 static void TagFree(wchar_t *tag, void *p)

{



		 // nothing

}



static void QuickFormat(char *blah)

{

	waFormatTitleExtended fmt;

	wchar_t tempWideFn[MAX_PATH];

	wchar_t out[1024];

	MultiByteToWideChar(CP_ACP, 0, blah, -1, tempWideFn, MAX_PATH);

	fmt.filename = tempWideFn;

	fmt.useExtendedInfo = 1;

	fmt.spec = L"%artist% - %title% - %playcount% - %test%";

	fmt.p = 0; // don't need context

	fmt.out = out;

	fmt.out_len = 1024;

	fmt.TAGFUNC = TagFunc;

	fmt.TAGFREEFUNC = TagFree;

	SendMessage(plugin.hwndWinampParent, WM_WA_IPC, (WPARAM)&fmt, IPC_FORMAT_TITLE_EXTENDED);

	MessageBoxW(NULL, out, L"Results", MB_OK);

}

[shaneh]

Cool thanks Benski, itd be great not have to handle these myself, would %streamtitle% work too?.

Ive now got a C++ abstract framework in place to transparently switch between the different formatting methods depending on version. With the next release or beta I should be able to release gen_msn based on it, and just use the old ansi formatter for 5.32 (which manually does the %rating% lookups etc) rather than give that version special attention.

Mind you, my tag processing is probably a bit more efficient than letting the ML handle it, as I imagine it does a lookup for the file each time for every tag. Whereas I cache the itemRecord once and use it every time for the entire processing of the atf spec.

Itd also make ActiveWinamp much easier to code, and I can drop heaps of legacy code cause it will only target the most recent release.

So looking forward to it

[IceBear]

Originally posted by Benski
I fixed this bug internally in 5.3x, here's an updated (but still beta) SDK - http://download.nullsoft.com/winamp/beta/WA5.32_SDK.exe

When trying to run it I get a message that the installer is corrupt
Can you post a new file here or email a new file to ice.bear(a)home.se , please!

[DrO]

is nice to see that people read threads they post in.. click - none of the files were changed from the earlier 5.25 beta version that the attached lang pack zip contains

-daz

[shaneh]

Am hanging out for the ML whar query IPCs..

ML_IPC_DB_RUNQUERY_SEARCHW?

Do these exist in Winamp 5.33 or are they still coming?

[DrO]

no idea, is one for benski/will to make comment on (have stayed clear of anything to do with the ml personally)

-daz

[Benski]

Originally posted by shaneh
Am hanging out for the ML whar query IPCs..

ML_IPC_DB_RUNQUERY_SEARCHW?

Do these exist in Winamp 5.33 or are they still coming?

Some exist in 5.33. I'll post a new SDK shortly.

Here's some a quick overview of what Unicode IPC's were added (obviously the details will be in the new SDK)

code:


#define ML_TYPE_ITEMRECORDLISTW 6 

// if this, cast obj to itemRecordListW



#define ML_IPC_TREEITEM_ADDW			0x133 

// Adds new item using MLTREEITEMW passed as a param



#define ML_IPC_TREEITEM_INSERTW    0x134 

// like ML_IPC_TREEITEM_ADDW, but id becomes an "insert after" ID



#define ML_IPC_TREEITEM_SETINFOW    0x135

// Pass MLTREEITEMINFOW as a param. return TRUE - if ok



typedef struct {

  wchar_t *desc; // str

  intptr_t context; // context passed by ML_MSG_ONSENDTOBUILD

  intptr_t user32; // use some unique ptr in memory, you will get it back in ML_MSG_ONSENDTOSELECT...

} mlAddToSendToStructW;



#define ML_IPC_ADDTOSENDTOW 0x0401 

// pass mlAddToSendToStructW



#define ML_IPC_DB_RUNQUERYW 0x1700



#define ML_IPC_DB_RUNQUERY_FILENAMEW 0x1702 

// searches for one exact filename match of "query"



#define ML_IPC_DB_FREEQUERYRESULTSW 0x1705 

// frees memory allocated by ML_IPC_RUNQUERYW (empties results)



#define ML_IPC_DB_UPDATEITEMW 0x1706    

// returns -2 if item not found in db



#define ML_IPC_DB_ADDORUPDATEITEMW 0x1707





#define ML_IPC_DB_UPDATEFILEW 0x1710         

// Update File in the Local Media Data Base (return -2 if file record not found)

// NOTE that this call is broken on 5.33.  Only use on 5.34+



#define ML_IPC_DB_ADDORUPDATEFILEW 0x1711      

// Adds or Updates File in the Local Media Data Base.  

there is also a new itemRecordW that is more than just a wchar_t version of the itemRecord type. It includes all of the 5.33 MLDB fields.

[shaneh]

Awesome thanks.. I also reverse engineered the 'send to' menu IPCs to allow me to use the 'Send To' menu in ml_tree. I can't remember the details and don't have the code on hand, but I assume there are wchar equivalents of these? Given that the playlist still supports the 'send to' menu.

[Benski]

Originally posted by shaneh
Awesome thanks.. I also reverse engineered the 'send to' menu IPCs to allow me to use the 'Send To' menu in ml_tree. I can't remember the details and don't have the code on hand, but I assume there are wchar equivalents of these? Given that the playlist still supports the 'send to' menu.

Nope, but not really much of a need, since there weren't any strings in that API - it's HMENU based. There is a new send-to type for itemRecordListW but nothing is using it yet.

Why the need to reverse engineer it? The details should be in gen_ml/ml_ipc.h

[shaneh]

To add an item to the send to menu sure, but what about to display the send to menu itself, and then supply the itemrecords for the selected menu item? ie mimick the behaviour of the playlist with 'send to' to support 'sending to' everything else. I will show you later when I get a hold of the code, but Im pretty sure its not documented.

[Benski]

Originally posted by shaneh
To add an item to the send to menu sure, but what about to display the send to menu itself, and then supply the itemrecords for the selected menu item? ie mimick the behaviour of the playlist with 'send to' to support 'sending to' everything else. I will show you later when I get a hold of the code, but Im pretty sure its not documented.

Yeah, that's a bit of a challenge Send-to is still mostly using char * stuff. I'll try to write up some code for you. Basically, ML playlists tries to send a new send-to type and if it fails, reverts to sending an older send-to type. We'll discuss more when you have the code in front of you.

[shaneh]

I am referring to these tid-bits. Undocumented AFAIK.

libsendtoipc = (LONG)SendMessage(plugin.hwndWinampParent, WM_WA_IPC, (WPARAM)"LibrarySendToMenu", IPC_REGISTER_WINAMP_IPCMESSAGE);

struct sndstruct{
/*
0 = Not used?
1 = Build the send to menu on the hmenu supplied
2 = Check if menu id that was selected was on sendto menu
3 = Send list of selected files
4 = Free allocated memory
*/
DWORD cmd;
HMENU ma1SubMenu; //HMENU to build the menu on
DWORD ma2; //unknown
DWORD ma3; //causes a 1500 push..?
DWORD ma4flag; //Type of source ie. ML_TYPE_RECORDLIST etc
DWORD ma5menuid; //menu id that was selected
void* ma6itemsaddress; //address of items
HWND ma7Hwnd; //hwnd on owner window
DWORD ma8; //handle? context? used internally? Don't set.
byte data[124]; //reserved
};

[Benski]

Shane - I'll put it in the next build of the SDK

code:


typedef struct { // always init this to all 0s



  int mode; // mode can be 0, to see if sendto is available. If sendto is available, we'll return 0xffffffff.

            // mode = 1 means we are building the menu. data_type should be set. on success, this will return 0xffffffff. 

            // mode = 2 means we are querying if our menu_id is handled by the sendto menu. returns 0xffffffff if it was.

            // mode = 3 means we are sending the data. return value is not important =)

            //        be sure to have set data_type, menu_id, and data, for this one.

            // mode = 4 means to cleanup this structure.



  // build parms

  HMENU build_hMenu; // set this to the HMENU

  int build_start_id; // override the start and endpoints of IDs it can use

  int build_end_id;   // or leave as 0s for defaults.



  // type used for build and send modes

  int data_type;



  int menu_id;



  void *data;   // only used in mode = 3



  HWND hwnd; // parent for sendto





  intptr_t ctx[32]; // internal winamp use

} librarySendToMenuStruct;

[shaneh]

typedef struct
{
wchar_t *query;
int max_results; // can be 0 for unlimited
itemRecordListW results;
} mlQueryStructW;

Is the query struct wchar like above? How are the items returned? It seems different to the itemRecordList results.

Using:
SendMessage(plugin.hwndLibraryParent,WM_ML_IPC,(WPARAM)&mlQ,ML_IPC_DB_RUNQUERYW);
for (int i = 0; i < mlQ.results.Size; i++) {
wstring fn = mlQ.results.Items[i].filename;
}

Doesn't work too well.


EDIT: Nevermind. It appears the sdk is out of date, the itemRecordW has 4 extra DWORDS/pointers in it not accounted for. Adding them in fixed the arithmetic.

[DAVOR]

After a few Years not beeing here, I desided to see what is going on in the Winamp Community.
I was disapointed when the guys from Sqr Soft leaved their project in crossfading. 'Some' Years later there is no work forther.
Why can't none one make the plug-in for crossfading that could be based on scanning signals on beginnig and end of the song, on given dB to mix, without to take the next song 15 sec. before the end.
I've tried to learn C++, but never had the time to learn so that I could build plug-ins for Winamp.
Dont take my frustration seriusly, i'm just frustrated.
OK, I will come again in few Years, maybe then will it be some new interesting things.

[CraigF]

the directsound output plugin can be configured to cut silence off at a db threshold which, assuming enough pre-buffer, will also notify winamp to start serving up the next song. optionally, you can fade these transitions. voila, crossfading.

The main difference being, this is what is being fed into the soundcard, its not available at the dsp part of the chain, so its not ideal for streaming with say, shoutcast.

[bayaraa]

Where is the Latest lang_b (non beta)?
Can someone give me.

[DrO]

it's the same as is attached in the start of this thread. there have been no updates to the language file that i've seen since 5.32

-daz

[DrO]

http://forums.winamp.com/showthread....46#post2157946 has a pre-compiled example language file

-daz

[bayaraa]

Originally posted by DrO
it's the same as is attached in the start of this thread. there have been no updates to the language file that i've seen since 5.32

-daz

ok, thank you.

[bayaraa]

Originally posted by DrO
there shouldn't be any reason for that file to be needed and with a few modifications i can happily build the language file (moved tips.txt into a resource folder and disabled all of the icon, bitmap and cursor references). basically i'd just comment out those lines if they're still giving you issues (like in the modified version i've attached all files of)

-daz

What are these graphics? Are these Skin files?
Can someone attach me?

[DrO]

you don't need them, they are part of the internal resources included in winamp.exe for icons, the classic skin, etc and are not needed for a language pack.

-daz

[ChaosBlade]

Any news of an updated SDK?

[Safai]

Hi,

I'm wondering if there is a unicode version of the ML_IPC_TREEITEM_ADD?

Safai

[NiceguyRK]

Can a makefile be included (exported with visual studio and added to the diffrent SDK projects) so that it will be possible to easily import the samples to eclipse and other IDEs ?

A link:
http://www-128.ibm.com/developerwork...cdt/index.html
The link is for the older Callisto eclipse version and not for the newer Europa, but the visual studio side instructions should be the same.

I know its not a priority but some docs would be nice, or at least dependences.
I've even seen open-source projects with better docs then Winamp, and that's saying a lot !!!

[Benski]

Updated to 5.34 SDK (was sitting on the download site for a while but I forgot to post the link). I'll go ahead and compile the 5.35 SDK right now.

[tt01t2]

Is there any change in lang_b? I'd made a Vietnamese language pack with brken font in treeview. I'm waiting for a good news


This is my problem using 5.25 SDK. I worndering how to solve?

PHP Code:

http://forums.winamp.com/attachment.php?s=&postid=2018393 


[DrO]

you should be using http://forums.winamp.com/showthread....hreadid=270183 instead of pre-building the file yourself as lang_b is deprecated now and will be removed in one of the next sdk builds (is easier for us to just pre-build an example lng file for use now)

-daz

[tt01t2]

Do you mean the lang_b will be replaced?

Thanks for the 5.35 pre-building language pack. But it's difficult for me to do with .lng file 'cause Vietnamese should be translated in the context (on dialog.etc..) to get a exactly mapping.
So, i want to know what different between your pre-building and the latest SDK lang_b is. Or can you give me the latest one?
Thank you for your help

[DrO]

you just need to use a resource editor on the pre-built .lng file which will allow you to translate and adjust the sizing of the controls on the dialog pages, etc to better fit the language.

the main difference is that lang_b hasn't been updated to properly match the current winamp resources (from what i remember of the sdk build action and the fact that it's broken without modifying the rc file first). the link i refered you to has the latest official lng file to work with as there will not be one done for 5.36 until that is finalised.

from experience and other comments it's just easier for the base .lng file to be pre-built as most language pack developers don't have the means/knowledge to be able to compile a lang pack (as shown by the number of ones that i'd built for people in the past) and so is why the pre-built one will be the prefered method in future

-daz

[Maxim]

Originally posted by Benski

code:
static api_service *serviceApi=0;

static api_config *configApi=0;



api_config *GetConfigAPI()

{

  if (!serviceApi)

  {

    serviceApi = (api_service *)SendMessage(mod.hMainWindow, WM_WA_IPC, 0, IPC_GET_API_SERVICE);

  }



  if (serviceApi && !configApi)

  {

    waServiceFactory *sf= (waServiceFactory *)serviceApi->service_getServiceByGuid(AgaveConfigGUID);

    configApi = (api_config *)sf->getInterface();

  }



  return configApi;

}



...

Bugfix:

code:
api_config *GetConfigAPI()

{

  if (!serviceApi)

  {

    serviceApi = (api_service *)SendMessage(mod.hMainWindow, WM_WA_IPC, 0, IPC_GET_API_SERVICE);

  }



  if ((int)serviceApi == 1)

    return NULL;



  if (serviceApi && !configApi)

  {

    waServiceFactory *sf= (waServiceFactory *)serviceApi->service_getServiceByGuid(AgaveConfigGUID);

    configApi = (api_config *)sf->getInterface();

  }



  return configApi;

}

Winamp returns 1 when it's an old version that doesn't understand that message.

[Maxim]

What's the spec for winampUninstallPlugin? void(void)?
Should I be replying to requests for "family" tags?
Is there anything I can do (as an in_plugin) to support album art, or to get into the Unified File Info/Editor party?
Where's the list of Global Config settings I ought to be using? (eg. global playback thread priority)

[DrO]

winampUninstallPlugin has been present since 5.0 (as i recently found out) but has been improved on slightly with 5.5 (varies depending on the plugin in use - as i'm not at home i can't give the handling for that and Egg is just too keen on logging everything done in cvs at times before we can sort out docs, etc heh since i knew we'd not put this into the full changelog).

the "family" thing i'd need to check against (is primarily for the setup (/REG=S association page to group things)

the unified info editor is done as a full api (requires some additional in_* exports) but i don't think there's a basic example of this at the moment to work against (i believe all of that will be one of the next things on my official winamp todo list)

the global stuff i think benski already posted about that (will find out the link in a bit - was to do with in_mad if you want to have a look in the meantime)


due to all of the changes in 5.5 i think it may be a little while before the full 5.5 sdk is done but will post back what i can of the changes raised.

-daz

[gLes]

Erm, it's probably already been asked a hundred times, or maybe it's still too early, but what's with the new localization in Winamp? I just can't find any relevant information, besides this beta SDK, which already might be outdated, or whatever. Actually this is what I'm mostly interested in:

* New: Fully translatable Localization support
* New: WLZ (Winamp Language Zip) filetype support

Can I have some more info on that? What's changed, and what do I have to do to update my old localization to work with Winamp 5.5?

[DrO]

check out the information in the 5.5 release thread on the links to information currently available about the new style language packs (is incomplete what's available).

full details plus an example language pack will be coming out this weekend (i've bust a nut over the last 2 weeks so i'm trying to recover for the last 2 days so things are running a bit behind on getting everything out the door especially when we only got a few things working at the last moment). all i shall say is i hope you're up for a ~40k word translation (since i'm relucant to allow any wlz's onto winamp.com that aren't complete in all respects)

-daz

[gLes]

Originally posted by DrO
check out the information in the 5.5 release thread on the links to information currently available about the new style language packs (is incomplete what's available).

full details plus an example language pack will be coming out this weekend (i've bust a nut over the last 2 weeks so i'm trying to recover for the last 2 days so things are running a bit behind on getting everything out the door especially when we only got a few things working at the last moment). all i shall say is i hope you're up for a ~40k word translation (since i'm relucant to allow any wlz's onto winamp.com that aren't complete in all respects)

-daz

It might take a while, but I've got a good deal to begin with

[Maxim]

OK... /REG=S only queries "family" if you return "type" == 0 or 1. I return a custom type (if configured that way) to get my files split out of regular audio, which has worked fine until now. The /REG=S window understand this and classifies it as "other" but does not query "family" on those items.

Is that on purpose, or a bug?

Here's the priority bit:

code:
extern "C"	int GetPlaybackThreadPriority()

{

	api_config *config = GetConfigAPI();

	int pri = THREAD_PRIORITY_ABOVE_NORMAL;

	if (config)

		pri = config->GetInt(playbackConfigGroupGUID, L"priority", THREAD_PRIORITY_ABOVE_NORMAL);



	return pri;

}

It threw me because the setting name isn't the same as the INI entry for this one.