| 1 | 1. CW-multimedia classes
|
|---|
| 2 | ------------------------
|
|---|
| 3 |
|
|---|
| 4 | This package is a complete replacement for the
|
|---|
| 5 | multimedia classes coming with MMOS2. The convert menu
|
|---|
| 6 | is enhanced and the image classes are more robust WRT
|
|---|
| 7 | broken image files or buggy IO-procs. The limitations
|
|---|
| 8 | of the JPG-IO proc are still there. This procedure crashes
|
|---|
| 9 | on some images and the only way to resolve is a restart of
|
|---|
| 10 | the WPS. To overcome this limitiation a new JPGIO-IO procedure
|
|---|
| 11 | is included.
|
|---|
| 12 |
|
|---|
| 13 | New classes are for seemless integration of the
|
|---|
| 14 | MMIO procedures for MP3 and OGG files written by
|
|---|
| 15 | Russel O'Connor.
|
|---|
| 16 | Get these procedures from:
|
|---|
| 17 |
|
|---|
| 18 | http://www.math.berkeley.edu/~roconnor/
|
|---|
| 19 |
|
|---|
| 20 | After installation Ogg- and MP3 files are treated the
|
|---|
| 21 | same way by the WPS as the other audio files. They have
|
|---|
| 22 | their own Icons and the same menus as for example
|
|---|
| 23 | wave files. A doubleclick starts playback another one
|
|---|
| 24 | stops it. The convert menu item helps you decoding the
|
|---|
| 25 | file to wave without any other program.
|
|---|
| 26 |
|
|---|
| 27 | The settings notebook of every audio file gets a new
|
|---|
| 28 | page added describing the audio characteristics like
|
|---|
| 29 | playtime or samplerate. This data is also shown in the
|
|---|
| 30 | details view of folders if set to class:CWAudio.
|
|---|
| 31 |
|
|---|
| 32 | There's also a new open-item for volume.
|
|---|
| 33 |
|
|---|
| 34 | You may view and change the ID3 tags of MP3 files
|
|---|
| 35 | using the settings notebook. These tags are also shown
|
|---|
| 36 | in the details view.
|
|---|
| 37 |
|
|---|
| 38 | A new JPEG IO procedure supports progressive JPEG images.
|
|---|
| 39 |
|
|---|
| 40 |
|
|---|
| 41 | 2. Media folder and audio shadow
|
|---|
| 42 | --------------------------------
|
|---|
| 43 |
|
|---|
| 44 | The Media folder is a player for any
|
|---|
| 45 | audio file known by OS/2. The usual play
|
|---|
| 46 | controls are available and you may create
|
|---|
| 47 | playlists just by dropping files into the folder.
|
|---|
| 48 |
|
|---|
| 49 | Audio files will not be put into the folder directly
|
|---|
| 50 | but shadows are created.
|
|---|
| 51 | A new shadow class shows you details information
|
|---|
| 52 | for the linked audio files in the details view of a
|
|---|
| 53 | Media-Folder. A REXX interface is available if
|
|---|
| 54 | WPS-wizard V0.2.0 or above is installed.
|
|---|
| 55 |
|
|---|
| 56 | A WPS enabled CD player with FreeDB support is included
|
|---|
| 57 | and a *.M3U playlist editor.
|
|---|
| 58 |
|
|---|
| 59 |
|
|---|
| 60 | 3. Slide show
|
|---|
| 61 | -----------
|
|---|
| 62 |
|
|---|
| 63 | Starting with V0.2.8 the package contains a slide show program for
|
|---|
| 64 | displaying the contents of one or more directories.
|
|---|
| 65 |
|
|---|
| 66 |
|
|---|
| 67 | Installation
|
|---|
| 68 | ------------
|
|---|
| 69 | Before you ask:
|
|---|
| 70 |
|
|---|
| 71 | YES THE MULTIMEDIA CLASSES WORK WITH XWP AS THEY
|
|---|
| 72 | ALWAYS DID.
|
|---|
| 73 | DON'T BOTHER ME WITH QUESTIONS ABOUT THAT.
|
|---|
| 74 |
|
|---|
| 75 | !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|---|
| 76 |
|
|---|
| 77 | MAKE A BACKUP OF YOUR INI FILES!
|
|---|
| 78 |
|
|---|
| 79 | MAKE A BACKUP OF YOUR INI FILES!
|
|---|
| 80 |
|
|---|
| 81 | MAKE A BACKUP OF YOUR INI FILES!
|
|---|
| 82 |
|
|---|
| 83 | !!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!!
|
|---|
| 84 |
|
|---|
| 85 | Note:
|
|---|
| 86 | If you've installed WordPerfect for OS/2 5.2(a) uninstall it first.
|
|---|
| 87 | Otherwise it'll be impossible to deregister the IBM multimedia classes
|
|---|
| 88 | and your system will most likely crash during install of the new
|
|---|
| 89 | classes. Be sure to clean the INI file using 'checkini /C' before
|
|---|
| 90 | you proceed. The cause of this problem is unknown at the moment.
|
|---|
| 91 |
|
|---|
| 92 | Make a copy of JPEGIO.DLL and MMPARTS.DLL in the directory
|
|---|
| 93 | MMOS2\DLL. These files will be overwritten during installation
|
|---|
| 94 | of the new multimedia classes. The install skript will create additional
|
|---|
| 95 | copies of the DLLs in the directory MMOS2\CWMMBack for reinstallation
|
|---|
| 96 | of the IBM classes
|
|---|
| 97 |
|
|---|
| 98 | Deinstall any old version of the media folder and the CWAudio
|
|---|
| 99 | classes. Restart the system.
|
|---|
| 100 |
|
|---|
| 101 |
|
|---|
| 102 | 1. Put the contents of the archive into a directory
|
|---|
| 103 | 2. Start the Skript Runme1st.cmd
|
|---|
| 104 | 3. Restart the WPS. DON'T SKIP THIS STEP!
|
|---|
| 105 | 4. Clean the INI files with 'Checkini.exe /C' (wptool32.zip, http://hobbes.nmsu.edu)
|
|---|
| 106 | 5. Restart the WPS. DON'T SKIP THIS STEP!
|
|---|
| 107 | 6. Run install.exe.This will copy the files and register the
|
|---|
| 108 | new classes.
|
|---|
| 109 | 7. Restart the WPS so the new classes will be loaded.
|
|---|
| 110 |
|
|---|
| 111 | If the WPS doesn't start rename the installation directory from
|
|---|
| 112 | a command line. It may be helpful to move all objects from the desktop
|
|---|
| 113 | when start problems occur.
|
|---|
| 114 |
|
|---|
| 115 | Be sure to use the latest release of the MMIOMP3 IO-procedure
|
|---|
| 116 | (http://www.math.berkeley.edu/~roconnor/). It has a lot of improvements.
|
|---|
| 117 |
|
|---|
| 118 |
|
|---|
| 119 | Uninstallation
|
|---|
| 120 | --------------
|
|---|
| 121 |
|
|---|
| 122 | 1. Use the uninstall feature of the generic installer
|
|---|
| 123 | 2. Restart the WPS. DON'T SKIP THIS STEP!
|
|---|
| 124 | 3. Clean the INI files with 'Checkini.exe /C' (wptool32.zip, http://hobbes.nmsu.edu)
|
|---|
| 125 | 4. Run the script x:\MMOS2\CWMMBack\INSTIBM.CMD to install the IBM classes.
|
|---|
| 126 | Replace x with your boot drive.
|
|---|
| 127 |
|
|---|
| 128 | Restart the WPS afterwards.
|
|---|
| 129 |
|
|---|
| 130 |
|
|---|
| 131 | Known problems
|
|---|
| 132 | --------------
|
|---|
| 133 |
|
|---|
| 134 | The playtime may be not correct for some VBR-MP3s. This is a problem
|
|---|
| 135 | of the MMIOMP3-Proc not the classes.
|
|---|
| 136 |
|
|---|
| 137 | MP3 files may not be recognized correctly. This happens if there was a
|
|---|
| 138 | previous installation of the classes. Drop the folder containing the MP3
|
|---|
| 139 | files on the skript \cwmm-x_x_x-lang\bin\RemoveEA.CMD to remove the
|
|---|
| 140 | attribute .CLASSINFO and to set the right .TYPE attribute. The folder must
|
|---|
| 141 | be closed when dropping!
|
|---|
| 142 | Wave and ogg files loose the track information entered in the settings so
|
|---|
| 143 | be sure to backup this information before using the skript.
|
|---|
| 144 |
|
|---|
| 145 | The audio stream class only supports IceCast servers. There's no support for
|
|---|
| 146 | Shoutcast.
|
|---|
| 147 |
|
|---|
| 148 |
|
|---|
| 149 | Bug reporting
|
|---|
| 150 | ------------
|
|---|
| 151 |
|
|---|
| 152 | Use the 'Multimedia Extensions' section of http://xtracker.netlabs.org if you
|
|---|
| 153 | find a bug.
|
|---|
| 154 |
|
|---|
| 155 |
|
|---|
| 156 | Helpful utility
|
|---|
| 157 | ------------
|
|---|
| 158 |
|
|---|
| 159 | Salvador Parra Camacho has written a program to change the hidden settings
|
|---|
| 160 | (see documentation) in a convenient way.
|
|---|
| 161 | Find the homepage at:
|
|---|
| 162 |
|
|---|
| 163 | http://www.geocities.com/escajarro/
|
|---|
| 164 |
|
|---|
| 165 | Direct download of the utility:
|
|---|
| 166 |
|
|---|
| 167 | http://www.geocities.com/escajarro/soft/ccfg010z.zip (Zip)
|
|---|
| 168 | http://www.geocities.com/escajarro/soft/ccfg010w.zip (Wpi)
|
|---|
| 169 |
|
|---|
| 170 |
|
|---|
| 171 | History
|
|---|
| 172 | -------
|
|---|
| 173 |
|
|---|
| 174 | V0.1.0
|
|---|
| 175 |
|
|---|
| 176 | First release of the new audio classes.
|
|---|
| 177 |
|
|---|
| 178 | V0.2.0
|
|---|
| 179 |
|
|---|
| 180 | -Type 'Digital Audio' returned in addition to MP3/OGGS for the audio classes.
|
|---|
| 181 | -Setting of .TYPE EA so Digital Audio player works with MP3/OGG files without further fiddling
|
|---|
| 182 | -Caching of MP3 technical data in EAs to speed up folder opening.
|
|---|
| 183 | -ID3 data shown with the right codepage.
|
|---|
| 184 | -Mnemonic for Volume menu item.
|
|---|
| 185 |
|
|---|
| 186 | -New classes CWMediaFolder and CWAudioShadow for playing of audio files.
|
|---|
| 187 |
|
|---|
| 188 | V0.2.1
|
|---|
| 189 |
|
|---|
| 190 | MMClasses:
|
|---|
| 191 | -A bunch of minor fixes.
|
|---|
| 192 | -No prereading of audio info for files on CD to speed up folder opening.
|
|---|
| 193 |
|
|---|
| 194 | Media folder:
|
|---|
| 195 | -Repeat function added
|
|---|
| 196 | -new (and improved) sliders
|
|---|
| 197 | -Keyboard control added (not for sliders yet)
|
|---|
| 198 | -Display for elapsed time, remaining time and ID3 tags (click to switch)
|
|---|
| 199 | -Change playtime font by DnD
|
|---|
| 200 | -Drag and drop handling rewritten.
|
|---|
| 201 | -Statusline added
|
|---|
| 202 | -REXX interface added
|
|---|
| 203 | -No audio info reading for files on CD to speed up CD opening.
|
|---|
| 204 |
|
|---|
| 205 | V0.2.2 (29.03.2002)
|
|---|
| 206 |
|
|---|
| 207 | MMClasses:
|
|---|
| 208 | -New CD track class for FreeDB enabled CD player
|
|---|
| 209 | -Improved open function. See media folder documentation
|
|---|
| 210 |
|
|---|
| 211 | Media folder:
|
|---|
| 212 | -CD player object with FreeDB support added.
|
|---|
| 213 | -Some minor fixes.
|
|---|
| 214 |
|
|---|
| 215 |
|
|---|
| 216 | V0.2.3 (13.07.2002)
|
|---|
| 217 |
|
|---|
| 218 | MMClasses:
|
|---|
| 219 | -Added new replacement classes for audio, video and image files. The MMOS2 classes are
|
|---|
| 220 | not used anymore.
|
|---|
| 221 | -Improved lighttable folder with selectable icon size.
|
|---|
| 222 |
|
|---|
| 223 | Media folder:
|
|---|
| 224 | -Added new replacement classes for audio, video and image files. The MMOS2 classes are
|
|---|
| 225 | not used anymore.
|
|---|
| 226 | -Improved lighttable folder with selectable icon size.
|
|---|
| 227 |
|
|---|
| 228 |
|
|---|
| 229 | V0.2.4 (29.11.2002)
|
|---|
| 230 |
|
|---|
| 231 | Media folder:
|
|---|
| 232 | -Fixed PM-freeze with broken shadows.
|
|---|
| 233 | -Fixed problems when user deleted shadows during playing.
|
|---|
| 234 | -Repeat function was broken.
|
|---|
| 235 | -Device sharing didn't really work.
|
|---|
| 236 | -Random play added.
|
|---|
| 237 | -Launch area for objects.
|
|---|
| 238 | -Settings opening was only possible with closed folders
|
|---|
| 239 | -Audio files are started on a separate thread.
|
|---|
| 240 | -Media folder will take over already playing files (very limited for now, only skip/stop).
|
|---|
| 241 | -CD-folder works for all drives not only default cd drive.
|
|---|
| 242 |
|
|---|
| 243 | MMClasses:
|
|---|
| 244 | -Added some more exception handlers.
|
|---|
| 245 | -Image details aren't read from CD unless key in INI file is set (see docs).
|
|---|
| 246 | -Titlebar of volume control may be hidden
|
|---|
| 247 | -Tabbing in volume control enabled
|
|---|
| 248 | -Save colors and position of volume control, audio- and image converter
|
|---|
| 249 | -Query audio information on a separate thread when awakening objects (speed boost for MP3)
|
|---|
| 250 | -Print menu removed for audio and video files.
|
|---|
| 251 | -Improved ID3 handling. ID3 V1.1 tracknumber is kept if present.
|
|---|
| 252 | -Elapsed time in icon titles when playing.
|
|---|
| 253 | -Changed names for classes to improve compatibility with the IBM classes.
|
|---|
| 254 | -Unified setup strings for MP3 and other audio files.
|
|---|
| 255 | -Lighttable folders: sometimes drawing of icons failed.
|
|---|
| 256 |
|
|---|
| 257 | V0.2.5 (16.02.2003)
|
|---|
| 258 |
|
|---|
| 259 | Media folder:
|
|---|
| 260 | -Popup menu on time control for changing display
|
|---|
| 261 | -New playlist editor
|
|---|
| 262 | -Shadows for fly over help
|
|---|
| 263 |
|
|---|
| 264 | MMClasses:
|
|---|
| 265 | -DLLs needed by specified players or editors weren't found if not in LIBPATH.
|
|---|
| 266 | -You may specify a different mp3 player
|
|---|
| 267 | -Fixed wrong icon size for standard classes in details view of light table folders.
|
|---|
| 268 | -Added support for animated folder icons in lightable folder
|
|---|
| 269 | -Templates were not drawn in light table folders icon view
|
|---|
| 270 | -Pause function for audio files
|
|---|
| 271 | -Fixed asscociations for image files.
|
|---|
| 272 | -Fixed image conversion.
|
|---|
| 273 | -Renamed REXX functions. The old names are still working but shouldn't be used longer.
|
|---|
| 274 | -Added new REXX function cwmmQueryImageInfo()
|
|---|
| 275 | -Added method cwmmQueryImageInfo().
|
|---|
| 276 | -ID3 tags of MP3 files weren't set when using setup strings. Only EAs were updated.
|
|---|
| 277 | -No more garbled characters with some players when reading the ID3 tags.
|
|---|
| 278 | -Black and white images are properly drawn in light table folder
|
|---|
| 279 |
|
|---|
| 280 | JPEG IO procedure:
|
|---|
| 281 | -Procedure now accepts 8 bit input images.
|
|---|
| 282 |
|
|---|
| 283 |
|
|---|
| 284 | V0.2.6 (02.07.2003)
|
|---|
| 285 |
|
|---|
| 286 | -Audio extensions added in the MM configuration notebook are recognized.
|
|---|
| 287 | -createcd compiled with VAC
|
|---|
| 288 | -helper progs statically linked.
|
|---|
| 289 | -No template for CWMMDataFile.
|
|---|
| 290 | -New FLAC class.
|
|---|
| 291 | -New EA MMNUMAUDIOBYTES containing the number of audio bytes of the file.
|
|---|
| 292 | -M3U playlist editor failed using M3U lists created by Rockbox.
|
|---|
| 293 | -Play menu for M3U objects.
|
|---|
| 294 | -Hilighting of play and pause buttons during device sharing corrected
|
|---|
| 295 | -You can't start more than 3 audio files at a time now, preventing problems when a whole folder of audio objects was accidently selected.
|
|---|
| 296 | -Support for converting to OGG-Vorbis. Any future write enabled audio IO-Proc will be automatically supported now.
|
|---|
| 297 | -Default audio player replaced
|
|---|
| 298 | -Opening of folders with image files is faster now
|
|---|
| 299 | -Image spacing in lighttable folders improved
|
|---|
| 300 | -Image converter dialog had german resources in the english language version (obviously nobody cared...).
|
|---|
| 301 | -Preview in image converter
|
|---|
| 302 | -PNG image class
|
|---|
| 303 | -PNG files are recognized as image files. Automatic support of future image IO procs.
|
|---|
| 304 | -Only one INI file for MM class helpers.
|
|---|
| 305 |
|
|---|
| 306 |
|
|---|
| 307 | V0.2.7 (01.09.2003)
|
|---|
| 308 |
|
|---|
| 309 | -Renamed method cwmmAddWaveInformationPage() to cwmmAddAudioInformationPage().
|
|---|
| 310 | -Added container handle to parameter list of methods cwmmPlayTrack() and cwmmPauseTrack()
|
|---|
| 311 | -If several audio files in a folder are started at once they will be played consecutively.
|
|---|
| 312 | -Image information in popup menu
|
|---|
| 313 | -Added audio information for midi files in details view.
|
|---|
| 314 | -Audioplayer playback always started with default volume setting (70%).
|
|---|
| 315 | -Master volume item added to sys menu of audio player.
|
|---|
| 316 | -Language now derived from LANG setting not the country code.
|
|---|
| 317 | -URL of audio stream objects was truncated to 4 chars when reopening the settings.
|
|---|
| 318 | -Audio-Stream objects lost their type after changing settings.
|
|---|
| 319 | -Bitrate display for MP3 files if MMIOMP3 0.4.2 or above is installed.
|
|---|
| 320 | -Bitrate display for OGG files if MMIOOGG 0.3.1 or above is installed.
|
|---|
| 321 | -ID3 tag handling completely rewritten. Track information may be 256 bytes long per entry.
|
|---|
| 322 | ID3 tags are handled separately now.
|
|---|
| 323 | -Volume for audio files adjustable now. Volume menu no longer starts master volume.
|
|---|
| 324 | -Modified settings page handling for audio objects on CD
|
|---|
| 325 | -Added INI key to disable audio file scanning for certain drives.
|
|---|
| 326 | -Added INI key to disable ID3 tag reading for certain drives.
|
|---|
| 327 |
|
|---|
| 328 |
|
|---|
| 329 | V0.2.7b (06.09.2003)
|
|---|
| 330 |
|
|---|
| 331 | -Skript creatobj.cmd for creation of CD players was broken.
|
|---|
| 332 |
|
|---|
| 333 |
|
|---|
| 334 | V0.2.8 (01.11.2004)
|
|---|
| 335 |
|
|---|
| 336 | -Icon view removed for media folders.
|
|---|
| 337 | -Icon view page removed for media folders. This removes it also from CD folders which never supported icon view anyway.
|
|---|
| 338 | -Compact view improved.
|
|---|
| 339 | -Track information in switch list and titles.
|
|---|
| 340 | -Opening of Media folder wasn't possible when settings already open.
|
|---|
| 341 | -Fixed a memory leak for image files.
|
|---|
| 342 | -Fixed deadlock when copying image files in light table folders.
|
|---|
| 343 | -Background bitmap deletion of image files to give memory back to the system.
|
|---|
| 344 | -English distribution included german help file for the classes.
|
|---|
| 345 | -Audio objects stopped playing after a second if not started from a folder.
|
|---|
| 346 | -Workaround for WPS crash with Timidity. No, It's still not working with the classes.
|
|---|
| 347 | -Fixed possible crash with abstract objects in light table folders.
|
|---|
| 348 | -Fixed CD querying for LVM systems (not for dynamically attached USB drives yet).
|
|---|
| 349 | -Audio file scanning now stops when folder is closed.
|
|---|
| 350 | -No scanning for CD tracks.
|
|---|
| 351 | -Video player didn't work at all.
|
|---|
| 352 | -ID3 info for artist was overwritten with the album name when using setup strings.
|
|---|
| 353 | -Trap when Quicktime for OS/2 was installed during scanning of MP3 files.
|
|---|
| 354 | -Marking image files as invalid for the WPS when caused a trap.
|
|---|
| 355 | -Only create thumbs when image is visible in container. Esp. useful when WPS-Wizard is installed.
|
|---|
| 356 | -When first creating ID3 tags the genre was always set to 'blues'.
|
|---|
| 357 | -CD objects are no longer created automatically. This will fix most lock ups people experienced.
|
|---|
| 358 | -Slide show program for displaying the contents of one or more directories
|
|---|
| 359 |
|
|---|
| 360 |
|
|---|
| 361 | Credits
|
|---|
| 362 | -------
|
|---|
| 363 |
|
|---|
| 364 | The Icons and graphics are (C) Klaus Staedtler-Przyborski. Thanks for
|
|---|
| 365 | fearless beta testing.
|
|---|
| 366 |
|
|---|
| 367 | The script for creation of a media folder tree is (c) Eirik Oeverby.
|
|---|
| 368 |
|
|---|
| 369 |
|
|---|
| 370 | License
|
|---|
| 371 | --------
|
|---|
| 372 |
|
|---|
| 373 | See license.txt
|
|---|
| 374 |
|
|---|
| 375 |
|
|---|
| 376 | Author
|
|---|
| 377 | ------
|
|---|
| 378 |
|
|---|
| 379 | These classes are (C) 2001-2005 Chris Wohlgemuth.
|
|---|
| 380 |
|
|---|
| 381 | http://www.geocities.com/SiliconValley/Sector/5785/
|
|---|
| 382 | http://www.os2world.com/cdwriting
|
|---|
| 383 |
|
|---|
| 384 |
|
|---|
