This file contains the change history of the releases

+ means new feature
* mean changed feature
- means bugfix
- [H10 5/6G] describes a change that only affect one type of firmware, in this
  example a bugfix for H10 5/6 G firmware only


Version 2.7.2652, 2007/04/06
=================================================================================
+ [Sansa] Little fix in string dialog: not possible to enter more than the 
  allowed number of letters any more

Version 2.7.2647, 2007/04/02
=================================================================================
+ [Sansa] Initial string support. For now, just the strings that allow to create
  the coveted textless menu

Version 2.7.2640, 2007/03/25
=================================================================================
- Fix for systems with high screen resolution and large fonts, all dialogs
  should now scale properly. Maybe a few pixel off, but much better than before
- [S10] Preview (and possibly themeing) of many icons was corrupted

Version 2.7.2626, 2007/03/11
=================================================================================
- loading themes shows the summary window again
+ animation in preview, affects Sansa, S10 and T10. Note that this is for the
  device preview only, not for the poster!
* [Sansa] preview for most screens, thanks to zippererSolutions


Version 2.7.2624, 2007/03/09
=================================================================================
- [Sansa] Saving Rhapsody firmware works


Version 2.7.2623, 2007/03/08
=================================================================================
+ [Sansa] Support for e200 Rhapsody firmware: all images bookmarked,
  Preview still needs to be adapted
- [Sansa] Preview works again for firmware without font support (i.e. all but 1.02.15)


Version 2.7.2606, 2007/02/19
=================================================================================
+ command line options for batch operation (see help file for details)
+ [insignia] Experimental support for DVxG: only a few icons, no real preview,
  no version recognition


Version 2.7.2596, 2007/02/9
=================================================================================
- [Sansa] Exit animations are back
* [Sansa] Full support for 1.02.15F firmware (gray Sansa logo was missing)


Version 2.7.2577, 2007/01/21
=================================================================================
- [Sansa] Reset fonts works properly
- [Sansa] font support for 1.01 versions removed: fixing the bug there, too
  would be too much effort.


Version 2.7.2563, 2006/01/07
=================================================================================
+ Loader detects .NET problems when starting. Maybe that stops a few of the
  ever repeating noob questions...
+ support for 16bit RGB little endian images, as implemented by latest Sansa
  firmware
* [Sansa] Initial support for firmware version 1.03.01: can be loaded, and
  searching the images (in 16 bit little endian mode) is possible
- Somewhat more user friendly dialog after finishing theme import, and some
  enhanced error messages
- Stability in case of problems improved a bit


Version 2.7.2553, 2006/12/28
=================================================================================
* [S10] Support for firmware version 1.03
* [S10] Renamed several bookmarks, now that I know what they are
        Note: this means you need to rename any images you may have in a theme
* [S10] a few small fixes in preview
- [S10] EQ bars had wrong size


Version 2.7.2536, 2006/12/10
=================================================================================
- Images with wrong size could cause theme packs to crash


Version 2.7.2535, 2006/12/10
=================================================================================
* [Sansa] support for 1.02.15 firmware
  This affects the fonts:
  * "Latin Extended 1/2" has changed o much that it was replaced by "Latin Extended 1/2.1"
  * New fonts Cyrillic, Russian, Hebrew

Version 2.7.2524, 2006/11/29
=================================================================================
- Themes for T10 couldn't be loaded any more: claimed to be for the U3


Version 2.7.2520, 2006/11/25
=================================================================================
+ Full S10 support, including many preview screens, 1.01 and 1.02 firmware
+ H300 firmware 1.31K supported, including mine sweeper images
+ [T10/S10] Transparency in images works regardless where in the palette the
  pink is located.
* performance improvement when loading firmware
* some performance improvement when replacing fonts
* 4 bit images can have odd widths (only 2, 4,... had been possible before)
* Starting a new installation will not open Quickref and Zoom Window any more
* [Sansa e200] three new horizontal lines images
* [T10] 36 new images. I slightly reorganised the groups, but that does not stop
  existing themes from working.
  - For radio firmware (thanks to Demimurych)
    Lock 3
    Preset Squares (4)
    Blue Dot (probably unused, disappeared in 1.73)
    Wide Arrow (probably unused, disappeared in 1.73)
  - for settings dialogs
    Purple Border (4)
    Arrows (4)
  - Progress Bars (6, each 3 images)
  - Scroll bar for Browser and Settings
* [T10] the two checkboxes and Preset from Radio are one pixel narrower.
  That doesn't have any effects on existing themes, just ignore the size warning.
* [T10] Added scroll bars and a few dialogs to the preview; small preview fixes.
* [S10/T10/X5] Hide Bookmarks now also hides image headers, leaving completely
  black areas where images used to be. Makes searching easier, as the many new
  T10 images prove
* [H300] preview screens for mine sweeper
- crash when loading unknown firmware
- file isn't long enough... bug fixed. Again. That one keeps returning.
- Hide Bookmarks was hiding a bit too much, especially after fonts.


Version 2.6.2492, 2006/10/28
=================================================================================
+ [Sansa e200] first implementaion of support for font changing. This required
  quite massive changes in the font handling, hopefully not breaking any
  of the existing firmwares...
+ Preview now supports the display of rotated images, the online tutorial is 
  updated
* [Sansa e200] version 1.02.12A supported: this adds a new set of pictures
  for the battery loading screen and changes "Icon Charging"
* [Sansa e200] previews updated with firmware fonts instead of Arial.
  They might be the wrong size, I'd need a Sansa to test this.
* [H10] preview now displays progress bars correctly, as far as I can
  guess what they
- [T10] replacing fonts sometimes caused an error message about unknown firmware


Version 2.6.2467, 2006/10/03
=================================================================================
+ H300 firmware 1.30E supported
* Sansa e200: 4 new preview screens added
* Sansa Theme creators beware: 3 images changed size: Status Bar Black,
  Status Bar Blue, Status Bar Light Blue 2 are now all 23 pixels high
* Sansa: Horizontal Strip Blue, Horizontal Strip Grey and Vertical Strip Blue have
  been removed: they form the extra lines below the bars mentioned above
* Sansa: The unknown vertical strips have been made horizontal, based on the
  assumption that a 176 image on a 176 wide screen makes more sense in that orientaion
- more robust loading of pictures that are the wrong size (smaller pictures now
  load fine, overlaying the original picture)


Version 2.6.2437, 2006/09/03
=================================================================================
* Sansa e200 version 1.01.11A support (Horizontal Scale Grey is found)
- multiple occurrences of an identical image are found (affected Play button 3 in
  the Sansa firmware)


Version 2.6.2423, 2006/08/20
=================================================================================
+ Sansa e200 bookmarks for 170 images
+ Support for adding text to preview, when no font is marked in firmware


Version 2.6.2411, 2006/08/08
=================================================================================
- Loading themepacks caused an error message about wrong product version



Version 2.6.2409 news:

H10 users
=================================================================================
Added images
--------------------------------------------------------------------------------
Group Settings
      Settings P (only 5/6 G firmware)
Group Music
      Music Progress Bar Left
      Music Progress Bar Middle
      Music Progress Bar Right

Modified images
--------------------------------------------------------------------------------
Group Radio
     Stereo off resized to 39x7
Group Music
     Scrollbar resized to 4x105

Removed images
--------------------------------------------------------------------------------
Group Settings
     Settings Dot

- Fixed "this may fry your player" message. Everything had be OK, just had to make
  the checking function less paranoid to accomodate for the encryption algorithm.
- Preview for 5/6 G firmware thanks to mykel--

Version 2.5.2398 news:

All users
=================================================================================
Drag and drop support:
- a folder will do the same as Theme/Import images
- a h3theme or h3skin file will do the same as Theme/Load Pack
- a bmp/gif/png file will do the same as Bitmap/Load followed by Bitmap/Copy to Firmware
- any other file will do the same as Firmware/Load
- possible to load .h3skin files again (old format, had been accidentally dropped)

H10 users
=================================================================================
This is the first version that can encrypt and sign H10 mi4 firmware. That means
you can use it without any extra steps by mi4code, just like any other firmware
type.
I also added the images and bookmarks required to handle MTP, UMS, and Pure
flavours of 5/6G firmware.

Version 2.4.2392/2393 news:

T10 users
=================================================================================
can handle 1.72 firmware


Version 2.4.2392/2393 tips:

All users
=================================================================================
Window positions are remembered again after closing the app

H10 users
=================================================================================
checksums are now updated, but it's probably still impossible to update a player.
.rom/.hex files need to be patced, too, and that's still researched.


Version 2.4.2388 tips:

All users
=================================================================================
The behaviour of the "Create Theme Pack" dialog has slightly changed: you can
now select both the images folder and the location of the resulting theme pack.
The old dialog was too confusing.

H10 users
=================================================================================
mi4 support is still experimental! Read the H10 section of the helpfile for
details.


Version 2.4.2346 tips:

All users
=================================================================================
- "Skins" have been renamed to "Themes", to avoid confusion with inSkins and
  similar hardware modifying skins. In the process I discovered a possible bug:
  themes (or then, skins) saved with recent versions can't be opened again. This
  should be OK now.
- All settings are stored to an xml file now, called H3ModSettings.xml now, in
  the same folder as the .exe. The Registry is not used any longer, you can delete
  HKEY_CURRENT_USER\Software\H3Mod

  ATTENTION: This means that all previous settings are lost, so check the options
  dialog if there is anything you need to change again.

- All dialog boxes now contain a recent file list. When you select something from
  that list, it is copied to the file name box. A maximum of 10 files per dialog
  is remembered.
- The help file is updated to explain about font width adjustments, and with two
  tutorials. It also lists a few things you should keep in mind in the T10 section,
  it's well wort reading it.

T10 users
=================================================================================
Font support has reached something close to perfection. Many fonts (except Korean
and Chinese) can be changed, and you can even use replacement fonts with
different widths. The ideal width can be calculated automatically and ajusted
manually. Thanks to atolonen, theme creator and beta tester extrordinaire!


Version 2.4.2322 tips:

T10 users
=================================================================================
- Much improved T10 support: some glitches in the verification have been fixed,
  that caused the dreaded "this may fry your player" warning, full preview
  function thanks to atolonen, and it's been tested several times and works
- 64K colour images are now handled properly. This concerns 3 pictures in the
  "Other" folder that used to ge gif and need to be changed to png:
  - Purple Bar Thin.png
  - Grey Bar Tiny.png
  - Grey Bar Vertical.png
- There is some rudimentary font support, but only for a few uppercase only
  letters and numbers. The main font still eludes me...


Version 2.4.2244 tips:

T10 users
=================================================================================
- This is the first T10 release. It fully supports all image changing functions,
  quite a big number of images are already predefined.
- Fonts are not yet supported. The format is different than in the H3xx, and I
  will only start the additional work when I get feedback that theming works, and
  somebody is interested in font changing.
- Preview is fully customised, but only contains 2 demo slides.
- It has not been tested on a T10 yet, so I can't say if the checksum algorithm
  is correct. I suppose so, since it works fine with the original images,
  creating exactly the same values as the downloaded original file. Somebody must
  be the first person with a personalised T10 player, your chance to fame!

U3 users
=================================================================================
- This release has preliminary U3 support. You can open data1 and data3 files,
  and one example image is displayed. Works for 1.12 and 1.13, which wasn't too
  easy, believe me :)
- The data1 appears to be the main file; data3 is surprisingly similar, with the
  same images, and in case of 1.13 an older version (it's still 1.12). data2
  contains fonts, mostly. These could be mapped and changed, but it's not worth
  the effort before we know if upgrading is possible, see next item.
- I don't know if the firmware contains checksums. I would not be surprised if
  it does, since many firmwares, including the X5, have it. If yes, you would
  probably not be able to upgrade your player with the modified firmware; the
  X5 reported a checksum error and just refused the file. In that case, it's up
  to some clever people to analyse the firmware. Maybe you can contact the people
  at the X5 forums, somebody there discovered how it works for the X5 and may be
  able to do it again. A guess are bytes 16-29. These are different for all
  files, and are before a fixed header area.
- Somebody needs to try to change the one image and upgrade the player with the
  modified firmware. If that works, we can start full support and image hunting.
  Admittedly, there is a risk of bricking the player, but judging from
  experience, a simple error message from the upgrade tool is more likely.


Image changes in 2.3.2226:

Added images (X5)
--------------------------------------------------------------------------------
Group General
      Volume Fill
      Startup Loading Fill

Fonts
     Latin Numbers 5x5

Modified images
--------------------------------------------------------------------------------
Group Unknown
     Unknown pattern renamed to Text Viewer Pattern
     Little A and Little B moved to folder Status
     Little small b renamed to Bookmarks symbol



Version 2.3 tips:

All users
=================================================================================
- The help file is not updated to the latest changes. Too many other interesting
  things to do :-). But it is still accurate in almost everything, so keep 
  reading it before you post questions.
- press F3 (or select Skin/Poster) to create an image that combines all the
  screens from the preview.
- Bookmark hunters: if you select Bookmarks/Hide, all known bookmarks turn black
  (or white, depending on the image type). This makes it easier to focus on
  uncharted areas instead of redescovering the same things over and over again.
  Thanks to pauljam for the suggestion.

X5 users
=================================================================================
- This is the first proper X5 release. It supports automatic searching of images
  in all firmware versions, no need for external bookmarks.
- The preview, thanks to sepparator, provides 4 screens now. Some fine tuning
  may follow, but it looks good.
- If you get a skin, you can add a folder =External= to the image folders, and
  put a file called "wallpaper.jpg" in it. This will then be displayed as a
  background to the preview of the playing screen. I'm not quite sure how that
  wallpapering works, let me know if the current display makes any sense.



Version 2.2 tips:

X5 users
=================================================================================
- Support is in a very early stage, almost no bookmarks yet, and
  no support for the pictures on the remote.
- All pictures need to be 256 colours and use exactly the same palette.
- bright green (RGB 00FF00) is the transparent colour.
- somebody who has an X5 needs to provide the slides for the preview.
  You can save the test slide for an example file, it's pretty easy
  to understand.
- The firmware is not encrypted, but I recommend using "Load Firmware"
  anyway. That's what I mostly tested, and it has a keyboard shortcut :-)

H10 users
=================================================================================
- MTP files are "encrypted" compared to UMS files, although they may
  look similar. So don't use the "Load Decrypted" function.
- All pictures are 16 bit, so you don't have to worry about palettes, hooray!
- Preview pictures are pixel-precise, as far as I can see. So you should
  be able to see how your icons fit on the backgrounds
- I have no clue how to upgrade, or where to get roms. I just changes
  dem picshus. So please don't ask for general H10 help.

H3xx users
=================================================================================
- You need to resize a picture and add a few new ones. The best way to
  go: Open unmodified hex file, choose Skin/Export Images. Then you have
  all the original images. For each new/changed file, copy the original
  into the theme, using H3Mods warnings as a guide.
  Or you pester the original authors to do it for you ;-) Very politely.
- The Japanese firmware for some reason messed up the fonts. Since it is
  not a very popular version to use, I just can't be bothered to add all
  the changes to the reference file. If you absolutely need to theme 1.29J,
  you have to live with most of the original fonts.

Image changes in 2.2:

Added images
--------------------------------------------------------------------------------
Group Record
      Record Setting Number Box

Group Browse
      Video

Group Functions
      Big Video

Group Play
      Shuffle Mode 1 (I don't know where this is used, but it's been added,
      so I included it in the bookmarks)

Group Remote
      Remote Functions Video

Fonts
     Greek
     Hebrew
     CJK Special

Modified images
--------------------------------------------------------------------------------
Group Browse
      "Text Browse Modes" needs to be resized to 28 x 144 (VIDEO has been
      added at the bottom)

Fonts
     Hiragana
     Katakana (both changed to a more brush-like style)

Removed images
--------------------------------------------------------------------------------
Fonts
     Latin 6x6
     Latin 6x8
     Latin 8x16 (I don't think these were used anyway)






Image changes in 2.1:

Added images
--------------------------------------------------------------------------------
Group Play
      EQ Set
      Clock
      AmPm

Group Browse
      Small Icon Wav

Modified images
--------------------------------------------------------------------------------
Group Play
      "Audio Types" is still used for versions 1.02 to 1.27. For 1.28, it contains
      the WAV type and is called "Audio Types Wav". It is strongly recommended to
      include both images in a skin, so any version can be skinned.






Image changes in 2.0:

Added images
--------------------------------------------------------------------------------
Group Play
      Scroll Handles
      User EQ Bars

Group Record
      Record (1-5): the blue and white box in the background,
      Settings Box (1-5)
      Setting Item

Group Browse
      Scroll Elements Vertical

Group Radio
      FM Tuner
      Point
      Radio 76

Group Settings
      Settings General
      Settings Display
      Settings Timer
      Settings Control
      Settings Mode
      Settings Sound
      Warning

Group Misc
      Battery Small
      Text Firmware Upgrade,
      INFO Box (1-3)
      PicInfo Item
      Volume Speaker

Group Unknown
      Scroll Handle Horizontal
      Up Down Left
      Up Down Middle

Modified images
--------------------------------------------------------------------------------
Group Play
    Folder Open: position in firmware adapted, avoids two black pixels
        appearing after the image in some skins. The image can remain unchanged.
Group Functions
    Functions Scrollbar: same as Folder Open above
Group Unknown
    Unknown Up Down -> renamed for consistency, now called Unknown Up Down Right
    Unknown Oval -> found purpose, now called PicInfo Title in Group Misc
    Volume Unused -> used to be "Volume" in Misc, but is really unused
    Unknown Bar Blue -> size change, now called Unknown Blue Bar
Group Misc
    Tree Elements -> position change, now called Tree Lines. You need to add this
        new image to your skin if you want to change the tree lines.

