TCPMP SUBS SUBTITLE PLUGIN
Version 0.6

I. What this plugin can be used with.

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

Note: not all *.sub files are in MicroDVD format.

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

3. The following video drivers are not supported:
- Raw Frame Buffer
- Direct Draw
- Intel XScale

These ones will not show any subtitles.
If you are a developer and can modify the drawing drivers to make them supported, you may send the code to my email.

II. Installation.

1. You should setup TCPMP 0.72 if you don't have it already.

Variant 1.
This is the official CAB installator: http://picard.exceed.hu/tcpmp/test/tcpmp.pocketpc.0.72RC1.cab.
Use files from the WM.2003.and.higher folder.

Variant 2.
If the previous installator won't work on your device, you can try another one here: http://forum.xda-developers.com/showthread.php?t=380387
Use files from the WM6.1 folder.

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

Probably, you won't be able to install several versions of TCPMP at the same time and will have to delete your old one.

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. Copy contents of the folder (see 2 variants described above) to the same directory 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 necessary if your device does not support Intel 2700 or ATI 3200 drivers.
- 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 and 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 some changes in interface:
- A new page of settings where you may change font name, size and boldness, disable
subtitles completely or change their speed.
- Options->Subtitle submenu in the main menu. It allows opening a new subtitle file,
to switch between several subtitle streams and also to change speed.
- A hotkey for subtitle stream switching in Settings on the Hotkey page

6. Using the plugin

You may copy subtitle files to the same folder where the films are located.
The plugin will autodetect subtitles which names begin with the film name when you click the "Play" button:
filmname.srt
filmname.eng.smi
...
etc

You may also use Options->Subtitle->Open... to manually load a subtitle file.

If you are using *.sub files, they are frame based.
The plugin tries to determine the right frame per second rate automatically.
First it looks at the first line of a *.sub file to see if frame rate is mentioned there.
If a value is not found, the current film FPS is taken.
You may need to change the FPS setting manually only in rare cases.
This setting does not influence any other subtitle types or the film.

IV. 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. In both cases you should attach a subtitle file
as an example to test on.

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.

Q: Can you make work another video driver that is not supported yet?
No, drivers that provide picture drawing are rather hard to implement and modify.
I ported the changes in video drivers from BetaPlayer 0.96 smi plugin without
touching them.

V. Contacts.

Send any feedback and questions to my email:
sorokin88@gmail.com (Alexander Sorokin)