home *** CD-ROM | disk | FTP | other *** search
/ OS/2 Shareware BBS: InfoMgt / InfoMgt.zip / mframe01.zip / readme.txt < prev    next >
Text File  |  2000-08-20  |  15KB  |  296 lines
  1. -----------------------------------------------------------------------------------
  2. Music Frame for Java
  3. Version 0.01 beta
  4. -----------------------------------------------------------------------------------
  5.  
  6. Welcome to Music Frame for Java!
  7.  
  8. What the hell is MusicFrame?
  9.  
  10. If you're really interested in music and/or you've a big collection of CD, MC, LP,
  11. Video etc. then this software is for YOU!
  12.  
  13. MusicFrame for Java v 0.01 ist the first public beta of my OS/2 application
  14. MusicFrame/2 remastered to the Java plattform. It's a xBase type database to store
  15. data with musical relation. In fact it's a programm that can manage your cd, mc,
  16. lp or whatsever collection. It can show crossreferences between bands as the main goal.
  17. If you once have your database up to date you can pre calculate a planed recording to
  18. cd or mc etc. Printing layouts isn't available yet, but I hope I can implement it soon.
  19. The song titles and times on your cd's can be read direct from your cd-rom drive by
  20. pressing a button. MusicFrame gives you some information 'bout your collection and
  21. database. MusicFrame are able to create a database for Albatros CD-Player on OS/2.
  22. This version includes a little demo database. If you want the full database, you'll have
  23. to register your copy.
  24.  
  25.  
  26.  
  27. What requirements are there?
  28.  
  29. You must have installed a Java JRE 1.1.7 or higher and Swing 1.0.3. Your Operating
  30. System of choice must be capable to run Java applications. The first beta
  31. (this version) will be only released to the OS/2 community.
  32.  
  33. The execution on other plattforms is supported, but MusicFrame for Java can't access
  34. the CD-rom drive on plattforms other than OS/2 this time. This is because the lack of
  35. an multimedia-dll. I hope I can supply the linux support in the next version.
  36.  
  37.  
  38.  
  39. How can I install or uninstall Music Frame for Java?
  40.  
  41. Installation is simple, just unzip all files in the archive to a directory.
  42.  
  43. OS/2:
  44. OS/2 users are supported with a file that creates Objects on your WPS. To do this, simply execute
  45. "wps.cmd" from your MusicFrame directory.
  46. If you want create a program object for MusicFrame on OS/2 without using any cmd file, create
  47. a program object manually and supply it by this information:
  48.  
  49. Path and filename: <Your Java Path>\javapm.exe
  50. Parameters       : -classpath <Path to classes.zip>;<Path to swing.jar>;<Path to mframe.jar> MusicFrame
  51. Working directory: <Musicframe directory>
  52.  
  53. Example
  54. Path and filename:    D:\JAVA11\bin\javapm.exe
  55. Parameters       :    -classpath D:\JAVA11\lib\classes.zip;D:\JAVA11\SWING\swing.jar;E:\MFRAMEJ\mframe.jar MusicFrame
  56. Working drectory :    E:\MFRAMEJ
  57.  
  58. Windows:
  59. Create links manually on your Desktop with mframe.bat and jview.bat.
  60.  
  61. MusicFrame makes no changes to your configuration. So you have to delete all files in
  62. your MusicFrame directory if you wish to discontinue using.
  63.  
  64.  
  65.  
  66. Are you responsible on damages or loss of outcomes?
  67.  
  68. THIS PROGRAM IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND.
  69. The developer disclaims all warranties expressed or implied for this program.
  70. The developer shall not be liable for any outcomes caused by the use or misuse of this program.
  71. You may not reverse ingeneering the MusicFrame files.
  72. You may not disassemble, reverse-compile, reverse-assemble, or alter the files in any manner.
  73. Each individual end-user will register this product after an evaluation period of ten (10) days.
  74. Use of the program indicates your acceptance of the above license agreement.
  75.  
  76.  
  77.  
  78. Why should I register my copy?
  79.  
  80. OK, we all now that os2 requires more software. And you should know that this software will only
  81. have os2 support in the future when I have registrations from os/2 users! So register your
  82. software if you like it and you use it longer than the shareware period.
  83. This is true for other plattforms as well.
  84. Registered Users will receive a ready to use database with nearly 1800 records and 4500 Musicians.
  85. Registered Users will receive updates to the MusicFrame database from time to time.
  86.  
  87.  
  88.  
  89. How can I register MusicFrame for Java?
  90.  
  91. If you live in the US register your copy with the BMT Micro Order form, or online at
  92. http://www.bmtmicro.com. The registration is $15. You'll receive your key direct
  93. from me via email. So please give BMT your email address.
  94.  
  95. If you live in Europe simply send your money to this bank:
  96.  
  97. Frank Ambacher, Berliner Bank BLZ: 10020000, Konto: 3400351700, Germany
  98. with this text: Reg for MusicFrame/J <Your address, email>
  99. The registration is EUR 15 or DM 30.-.
  100. You'll receive your key via email direct from me.
  101.  
  102. If you live outside the US and outside of Europe please order with BMT Micro, too.
  103.  
  104.  
  105.  
  106. Are there any restrictions in the unregistered version?
  107.  
  108. No, the unregistered version is full functional. But the logo window is shown 20 seconds.
  109.  
  110.  
  111.  
  112. I miss some features, where do you hide it?
  113.  
  114. This version is beta software and still under developement. Not all features are implemented yet,
  115. e.g. there's no onlinehelp available.
  116. Features are underway: Online help, printing cover for cd, linux support.
  117. If you interested in this software please fill out my feedback form and send it to
  118. anakor@admiral.berlinet.de by email. So I'll know what you would like to see and what do you think
  119. about this software.
  120. You can also post questions, suggestions or wishes. I'll try to lend you an ear.
  121.  
  122. Newest updates can be found at:
  123. http://www.snafu.de/~anakor
  124. http://hobbes.nmsu.edu
  125. http://www.leo.org
  126. Admiral Fido Mailbox 2:2411/312 T:49-30-97105374    For german users only
  127.  
  128.  
  129. What should I do with the windows in the program itself?
  130.  
  131. Here is an examples to give in a complete CD. This example shows the most required windows. I
  132. recomend that you open the MusicFrame program now, to see what I make.
  133.  
  134. After MusicFrame has finished the loading process klick File/Open Database. This loads the record
  135. database. The record list is shown in the main window.
  136.  
  137. Klick on File/List of Labels. The Window opened shows the current available Record labels. The
  138. numbers are the labels label numbers. We'll use this numbers later. After you've take a look on
  139. the list, close the list via the system menu (doubleclick the icon in the left upper corner).
  140.  
  141. Klick on File/List of Labels again. The same list is showing. Then Klick on File/List of instruments
  142. The list shown will show you the current available instruments played by musicians. Now if the
  143. list of instruments isn't selected, select it by klick on its titlebar. Press the End key on your
  144. keyboard. The end of the list is selected. Press Home on your keyboard will select the first item.
  145. Now press letter 'h' on your keyboard. The first item beginning with the letter 'h' is selected.
  146. In this way all lists in the whole program are working.
  147. Close both windows by doubbleclicking on their system menu.
  148.  
  149. MusicFrame for Java work with 2 different main lists. The first we see is the record list. The
  150. other is the musician list. Klick on File/Change list to view it now. You can toggle between the
  151. two lists by clicking File/Change list.
  152.  
  153. Now we want to give in some data.
  154. Our example cd is: Going for the one - Yes, from 1977.
  155. In the record list we' ve seen that this record isn't available in the database. In the musician
  156. list we see that some of the musicians are in the database, while other don't. Klick Edit/New to
  157. see the musician input dialog. The most left tab in the notebook should read Musicians.
  158. If this is not the case close the dialog with the system menu and toggle the main list. Then reopen
  159. the Edit dialog with Edit/New.
  160.  
  161. Now we wish to enter a new musician. Fill out the fields.
  162. I type: first name: Jon   last name: Anderson
  163. I leave the pseudonym field blank, because we have a real name.
  164. I select those instruments: vocals, percussion
  165.  
  166. If you want to select more than one instrument in the list you've to press the ctrl key on your
  167. keyboard while selecting in the list.
  168. After selection verify the string labeled Instruments.
  169. If you're sure the information is right, klick the button in the lower right corner to save the data
  170. to disk.
  171. In this way proceed for all musicians, you wish to give in.
  172. I proceed this way to give in all musician on the CD not available in the database.
  173.  
  174. Now we want to give in the cd itself. Toggle the main list to the record list, then klick on
  175. Edit/New. In the dialog the most left tab in the notebook should read Record.
  176. If this is not the case close the dialog, toggle the main list and klick on Edit/New again.
  177. Select the tab Record, if it's not selected.
  178.  
  179. Fill out the fields and/or select the right data.
  180. I type:    Interpret:    Yes
  181.     Title:        Going For The One
  182.     P-Year:    1977                    This is the original release year
  183.     Collection:    marked
  184.     PP:        15.95                   This is the price you've payed, use your local currency
  185.     Rec.Proc    AAD            If the media is a CD, I recomend AAD, ADD, or DDD
  186.  
  187. ----------------------------------------------------------------------
  188. If you don't know what AAD,ADD,DDD is, please read this:
  189. These shortcuts are wide accepted in Europe and printed on most
  190. available europian CD's. It classifies the record procedure as follows
  191.  
  192. AAD analog recording,  analog mixing/editing,  digital mastering
  193. ADD analog recording,  digital mixing/editing, digital mastering
  194. DDD digital recording, digital mixing/editing, digital mastering
  195.  
  196. If there are no such shortcuts on the inlay or the CD itself, look for
  197. a text like CDD mastering by <name>. If such a text is available then
  198. the record procedure is ADD.
  199. ---------------------------------------------------------------------
  200.  
  201. If all information is right, then klick the save button, to save this page to disk.
  202.  
  203. Go to the Identity page.
  204. Every CD has a hidden cdhex number on disk. Insert the CD in question in your cd-rom drive then
  205. klick on the CD button to read it direct from the media. If reading was successful the number is
  206. shown in the box labeled CD Hex.
  207. Look for the barcode on the CDs inlay or on the CD itself. The barcode should look like
  208.  
  209. 0 111111 111111 6    12-Numbers (counting only the 2 groups in the middle)
  210.             '-' are a valid character here
  211. or
  212. 0 11111 11111 6        10-Numbers
  213.  
  214. Select the type of barcode and type it in the fields.
  215. The first number is the country code. If your barcode don't have it, then type
  216. 0 (international). The last number is a check number. If your barcode don't have it type 0.
  217. If you can't find a barcode on a CD leave all fields blank.
  218. Select the Label field. If you've typed a valid barcode MusicFrame fill out this field with
  219. the right label for you. Some labels are family labels including sub labels. Please edit the
  220. label that it contains only one label in this case.
  221. Select the Order-No. field. If you've typed a valid barcode MusicFrame fill out this field with
  222. the right Order-No for you.
  223. If you typed label and Order-No but leave the barcode fields blank, then select one of the barcode
  224. fields again. In this case MusicFrame generates a valid barcode for you.
  225.  
  226. I type this informatiom:
  227. Type    :    12-Numbers
  228. Barcode :    0 7567-8 1510-2 6
  229. Label   :    Atlantic
  230. Order-Nr:    81510-2
  231.  
  232. When ready klick on save to save this page.
  233.  
  234. Go to the Tracks page.
  235. The information here are related to Songs on a media.
  236. If you've read the CD successfully on the previous page, then the track times are already inserted
  237. in the times list. Otherwise you must type it in here. Write a song title in the title field then
  238. write the time in the time field and klick on the plus button.
  239. Proceed in this way for all songs included on your media.
  240. In the Program field you can store a program for a cd player. Just type the track numbers seperated
  241. by spaces like this '7 4 2 11 17'.
  242. When ready klick on save to save this page.
  243.  
  244. Go to the Links page.
  245. On this page you can link musicians with the media. First klick one of the buttons A-H I-P Q-Z.
  246. If you do so, all available musicians will be loaded into the Musician list, shown on this page.
  247. Moving the selected musician from the list to the list on the right will create the link.
  248. You can separate main musicians from studio musicians by setting a Separator with the separator
  249. button.
  250. If you want change the order, select a musician and remove him to the Musicians list. An
  251. alternative way is to cut him from the list using the del key on your keyboard and re-insert him
  252. on another location by pressing the insert key.
  253. I link here the previous created Jon Anderson, and the rest from Yes.
  254.  
  255. When you're ready please klick the save button to save this page on disk.
  256. Close the New Dialog by double clicking the system menue.
  257. Now we have createted the first record.
  258.  
  259. Now we want to see a crossreference.
  260. Toggle the main list to the record list. Our new CD now should be in this list.
  261. Doubble Click this CD in the list. The dialog opened shows the crossreference of the CD.
  262.     Please double click one of the musicians in the new dialog.
  263.         Please double click one of the records in the new dialog.
  264.             Please double click one of the musicians in the new dialog.
  265.                 Please double click one of the records in the new dialog.
  266.                     Please double click one of the musicians in the new dialog.
  267.  
  268.  
  269.  
  270. What is J-View?
  271.  
  272. JView is not part of MusicFrame, but it's a plus Freeware GIF/JPG Viewer. For help on this
  273. program please load a GIF file and take a look what it does. The menu is available in german only,
  274. but there are only 4 choices.
  275. 'Verlassen' means Quit, 'Oeffnen' means Open, 'Vollbild' means Fullscreen, 'Fenster anpassen' means
  276. Resize Window.
  277.  
  278. Is there a way to get a free copy of MusicFrame?
  279.  
  280. Yes, you can get a free copy by giving me a solution on some OS/2 related questions.
  281.  
  282. 1. The MMOS/2 CD-Player stores CDHex numbers in its cdplayer.ini file in bootdrive:\mmos2.
  283.    A CD with CD-Hex: 01 98 1C 0D 48 C8 76 00
  284.    is stored as    : 43123937.47
  285.    If you know how to create and interpret this numbers you'll get a free copy.
  286.    Please verify that with an ini editor on cdp.ini!
  287.  
  288. 2. The Creative Labs CDPlayer on OS/2 CTCD.EXE stores it's CDHex numbers in the file ctcd.ini.
  289.    A CD with CD-Hex: 01 98 1C 0D 48 C8 76 00
  290.    is stored as    : 00 00 1c 98 00 6c f3 68
  291.    If you know how to create and interpret this numbers you'll get a free copy.
  292.    Please verify that with an ini editor on ctcd.ini!
  293.  
  294. 3. I'm searching for a way to read label volumes of an audio-cd on OS/2.
  295.    If you know how to read the labels you'll get a free copy.
  296.