@database MUICD @author Piotr "PP/UNION" Pawlow @index Index @node Main "MUI CD Player" @{i} Please note: the author's native language is Polish, so please forgive bad spelling, grammar mistakes, etc. @{ui} @{b} MUI CD Player package version 1.13 (12-08-98)@{ub} @{b} The CDDA player for CD32/ATAPI/SCSI using MUI@{ub} @{b} Written by Piotr Pawlow (PP/UNION)@{ub} @{" Introduction " link introduction} @{" Requirements " link requirements} @{" Installation " link installation} @{b}The package:@{ub} @{" Player " link player} @{" Editor " link editor} @{" Manager " link manager} @{b}Miscellaneous:@{ub} @{" Files format " link filesformat} @{"Acknowledgements" link acknowledgements} @{" History " link history} @{" To do " link todo} @{" Bugs " link bugs} @{" Compatibility " link compatibility} @{"Troubleshooting " link troubleshooting} @{" Author " link author} @{" About MUI " link mui} @endnode @node introduction "Introduction" @{u} Introduction @{uu} Since I bought my CD32 I was looking for a CD player that doesn't make small gaps between tracks while playing. Because all players make such gaps I decided to write my own. This program is placed in public domain, but if you want, you can send me some money :). I really need some! Use these programs at your own risk. I'm not responsible for any damage these programs may do (but I'm quite sure that they will not eat your cat). @endnode @node requirements "Requirements" @{u} Requirements @{uu} This package requires @{"MUI 3.3" link mui} or newer, MUI NList custom class, version at least 0.48, by Gilles Masson and of course a CD-ROM drive, ATAPI, SCSI or CD32 compatible. @endnode @node installation "Installation" @{u} Installation @{uu} Use supplied installer script, or just copy all files wherever you want and adjust player's tooltypes. If you haven't NList custom class already, you will have to download and install it. You can find it on Aminet. @endnode @node player "Player" @{u} MUI CD Player @{uu} @{"Using the player" link window} @{"Menu" link menu} @{"Tooltypes" link tooltypes} @endnode @node window "Using the player" @{u} Usage @{uu} When you launch the player a window appears with some control gadgets, info box and two lists. If you don't see some of them, make the window bigger. If there are still some gadgets missing, check the @{"settings" link menu 13}. The list on the left contains all tracks on the CD (track number, time and name), the list on the right contains programmed tracks. You can add tracks to the program by dragging them from the list with all tracks. To play a track from the list, double click on it. If you press RMB while your mouse pointer is above the program list the following context menu appears: Group - make a @{"group" link groups} out of selected entries Ungroup - remove selected entries from a group ------- Shuffle - randomly shuffle selected entries Delete - delete selected entries ------- Read - read program from a disk Write - write program There is a balance object between the program list and track list. You can change with it relative sizes ("weights") of both groups. Groups' weights are saved together with other settings. If you press RMB on an entry in the list of all tracks, this entry will become disabled (entry number will disappear). Disabled entries are not played (they're skipped while playing). Control gadgets: Image Text Function Shortcut |< Previous Play previous track v << < Search Rewind < |> Play Start/resume playing p || Pause Pause/resume playing a >> Search > Fast forward > >| Next Play next track n [] Stop Stop playing s @{u}^@{uu} Eject Open/Close CD tray j Below there are some sliders: - volume control; from 0 to 100%; current level is saved with @{"settings" link menu 13}. - balance; from 0 (maximum on left) to 100 (maximum on right); also saved with @{"settings" link menu 13}. - track position; in seconds from the beginning of current track; can be used to quickly jump to any position on the track. Some or even all of these sliders can be inactive, which means that your CD-ROM/device/driver does not support volume or balance or position control. @endnode @node groups "Groups" @{u} Groups @{uu} Entries in the program list can be grouped together. A group behaves while shuffling like a one entry - it can be shuffled with other entries but the order of entries inside it will not change. @endnode @node menu "Menu" @{u} Menu @{uu} Project menu: About... About MUI... @{"CD-ROM Info..." link cdrominfo} ---------- CD Manager... - run @{"manager" link manager} CD Editor... - run @{"editor" link editor} ---------- Quit - quit program Settings menu: @{"LoopCD" link loopcd} @{"Auto play" link autoplay} @{"Auto shuffle" link autoshuffle} @{"Auto make program" link automakeprogram} @{"Auto use program" link autouseprogram} @{"Joypad" link joypad} @{"Popup" link popup} @{"Volume control" link volumecontrol} @{"Balance control" link balancecontrol} @{"Position slider" link positionslider} @{"Play data track" link playdatatrack} @{"Display program" link displayprogram} @{"Confirm quit" link confirmquit} @{"Buttons" link buttons} @{"Group frames" link groupframes} -------------- MUI... - @{"MUI" link mui} preferences for player -------------- Save settings - save current settings to the icon as @{"tooltypes" link tooltypes} @endnode @node cdrominfo "CD-ROM info" @{u} CD-ROM info @{uu} This window shows some information about your CD-ROM. Use this info if possible when reporting CD-ROM related bugs. @endnode @node loopcd "LoopCD" @{u} LoopCD @{uu} If this option is set then after reaching the end of CD it will be played again. @endnode @node autoplay "Auto play" @{u} Auto play @{uu} When you insert a CD, it will be played automatically. There is a little problem with this option: playing must be started *after* the filesystem reads the CD (or else it will be aborted). With AUTOPLAYDELAY @{"tooltype" link tooltypes} you can set how long the program shall wait before it starts playing (in 1/50s). @endnode @node autoshuffle "Auto shuffle" @{u} Auto shuffle @{uu} Program entries are automatically shuffled before first play (and every restart when loop is on) when this option is checked. Look also @{"Auto use program" link autouseprogram} and @{"Auto make program" link automakeprogram} options. @endnode @node automakeprogram "Auto make program" @{u} Auto make program @{uu} If a CD does not have a program, it will be automatically created. Useful with @{"Auto shuffle" link autoshuffle} option, because you will not be forced to make programs for CDs you want to be auto-shuffled. On the other side, you will have to make programs for CDs you DON'T WANT to be shuffled. It is up to you to decide what is better. Some people have more CDs which contents should not be shuffled, others inversely. @endnode @node autouseprogram "Auto use program" @{u} Auto use program @{uu} CDs will be played using their programs. @endnode @node joypad "Joypad" @{u} Joypad @{uu} When this option is set, you can control playing with a joypad. Up/Down - scroll the list of tracks Left/Right - previous/next track Red button - start playing Green button - eject Yellow button - change time mode Other buttons work like in the player built in CD32. @endnode @node popup "Popup" @{u} Popup @{uu} If this option is off, the player will start iconified. @endnode @node volumecontrol "Volume control" @{u} Volume control @{uu} Turns on/off the slider for volume level control. Please note, that some drives don't support volume control, or support only mute (for example CD32). @endnode @node balancecontrol "Balance control" @{u} Balance control @{uu} Turns on/off the slider for balance control. @endnode @node positionslider "Position slider" @{u} Position slider @{uu} Turns on/off the position slider. By using this slider you can immediately jump to any part of the track. Unfortunately I could not make it work with cd.device. Anybody know how to change the laser position without aborting play command in progress ? CD_SEEK does not work, but also returns no error. Strange... @endnode @node playdatatrack "Play data track" @{u} Play data track @{uu} If this option is turned on, data track can be played too. Please note, that some devices don't allow to play data tracks. @endnode @node displayprogram "Display program" @{u} Display program @{uu} If this option is off, program list will not be displayed. @endnode @node confirmquit "Confirm quit" @{u} Confirm quit @{uu} Always - the program will always ask if you really want to quit Never - will never ask While playing - you will be asked only while playing a CD @endnode @node buttons "Buttons" @{u} Buttons @{uu} Text - type of buttons Image Image+Text ---------------- One Row - layout of buttons Two Rows ---------------- Select images... - with this option you can select a directory with images for buttons. These are normal IFF brushes, thus you can make your own buttons. @endnode @node groupframes "Group frames" @{u} Group frames @{uu} Normal - standard frames with titles No titles - frames without titles, they take less space Off - no frames, the GUI is as compact as possible. Good for low resolutions @endnode @node tooltypes "Tooltypes" @{u} Tooltypes @{uu} Currently supported tooltypes are: @{"LIBRARY" link library}= @{"DEVICE" link device}= @{"UNIT" link unit}= @{"VOLUME" link volume}= @{"VOLUMECTRL" link volumecontrol}= @{"BALANCE" link balance}= @{"BALANCECTRL" link balancecontrol}= @{"POSITIONSLIDER" link positionslider}= @{"LOOPCD" link loopcd}= @{"AUTOPLAY" link autoplay}= @{"AUTOUSEPROGRAM" link autouseprogram}= @{"CONFIRMQUIT" link confirmquit}= @{"TIMER" link timer}= @{"PLAYDATA" link playdatatrack}= @{"DISPLAYPROGRAM" link displayprogram}= @{"JOYPAD" link joypad}= @{"BUTTONS" link buttons}= @{"BUTTONROWS" link buttons}=<1|2> @{"IMAGEPATH" link buttons}= @{"AUTOSHUFFLE" link autoshuffle}= @{"AUTOMAKEPROGRAM" link automakeprogram}= @{"AUTOPLAYDELAY" link autoplay}= @{"TRACKLISTWEIGHT" link weights}= @{"PROGLISTWEIGHT" link weights}= @{"GROUPFRAMES" link groupframes}= @{"CX_POPUP" link popup}= @endnode @node library "Library" @{u} Library @{uu} The name of library that will be used to control specified @{"device" link device}. There are two libraries in this release: - cddevplay.library for cd.device and compatible devices - atapiplay.library for ATAPI/SCSI drives controlled via atapi.device, scsi.device etc. @endnode @node device "Device" @{u} Device @{uu} The name of device that will be used by player's @{"library" link library} to control your CD-ROM. For CD32 this should be cd.device. @endnode @node unit "Unit" @{u} Unit @{uu} Unit number for your CD-ROM (0 for CD32). @endnode @node volume "Volume" @{u} Volume @{uu} Initial volume value from 0 to 100%. @endnode @node balance "Balance" @{u} Balance @{uu} Balance value from 0 (only left channel) to 100 (only right channel). @endnode @node timer "Timer" @{u} Timer @{uu} Initial timer mode. @endnode @node weights "Weights" @{u} Track list and program list weights @{uu} With these two tooltypes you can set relative sizes of track and program lists. Of course you can do the same with a balance object and then save the settings which is much easier :) @endnode @node editor "Editor" @{u} CD Editor @{uu} This simple program is used to edit contents of one CD description file. It can be called from the @{"player" link player} or from the @{"manager" link manager}. The main window contains: - the @{"menu" link editor_menu} - a string gadget for CD title and @{"Other" link Other} button - a list with all tracks - a string gadget with the name of selected track - "Save" and "Cancel" buttons You can use Drag'n'Drop feature to change succesion of entries. @endnode @node editor_menu "Menu" @{u} Menu @{uu} Project About... About MUI... ------------- CD Manager... - call the @{"manager" link manager} ------------- Load... - load a CD description from a text file Save - save current CD (like "Save" button in editor's window) Save as... - save current CD as a text file ------------- Quit Settings MUI... @endnode @node Other "Other" @{u} "Other" button @{uu} If you press this button a new window will open. The window contains a list with other CDs in the database having the same number of tracks than edited CD. So, if you insert a CD and this CD is not recognized, you can run the editor and use "Other" gadget - maybe you will find your CD in this list ! You can view any CD by selecting it from the list. Its contents will be displayed in editor's main window (don't worry - old contents will be saved). If you press "OK" then actual contents of main window will be used, and if you press "Cancel" - the old contents will be restored. @endnode @node manager "Manager" @{u} CD Manager @{uu} With this program you can manage your CD database. You can edit your CDs, delete them, search for some information, import CDs from other programs or export them. After starting the program it will scan your database. It may take some time if you have a big database! Program's window contains: - the @{"menu" link manager_menu} - a list of all CDs in the database - 4 pages' group: * @{"Commands" link manager_commands} * @{"Select" link manager_select} * @{"Search" link manager_search} * @{"Imp./Exp." link manager_impexp} @endnode @node manager_menu "Menu" @{u} Menu @{uu} Project About About MUI ---------------- Rescan directory - rescan directory with your database, add comments to files ---------------- Quit Settings Show Number - show CD numbers Tracks - show number of tracks Dates - show CD dates File names - show @{"file name" link filesformat} for every CD Sort by Name - sort by name of CD Number of tracks - guess :) Date - by date of last change ------------------ MUI ------------------ Save settings - as it says! They are saved as tooltypes @endnode @node manager_commands "Commands" @{u} Commands @{uu} Show all - show all CDs Show selected - show only selected CDs Edit - edit active CD Delete - delete selected CDs @endnode @node manager_select "Select" @{u} Select @{uu} All - select all CDs None - deselect all CDs Invert - invert selection Pattern - select all CDs matching given pattern This pattern is a standard @{"AmigaDOS pattern" link patterns}. @endnode @node manager_search "Search" @{u} Search @{uu} Using this function you can search selected CDs for a given string. Wildcards are not supported. @endnode @node manager_impexp "Import/Export" @{u} Import/Export @{uu} @{"MUI CD" link manager_muicd} - import/export for MUI CD Player (this player !) @{"Interplay" link manager_interplay} - import from Interplay @{"MegaCd Player" link manager_megacdplayer} - import from MegaCd Player @{"ID files" link manager_idfiles} - import from MCDP, CeeD, SkandalfoCDP etc. Before importing database, you will be asked for an @{"AmigaDOS pattern" link patterns}. Only CDs matching this pattern will be imported, so you can import only really needed CD descriptions. @endnode @node manager_muicd "MUI CD" @{u} MUI CD Player @{uu} With this option you can import/export CDs in Manager's own format. Remember to always use it if you want to share your CDs with other people, don't just copy your "Disks" directory! Please use ".MCD" extension for exported files. You must select CDs you want to export. WARNING: If you import damaged file, the manager may hang. @endnode @node manager_interplay @{u} Importing from Interplay @{uu} Interplay is a great CDDA player for Overdrive, Zappo, CD32 or SCSI CD-ROMS written by Stian Olsen & Espen Skog. It can be found on Aminet. Using this option you can import CD descriptions from Interplay. Interplay's database should be located in "S:" directory. WARNING: If imported database is damaged, the manager may hang. @endnode @node manager_megacdplayer @{u} Importing from MegaCd Player @{uu} MegaCd Player is a CDDA player for CD32 written by Steven Ross. It can be found on Aminet. Its database is located in "datastore" directory. WARNING: If the database is damaged, the manager may hang. @endnode @node manager_idfiles @{u} ID files import @{uu} The ID files are used by many players for SCSI CD-ROMs, like MCDP, SkandalfoCDP, CeeD etc. Each file contains one CD (this player uses similar format). ID files can be found in "Disks" directory. CeeD uses slightly modified file names, so if you want to import from CeeD, switch the cycle gadget to "CeeD". Some people making ID collections, are mixing files from CeeD with the other files. The manager cannot recognize file format, because it's sometimes impossible, but if you import files using wrong format, they will only have wrong IDs (thus you can still use them from the editor, by pressing "Other" button). @endnode @node filesformat "Files format" @{u} Files format @{uu} MUI CD Player uses some sort of ID files: xxyyyyyy.zzzzzz xx - number of tracks (hex) yyyyyy - position of last track in LSN format (hex) (optional) .zzzzzz - length of CD in MSF format (hex) (optional) For example "0703E706.402649" means that CD has 7 tracks, last track begins at sector 255750 ($03E706) and length of CD is 64:38:73 ($40,$26,$49). This CD will be also recognized, when written as "0703E706" or "07.      402649". Since this version it will also try "07.      402449", because for some strange reason MSF format addresses are always 2 seconds higher than LSN addresses, thus if a CD player reads TOC in LSN format the CD playing time will be shorter by those 2 seconds. For example Scandalfo's CD Player produces ID's with CD length shorter. When you insert a CD, the Player tries to read a file with complete information. If it fails, the program tries also incomplete format. Every file contains: - Name of CD - Track names The Manager uses also other format in which database is exported. Format of archive file: - "MCD1" string and for every file in the archive: - name of file - length of file - file itself Format of these files may be changed or extended in future. @endnode @node acknowledgements "Acknowledgements" @{u} Acknowledgements @{uu} Many thanks to Gilles Masson for his custom class - it's great ! Thanks to Stefan Stuntz for MUI. It's so easy to create very flexible user interface with it ! Thanks to Shane Robertson and Pat Donohoe for your cash support :) That's the most important reason why I'm still working on this program. Thanks to Roland Fulde, Gregor B. Rosenauer, Jens Thos, Markus Bawidamann, Matthew James Scott, Steve Clack for your mails, bug-reports and ideas. Thanks to everyone who contributed with translations. Greetings fly to (no order): Hali, Tom, Kulfon, Irek P., Infection, Docent, Diodak, Snoopy, Root, Shocker, Sachy, Tracer, Musashi, Pic, Amst, Magor ... and all I have forgotten @endnode @node bugs "Bugs" @{u} Known bugs @{uu} Set window redraw to "with clear" in MUI preferences for the player, or you will sometimes get some graphical trashes while resizing the window. It's probably a bug in MUI. @endnode @node compatibility "Compatibility" @{u} Compatibility @{uu} This program has been tested, and works, with: - cddevplay.library * CD32 with ProModule, OS3.1, 68882, 10MB RAM * CD32 with SX-1, OS3.1, 10MB RAM * A1200, 68882, 6MB RAM, CD-ROM SCSI RENO 2x connected via SQUIRREL SCSI interface * A1200, APOLLO 040/33, 16 MB RAM, CD-ROM ATAPI MITSUMI 16x with a CD32 emulator from the CacheCDFS package. Everything work except ejecting. * A1200, APOLLO 040/25, 8 MB RAM, CD-ROM ATAPI SAMSUNG 12x with Atapi-PNP package. Search does not work, because cd.device from this package doesn't support it. - atapiplay.library * A1200, APOLLO 040/33, 16 MB RAM, CD-ROM ATAPI MITSUMI 16x connected to the internal IDE interface and controlled thru atapi.device. Everything works great! * The same as above, but with AI scsi.device 43.23 * also tested with SAMSUNG x24 and x32 and BTC x32 drives It has been tested also with Overdrive. Searching, volume control, and eject functions did not worked due to incomplete cd.device emulation. Is there any newer cd.device for Overdrive which works better ? @endnode @node troubleshooting "Troubleshooting" @{u} Troubleshooting @{uu} Q: Rewind/Forward/Eject buttons won't work A: The device you are using probably does not support these. Try to find a newer version. Q: It says "Could not open device" and then quits. What's wrong ? A: Check in @{"tooltypes" link tooltypes} if DEVICE and UNIT fields are set correctly. Q: It does not want to start, instead it displays "Could not create application". What does it mean ? A: It means that either: - there is not enough memory for some GUI objects. Try to free some. - some MUI libraries are missing. Try to reinstall MUI. Also make sure that you have NList installed correctly. Q: It crashes when I try to use drag'n'drop. A: Install newer NList version. Q: Where are program and song lists ?!! A: It seems that the window is too small. Make it bigger and they will appear. :) Q: Why the Manager is sooo slooooow ? A: Did you imported all CDs you had ? Well, if you have more than a thousand entries in your database - no wonder. (Also Amiga FFS is known to be very slow when it has to handle directories with very many files in them). But hey! - do you really need all of them ? Use a pattern to import only what you need and leave the rest in the archive. :) @endnode @node history "History" @{u} History @{uu} 1.00, 20-11-96 - First release 1.01, 26-11-96 - manager, editor, player * fixed some bugs in memory allocation - player * changed time counter - length of deselected tracks is substracted from playing time 1.02, 02-12-96 - editor * fixed stupid bug in drag'n'drop feature 1.03, 06-12-96 - archive * NList removed 1.04, 23-12-96 - player, editor and manager * now using their icons while sleeping instead of MUI default * fixed possibility of small memory leak 1.05, 27-12-96 - player * added an option to play data tracks too 1.06, 29-12-96 - player * things related to tracks' programming added 1.07, 30-12-96 - player * fixed timer in program mode 1.08, 16-01-97 - player * drag'n'drop sometimes crashed due to a bug in NList, added workaround for this bug 1.09, 02-03-97 - player * read and shuffle functions added to program * fixed a bug while writing program with only one entry * many parts of the program rewritten in AmigaE * needs at least version 0.48 of NList, due to a bug in previous versions - editor * fixed another bug in drag'n'drop * maximum lenght of track name is 256 chars now * many parts of the program rewritten in AmigaE - manager * many parts of the program rewritten in AmigaE 1.10, 26-03-97 - player, editor, manager: * finally work with NList version 0.50 and higher. 1.11, 24-04-98 - player * auto shuffle added * program groups added * image buttons * many minor improvements and bug fixes - editor and manager * minor changes and bug fixes 1.12, 01-05-98 - player * balance control * position slider * "Auto make program" option * more bugs fixed. Including a stupid one which could sometimes give more than 60 seconds in one minute :) really stupid... :) And it existed since the first version :) - package * added installer script * ** NEW LIBRARY FOR ATAPI/SCSI DRIVES ** at least ! 1.13, 29-09-98 - player * "Group frames" option added * added a possibility to make buttons without frames, and with alternative images, shown when the button is pressed - manager * Uses fast custom string formatting routines instead of terribly slow RawDoFmt() - package * more button images * more translations Changes in cddevplay.library: 1.0, 26-11-96 * some bugs fixed * shorter :) * some commands changed 1.1, 29-12-96 * removed code, that prevents from playing data tracks 2.0, 30-04-98 * some new functions Changes in atapiplay.library: 2.0, 30-04-98 * first release 2.1, 03-06-98 * fixed for SAMSUNG drives 2.2, 12-08-98 * should work now with BTC, LITEON, CREATIVE and many other drives, fixed to work with scsi.device version 43.23 from Amiga Technologies @endnode @node todo "To do" @{u} Things to do in the future @{uu} - MOST IMPORTANT: detach play routines from the GUI thus making possible to add plugins, more GUIs, database caching, lyrics support, and to make it easy for everyone to add new features - lyrics - TOC editor - Editor for joypad buttons' functions - announcing tracks with narrator.device - conversion from JukeBox - CDDB support if I get some money to cover my phone bills. If you don't know what CDDB is, surf to http://sunsite.unc.edu/~cddb/xmcd Thanks to all of you who suggested some ideas :) @endnode @node author "Author" Send your bug reports, suggestions, opinions, gifts and -= money =- to: Piotr Pawlow Lewartowskiego 12/46 00-185 Warszawa Poland EMail: pp@union.org.pl Homepage: http://www.union.org.pl/pp/ @endnode @node patterns "Patterns" @{u} AmigaDOS patterns @{uu} (taken from dos.library autodocs) The patterns are fairly extensive, and approximate some of the ability of Unix/grep "regular expression" patterns. Here are the available tokens: ? Matches a single character. # Matches the following expression 0 or more times. (ab|cd) Matches any one of the items seperated by '|'. ~ Negates the following expression. It matches all strings that do not match the expression (aka ~(foo) matches all strings that are not exactly "foo"). [abc] Character class: matches any of the characters in the class. [~bc] Character class: matches any of the characters not in the class. a-z Character range (only within character classes). % Matches 0 characters always (useful in "(foo|bar|%)"). * Synonym for "#?", not available by default in 2.0. Available as an option that can be turned on. "Expression" in the above table means either a single character (ex: "#?"), or an alternation (ex: "#(ab|cd|ef)"), or a character class (ex: "#[a-zA-Z]"). @endnode @node mui "About MUI" This application uses MUI - MagicUserInterface (c) Copyright 1993-96 by Stefan Stuntz MUI is a system to generate and maintain graphical user interfaces. With the aid of a preferences program, the user of an application has the ability to customize the outfit according to his personal taste. MUI is distributed as shareware. To obtain a complete package containing lots of examples and more information about registration please look for a file called "muiXXusr.lha" (XX means the latest version number) on your local bulletin boards or on public domain disks. If you want to register directly, feel free to send DM 30.- or US$ 20.- to Stefan Stuntz Eduard-Spranger-Straße 7 80935 München GERMANY Support and online registration is available at http://www.sasg.com/ @endnode @node hidden "Totally hidden and almost impossible to find part of the guide" Eeeeeee... What's up doc ? :-D @endnode