MMPlayer 1.1.0
==============

MMPlayer is a powerful Mobile Media Player for PalmOS that can play Ogg, mp3 and MIDI
audio plus mpeg 1,2,4, DivX, XviD and H263 video.

To install and use MMPlayer, just install MMPlayerLib.prc, MMPlayerGUI.prc,
MMMidiInstr.pdb plus optionally one or more skins from the Skins directory
onto your handheld.

Also check the distribution file and the manual for additional support for your device.


News in 1.1.0
=============
* Significantly faster on newer Palm devices. Zire 72, Treo 650, etc.
* Bugfixes, many related to zooming and rotating.

News in 1.0.0
=============
* Version string changed.

News in 1.0.0 RC4:
=================
Bugfixes:
* Sometimes when rotating and changing forms much, the status text becomes a red bar.
* On Zodiac, OSD controls go by 2 at a time
* Text overlapping when the next song is shorter.
* Pause should not exit MMPlayer (when started from another program).
* Adapt file selection dialog for 480x320.
* Audio seeking didn't work very well.
* Video seeking much snappier than RC2.
* Unblank button shouldn't do anything.
* Generally better streaming behaviour.

News in 1.0.0 RC2:
=================
* Selecting Edit Marks... doesn't crash.
* It's possible to type a URL in the bottom field and just add it.
* MMPlayer warns about unnamed cards (only once though), but tolerates them anyway.
* Only checks for bookmarks for local files. Otherwise it would make HTTP accesses whenever a HTTP file was selected.
* MMPlayer library can now be on memory card. Must be in the same dir as MMPlayerGUI.
* The default skin supports 480x320 and 320x480
* The Mark button in the Add file dialog in HTTP mode only added a .com instead of adding the current URL to the Mark list.
* The Base version is a lot more capable than RC1. I think it has all the features from 0.2.14 and then some.


News in 1.0.0 RC1:
=================
* It's now possible to use the default skin even if other skins are installed.
* URL bookmarks. Lets you add favourite URLs you often visit.
* Podcasting.
* Load/save playlists. The M3U format is used.
* Resume. When a video is playing and you exit MMPlayer, it resumes ~10 seconds
  before the exit point the next time you restart MMPlayer. This function is
  only active for video now since the audio continues to play in the background
  when exiting.
* Separate rotation settings for fullscreen/window mode.

Bugfixes:
* I think the crash when touching the Eq on Zire 72 is fixed. I was able to
  reproduce it on my Treo 650 when it finally got to Europe. Somehow, the
  different CPU managed to find a division by zero in the floating point
  math involved when drawing the equalizer spline.
* Some more memory leaks fixed.
* 5-way navigator can be used to browse the menu left/right.
* Generally better behaviour on the Treo 650.
* Some mp3 files with large pics in the header failed to play if you
  didn't increase the audio buffer.
* Mp3 and Ogg seeking was broken.


News in 0.2.14:
===============
* Screen blanking.
* Online key downloading for internet connected devices.
* MMFont.pdb is now built-in in the library prc.
* The default skin is now built-in in the GUI prc.

Bugfixes:
* Fixed background play on Treo 600.
* It crashed pretty often when changing skin.
* A few rather serious memory leaks when playing mp3 and ogg.
* Bookmarks should actually be working now.


News in 0.2.13:
===============
* Added a performance warning about non-standard audio frequencies so the warning that
  was added in 0.2.12 can be shut-off.
* Added a low memory warning if too little memory is detected at startup.
* New launch code (sysAppLaunchCmdGoToURL) to enable 3rd party developers to
  launch MMPlayer and start playing a file directly. ZLauncher will probably
  be the first to use this.

Bugfixes:
* HTTP directory listings should work better on WiFi and Treo devices. A too small
  memory allocation was the cause and may fix other strange crashes as well.
* Plugged some memory leaks.
* Avoids checking orientation on devices that doesn't have that function.
* Ogg seeking implemented.
* The file type WAV wasn't included in the file types reported to the exchange manager,
  so WAV attachments weren't possible to play.
* Zodiac rotation fixes.
* MMPlayer sometimes failed to read the index, causing seeking to be disabled.
* Some files wasn't seekable, (probably because of incorrect indexes causing MMPlayer
  to look for keyframes at the incorrect position). This also caused the video to
  play very slow after seeks.
* "Projector noise" mp3 bug fixed.
* Pauses playback while accessing the menus to avoid graphical corruption.
* On some devices, the main form was misplaced, or hidden under the virtual grafitti
  area.



News in 0.2.12:
===============
* Support for Garmin iQue fullscreen window mode. (There seems to be a problem though,
  you will probably need to switch forms back and forth to get the correct form).
* "Font Setting" renamed to "GUI Settings" and a playlist format setting was added letting
  the user choose if the whole path of files should be displayed or just the filename.
* Benchmarks are now played with audio. If the benchmark plays faster than normal,
  some audio will be skipped and if slower, the audio will studder. There's also a new
  benchmark audio setting that lets you shut off the benchmark audio if desired.
* New setting to control if audio is to be played or not. There's also a new safety
  catch for illegal audio frequencies. If an unsupported frequency is detected, the user
  is warned and may choose to play the video without audio.
* Removed the native MCA support for Clies. Use MCA2 instead, see
  http://www.aibohack.com/clie/modclieaud.htm
* Skins can now set the colour of the audio waveform.
* New skins, making full use of the dynamic size feature introduced in 0.2.11. So, some
  skins will work for all devices, including the Treo 600. (Plain and Black)
* New fallback method when looking for skins. The MMDefaultSkin file doesn't need to
  be present, any skin will do.
* New statistics value "Dynamic memory headroom". This value indicates how much dynamic
  memory is left over/required when playing a video. Since 0.2.9, dynamic memory is used
  to speed up video playback, this value can be used to determine if this feature has
  been used or not. If the value is positive, the faster mode was active, but if it was
  negative, it used a slower method as a fallback.

Bugfixes:
* The video area was sometimes misplaced in landscape window mode.
* Some zoom modes had bugs causing some artifacts at the video borders or crashes.
* Zodiac specific buttons didn't work.
* The playlist scrollbar crashed when the files didn't fill up the list and the
  scrollbar was tapped.
* Sometimes, the volume (or some other) slider was drawn at the incorrect position
  when changing the value with a hardware button (instead of with the slider).
* A memory leak caused MMPlayer to stop playing a video if it needed to look for the
  next keyframe. (Which can happen in difficult passages).
* Some MIDI songs crashed before starting to play if drums were used that wasn't
  included in the instrument file.
* The audio waveform shouldn't leave traces anymore.
* The playlist font is changed directly when changed in the GUI Settings.
* When a new memory card is inserted when displaying the file selection form, the newly
  inserted card is read.

News in 0.2.11:
===============
* Ogg Vorbis audio. Note that Vorbis audio in AVI files is not yet supported.
* MIDI audio. You should be able to play .mid files with MMPlayer. Don't forget
  to install the instrument file MMMidiInstr.pdb if you want to play MIDI.
* The skin system has been enhanced to allow skins to adapt to dynamic screen size
  changes, like when the virtual grafitti area is collapsed or the system rotation
  is changed.

Bugfixes:
* Some Tungsten|T users had problems playing anything with 0.2.10. Fixed.
* The grafitti collapse icon on the TH55 was disabled due to an updated API.
* Mpeg video encoded with some encoders played very jerky.


News in 0.2.10:
===============
* MMPlayer now registers with the exchange manager, meaning that you can use it
  to play mail attachments. It should also be possible to play files received via
  other programs, such as web browsers.
* Streaming via HTTP is now possible by adding a URL file via the playlist "Add"
  button. Select URL in the top-right list and type the URL of the file, then press
  ok. It's also possible to list directory listings by typing a directory on the
  line and tab "List".
* M3U playlist parsing. Select a .m3u file to add all its files in the playlist.
* The rotate and grafitti collapse buttons in the status bar of 320x480 Palms
  are now enabled. There's also a new rotation setting "Follow GUI" that follows
  the current GUI setting. Collapsing the virtual grafitti area doesn't do much
  now since the skin system isn't updated yet.
* Clies with Sony's own sound API (NX, NZ and TG) can now do HiFi audio thanks to
  CliePet's MCA library. There's still some bugs left in there though, but we'll
  update our implementation when new versions of MCA are released.
* We added a DRM system (Digital Rights Management) to MMPlayer. Note that usual
  media files will not be restricted in any way. The sole purpose of the DRM system
  is to enable content sites to offer really cool content, stuff that the authors
  never would have made available otherwise.

Bugfixes:
* When a file once had bookmarks but all have been deleted, a remaining empty
  bookmark file was left behind (.bkm). This caused MMPlayer to crash when playing
  that file.
* Some primitive functions in the decoder used a lot of stack, causing the stack
  to overflow in some conditions (and almost always on some devices with a small
  stack, e.g. the TJ35).

Known bugs:
* The MCA implementation to enable HiFi audio on Clies sometimes causes clicks
  in the audio stream. We're working with CliePet to resolve this issue.



News in 0.2.9:
===============
* By using available dynamic memory, it was possible to boost performance between
  8-20% depending on video parameters and other circumstances. MMPlayer now tries
  to use dynamic memory for video decoding buffers, (which is not the buffers
  that can be resized using the settings form). If all decoding buffers can be
  allocated in dynamic memory, video decoding can be done faster. On some devices,
  the dynamic memory won't suffice to hold all those buffers, in which case storage
  memory will be used instead. The same performance increase can also be reached,
  (even if dynamic memory isn't enough), by encoding the video without B-frames.
  Note however that this will decrease the quality/bitrate ratio some. In other
  words, you sacrifice space (or quality) to gain speed.
* The A/V sync strategy has been adapted to the PTS values that is used since
  0.2.7-0.2.8. The old FPS regulator has been scrapped and a new, more direct,
  method is used instead. 
* The new setting "B-frame skip threshold" can be used to set how many milliseconds
  the video may lag behind the audio before starting to skip B-frames. If set to 0,
  it will skip most B-frames, and if set to 500, it will wait until the video is
  half a second behind the audio before skipping B-frames.
* After user requests, the A/V sync compensation stays the same between clips.

Bugfixes:
* When playing a complex video, the audio started clipping.
* When a video was playing in fullscreen and the playlist came to an end and repeat
  was not active, it caused MMPlayer to get stuck in fullscreen mode. Now it comes
  back to window mode when done playing.
* When playing a video at 3/2 zoom with rotation, vertical lines were jagged.
* Connected the playlist with the scrollbar, finally!
* Sometimes when a stream was already closed, it was closed again at the end of
  a file or when pressing stop, causing a crash.
* The PCM audio codec could overwrite the audio buffer when decoding large audio
  packets. This could be one of the big bugs for people playing clips from the
  internet without re-encoding them.
* The buffer indicators left trails behind.
* When initializing some codecs with large resolution videos, memory allocations
  could fail resulting in a crash. It now reports the out of memory error instead.
  It does not however, completely reclaim the memory, so you'll probably need to
  reset your device anyway when this has happened.

Known bugs:
* In low memory conditions, especially for devices like the T1, T2 and Z71, MMPlayer
  can fail to deallocate all allocations. This will give the device even less
  memory to work with. You'll probably need to make a soft reset when this has
  happened.
* Audio shutoff. This can happen when the video lags behind the audio. This
  means that some video packets are stored in the video buffer until needed, and
  when the video buffer is full, or the video packet array is full, no more
  audio packets will be read, causing the audio outage. I've increased the video
  packet array to 256 packets in 0.2.9 so I think this won't happen too much, but
  it might still happen if you use a large "B-frame skip threshold".
* Some movies, especially .mov clips taken with digicams, use strange audio
  frequencies. This shouldn't be a problem since the OS is supposed to refuse
  playing unsupported frequencies, but the OS in the T3, and possible others
  tried to play them anyway, resulting in a "Fatal exception".


News in 0.2.8:
==============
* Added support for Treo 600 button layout so Treo 600 users can use the OSD
  settings.
* I think I finally found what was wrong with the AVI A/V sync. Some clips from
  with the mjpeg codec (mostly clips created by small digicams) still have A/V
  sync problems. But you can use the A/V Sync compensation to compensate for that.
  
Bugfixes:
* Some audio files sounded really bad with bloops, squeeks and an occasional whoosh.
* When seeking from (or to) a location with much sound, a high shrieek was often
  heard. The fix should decrease this unpleasant effect. I think some audio may
  still be left in the hardware buffer and may be played when the audio is un-
  paused again. If you still think it's irritating, I guess I could decrease the
  volume to zero while seeking and then quickly increase it during the first
  frames after the seek.
* Some encoders used some "alternative" way of writing AVI files that MMPlayer
  didn't recognize. It should now.
* Some, or at least one, digicams writes the audio frequency 11024 instead of
  11025 in AVI files. The T|T3 OS accepted this frequency but the hardware failed
  when trying to play it. MMPlayer now simply plays the audio at 11025 to avoid
  trouble.
* When an mpeg clip got to the end, it complained about a too small video buffer.

Known bugs:
* After adding the 11024 Hz workaround above, I realized some mov clips have some
  really odd audio frequencies like 7875 Hz. For these clips, MMPlayer really
  needs to resample the audio and until that's done, these will sound pretty bad
  on a T|T3, and will not be played at all on a T|T.
* MMPlayer fails to correctly calculate the length of some mpeg clips. This will
  cause the playback slider to move outside its area. You can still seek through
  the whole clip though.



News in 0.2.7:
==============
* Mpeg lipsync is now based on the packets' PTS values (presentation time stamps)
  and should be as synchronized as possible, both before and after seeks.
* AVI packets don't have PTS values, so those are faked. It seems we're back to
  the days where you need to set preload=0 in the audio interleave dialog (in VirtualDub).
  However, this sync offset *should* be constant throughout the file so the workaround
  below should suffice to compensate.
* To be able to manually compensate for audio/video sync offsets, a new OSD setting
  has been added called "A/V sync". Use the notepad button to find that OSD setting
  and use the up/down to move the video track forward/backward. Thanks Markus for
  the suggestion.
* Rotation left added
* Video position can be tweaked using the "Video position" OSD setting. When active,
  the D-pad can be used to move the video area up/down/left/right.
* The buttons on the Zodiac are now mapped in a usable fashion.

  The digital pad (right side):
  up/down zooms up/down
  left changes rotation
  right changes OSD setting

  The analog rocker (left side):
  up/down changes the current OSD value up/down
  left/right skips to prev/next file, or moves video area left/right if OSD setting
  is "video position".
  push pauses or unpauses

Bugfixes:
* Sometimes the audio stopped playing before the end.

Known bugs:
* AVI files don't sync right when the audio preload isn't 0. The workaround is to
  use the "A/V sync" OSD setting to compensate manually.



News in 0.2.6:
==============
* Optimized mpeg playing. The optimization plus some bugfixes enables MMPlayer
  to play VCD class mpeg videos (1150kbps video + 224 kbps audio) on a T3.
* Optimized the text drawing. Nag and OSD texts shouldn't slow down things
  as much as it used to.
* Added an amplifier. Warning! This can amplify *very* much, probably much
  more than you'll ever need. It might come handy if the audio track is encoded
  very low. I added a little safing mechanism to the slider so you won't be able
  to increase the gain very much at a time above zero level.
* Added an amplifier slider to both skins, plus the missing buttons on the
  default skin, (Eq, Repeat and Shuffle).
* Small optimizations in video decoding.

Bugfixes:
* When nothing was playing and a hard button was pressed, MMPlayer crashed.
* Fixed the bug prohibiting fullscreen using old skins.
* A strange bug caused a crash when entering the settings dialog or exiting
  MMPlayer. When chasing it, I found a work-around more or less by mistake. I'm
  still not sure if it's an OS bug or if MMPlayer somehow causes it. I'll just
  leave the work-around in there for now and let you report if it works for you
  too. It works fine on my T3 an T|T.
* Mp3 seeking suffered from the same overflow bug AVI seeking did a few releases
  back. You should be able to seek through large mp3 files now.

Known bugs:
* When seeking in mpeg files, the lipsync is lost. 
* When the audio gets too much much ahead of the video, i.e. if it takes too long
  time to go fullscreen or do some other operation, MMPlayer thinks the audio
  track is over and will stop playing audio.


News in 0.2.5:
==============
* MMPlayer keeps running when a memory card is inserted.
* The Notepad button is now used to toggle what the up/down buttons controls.
  It toggles between volume, pan, brightness and contrast.
* A little status text displays what was changed for ~1 second (30 frames).
  (zoom mode, rotation, volume, pan, brightness, contrast)
* A new skin showing off what you can do with the skin system, (no it's not
  another wood skin). There's also some changes to the skin system to be able
  to have different looks for audio and video modes. It's also possible to
  set fonts now. The old default skin is now called MMTinySkin.
* The warning about untested device should only appear the first time you start
  MMPlayer (and continue). It also never allows pre OS5 devices to continue.
* I made an attempt to minimize the time in the audio callback. Audio data is
  now decoded in the video thread and just copied by the audio callback. This
  is actually the same method used in, hmmm... was it 0.1.5 or something, and
  if I remember correctly, a method that seemed to work well on many devices.

Bugfixes:
* Treo 600 fullscreen mode
* Nag text caused a crash after ~45 sec on Treo 600
* Black rectangle on Treo 600

Known bugs:
* There seems to be a bug in the mpeg decoding code. When decoding a difficult
  mpeg file, the memory heap sometimes gets corrupted, leading to a crash when
  exiting MMPlayer or opening the Settings dialog.
* When seeking in mpeg files, the lipsync is lost.
* Some buttons are missing in the new default skin - Eq, Repeat and Shuffle.
  There's also no area for wave drawing yet.


News in 0.2.4:
==============
* There are lots of more user settings so the settings dialog has been divided
  into four sub-forms.
* Rotation added. You can set the rotation mode in the video settings form.
  Rotation plus 3/2x zoom is extremely useful on a T|T3 to watch a 320x240
  video in fullscreen 480x320. Note that you mustn't use the normal rotation
  button in the system status bar. If you do, the display bitmap will move and
  reorder itself, making it harder for MMPlayer to render fast video on it.
* The hardware buttons can be used to control zoom and rotation if the "Use
  buttons" checkbox in the video settings form is checked. The datebook
  button steps down in the list of zoom modes (zoom down), the address button
  steps up in the list of zoom modes (zoom up) and the todo button toggles
  rotation mode.
* Performance warnings are given when MMPlayer detects some aspect of the
  currently playing video that is outside to capabilities of the device. They
  may also warn if the audio or video buffers are too small, in which case you
  just need to increase it and try again. Each warning can be shut off, either
  by tapping "Never again" when one is given, or by using the "performance
  warnings" settings sub-form.
* Mpeg seeking is implemented. The lipsync is lost when seeking though, didn't
  have time to fix that.


News in 0.2.3:
==============
* The skin selection form can now browse memory cards. I.e. you can have
  skins on the card.
* Large font in file and skin lists. Set it to the old hires version by
  checking the Hires checkbox in the settings dialog.
* T3 fullscreen support. Note that there's no rotation of the video yet,
  so keep your T3 in portrait mode and if you want to watch movies in landscape,
  rotate them in VirtualDub. We will add rotation but it didn't make it into
  0.2.3.
* The zoom mode can be set in the settings dialog. There are two zoom mode
  settings, window zoom and fullscreen zoom. The window zoom controls which
  zoom mode to use when viewing video in the window and fullscreen zoom
  controls which zoom mode to use when viewing video in fullscreen. You
  can either set a fixed zoom mode (2x, 3/2x, 4/3x, 1x or 1/2x) or let
  MMPlayer select the best mode for each video, (which is the default).
  For example, If you let MMPlayer select zoom mode for a VCD encoded mpeg
  file that has a 352x288 size (for PAL), it will pick 1/2x zoom, but you may
  want to select 1x instead to crop the video and watch the center 320x288 part.
* MOV decoding. Note that common Quicktime codecs like Sorenson etc. is
  not included, just MOV parsing. It's nonetheless useful for certain cameras
  that produces MJPeg clips in MOV files.


Bugfixes:
* Crash when you tapped outside the file or skin list.
* Benchmarks can now be started from any form.
* Brightness and contrast are now correctly initialized when starting a video.
* When changing into a memory consuming form while playing, it could crash if
  it ran out of memory. Now it just fails to display the images that failed
  to load.
* The T3 (OS5.2.1) was very unstable when using the low-res versions of the
  built-in fonts. I now use "real" fonts and the problem is gone.
* Playing from internal memory fixed. The protocol is now called "int" instead
  of "hh", so you need to re-add the files to the playlist.
* Some MJPegs without audio track didn't play.
* The song progress meter was too fast for some MJPeg AVIs.
* The repeat and shuffle buttons didn't work right.
* It sometimes crashed when exiting or viewing the settings dialog. This was
  (probably) caused by an old audio stream that wasn't deleted right when pausing.
  I worked around the problem and haven't seen the crash since.


News in 0.2.2:
==============
* Equalizer, at last! It's limited to 5 bands for now, so if you use one of
  the skins with 10 bands, the last 5 won't show up. We also haven't done much
  testing, measuring frequency response and such. And remember that the eq does
  eat a bit of the CPU when enabled, so you might want to turn it off when
  playing videos and only use it for mp3 listening.
* New memory handling. We used to use dynamic memory for video and audio packet
  buffers, (i.e. the data read from file that is not yet decoded). Since dynamic
  memory is a limited resource, and in some devices very limited, we now use
  storage memory for those buffers. And it's also much more tolerant to low
  memory conditions.
* Two new settings in the Settings dialog (the old Display dialog) can be used
  to set the audio/video packet buffer sizes. Please see the Settings info page
  for more info.
* Fullscreen support for landscape mode UX-40/50.
* MJPeg decoding much better. It's really cool to just shoot a clip, move the
  memory card to the Palm and watch it. I've seen some strange looking
  coloration in some videos but haven't had time to look at it. And as always,
  we're always interested in clips that fails to play, especially for MJPeg
  clips since those are meant to be played without re-encoding.
* The playlist advance for songs was lost in 0.2.1. It should now skip to the
  next song when done playing a song.


News in 0.2.1:
==============
* Faster startup time. Initialization code is now executed in ARM mode.
* Stability has been improved. It's still possible to make it crash but it's
  not as easy as before.
* Seeking in long movies is now possible. An overflow bug has been fixed.
  However, when starting a long movie, the index part of the file gets really
  large. A 2h movie can have a 8MB index that can take ~20 seconds to read. So,
  when you press play, it will take ~20 seconds for the movie to start.
* Skin graphics are now stored in storage memory instead of wasting precious
  dynamic memory. This also makes form switching faster since the bitmaps are
  kept in memory between form switches.
* ~10% better performance. (Actually, it should be back to the 0.1.5b performance
  now. An old optimization was somehow lost around 0.1.6)
* Clie support restored. It was temporarily lost in 0.2.0. Also, some Clies have
  problems opening files on VFS volumes with the LeaveOpen flag set. This flag is
  used to be able to do background play. If this problem is detected, the file is
  opened without that flag instead. The only drawback is that background play is
  disabled.
* Font handling. There's a new font rendering engine. It's currently only used
  for trialware nagging but a future version will use it for subtitles.


News in 0.2.0:
==============
New skin system. Please read the skin development guide on the Skins page for
more information about how to make skins. The basics are:

* Skins are defined in an XML-file.
* The three forms (Main, Playlist and Prefs) that existed in pre 0.2.0 are gone.
  The skin developer has complete control over the number of forms and what buttons
  and other controls to put on those forms. Formlink controls are used to move
  from one form to another.
* There's a new 1/2 zoom mode that skin developers can use to define a small area
  for video rendering. This way, more controls can be placed on the same form as
  the video area. The full screen toggling is of course still available.
* A form can have an audio area which is only visible when audio songs are played.
  Song information info can be included here, but also bitmaps and other controls.
* Pictures are included in the XML file as base64 encoded text. GIF and JPG
  pictures are supported.

The lipsync has been reworked some. It's not perfected but should be more
tolerant to different audio preload settings.

Added a small icon after repeated complaints. :)




News in 0.1.7:
==============
Clie support with sound. The sound support is limited to 8kHz mono since this
is the only API Sony has made public. You also need to encode the audio to this
sampling frequency because we haven't implemented resampling yet. Many thanks to
Jean-Baptiste Poljak for making this possible.

Brightness and contrast. There are two new sliders on the prefs form (not yet
added to the wood skin though) with which you can set the brightness and contrast.

Smoother frame rates. We've implemented yet another lipsync engine that shouldn't
be as jerky as the former. Good lipsync still requires preload set to 0 though.
A new indicator has been added that indicates how much the frame rate regulator
tries to increase or decrease the frame rate in order to keep the video in sync
with the audio.

No default B-frame skipping. In older versions, B-frames was always skipped
when the resolution was larger than 160x160. 0.1.7 only skips B-frames when it
needs to. So, users with T|C and overclocked Clies can probably enjoy 320x240
in ~25 FPS.


News in 0.1.6b:
===============
We tried a new threading scheme in 0.1.6 which proved to work bad for Zire 71.
The approach for 0.1.6b is a mixture of 0.1.5 and 0.1.6 and should work better.
The lipsync was implemented in a bit of a hurry but it works ok on the samples
I've tried. It does depend on the right amount of audio preload, so the 500ms
that is the default value in VirtualDub works for me.

I also had a little time to work on Clie support, so 0.1.6b can play videos in
benchmark mode (without sound) on OS5 Clies. Fullscreen is supported by hiding
the silkscreen area. Clie users can also start a video with the play button and
seek with the seek slider.


News in 0.1.6:
==============
It's now possible to seek in AVI files. Just drag the slider in the main form.
The seek function works best if the AVI file has an index (which is fairly
common). This index contains pointers to all keyframes and MMPlayer jumps directly
to these when seeking. If no index is present, it has to find the next packet,
then search all packets in sequence until it finds a keyframe.

Bookmarks has been added. Use "Bookmarks->Mark here" to add a bookmark. Use the
"Bookmarks->Edit..." dialog to edit them and next/prev to jump between them.
The Bookmark edit form is buggy but it works if you don't edit too much at a time.
Bookmarks are only available when the media is on memory card. The bookmarks are
written to a file with the same name as the media file but with the extention .bkm.
(Unregistered users can have a maximum of 3 bookmarks)

The audio/video synchronization has been redesigned (again), hopefully for the
last time. I didn't have time to trim it though so the video seems to lag just
a little bit. But it seldom gets any more than "a little bit".


News in 0.1.5b:
===============
It should really run good on Zire 71 now. 0.1.5 had a bug that caused MMPlayer
to pause 1/2 second when some frames had been rendered. On the T|T, we got away
with the bug but the Zire's newer OS 5.2 had obviously fixed this.

It also runs on the Tungsten|C now.

Some statistics values are added to the statistics form.

Mpeg movies should play ok again now. But to be honest, MMPlayer is much better
on DivX.


News in 0.1.5:
==============

There's a new 4/3 zoom mode that zooms from i.e. 240x180 to 320x240. There's no
need to activate it, you can't shut it off.

A great deal of optimizations have been done. It's hard to put a number on
exactly how much since 0.1.4 didn't have a benchmark mode but one video runs
now with 31.1% idle time compared to 11.1% with 0.1.4.

It runs much better on Zire 71. Some tests have been done and it's hard to see
any conclusive difference between a T|T and a Zire 71.

0.1.5 should have better "lipsync". I.e. the sound of someone yelling "No" will
coincide better with the video.

If you have trouble encoding a video and get video artifacts or sound clips,
you might want to enable the buffer indicators. They are enabled in the Display
dialog (Options->Display on the main form). The upper one shows the lenght of
decoded data in the audio buffer, if this reaches the left side of the screen,
you'll probably get an audio clip. The lower one shows the number of video
packets in the video queue and if this goes too far to the right, you're loosing
video packets and the video will look awful.

0.1.5 tries to keep the decoded audio buffer full at all costs, even if it means
throwing away old video packets. The alternative, to pause the audio decoding,
is just as bad. Both alternatives means that the video is encoded with a too
high overall bitrate/quality and you need re-encode with a lower setting.

MMPlayer 0.1.5 also skips B-frames for videos larger than 160x160. This means
that if you've encoded a video with B-frames (Bidirectional encoding), it will
(probably) run at half the frame rate. In a future version, this skipping of
B-frames, and skipping of other types of rendering, will be dynamic. But in
0.1.5 it's predefined.

The statistics dialog does not display many values anymore, not even for T|Ts.
The reason is that the clock we use is probably the reason why the T|C crashes
when running MMPlayer, we will add other good measurments on that page later.
