MP3+G Plug-In (c) 2002, 2003, 2004 PHY Systeme, Vaudreuil-Dorion, Quebec, Canada
(a.k.a cdg plugin (c) 2002, 2003, 2004 )
All Rights Reserved

THIS SOFTWARE IS PROVIDED BY PHY SYSTEME ``AS IS'' AND ANY EXPRESS 
OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED 
WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR 
PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL PHY SYSTEME BE LIABLE 
FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR 
CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT 
OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; 
OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF 
LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT 
(INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE 
USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH 
DAMAGE.

PERMISSION IS GRANTED TO ANYONE TO USE THIS SOFTWARE FOR ANY PURPOSE, 
INCLUDING COMMERCIAL APPLICATIONS, AND TO REDISTRIBUTE IT FREELY, 
SUBJECT TO THE FOLLOWING RESTRICTIONS:

  1. THE ORIGIN OF THIS SOFTWARE MUST NOT BE MISREPRESENTED; YOU MUST NOT
     CLAIM THAT YOU WROTE THE ORIGINAL SOFTWARE. IF YOU USE THIS SOFTWARE
     IN A PRODUCT, ACKNOWLEDGMENT IN THE PRODUCT DOCUMENTATION IS REQUIRED.
  2. THIS NOTICE MAY NOT BE REMOVED OR ALTERED FROM ANY DISTRIBUTION.


/-------\
|Content|
\-------/
-Introduction
-Features
-Instruction
-Configuration
-Known problem
-History

/------------\
|Introduction|
\------------/
This plug-in is used to display CDG files in sync with MP3 or 
other supported formats by Winamp (version 5 and later). This 
transforms your PC in a powerful karaoke machine.

/--------\
|Features|
\--------/
 Play CDG files in karaoke style window
 Support ALL features of CDG: scrolling, palette cycling, 
channels and more
 Seamless integration with Winamp
 Predefined zooms and full screen mode display
 Multi-monitors support for full screen mode
 Instant access to any part of a song/lyrics with the jump bar 
of Winamp
 Simple context menu
 Auto-hide cursor in full screen mode
 Optimized C code 
 Co-exist with other plug-ins for Winamp (DSP, visualization)
 Donation based!

/-----------\
|Instruction|
\-----------/

Load your favorite .mp3 or other audio files in Winamp as usual. 
If a .cdg file exists in the same folder as the audio file, a 
window will appears on the screen and starts displaying the 
content of the cdg file (usually lyrics). The content is 
synchronized with the music.

The window can be dragged anywhere on the screen with the mouse. 
If you double-click in the window, it will go alternatively 
between full screen mode and window mode. You can resize the 
window by dragging the border, but it's better to use the 
predefined zooms to keep a good visual aspect ratio. You can 
select the zoom mode by clicking with the right button in the 
window or using the shortcut keys (listed in the menu). The 
"escape" key can be used to return to window mode from full 
screen mode.

The right-click menu can also be used to select the "always on 
top" mode. When "always on top" is checked, no windows can be 
placed in front of the window's plug-in. 

If the CDG contains different channels, you can select 
individually which channels to play from the channel menu. You 
just have to right click in the window and go in the channel sub-
menu to select which channels are enabled.

/-------------\
|Configuration|
\-------------/

If you go in options->preference->plugin->general purpose menu 
from Winamp, you can configure some aspects of the plug-in like 
graphic parameters and timing parameters. You can also activate 
or deactivate the plug-in operation by checking or not the 
"Enable Plug-in" box.

The section named "graphic" in the configuration screen is used 
to customize the way the plug-in display the information. From 
here, you can change the width and height of the margin of the 
plug-in. These numbers represent the number of pixels around the 
border in 1x zoom mode. You can also enable or disable the auto-
hide feature from here. When it is on, the plug-in hides the 
cursor in full screen mode after 3 seconds of mouse inactivity. 
The last thing you can configure is the multi-monitors option. If 
youre system support multi-monitors, you can select which 
monitor should be used for full screen display. On one monitor 
system, the list is disabled.

The timing section is left for your experiment. Usually, on most 
systems, you dont have to change anything there!

/-------------\
|Known problem|
\-------------/
Winamp tends to drift the time code as long as a file is playing. 
The drift factor (see configuration screen) is used to fix that 
temporary (until Nullsoft will release a patch). However, this 
cause a small sync problem that can be seen if you move the jump 
bar of Winamp near the end of the file, just after the music 
start playing. The drift is around one second for each 3 minutes 
of song. In normal operation, if you let the audio file play 
without using the jump bar, there is no problem at all!! 

/-------\
|History|
\-------/
V1.4 - May 26, 2004
-Adapted for www.physysteme.com with new contact info

v1.3 - January 21, 2004
-Adapted for Winamp 5

V1.2a - September 22, 2002
-Fixed right line bug in display engine

V1.2 - September 17, 2002
-Fixed glitch in graphic display
-Accelerated graphic engine: it draws faster and uses less CPU
-Fixed bug when screen resolution is changed that affect full 
screen mode

V1.1 - May 31, 2002
-Full screen multi-monitor support in the config screen
-Position and state of the windows plug-in saved when Winamp is 
closed
-Keys pressed not used by the plug-in are sent to Winamp
-Auto-hide cursor in full screen mode after 3 seconds of 
inactivity
-Enable/disable checkbox in the config screen
-Some minor bugs fixed

V1.0 - March 28,2002
-Initial version

Have fun !!

cdgplugin@physysteme.com
http://www.physysteme.com

