About the Facelifting How-To: Difference between revisions
No edit summary |
|||
(5 intermediate revisions by 2 users not shown) | |||
Line 1: | Line 1: | ||
{{Article | |||
|Author=[[Tim Mecking]] | |||
|Date= | |||
|OS=OS/2 Warp 4.x / eComStation 1.x | |||
|File=N/A | |||
|Source= | |||
}} | |||
This document is about optical enhancement of OS/2 and eComStation. There may be a functional enhancements as side effect. But functional enhancements are not in the focus of this document. | |||
In this release there is a bundled application called "Theme Creator". More applications may be contained in future releases. | |||
There is only the Window Themes chapter completed, yet. Other chapters will follow. | |||
There is only the Window Themes chapter completed, yet. Other chapters will follow. | |||
==Authors and Contributors== | ==Authors and Contributors== | ||
This document, the themecreator, and the radio button bitmap of the spflat theme is written/created by Tim Mecking ("facelift@mecking.net"). | This document, the themecreator, and the radio button bitmap of the spflat theme is written/created by Tim Mecking ("facelift@mecking.net"). | ||
The dtaltair and the dtbbox theme are created by Dorothee Tops. | The dtaltair and the dtbbox theme are created by Dorothee Tops. | ||
==eComStation ThemeMrg Window Themes== | ==eComStation ThemeMrg Window Themes== | ||
This chapter shows how to build and install themes for eComstation ThemeMgr. | This chapter shows how to build and install themes for eComstation ThemeMgr. | ||
[[Image:006_L1_eComStationThemeMgrW_0.png]] | [[Image:006_L1_eComStationThemeMgrW_0.png]] | ||
===Requirements=== | ===Requirements=== | ||
* eComStation 1.0 or eComStation 1.1 | * eComStation 1.0 or eComStation 1.1 | ||
* ThemeMgr (*) | * ThemeMgr (*) | ||
* IconEdit (*) or any other pixel oriented graphic application supporting multi page | * IconEdit (*) or any other pixel oriented graphic application supporting multi page OS/2 bitmaps. | ||
* ResMgr by Martin Lafaix (*) | * ResMgr by Martin Lafaix (*) | ||
* Resource Compilter RC.EXE (*) | * Resource Compilter RC.EXE (*) | ||
* System Editor E.EXE (*), Extended Editor EPM.EXE (*) or any other ascii editor. | * System Editor E.EXE (*), Extended Editor EPM.EXE (*) or any other ascii editor. | ||
(*) included in eComStation 1.0 and eComStation 1.1 | (*) included in eComStation 1.0 and eComStation 1.1 | ||
===Working with Themes - Command line based=== | ===Working with Themes - Command line based=== | ||
Here we discuss in detail the creation & installation of a new theme based on an existing one and how to uninstall schemes from Thememgr. If you are not interested in the details take a look at "Working With Themes - Theme Creator Based". | |||
A Theme is created by creating the following 3 files: | |||
* .RES File | |||
A Theme is created by creating the following 3 files: | * .BMP File | ||
* .IDX File | |||
* .RES File | If you have created the files, you can install them to make them available in the Theme Manager. | ||
* .BMP File | |||
* .IDX File | |||
If you have created the files, you can install them to make them available in the Theme Manager. | |||
You certainly can also uninstall themes from the Theme Manager. | You certainly can also uninstall themes from the Theme Manager. | ||
====Creating the .RES file==== | ====Creating the .RES file==== | ||
Line 45: | Line 47: | ||
In eComStation 1.0: | In eComStation 1.0: | ||
[E:\]cd os2\thememgr | [E:\]cd os2\thememgr | ||
[E:\os2\thememgr]md t | [E:\os2\thememgr]md t | ||
[E:\os2\thememgr]cd t | [E:\os2\thememgr]cd t | ||
[E:\os2\thememgr\t]unzip ..\thmres.zip | [E:\os2\thememgr\t]unzip ..\thmres.zip | ||
In eComStation 1.1: | In eComStation 1.1: | ||
[E:\]cd ecs\system\thememgr | [E:\]cd ecs\system\thememgr | ||
[E:\ecs\system\thememgr]md t | [E:\ecs\system\thememgr]md t | ||
[E:\ecs\system\thememgr]cd t | [E:\ecs\system\thememgr]cd t | ||
[E:\ecs\system\thememgr\t]unzip ..\thememgr.zip | [E:\ecs\system\thememgr\t]unzip ..\thememgr.zip | ||
Decompile the .res file you want to modify. If you only know the name of the theme as it shows in thememgr grep it from thememgr.idx. | Decompile the .res file you want to modify. If you only know the name of the theme as it shows in thememgr grep it from thememgr.idx. | ||
[E:\ecs\system\thememgr\t]find /I "eComStation - Flat" ..\thememgr.idx | [E:\ecs\system\thememgr\t]find /I "eComStation - Flat" ..\thememgr.idx | ||
---------- ..\thememgr.idx | ---------- ..\thememgr.idx | ||
eComStation - Flat flat.dll flat.bmp | eComStation - Flat flat.dll flat.bmp | ||
To decompile the .res file (which name is equal to the name of the .dll listed in thememgr.idx) use the rdc command from resmgr. | To decompile the .res file (which name is equal to the name of the .dll listed in thememgr.idx) use the rdc command from resmgr. | ||
[E:\ecs\system\thememgr\t]rdc flat.res | [E:\ecs\system\thememgr\t]rdc flat.res | ||
A lot of bitmap files will be created. Modify these files now. Don't change the size, the color palette and the number of pages. PMView can not be used, because it doesn't support multi page bitmaps and also changes the color palette under certain circumstances. I recommend the System's own Icon Editor. | A lot of bitmap files will be created. Modify these files now. Don't change the size, the color palette and the number of pages. PMView can not be used, because it doesn't support multi page bitmaps and also changes the color palette under certain circumstances. I recommend the System's own Icon Editor. | ||
If you are done, rename the .rc2 file to the short name of your new theme. The short name should not be more than 8 characters long (excluding the file extension) to prevent problems on systems installed on a FAT partition. | If you are done, rename the .rc2 file to the short name of your new theme. The short name should not be more than 8 characters long (excluding the file extension) to prevent problems on systems installed on a FAT partition. | ||
[E:\ecs\system\thememgr\t]ren flat.rc2 spFlat.rc2 | [E:\ecs\system\thememgr\t]ren flat.rc2 spFlat.rc2 | ||
Compile the .rc2 file using RC.EXE | Compile the .rc2 file using RC.EXE | ||
[E:\ecs\system\thememgr\t]rc -r spFlat.rc2 | [E:\ecs\system\thememgr\t]rc -r spFlat.rc2 | ||
===Creating the .BMP File=== | ===Creating the .BMP File=== | ||
Copy a bitmap from an existing theme and replace the buttons by the ones used in your theme. For this step I | Copy a bitmap from an existing theme and replace the buttons by the ones used in your theme. For this step I recommend the Icon Editor, too. (Open it twice and use the clipboard.) | ||
[E:\ecs\system\thememgr\t]copy ..\flat.bmp spFlat.bmp | [E:\ecs\system\thememgr\t]copy ..\flat.bmp spFlat.bmp | ||
===Creating the .IDX File=== | ===Creating the .IDX File=== | ||
The last file to create is an .IDX file. Copy the thememgr.idx and name it like your .RES file, but leave the extension .IDX. | The last file to create is an .IDX file. Copy the thememgr.idx and name it like your .RES file, but leave the extension .IDX. | ||
[E:\ecs\system\thememgr\t]copy ..\thememgr.idx spFlat.idx | [E:\ecs\system\thememgr\t]copy ..\thememgr.idx spFlat.idx | ||
Remove all lines except the last one. Remove the semicolon at the beginning of the line and enter the long name of your theme in the first column (use overwrite mode), the short name of your theme with the extension .DLL appended in the second column. In the third column enter the short name followed by the extension .BMP. | |||
Remove all lines except the last one. Remove the semicolon at the beginning of the line and enter the long name of your theme in the first | |||
spTim - Flat spflat.dll spflat.bmp | spTim - Flat spflat.dll spflat.bmp | ||
===Installation of themes=== | ===Installation of themes=== | ||
Make shure the .IDX, the .BMP, and the .RES file of the theme to be installed are placed in the Theme Manager directory. | |||
Open a command prompt window, go to the ThemeMgr directory, and start addtheme <shortname>. | Open a command prompt window, go to the ThemeMgr directory, and start addtheme <shortname>. | ||
In eComStation 1.0: | In eComStation 1.0: | ||
[E:\]cd os2\thememgr | [E:\]cd os2\thememgr | ||
[E:\os2\thememgr]addtheme spFlat | [E:\os2\thememgr]addtheme spFlat | ||
In eComStation 1.1: | In eComStation 1.1: | ||
[E:\]cd ecs\system\thememgr | [E:\]cd ecs\system\thememgr | ||
[E:\ecs\system\thememgr]addtheme spFlat | [E:\ecs\system\thememgr]addtheme spFlat | ||
===Deinstallation of themes=== | ===Deinstallation of themes=== | ||
To uninstall a theme remove the | To uninstall a theme remove the corresponding line from thememgr.idx, located in the Theme Manager directory. You should also delete the .DLL file. | ||
Open a command prompt window, go to the ThemeMgr directory, remove the line containing the theme definition from thememgr.idx, and delete the .DLL file. | |||
[E:\]cd os2\thememgr | [E:\]cd os2\thememgr | ||
[E:\os2\thememgr]copy thememgr.idx thememgr.bak | [E:\os2\thememgr]copy thememgr.idx thememgr.bak | ||
Line 118: | Line 100: | ||
[E:\os2\thememgr]del thememgr.bak | [E:\os2\thememgr]del thememgr.bak | ||
[E:\os2\thememgr]del spFlat.dll | [E:\os2\thememgr]del spFlat.dll | ||
In eComStation 1.1: | In eComStation 1.1: | ||
[E:\]cd ecs\system\thememgr | [E:\]cd ecs\system\thememgr | ||
[E:\ecs\system\thememgr]copy thememgr.idx thememgr.bak | [E:\ecs\system\thememgr]copy thememgr.idx thememgr.bak | ||
Line 130: | Line 110: | ||
Here we discuss how to use the Theme Creator. A GUI tool to unpack, pack, install, and uninstall themes. | Here we discuss how to use the Theme Creator. A GUI tool to unpack, pack, install, and uninstall themes. | ||
[[image:014_L2_WorkingWithThemesThe_1.png]] | |||
Theme Creator is bundled with this How-To, thus you should already have this tool. | Theme Creator is bundled with this How-To, thus you should already have this tool. | ||
===Creating A Theme=== | ===Creating A Theme=== | ||
* Start Theme Creator | |||
[[image:014_L2_WorkingWithThemesThe_1.png]] | |||
* Select the "Unpack" Button. | * Select the "Unpack" Button. | ||
* A new theme is created by modifying an existing one. Select the theme to be modified. You also have to specify the target directory. The directory doesn't need to exist, but if it exists, it must be empty. | |||
[[image:015_L3_CreatingATheme_3.png]] | |||
* A lot of bitmap files will be created. Modify these files now. Don't change the size, the color palette and the number of pages. PMView can not be used, because it doesn't support multi page bitmaps and also changes the color palette under certain circumstances. I recommend the System's own Icon Editor. | * A lot of bitmap files will be created. Modify these files now. Don't change the size, the color palette and the number of pages. PMView can not be used, because it doesn't support multi page bitmaps and also changes the color palette under certain circumstances. I recommend the System's own Icon Editor. | ||
* Select the "Pack" Button. | * Select the "Pack" Button. | ||
* Make sure that the right directory is specified (the directory which contains the modified theme files). Enter a short name which is up to 8 characters long. Only FAT compatible names without extensions may be used. Also specify a long name. Click the "Pack" Button when done. | |||
* Make | |||
* The theme is now created and moved into the thememgr directory. It consists of the following files: | * The theme is now created and moved into the thememgr directory. It consists of the following files: | ||
**<ShortName>.RES | **<ShortName>.RES | ||
**<ShortName>.BMP | **<ShortName>.BMP | ||
**<ShortName>.IDX | **<ShortName>.IDX | ||
[[image:015_L3_CreatingATheme_4.png]] | |||
===Installing A Theme=== | ===Installing A Theme=== | ||
* Start Theme Creator | * Start Theme Creator | ||
[[image:014_L2_WorkingWithThemesThe_1.png]] | |||
* Select the "Install" Button. | * Select the "Install" Button. | ||
* The theme still has to be installed in thememgr. While installing, a .DLL is build and the theme is added to the THEMEMGR.IDX. | * The theme still has to be installed in thememgr. While installing, a .DLL is build and the theme is added to the THEMEMGR.IDX. | ||
* All themes found in the Theme Manager directory which are not currently installed will be listed. Select the one to be installed and click on the "Install" Button. | |||
[[image:016_L3_InstallingATheme_6.png]] | |||
* The new theme is ready for usage. Just start the Theme Manager, select your theme and reboot your machine. | * The new theme is ready for usage. Just start the Theme Manager, select your theme and reboot your machine. | ||
Line 166: | Line 149: | ||
===Uninstalling A Theme=== | ===Uninstalling A Theme=== | ||
* Start Theme Creator | * Start Theme Creator | ||
[[image:014_L2_WorkingWithThemesThe_1.png]] | |||
* Click the "Uninstall" Button. | * Click the "Uninstall" Button. | ||
* A list of all installed themes is shown. | * A list of all installed themes is shown. | ||
* Select the theme to be uninstalled and click on the "Uninstall" button. | |||
[[image:017_L3_UninstallingATheme_8.png]] | |||
==Chapters to be written== | ==Chapters to be written== | ||
Line 177: | Line 162: | ||
Right now the following topics are on my list: | Right now the following topics are on my list: | ||
* Scheme Palettes | * Scheme Palettes | ||
* Styler/2 & eStylerLite | * Styler/2 & eStylerLite |
Latest revision as of 05:09, 10 August 2021
Article Info | |
---|---|
Author | Tim Mecking |
Date | |
OS Version | OS/2 Warp 4.x / eComStation 1.x |
Companion File | N/A |
Source |
This document is about optical enhancement of OS/2 and eComStation. There may be a functional enhancements as side effect. But functional enhancements are not in the focus of this document.
In this release there is a bundled application called "Theme Creator". More applications may be contained in future releases.
There is only the Window Themes chapter completed, yet. Other chapters will follow.
Authors and Contributors
This document, the themecreator, and the radio button bitmap of the spflat theme is written/created by Tim Mecking ("facelift@mecking.net").
The dtaltair and the dtbbox theme are created by Dorothee Tops.
eComStation ThemeMrg Window Themes
This chapter shows how to build and install themes for eComstation ThemeMgr.
Requirements
- eComStation 1.0 or eComStation 1.1
- ThemeMgr (*)
- IconEdit (*) or any other pixel oriented graphic application supporting multi page OS/2 bitmaps.
- ResMgr by Martin Lafaix (*)
- Resource Compilter RC.EXE (*)
- System Editor E.EXE (*), Extended Editor EPM.EXE (*) or any other ascii editor.
(*) included in eComStation 1.0 and eComStation 1.1
Working with Themes - Command line based
Here we discuss in detail the creation & installation of a new theme based on an existing one and how to uninstall schemes from Thememgr. If you are not interested in the details take a look at "Working With Themes - Theme Creator Based".
A Theme is created by creating the following 3 files:
- .RES File
- .BMP File
- .IDX File
If you have created the files, you can install them to make them available in the Theme Manager.
You certainly can also uninstall themes from the Theme Manager.
Creating the .RES file
To create a new theme based on an existing one open a command prompt window, go to the ThemeMgr directory, create a new subdirectory and unzip the thmres.zip into it.
In eComStation 1.0:
[E:\]cd os2\thememgr [E:\os2\thememgr]md t [E:\os2\thememgr]cd t [E:\os2\thememgr\t]unzip ..\thmres.zip
In eComStation 1.1:
[E:\]cd ecs\system\thememgr [E:\ecs\system\thememgr]md t [E:\ecs\system\thememgr]cd t [E:\ecs\system\thememgr\t]unzip ..\thememgr.zip
Decompile the .res file you want to modify. If you only know the name of the theme as it shows in thememgr grep it from thememgr.idx.
[E:\ecs\system\thememgr\t]find /I "eComStation - Flat" ..\thememgr.idx ---------- ..\thememgr.idx eComStation - Flat flat.dll flat.bmp
To decompile the .res file (which name is equal to the name of the .dll listed in thememgr.idx) use the rdc command from resmgr.
[E:\ecs\system\thememgr\t]rdc flat.res
A lot of bitmap files will be created. Modify these files now. Don't change the size, the color palette and the number of pages. PMView can not be used, because it doesn't support multi page bitmaps and also changes the color palette under certain circumstances. I recommend the System's own Icon Editor.
If you are done, rename the .rc2 file to the short name of your new theme. The short name should not be more than 8 characters long (excluding the file extension) to prevent problems on systems installed on a FAT partition.
[E:\ecs\system\thememgr\t]ren flat.rc2 spFlat.rc2
Compile the .rc2 file using RC.EXE
[E:\ecs\system\thememgr\t]rc -r spFlat.rc2
Creating the .BMP File
Copy a bitmap from an existing theme and replace the buttons by the ones used in your theme. For this step I recommend the Icon Editor, too. (Open it twice and use the clipboard.)
[E:\ecs\system\thememgr\t]copy ..\flat.bmp spFlat.bmp
Creating the .IDX File
The last file to create is an .IDX file. Copy the thememgr.idx and name it like your .RES file, but leave the extension .IDX.
[E:\ecs\system\thememgr\t]copy ..\thememgr.idx spFlat.idx
Remove all lines except the last one. Remove the semicolon at the beginning of the line and enter the long name of your theme in the first column (use overwrite mode), the short name of your theme with the extension .DLL appended in the second column. In the third column enter the short name followed by the extension .BMP.
spTim - Flat spflat.dll spflat.bmp
Installation of themes
Make shure the .IDX, the .BMP, and the .RES file of the theme to be installed are placed in the Theme Manager directory.
Open a command prompt window, go to the ThemeMgr directory, and start addtheme <shortname>.
In eComStation 1.0:
[E:\]cd os2\thememgr [E:\os2\thememgr]addtheme spFlat
In eComStation 1.1:
[E:\]cd ecs\system\thememgr [E:\ecs\system\thememgr]addtheme spFlat
Deinstallation of themes
To uninstall a theme remove the corresponding line from thememgr.idx, located in the Theme Manager directory. You should also delete the .DLL file.
Open a command prompt window, go to the ThemeMgr directory, remove the line containing the theme definition from thememgr.idx, and delete the .DLL file.
[E:\]cd os2\thememgr [E:\os2\thememgr]copy thememgr.idx thememgr.bak [E:\os2\thememgr]find /V /I " spFlat.dll" <thememgr.bak >thememgr.idx [E:\os2\thememgr]del thememgr.bak [E:\os2\thememgr]del spFlat.dll
In eComStation 1.1:
[E:\]cd ecs\system\thememgr [E:\ecs\system\thememgr]copy thememgr.idx thememgr.bak [E:\ecs\system\thememgr]find /V /I " spFlat.dll" <thememgr.bak >thememgr.idx [E:\ecs\system\thememgr]del thememgr.bak [E:\ecs\system\thememgr]del spFlat.dll
Working With Themes - Theme Creator Based
Here we discuss how to use the Theme Creator. A GUI tool to unpack, pack, install, and uninstall themes.
Theme Creator is bundled with this How-To, thus you should already have this tool.
Creating A Theme
- Start Theme Creator
- Select the "Unpack" Button.
- A new theme is created by modifying an existing one. Select the theme to be modified. You also have to specify the target directory. The directory doesn't need to exist, but if it exists, it must be empty.
- A lot of bitmap files will be created. Modify these files now. Don't change the size, the color palette and the number of pages. PMView can not be used, because it doesn't support multi page bitmaps and also changes the color palette under certain circumstances. I recommend the System's own Icon Editor.
- Select the "Pack" Button.
- Make sure that the right directory is specified (the directory which contains the modified theme files). Enter a short name which is up to 8 characters long. Only FAT compatible names without extensions may be used. Also specify a long name. Click the "Pack" Button when done.
- The theme is now created and moved into the thememgr directory. It consists of the following files:
- <ShortName>.RES
- <ShortName>.BMP
- <ShortName>.IDX
Installing A Theme
- Start Theme Creator
- Select the "Install" Button.
- The theme still has to be installed in thememgr. While installing, a .DLL is build and the theme is added to the THEMEMGR.IDX.
- All themes found in the Theme Manager directory which are not currently installed will be listed. Select the one to be installed and click on the "Install" Button.
- The new theme is ready for usage. Just start the Theme Manager, select your theme and reboot your machine.
Uninstalling A Theme
- Start Theme Creator
- Click the "Uninstall" Button.
- A list of all installed themes is shown.
- Select the theme to be uninstalled and click on the "Uninstall" button.
Chapters to be written
Depending on the feedback I'll receive, I plan to write some additional chapters and tools.
Right now the following topics are on my list:
- Scheme Palettes
- Styler/2 & eStylerLite
- Icons & Icon Themes