TCPMP SUBS Subtitle Plugin

File Release Notes and Changelog

Release Name: 0.54 Beta

Notes:
TCPMP SUBS SUBTITLE PLUGIN
Version 0.5

I. What this plugin can be used with.

1. This plugin supports the following subtitle formats:
- SAMI (*.smi)
- ASS/SSA (*.ass,*.ssa)
- SubRip (*.srt)

2. The following video drivers can be used:
- GAPI
- GDI
- Intel 2700 (probably not working)
- ATI 3200 (probably not working)

Other video drivers will not show any subtitles.

II. Installation.

1. You should setup TCPMP 0.72 if you don't have it already.
This is the official CAB installator: http://picard.exceed.hu/tcpmp/test/tcpmp.pocketpc.0.72RC1.cab.
Some versions are most likely not supported and there may be conflicts:
- TCPMP 0.82 Unofficial Chineese Edition
- TCPMP Subtitle Edition
- TCPMP 0.71 and earlier
You may try to keep this versions and install TCPMP 0.72 to a separate folder. 
Any additional codec plugins can be installed too.

2. Please backup old versions of all files in TCPMP 0.72 folder.
If something will not work, there will be an opportunity to restore the previous stable state
without re-installing the player.

3. Unzip the contents of the "SUBS050.zip" archieve to the same folder you have installed TCPMP 0.72.
These files must be replaced:
- common.dll (changes some video drivers to add subtitle support)
- interface.plg (adds the Subtitle control menu)
Some other files are not nessasary if your device does not support Intel 2700 or ATI 3200 drivers.
There is also high probability they will work as they used to, but won't show subtitles.
- ati3200.plg
- intel2700g.plg

4. If your language is not English, you may need to change your system encoding.
Select "Settings->System->Regional Settings" from the Start Menu, then choose your language.
It will help if you see strange symbols in subtitle text instead of the correct ones.

5. Now start TCPMP 0.72. You will see a new page of settings where you may change the font name and size.
There will also be new "Subtitle" menu to switch subtitles on and off or to change their speed.

6. Copy subtitle files to the same folder where the films are located. The files names must be the same
as the films filenames, only difference is the extension. Subtitle files are founded automaticly by
the player when you click the "Play" buttion (not when you open a film).

III. Questions and answers.

Q: What was this plugin based on?
A: Some source files of "BetaPlayer 0.96 smi plg (050114)" were used. It helped in drawing subtitles on the screen.
The same source code was modified by other developers to create TCPMP Subtitle Edition which has much in common.
Main changes to make the SUBS plugin are:
- Porting the code from BetaPlayer 0.96 to TCPMP 0.72
- Parsing of SMI files was completely rewritten
- ASS/SSA and SRT support
- Subtitle menu and speed control was added

Q: This plugin is not working on my device. Can you help?
A: If your device is not based on Windows Mobile then this plugin won't work.
I can't port it to Palm or desktop Windows. If something is displayed wrong
due to screen size or some settings, your problem may be solved. But first
see the installation procedure description above to make sure you have
done everything correctly.

Q: Some specific file made TCPMP crash.
Q: I want some other subtitle format to be supported.
A: You can send not working files to my email for testing and fixing the bugs.
And if there is some popular subtitle format which is not too hard to
implement it can be added too.

Q: I want another function to be supported by the plugin.
A: The advices for further plugin development are also appreciated in case
many people will like these changes and this functions are really connected
with subtitles, not whole TCPMP player.

IV. Contacts.

Send any feedback and questions to my email:
sorokin88@gmail.com


Changes:
TCPMP SUBS SUBTITLE PLUGIN

Version 0.54

Fixed:

- Small code improvements

Added:

- Subtitle stream switching hotkey

Version 0.53

Fixed:
- Default font is now Tahoma
- Some font settings were not saved
- Speed settings were not saved after adjusting using menu, not Settings
- Simultaneous subtitle merging function disabled for causing crashes

Added:

Version 0.52

Fixed:
- Multiple subtitles appointed at the same time are now shown as one text
In version 0.51 only last line was visible.

- Subtitle timing was made more accurate
In version 0.51 subtitles were shown earlier than was needed because of rounding operations.

- *.SRT files critical parsing bug fixed

- First subtitle was shown when there should have been no subtitles yet.

Added:

- Manual subtitle file selection

Version 0.51

Fixed:
- Subtitles were not shown in pause mode

Added:
- Stream selection in Subtitle menu.

You can use this function to watch films with several subtitle languages.
For example, subtitle files for film 'any_name.avi' should be in the same folder and can be named like this:
	any_name.srt
	any_name.ENG.SRT
	any_name.new.mod.ssa
	any_name.smi
	...
	e.t.c.
Up to 8 subtitle streams are available

- Making font bold is now optional in the Settings menu