home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1999 November / PCONLINE_11_99.ISO / filesbbs / OS2 / ACDCR032.ZIP / source / audiofolderenglish.ipf < prev    next >
Encoding:
Information Presentation Facility markup  |  1999-08-22  |  43.3 KB  |  976 lines

  1. :userdoc.
  2.  
  3. :docprof.
  4.  
  5. :title. Help for Audio-CD-Creator/Data-CD-Creator
  6.  
  7. :h1 res=001.Audio-CD-Creator V0.32
  8. :i1 global.Audio-CD-Creator
  9. :p.
  10. Audio-CD-Creator helps you creating Audio-CDs with CDRecord/2. It works also as a frontend for any grabber program.
  11. As a folder subclass it uses features of the WPS like Drag and Drop and context menus. This version only supports TAO-mode.
  12. :p.
  13. Put the wavefiles you want to burn into this folder, 
  14. arrange them in the desired order and press the write-button. It's possible to use shadows of wavefiles, too. The
  15. folder follows the links and gives the right names to CDRecord/2. Any other object is skipped while processing the
  16. folder contents. So you can put dokumentation files, program objects and so on into this folder, too. A menu gives
  17. access to often used features of CDRecord/2.
  18. All options are set using the settings notebook of the folder object. Help is avaiable for most functions. Use the
  19. right mouse button.
  20. :p.
  21. :link reftype=hd res=600.Main window help:elink.
  22. :p.
  23. This DLL and the accompaigning program are provided 'as is' under the terms of the Gnu Public Licence (GPL).
  24. For further information read the file :link reftype=hd res=202.'COPYING':elink..
  25. :p.
  26. :link reftype=hd res=201.History:elink.
  27. :p.
  28. :note text='Author:'. Chris Wohlgemuth.
  29. :note text='E-Mail:'. christopher.wohlgemuth@bch.siemens.de
  30. :note text='WWW:'.    http&colon.&slr.&slr.www.geocities.com&slr.SiliconValley&slr.Sector&slr.5785&slr.
  31. :p.
  32.  
  33. :h2 res=202.Licence
  34. :p.
  35. .ce          GNU GENERAL PUBLIC LICENSE
  36. .ce               Version 2, June 1991
  37. :p.
  38.  Copyright (C) 1989, 1991 Free Software Foundation, Inc.
  39.                           675 Mass Ave, Cambridge, MA 02139, USA
  40.  Everyone is permitted to copy and distribute verbatim copies
  41.  of this license document, but changing it is not allowed.
  42. :p.
  43. .ce                Preamble
  44. :p.
  45.   The licenses for most software are designed to take away your
  46. freedom to share and change it.  By contrast, the GNU General Public
  47. License is intended to guarantee your freedom to share and change free
  48. software--to make sure the software is free for all its users.  This
  49. General Public License applies to most of the Free Software
  50. Foundation's software and to any other program whose authors commit to
  51. using it.  (Some other Free Software Foundation software is covered by
  52. the GNU Library General Public License instead.)  You can apply it to
  53. your programs, too.
  54. :p.
  55.   When we speak of free software, we are referring to freedom, not
  56. price.  Our General Public Licenses are designed to make sure that you
  57. have the freedom to distribute copies of free software (and charge for
  58. this service if you wish), that you receive source code or can get it
  59. if you want it, that you can change the software or use pieces of it
  60. in new free programs; and that you know you can do these things.
  61. :p.
  62.   To protect your rights, we need to make restrictions that forbid
  63. anyone to deny you these rights or to ask you to surrender the rights.
  64. These restrictions translate to certain responsibilities for you if you
  65. distribute copies of the software, or if you modify it.
  66. :p.
  67.   For example, if you distribute copies of such a program, whether
  68. gratis or for a fee, you must give the recipients all the rights that
  69. you have.  You must make sure that they, too, receive or can get the
  70. source code.  And you must show them these terms so they know their
  71. rights.
  72. :p.
  73.   We protect your rights with two steps: (1) copyright the software, and
  74. (2) offer you this license which gives you legal permission to copy,
  75. distribute and/or modify the software.
  76. :p.
  77.   Also, for each author's protection and ours, we want to make certain
  78. that everyone understands that there is no warranty for this free
  79. software.  If the software is modified by someone else and passed on, we
  80. want its recipients to know that what they have is not the original, so
  81. that any problems introduced by others will not reflect on the original
  82. authors' reputations.
  83. :p.
  84.   Finally, any free program is threatened constantly by software
  85. patents.  We wish to avoid the danger that redistributors of a free
  86. program will individually obtain patent licenses, in effect making the
  87. program proprietary.  To prevent this, we have made it clear that any
  88. patent must be licensed for everyone's free use or not licensed at all.
  89. :p.
  90.   The precise terms and conditions for copying, distribution and
  91. modification follow.
  92. :p.
  93. .ce            GNU GENERAL PUBLIC LICENSE
  94. .ce   TERMS AND CONDITIONS FOR COPYING, DISTRIBUTION AND MODIFICATION
  95. :p.
  96.   0. This License applies to any program or other work which contains
  97. a notice placed by the copyright holder saying it may be distributed
  98. under the terms of this General Public License.  The "Program", below,
  99. refers to any such program or work, and a "work based on the Program"
  100. means either the Program or any derivative work under copyright law:
  101. that is to say, a work containing the Program or a portion of it,
  102. either verbatim or with modifications and/or translated into another
  103. language.  (Hereinafter, translation is included without limitation in
  104. the term "modification".)  Each licensee is addressed as "you".
  105. :p.
  106. Activities other than copying, distribution and modification are not
  107. covered by this License; they are outside its scope.  The act of
  108. running the Program is not restricted, and the output from the Program
  109. is covered only if its contents constitute a work based on the
  110. Program (independent of having been made by running the Program).
  111. Whether that is true depends on what the Program does.
  112. :p.
  113.   1. You may copy and distribute verbatim copies of the Program's
  114. source code as you receive it, in any medium, provided that you
  115. conspicuously and appropriately publish on each copy an appropriate
  116. copyright notice and disclaimer of warranty; keep intact all the
  117. notices that refer to this License and to the absence of any warranty;
  118. and give any other recipients of the Program a copy of this License
  119. along with the Program.
  120. :p.
  121. You may charge a fee for the physical act of transferring a copy, and
  122. you may at your option offer warranty protection in exchange for a fee.
  123. :p.
  124.   2. You may modify your copy or copies of the Program or any portion
  125. of it, thus forming a work based on the Program, and copy and
  126. distribute such modifications or work under the terms of Section 1
  127. above, provided that you also meet all of these conditions:
  128. :p.
  129.     a) You must cause the modified files to carry prominent notices
  130.     stating that you changed the files and the date of any change.
  131. :p.
  132.     b) You must cause any work that you distribute or publish, that in
  133.     whole or in part contains or is derived from the Program or any
  134.     part thereof, to be licensed as a whole at no charge to all third
  135.     parties under the terms of this License.
  136. :p.
  137.     c) If the modified program normally reads commands interactively
  138.     when run, you must cause it, when started running for such
  139.     interactive use in the most ordinary way, to print or display an
  140.     announcement including an appropriate copyright notice and a
  141.     notice that there is no warranty (or else, saying that you provide
  142.     a warranty) and that users may redistribute the program under
  143.     these conditions, and telling the user how to view a copy of this
  144.     License.  (Exception: if the Program itself is interactive but
  145.     does not normally print such an announcement, your work based on
  146.     the Program is not required to print an announcement.)
  147. :p.
  148. These requirements apply to the modified work as a whole.  If
  149. identifiable sections of that work are not derived from the Program,
  150. and can be reasonably considered independent and separate works in
  151. themselves, then this License, and its terms, do not apply to those
  152. sections when you distribute them as separate works.  But when you
  153. distribute the same sections as part of a whole which is a work based
  154. on the Program, the distribution of the whole must be on the terms of
  155. this License, whose permissions for other licensees extend to the
  156. entire whole, and thus to each and every part regardless of who wrote it.
  157. :p.
  158. Thus, it is not the intent of this section to claim rights or contest
  159. your rights to work written entirely by you; rather, the intent is to
  160. exercise the right to control the distribution of derivative or
  161. collective works based on the Program.
  162. :p.
  163. In addition, mere aggregation of another work not based on the Program
  164. with the Program (or with a work based on the Program) on a volume of
  165. a storage or distribution medium does not bring the other work under
  166. the scope of this License.
  167. :p.
  168.   3. You may copy and distribute the Program (or a work based on it,
  169. under Section 2) in object code or executable form under the terms of
  170. Sections 1 and 2 above provided that you also do one of the following:
  171. :p.
  172.     a) Accompany it with the complete corresponding machine-readable
  173.     source code, which must be distributed under the terms of Sections
  174.     1 and 2 above on a medium customarily used for software interchange; or,
  175. :p.
  176.     b) Accompany it with a written offer, valid for at least three
  177.     years, to give any third party, for a charge no more than your
  178.     cost of physically performing source distribution, a complete
  179.     machine-readable copy of the corresponding source code, to be
  180.     distributed under the terms of Sections 1 and 2 above on a medium
  181.     customarily used for software interchange; or,
  182. :p.
  183.     c) Accompany it with the information you received as to the offer
  184.     to distribute corresponding source code.  (This alternative is
  185.     allowed only for noncommercial distribution and only if you
  186.     received the program in object code or executable form with such
  187.     an offer, in accord with Subsection b above.)
  188. :p.
  189. The source code for a work means the preferred form of the work for
  190. making modifications to it.  For an executable work, complete source
  191. code means all the source code for all modules it contains, plus any
  192. associated interface definition files, plus the scripts used to
  193. control compilation and installation of the executable.  However, as a
  194. special exception, the source code distributed need not include
  195. anything that is normally distributed (in either source or binary
  196. form) with the major components (compiler, kernel, and so on) of the
  197. operating system on which the executable runs, unless that component
  198. itself accompanies the executable.
  199. :p.
  200. If distribution of executable or object code is made by offering
  201. access to copy from a designated place, then offering equivalent
  202. access to copy the source code from the same place counts as
  203. distribution of the source code, even though third parties are not
  204. compelled to copy the source along with the object code.
  205. :p.
  206.   4. You may not copy, modify, sublicense, or distribute the Program
  207. except as expressly provided under this License.  Any attempt
  208. otherwise to copy, modify, sublicense or distribute the Program is
  209. void, and will automatically terminate your rights under this License.
  210. However, parties who have received copies, or rights, from you under
  211. this License will not have their licenses terminated so long as such
  212. parties remain in full compliance.
  213. :p.
  214.   5. You are not required to accept this License, since you have not
  215. signed it.  However, nothing else grants you permission to modify or
  216. distribute the Program or its derivative works.  These actions are
  217. prohibited by law if you do not accept this License.  Therefore, by
  218. modifying or distributing the Program (or any work based on the
  219. Program), you indicate your acceptance of this License to do so, and
  220. all its terms and conditions for copying, distributing or modifying
  221. the Program or works based on it.
  222. :p.
  223.   6. Each time you redistribute the Program (or any work based on the
  224. Program), the recipient automatically receives a license from the
  225. original licensor to copy, distribute or modify the Program subject to
  226. these terms and conditions.  You may not impose any further
  227. restrictions on the recipients' exercise of the rights granted herein.
  228. You are not responsible for enforcing compliance by third parties to
  229. this License.
  230. :p.
  231.   7. If, as a consequence of a court judgment or allegation of patent
  232. infringement or for any other reason (not limited to patent issues),
  233. conditions are imposed on you (whether by court order, agreement or
  234. otherwise) that contradict the conditions of this License, they do not
  235. excuse you from the conditions of this License.  If you cannot
  236. distribute so as to satisfy simultaneously your obligations under this
  237. License and any other pertinent obligations, then as a consequence you
  238. may not distribute the Program at all.  For example, if a patent
  239. license would not permit royalty-free redistribution of the Program by
  240. all those who receive copies directly or indirectly through you, then
  241. the only way you could satisfy both it and this License would be to
  242. refrain entirely from distribution of the Program.
  243. :p.
  244. If any portion of this section is held invalid or unenforceable under
  245. any particular circumstance, the balance of the section is intended to
  246. apply and the section as a whole is intended to apply in other
  247. circumstances.
  248. :p.
  249. It is not the purpose of this section to induce you to infringe any
  250. patents or other property right claims or to contest validity of any
  251. such claims; this section has the sole purpose of protecting the
  252. integrity of the free software distribution system, which is
  253. implemented by public license practices.  Many people have made
  254. generous contributions to the wide range of software distributed
  255. through that system in reliance on consistent application of that
  256. system; it is up to the author/donor to decide if he or she is willing
  257. to distribute software through any other system and a licensee cannot
  258. impose that choice.
  259. :p.
  260. This section is intended to make thoroughly clear what is believed to
  261. be a consequence of the rest of this License.
  262. :p.
  263.   8. If the distribution and/or use of the Program is restricted in
  264. certain countries either by patents or by copyrighted interfaces, the
  265. original copyright holder who places the Program under this License
  266. may add an explicit geographical distribution limitation excluding
  267. those countries, so that distribution is permitted only in or among
  268. countries not thus excluded.  In such case, this License incorporates
  269. the limitation as if written in the body of this License.
  270. :p.
  271.   9. The Free Software Foundation may publish revised and/or new versions
  272. of the General Public License from time to time.  Such new versions will
  273. be similar in spirit to the present version, but may differ in detail to
  274. address new problems or concerns.
  275. :p.
  276. Each version is given a distinguishing version number.  If the Program
  277. specifies a version number of this License which applies to it and "any
  278. later version", you have the option of following the terms and conditions
  279. either of that version or of any later version published by the Free
  280. Software Foundation.  If the Program does not specify a version number of
  281. this License, you may choose any version ever published by the Free Software
  282. Foundation.
  283. :p.
  284.   10. If you wish to incorporate parts of the Program into other free
  285. programs whose distribution conditions are different, write to the author
  286. to ask for permission.  For software which is copyrighted by the Free
  287. Software Foundation, write to the Free Software Foundation; we sometimes
  288. make exceptions for this.  Our decision will be guided by the two goals
  289. of preserving the free status of all derivatives of our free software and
  290. of promoting the sharing and reuse of software generally.
  291. :p.
  292. .ce                NO WARRANTY
  293. :p.
  294.   11. BECAUSE THE PROGRAM IS LICENSED FREE OF CHARGE, THERE IS NO WARRANTY
  295. FOR THE PROGRAM, TO THE EXTENT PERMITTED BY APPLICABLE LAW.  EXCEPT WHEN
  296. OTHERWISE STATED IN WRITING THE COPYRIGHT HOLDERS AND/OR OTHER PARTIES
  297. PROVIDE THE PROGRAM "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER EXPRESSED
  298. OR IMPLIED, INCLUDING, BUT NOT LIMITED TO, THE IMPLIED WARRANTIES OF
  299. MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.  THE ENTIRE RISK AS
  300. TO THE QUALITY AND PERFORMANCE OF THE PROGRAM IS WITH YOU.  SHOULD THE
  301. PROGRAM PROVE DEFECTIVE, YOU ASSUME THE COST OF ALL NECESSARY SERVICING,
  302. REPAIR OR CORRECTION.
  303. :p.
  304.   12. IN NO EVENT UNLESS REQUIRED BY APPLICABLE LAW OR AGREED TO IN WRITING
  305. WILL ANY COPYRIGHT HOLDER, OR ANY OTHER PARTY WHO MAY MODIFY AND/OR
  306. REDISTRIBUTE THE PROGRAM AS PERMITTED ABOVE, BE LIABLE TO YOU FOR DAMAGES,
  307. INCLUDING ANY GENERAL, SPECIAL, INCIDENTAL OR CONSEQUENTIAL DAMAGES ARISING
  308. OUT OF THE USE OR INABILITY TO USE THE PROGRAM (INCLUDING BUT NOT LIMITED
  309. TO LOSS OF DATA OR DATA BEING RENDERED INACCURATE OR LOSSES SUSTAINED BY
  310. YOU OR THIRD PARTIES OR A FAILURE OF THE PROGRAM TO OPERATE WITH ANY OTHER
  311. PROGRAMS), EVEN IF SUCH HOLDER OR OTHER PARTY HAS BEEN ADVISED OF THE
  312. POSSIBILITY OF SUCH DAMAGES.
  313. :p.
  314. .ce             END OF TERMS AND CONDITIONS
  315. :p.
  316. .ce    Appendix: How to Apply These Terms to Your New Programs
  317. :p.
  318.   If you develop a new program, and you want it to be of the greatest
  319. possible use to the public, the best way to achieve this is to make it
  320. free software which everyone can redistribute and change under these terms.
  321. :p.
  322.   To do so, attach the following notices to the program.  It is safest
  323. to attach them to the start of each source file to most effectively
  324. convey the exclusion of warranty; and each file should have at least
  325. the "copyright" line and a pointer to where the full notice is found.
  326. :p.
  327.     <one line to give the program's name and a brief idea of what it does.>
  328.     Copyright (C) 19yy  <name of author>
  329. :p.
  330.     This program is free software; you can redistribute it and/or modify
  331.     it under the terms of the GNU General Public License as published by
  332.     the Free Software Foundation; either version 2 of the License, or
  333.     (at your option) any later version.
  334. :p.
  335.     This program is distributed in the hope that it will be useful,
  336.     but WITHOUT ANY WARRANTY; without even the implied warranty of
  337.     MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  338.     GNU General Public License for more details.
  339. :p.
  340.     You should have received a copy of the GNU General Public License
  341.     along with this program; if not, write to the Free Software
  342.     Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
  343. :p.
  344. Also add information on how to contact you by electronic and paper mail.
  345. :p.
  346. If the program is interactive, make it output a short notice like this
  347. when it starts in an interactive mode:
  348. :p.
  349. .ce    Gnomovision version 69, Copyright (C) 19yy name of author
  350. .ce    Gnomovision comes with ABSOLUTELY NO WARRANTY; for details type `show w'.
  351. .ce    This is free software, and you are welcome to redistribute it
  352. .ce    under certain conditions; type `show c' for details.
  353. :p.
  354. The hypothetical commands `show w' and `show c' should show the appropriate
  355. parts of the General Public License.  Of course, the commands you use may
  356. be called something other than `show w' and `show c'; they could even be
  357. mouse-clicks or menu items--whatever suits your program.
  358. :p.
  359. You should also get your employer (if you work as a programmer) or your
  360. school, if any, to sign a "copyright disclaimer" for the program, if
  361. necessary.  Here is a sample; alter the names:
  362. :p.
  363. .ce  Yoyodyne, Inc., hereby disclaims all copyright interest in the program
  364. .ce  `Gnomovision' (which makes passes at compilers) written by James Hacker.
  365. :p.
  366. .ce  <signature of Ty Coon>, 1 April 1989
  367. .ce  Ty Coon, President of Vice
  368. :p.
  369. This General Public License does not permit incorporating your program into
  370. proprietary programs.  If your program is a subroutine library, you may
  371. consider it more useful to permit linking proprietary applications with the
  372. library.  If this is what you want to do, use the GNU Library General
  373. Public License instead of this License.
  374.  
  375. :h2 res=201.History
  376. :p.
  377. V0.32
  378. :sl.
  379. :li.New features:
  380. :ul compact.
  381. :li.Option to control the behaviour of the CDRecord/2 window (hide, close on exit)
  382. :li.Improved online help
  383. :eul.
  384. :li.Fixes:
  385. :ul compact.
  386. :li.Bug causing WPS lockup removed
  387. :li.Allow spaces in track names 
  388. :li.Various other small fixes
  389. :eul.
  390. :esl.
  391. :p.
  392. :p.
  393. 24.04.1999 V0.31b
  394. :sl.
  395. :li.New features:
  396. :ul compact.
  397. :li.More status windows
  398. :li.CDRecord write log
  399. :li.Total time is shown
  400. :li.More online help
  401. :eul.
  402. :esl.
  403. :p.
  404. :p.
  405. 23.01.1999  V0.3
  406. :sl.
  407. :li.New features:
  408. :ul compact.
  409. :li.Grabber support added
  410. :li.Online help
  411. :eul.
  412. :esl.
  413. :p.
  414. :p.
  415. 08.01.1999  V0.2
  416. :p.
  417. First public version
  418.  
  419.  
  420. :h2 res=900.Grab status window
  421. :p.
  422. This window shows the grab status. 
  423. :p.
  424. When pressing the :hp2.Break:ehp2. button the grabber process is terminated after the current track.
  425. If you want to kill the process immediately chose the :hp2.Grab track:ehp2. window in the window list
  426. and type CTRL-C in that window. If you selected several tracks the next track will be grabbed so it
  427. may be necessary to click :hp2.Break:ehp2. prior to killing the process.
  428.  
  429. :h2 res=1200.Write status window
  430. :p.
  431. This window shows the write status. 
  432. :p.
  433. When pressing the :hp2.Break:ehp2. button the write process is terminated after the current track.
  434. The process does not end immediately. The track will be properly written and closed to prevent
  435. damaging the CD-R. Killing the write process during writing a track produces an unusable CD. It may
  436. be necessary to manually fix the CD so an audio player can read it. Use CDR-Tools to do so.
  437.  
  438.  
  439. :h1 res=300.CDRecord/2 setup
  440. :p.
  441. Configure CDRecord/2 on this page. Mandatory are the program path and the device number of your
  442. CD-writer. The changes take effect after closing of the notebook.
  443. :p.
  444. Get more information by clicking on the links:
  445. :sl.
  446. :li.:link reftype=hd res=301.Undo:elink.
  447. :li.:link reftype=hd res=302.Path:elink.    
  448. :li.:link reftype=hd res=303.Browse:elink.
  449. :li.:link reftype=hd res=306.Options:elink.
  450. :li.:link reftype=hd res=307.Start hidden:elink.
  451. :li.:link reftype=hd res=308.Close window on exit:elink.
  452. :esl.
  453.  
  454. :h2 res=301.Undo
  455. :p.
  456. Click on this button to discard the changes you've made.
  457.  
  458. :h2 res=302.Path
  459. :p.
  460. Enter the path to CDRecord/2 into this entryfield or use the :link reftype=hd res=303.Browse:elink. button
  461. to find the executable.
  462.  
  463. :h2 res=303.Browse
  464. :p.
  465. Use this button to find the executable of CDRecord/2. A filedialog will pop up helping you browsing your
  466. disks.
  467.  
  468. :h2 res=306.Options
  469. :p.
  470. Enter arbitrary options into this entryfield to customize your CDRecord/2 commandline. Only options not accessible on the main window like :hp2.speed:ehp2. should be entered here.
  471. :p.
  472. Mandatory is the device
  473. number of your CD-writer e.g. :hp2.dev=0,1,0:ehp2..
  474.  
  475. :h2 res=307.Start hidden
  476. :p.
  477. If checked the window of the CDRecord/2 process which is started in the background is hidden. You can always make it visible using the window list to read the CDRecord/2 messages. Uncheck the button to start CDRecord visible.
  478.  
  479. :h2 res=308.Close window on exit
  480. :p.
  481. If checked the CDRecord/2 window closes after termination of the CDRecord/2 process. All messages are lost then. If you need the CDRecord/2 output for example for debugging leave the check box unchecked.
  482.  
  483.  
  484.  
  485. :h1 res=800.Grabber setup
  486. :p.
  487. Use this page to specify your grabber and the grabber options. Any textmode grabber may be used e.g. :hp2.Leech:ehp2..
  488. Be sure to read the section about the grabber :link reftype=hd res=806.options:elink..
  489. The changes take effect after closing of the notebook.
  490. :p.
  491. Get more information by clicking on the links:
  492. :sl.
  493. :li.:link reftype=hd res=802.Undo:elink.
  494. :li.:link reftype=hd res=805.Path:elink.    
  495. :li.:link reftype=hd res=801.Browse:elink.
  496. :li.:link reftype=hd res=806.Options:elink.
  497. :li.:link reftype=hd res=807.Tracknumbers:elink.
  498. :esl. 
  499.  
  500. :h2 res=802.Undo
  501. :p.
  502. Click on this button to discard the changes you've made.
  503.  
  504. :h2 res=805.Path
  505. :p.
  506. Enter the path to your textmode grabber into this entryfield or use the :link reftype=hd res=801.Browse:elink. button
  507. to find the executable.
  508.  
  509. :h2 res=801.Browse
  510. :p.
  511. Use this button to find the executable of your grabber. A filedialog will pop up helping you browsing your
  512. disks.
  513.  
  514. :h2 res=806.Options
  515. :p.
  516. Specify in the entryfield the grabber options. You must be familiar with your favourite grabber
  517. program to build the right commandline. Refer to the documentation of the program if you're in doubt.
  518. :p.
  519. Audio-CD-Creator replaces :hp2.%1:ehp2. with the drive letter you've
  520. chosen and :hp2.%2:ehp2. with the current track number. If your grabber needs a '&colon.' after the drive letter you
  521. have to specify it. 
  522.  
  523. :nt text='Example'.
  524. Let's assume the grabber is called to grab track 2 from drive G&colon..
  525. :p.
  526. The options :hp2.%1&colon. -option1 -option2 # %2 /another_option:ehp2. will be translated into:
  527. :p.
  528. :hp2.G: -option1 -option2 # 2 /another_option:ehp2.
  529. :ent.
  530. :p.
  531. Audio-CD-Creator assumes that the desired trackname has to be placed at the end of the grabber commandline.
  532. You don't have to provide this name as an option. It is build from the folder location and the name you enter in
  533. the entryfield of the main window. If your grabber does not expect the trackname as the last parameter contact the author. This version doesn't handle such a case.
  534.  
  535. :h2 res=807.Tracknumbers
  536. :p.
  537. Check this box if you want Audio-CD-Creator to insert the track number into the trackname e.g. track:hp2.02:ehp2..wav.
  538. If your grabber inserts the numbers leave the box unchecked.
  539.  
  540. :h1 res=6601.CD/RW-Tools menu
  541. :p.
  542. Select this menu to show a dialog which gives you access to some functions helping you when working with
  543. CD-Rs or CD-R/Ws. For example loading and unloading the media, blanking etc.
  544.  
  545.  
  546. :h1 res=600.Main window
  547. :p.
  548. The Main window divides into three parts. 
  549. :ul.
  550. :li.The container behaves like any WPS-folder container. You can put objects into it as usual. But only wavefiles
  551. and shadows of wavefiles are considered when writing CDs. So you can put documentation files into the folder to
  552. keep all parts of a project together.
  553.  
  554. :li.At the top of the window you can switch between :link reftype=hd res=601.write-:elink. and 
  555. :link reftype=hd res=602.grab-mode:elink.. When in grab-mode an entryfield pops up
  556. where you can enter the name for the saved tracked.
  557. :li.On the left side of the window you can change options for the selected mode. According to your mode selection
  558. this part changes.  
  559. :eul.
  560.  
  561. :h2 res=601.Write mode
  562. :p.
  563. In write mode you can select on the left side of the window the write options for audio-CDs. Order the wavefiles in
  564. the container as desired and press :hp2.Write:ehp2.. A tracklist dialog pops up where you can check the files 
  565. and confirm the write. After doing that CDRecord/2 is called to actually burn the CD. The whole setup for CDRecord/2
  566. e.g. which drive to use is done in the settings notebook.
  567.  
  568. :h3 res=610.Pad check box
  569. :p.
  570. Check this box to make sure CDRecord/2 pads the given audio files where appropriate. Since data only can be
  571. stored on the CD per sector which means a multiple of 1/75 sec it may be necessary to fill it up to sector
  572. boundaries. This is done by inserting binary zeroes into the stream which means silence.
  573.  
  574. :h3 res=611.No fix check box
  575. :p.
  576. Check this box to leave the CD unfixed after writing the last selected track. This is necessary if you want to append
  577. more tracks later. You can fix the CD using the CDR-Tools. Fixing the CD means writing the table of contents (TOC)
  578. and closing it. Audio players can only read properly closed CDs.
  579.  
  580. :h3 res=612.Preemphasis check box
  581. :p.
  582. Some CDs are recorded with preemhasis. When grabbing tracks from such CDs the preemphasis is preserved. When
  583. writing such wave files back on CD you have to tell CDRecord/2 to mark them as recorded with preemphasis. 
  584.  
  585. :h3 res=613.Dummy check box
  586. :p.
  587. If checked the CD is written in test mode. This means all tasks are performed but the laser of the writer is turned of.
  588. This is for example useful to check if the performance of the system is sufficient to write a CD while doing other tasks.
  589.  
  590. :h3 res=614.Write
  591. :p.
  592. Click this button to start the writing of the CD. A dialog pops up where you can check the wave files and
  593. confirm the write. If you've checked 'Dummy' everything is done with write laser turned of.
  594.  
  595. :h2 res=602.Grab mode
  596. :p.
  597. In grab mode you have a listbox on the left side to choose the tracks you want to grab.
  598. :ul.
  599. :li.Press :link reftype=hd res=622.Refresh:elink. to
  600. fill the listbox with the tracks of the inserted CD. Your grabbing drive and the grabber are specified in the settings
  601. notebook.
  602. :li.Choose the tracks you want to grab by clicking on them in the :link reftype=hd res=621.listbox:elink..
  603. :li.Enter a name in the entryfield at
  604. the top and press :hp2.Grab:ehp2..
  605. :eul.
  606. :p.
  607. A status window pops up and the grabbing takes place in the background. A logfile named
  608. :hp2.grab.log:ehp2. is created in the folder which contains any messages from :hp2.stderr:ehp2. of the grabber.
  609. Examine it if anything goes wrong. You can close the folder while grabbing.
  610.  
  611. :h3 res=621.Tracks listbox 
  612. :p.
  613. The tracks listbox shows the audio tracks of the inserted CD. Press :link reftype=hd res=622.Refresh:elink. to update the contents.
  614. This is necessary whenever you change the CD or after the opening of an Audio-CD-Creator folder.
  615. You can select tracks for grabbing simply by clicking on them. Multiple selections are possible. Press :link reftype=hd 
  616. res=624.Select all:elink. if you want to grab an entire CD.
  617.  
  618. :h3 res=622.Refresh button
  619. :p.
  620. Press this button to fill the :link reftype=hd res=621.tracks listbox:elink. with the tracks of the currently inserted CD.
  621. This is necessary whenever you change the CD in the grab drive. You can also use this button to deselect currently selected
  622. tracks in the tracks listbox.
  623.  
  624. :h3 res=623.Grab button
  625. :p.
  626. Press this button to start the grabbing of the selected tracks.
  627.  
  628. :h3 res=624.Select all button
  629. :p.
  630. Press this button to select all tracks of the inserted CD for grabbing. Clicking on a selected track deselects it.
  631.  
  632. :h2 res=603.Status line
  633. :p.
  634. The status line shows the total time of all tracks. It's important to know that the cd-writer inserts a pause of 
  635. 2 seconds between each two tracks. These pauses are not included in the shown time.
  636.  
  637.  
  638.  
  639.  
  640.  
  641.  
  642.  
  643.  
  644.  
  645.  
  646.  
  647.  
  648.  
  649.  
  650.  
  651. :h1 res=002.Data-CD-Creator V0.11
  652. :i1 global.Data-CD-Creator
  653. :p.
  654. Data-CD-Creator helps you creating data-CDs with CDRecord/2. It shields you from the commandline syntax of
  655. CDRecord/2 and mkisofs. As a folder subclass it uses features of the WPS like Drag and Drop and context menus.
  656. :p.
  657. It's possible to create singlesession- and multisession CDs. Choose the features you want in the settings notebook.
  658. After putting folders and files you want to burn on CD into the folder press the 'Create image' button. Mkisofs
  659. will be called with the options you've set. Afterwards select the 'Write-CD' button to write the created ISO-Image on
  660. CD. The contents of the folder will be written into the root-directory of the CD.
  661. :p.
  662. Beside filesystem objects you can also put shadows into the folder
  663. to create a virtual tree of files. When building the image
  664. the linked to files and folders are searched. Only one level
  665. of linkage is supported. That means shadows in
  666. shadow-folders are ignored.
  667. :p.
  668. :link reftype=hd res=221.Main window help:elink.
  669. :p.
  670. This DLL and the accompaigning program are provided 'as is' under the terms of the Gnu Public Licence (GPL).
  671. For further information read the file :link reftype=hd res=202.'COPYING':elink..
  672. :p.
  673. :link reftype=hd res=211.History:elink.
  674. :p.
  675. :note text='Author:'. Chris Wohlgemuth.
  676. :note text='E-Mail:'. christopher.wohlgemuth@bch.siemens.de
  677. :note text='WWW:'.    http&colon.&slr.&slr.www.geocities.com&slr.SiliconValley&slr.Sector&slr.5785&slr.
  678. :p.
  679.  
  680. :h2 res=211.History
  681. :p.
  682. V0.11
  683. :sl.
  684. :li.New features:
  685. :ul compact.
  686. :li.Create CD on-the-fly
  687. :li.Option to control the behaviour of the CDRecord/2 window (hide, close on exit)
  688. :eul.
  689. :li.Fixes:
  690. :ul compact.
  691. :li.Entryfield for image name sometimes not accepted the entered name
  692. :li.Directories linked as shadows are now properly inserted into the image
  693. :li.Various other small fixes
  694. :eul.
  695. :esl.
  696. :p.
  697. :p.
  698. 24.04.1999  V0.1
  699. :p.
  700. First public version
  701.  
  702.  
  703. :h2 res=221.Main window help
  704. :p.
  705. Put all the files and directories you want to burn on CD into this folder. You don't have to
  706. make copies of your files. Create shadows to save some space. Remember that only one level of shadow
  707. nesting is allowed. Select the action you want to perform on the left side of the window. 
  708. .br
  709. You may
  710. create an image file only, write an already created image on CD or even create a CD on the fly.
  711. :p.
  712.  For further information select one of the items below:
  713. :p.
  714. :link reftype=hd res=222.Create image only:elink.
  715. :p.
  716. :link reftype=hd res=223.Write only:elink.
  717. :p.
  718. :link reftype=hd res=224.On the fly:elink.
  719. :p.
  720. :link reftype=hd res=225.Settings:elink.
  721. :p.
  722. :link reftype=hd res=226.Dummy:elink.
  723. :p.
  724. :link reftype=hd res=227.Browse:elink.
  725. :p.
  726. :link reftype=hd res=228.Imagename:elink.
  727.  
  728. :h3 res=222.Create image only
  729. :p.
  730. Use this option if you only want to create an image file contain your data. You may
  731. burn this image later on a CDR after checking :hp2.Write only:ehp2..
  732.  
  733. :h3 res=223.Write only
  734. :p.
  735. Select this check box if you want to write an already existing image on CDR. Use the
  736. entryfield and the :hp2.browse:ehp2. button at the top to select the image file. After doing so
  737. press the :hp2.write:ehp2. button. You may select :hp2.Dummy:ehp2. if you only want to do a test. 
  738.  
  739. :h3 res=224.On the fly
  740. :p.
  741. When choosing :hp2.On the fly:ehp2. the data will be written directly on the CDR without
  742. creating an intermediate image file. Be sure the performance of your system is sufficient
  743. or a buffer underrun may occur causing the disk to be damaged. It's always a good idea to do
  744. some tests in -dummy mode first to check the configuration.
  745.  
  746. :h3 res=225.Settings
  747. :p.
  748. Choose this button to open the settings notebook of the Data-CD-Creator folder. In the notebook
  749. you may change the type of CD you want to create, the filename options and the paths to
  750. the helper applications like CDRecord/2 and mkisofs.
  751.  
  752. :h3 res=226.Dummy
  753. :p.
  754. When selecting this option all writing is done in test mode. This means the laser of the writer
  755. is turned off and no data is written on the CDR. This is useful to test the performance and
  756. configuration of the machine to make sure a real write will be successful.
  757.  
  758. :h3 res=227.Browse
  759. :p.
  760. Use this button to search an image file using the standard file dialog. If you know the name
  761. and position of the file you may enter the full path directly into the entryfield.
  762. :p.
  763. If you want to create an image you may use the file dialog to find the location where
  764. the file will be written to. Select the apropriate subdirectory and enter a filename into
  765. the file dialog. After pressing :hp2.Ok:ehp2. the full path will be put into the entryfield.
  766. If the file already exists the image will be overwritten.
  767.  
  768. :h3 res=228.Imagename
  769. :p.
  770. Enter the full path to the imagefile into this field. If you want to write the image on
  771. CD it's the source path.
  772. :p.
  773. If you want to create an image it's the destination path. If you select an already existing
  774. filename, this image will be overwritten.
  775.  
  776. :h1 res=1900.CD-type selection
  777. :p.
  778. Select on this page the type of CD you want to create. There is support for singlesession and
  779. multisession CDs. According to the selection there're different options avaiable. When creating
  780. multisession CDs it's possible to gather all necessary information from this page. There is no
  781. need to start CDRecord/2 by hand.
  782. :p. 
  783. Choose one of the items below to get further information. 
  784. :sl.
  785. :li.:link reftype=hd res=1910.Multisession:elink.
  786. :li.:link reftype=hd res=1920.Singlesession:elink.    
  787. :esl. 
  788.  
  789. :h2 res=1910.Multisession
  790. :p.
  791. When creating a multisession CD the image is written in a way on the CD which
  792. allows to append another session. Be sure to select Rockridge extensions on the filename page or mkisofs
  793. can't merge the created image into the next session.
  794. :p.
  795. :ul.
  796. :li.If you want to write the first session of a multisession disk just select the 'First session'-checkbox.
  797. Data-CD-Creator will provide the '-multi' switch when starting CDRecord/2 to write this session.
  798. :li.When writing the following sessions you have to uncheck the 'First session'-checkbox. After doing so some more
  799. items are selectable. It's necessary to give two magic numbers to mkisofs so previous sessions are merged into
  800. the current image. To get these numbers just click 'Get it...'. Data-CD-Creator will prompt for inserting the
  801. disk with the previous session and will start CDRecord/2 with the '-msinfo' switch afterwards. You can also gather
  802. these numbers by hand and insert them into the two entryfields. If you check 'Use writer as source' mkisofs reads
  803. the previous session from the disk in your writer as specified in the options on the 'CDRecord/2'-page.
  804. In the other case mkisofs uses the specified drive. The latter is only possible if you're using a version of mkisofs
  805. which is able to read from drives given as drive letters. The port done by R. Lalla has got this feature.   
  806. :eul.
  807. :p.
  808.  
  809. :h2 res=1920.Singlesession
  810. :p.
  811. After selecting singlesession you have to choose the tracktype for your CD. All other items on
  812. the settings page are disabled. For further information about tracktypes read the documentation coming with cdrecord or click one of the items below. Keep in mind that the documentation
  813. coming with cdrecord is usually more up to date.
  814. :sl.
  815. :li.:link reftype=hd res=1921.data:elink.
  816. :li.:link reftype=hd res=1922.mode2:elink.    
  817. :li.:link reftype=hd res=1923.XA1:elink.
  818. :li.:link reftype=hd res=1924.XA2:elink.
  819. :li.:link reftype=hd res=1925.CDI:elink.
  820. :esl. 
  821.  
  822. :h3 res=1921.data
  823. :p.
  824. From the documentation of cdrecord V1.8a19:
  825. :p.
  826. -data: If this flag is present, all subsequent tracks are written in CD-ROM mode 1 (Yellow Book) 
  827. format. The data is a multiple of 2048 bytes. The file with track data should contain an ISO-
  828. 9660 or Rock Ridge filesystem image (see mkisofs for more details). If the track data is an ufs 
  829. filesystem image, fragment size should be set to 2 KB or more to allow CR-drives with 2 KB 
  830. sector size to to be used for reading.
  831.  
  832. :h3 res=1922.mode2
  833. :p.
  834. From the documentation of cdrecord V1.8a19:
  835. :p.
  836. -mode2: 
  837. If this flag is present, all subsequent tracks are written in CD-ROM mode 2 format. The data is 
  838. a multiple of 2048 bytes.
  839.  
  840. :h3 res=1923.XA1
  841. :p.
  842. From the documentation of cdrecord V1.8a19:
  843. :p.
  844. -xa1: If this flag is present, all subsequent tracks are written in CD-ROM XA mode 1 format. The 
  845. data is a multiple of 2048 bytes.
  846.  
  847. :h3 res=1924.XA2
  848. :p.
  849. From the documentation of cdrecord V1.8a19:
  850. :p.
  851. -xa2: If this flag is present, all subsequent tracks are written in CD-ROM XA mode 2 format. The 
  852. data is a multiple of 2048 bytes.
  853.  
  854. :h3 res=1925.CDI
  855. :p.
  856. From the documentation of cdrecord V1.8a19:
  857. :p.
  858. -cdi If this flag is present, all subsequent tracks are written in CDI format. The data is a multiple of 
  859. 2048 bytes.
  860.  
  861. :h1 res=1400.Filename options
  862. :p.
  863. Specify the filename options for the files to be written to CD on this page. For more information on the meaning
  864. of the options read the mkisofs documentation or click the items below. Keep in mind that the documentation
  865. coming with mkisofs is usually more up to date.
  866. :sl.
  867. :li.:link reftype=hd res=1401.Allow 32 character filenames:elink.
  868. :li.:link reftype=hd res=1402.Allow leading periods:elink.    
  869. :li.:link reftype=hd res=1403.Generate Joliet filenames:elink.
  870. :li.:link reftype=hd res=1404.Generate Rockridge extensions:elink.
  871. :li.:link reftype=hd res=1405.Generate TRANS.TBL files:elink.
  872. :esl. 
  873.  
  874. :h2 res=1401.Allow 32 character filenames
  875. :p.
  876. From the mkisofs (V1.2b4) documentation:
  877. :p.
  878. -l Allow full 32 character filenames. Normally the ISO9660 filename will be in an 8.3 format 
  879. which is compatible with MS-DOS, even though the ISO9660 standard allows filenames of up 
  880. to 32 characters. If you use this option, the disc may be difficult to use on a MS-DOS system, 
  881. but this comes in handy on some other systems (such as the Amiga). Use with caution.
  882.  
  883. :h2 res=1402.Allow leading periods
  884. :p.
  885. From the mkisofs (V1.2b14) documentation:
  886. :p.
  887. -L Allow filenames to begin with a period. Usually, a leading dot is replaced with an underscore 
  888. in order to maintain MS-DOS compatibility. 
  889.  
  890. :h2 res=1403.Generate Joliet filenames
  891. :p.
  892. From the mkisofs (V1.2b14) documentation:
  893. :p.
  894. -J Generate Joliet directory records in addition to regular iso9660 file names. This is primarily 
  895. useful when the discs are to be used on Windows-NT or Windows-95 machines. The Joliet 
  896. filenames are specified in Unicode and each path component can be up to 64 Unicode characters long.
  897.  
  898. :h2 res=1404.Generate Rockridge extensions
  899. :p.
  900. You have to select Rockridge extension if you want to create a multisession CD.
  901. :p.
  902. From the mkisofs (V1.2b14) documentation:
  903. :p.
  904. -r This is like the -R option, but file ownership and modes are set to more useful values. The uid 
  905. and gid are set to zero, because they are usually only useful on the author's system, and not 
  906. useful to the client. All the file read bits are set true, so that files and directories are globally 
  907. readable on the client. If any execute bit is set for a file, set all of the execute bits, so that exe- 
  908. cutables are globally executable on the client. If any search bit is set for a directory, set all of 
  909. the search bits, so that directories are globally searchable on the client. All write bits are 
  910. cleared, because the CD-Rom will be mounted read-only in any case. If any of the special 
  911. mode bits are set, clear them, because file locks are not useful on a read-only file system, and 
  912. set-id bits are not desirable for uid 0 or gid 0. 
  913.  
  914. :h2 res=1405.Generate TRANS.TBL files
  915. :p.
  916. From the mkisofs (V1.2b14) documentation:
  917. :p.
  918. -T Generate a file TRANS.TBL in each directory on the CDROM, which can be used on non-Rock 
  919. Ridge capable systems to help establish the correct file names. There is also information 
  920. present in the file that indicates the major and minor numbers for block and character devices, 
  921. and each symlink has the name of the link file given.
  922.  
  923. :h1 res=1700.Author
  924. :p.
  925. You may specify some information about the author of the CD on this page.
  926. See the documentation coming with mkisofs for further information.
  927.  
  928.  
  929.  
  930.  
  931. :h1 res=1100.Mkisofs setup
  932. :p.
  933. Use this page to specify the path to 'mkisofs'. Mkisofs is the program to build the ISO-image which will
  934. be written to the CD. You can't write the files directly on the CD. It's always necessary to build an
  935. image first! Mkisofs is included in the CDRecord/2 distribution. There is another port avaiable created
  936. and maintained by R. Lalla. I recommend to use this port or the one from cdrecord_1.8a15 or above. The version of
  937. mkisofs included in cdrecord_1.8a19 contains a bug so don't use it. 
  938. :p.
  939. You may give some additional options for mkisofs which are not covered by the other
  940. pages of the settings notebook using the entryfield .
  941. :p.
  942. For more information click on the links below:
  943. :sl.
  944. :li.:link reftype=hd res=1005.Start hidden:elink.
  945. :li.:link reftype=hd res=1006.Close window on exit:elink.
  946. :esl.
  947.  
  948.  
  949. :h2 res=1005.Start hidden
  950. :p.
  951. If checked the window of the mkisofs process which is started in the background is hidden.
  952. You can always make it visible using the window list to read the mkisofs messages. Uncheck the button to start mkisofs visible.
  953.  
  954. :h2 res=1006.Close window on exit
  955. :p.
  956. If checked the mkisofs window closes after termination of the mkisofs process. All messages are lost then.
  957. If you need the mkisofs output for example for debugging leave the check box unchecked.
  958.  
  959.  
  960. :euserdoc.
  961.  
  962.  
  963.  
  964.  
  965.  
  966.  
  967.  
  968.  
  969.  
  970.  
  971.  
  972.  
  973.  
  974.  
  975.  
  976.