Synchronizing effectcode to music or events.

To create a synchronizer object inside the soundsystem, use DEMOGL_SoundSystemSyncCreate, specifying a certain ChannelCodeID to use as the source for the synchronizer object. The channel specified must play DGL_SS_MODELEMENT type data, otherwise the synchronizer object will not work (i.e. will never get triggered). An example of creating a synchronizer object:

iSyncID=DEMOGL_SoundSystemSyncCreate(iModuleChannelID, 
	BASS_SYNC_MUSICINST,MAKELONG(7,-1),1);

When a synchronizer object gets triggered, it will send a normal windows message. Besides the triggerdata, also the flag specified when the synchronizer object was created is send with the message. This flag is now usable to select which synchronizer object was triggered and send this message. Below is an example how this synchronizer just created above can be used to perform certain actions. Note: a message send due to a synchronizer is send to the application message pump, and all messages received by the application message pump are passed through to all enabled MessageHandler methods of all effectobjects. This way it's easy to synchronize multiple effects on just one synchronizer object.

// Purpose: the messagehandler of this effect. if we enable it we'll receive 
// every message posted to the window of the current app. This is handy if we 
// want to receive keyboard or mouse messages or f.e. soundsystem synchronizer
// messages
void
CMyCoolEffect::MessageHandler(HWND hWnd, UINT uMsg, WPARAM  wParam, LPARAM  lParam)
{
	switch(uMsg)
	{
		// ... other message handler case clauses
		
		case WM_DEMOGL_SOUNDSYSTEMSYNC:
		{
			switch(wParam)
			{
				// here 3 synchronizers are created, they are used to
				// modify rotation angles of a rotating object. 
				case 1:
				{
					m_fAlpha+=1.0f;
				}; break;
				case 2:
				{
					m_fBeta+=4.0f;
				}; break;
				case 3:
				{
					m_fGamma+=3.0f;
				}; break;
			}
		}; break;
	}
}