NeroCmd v1.5 User`s Manual
Contents
1. v1 5 User s Manual NeroCmd will only work with a fully installed Nero version v1 05 Copyright 2002 Ahead Software AG Ahead Software AG Im Stockmaedle 18 76307 Karlsbad Germany v1 5 User s Manual 1 Contents 1 GOMTONTS cem 2 2 tee ele 3 3 eee 4 3 1 ueni ET 4 3 2 came ree ao 4 3 3 ize itus EE 4 4 Using the Sample Parameter 5 gt T E T up III RIETI Ree eR 6 5 1 List Available Drives uc oett ete en EO oeque a lee e ale t tbe d ung 6 5 2 Obtain Information About A CD s iicet notte tortus utes br teva 7 5 3 Write Audio ISO CD or ISO 7 5 4 Write Video CD s xi d eee ee e wath cel ea sale ede Men de 9 5 5 Write Super Video CD cte eee eet tomo e e FREE dae eee 10 5 6 Write Image eio eode e e A store rte dde Edd er e 11 5 7 Write BreestylesCD i uote buit m2. v1 5 User s Manual 5 5 Write Super Video CD This function will create a Super Video CD SVCD Compared to Video CD the SVCD supports higher resolutions and variable bitrate MPEG 2 video encoding as well as MPEG 1 or MPEG 2 audio encoding You must use a 2x or faster CD ROM drive to read SVCDs as opposed to 1x drives for VCD Command Function write Write Super Video CD Parameters Description no_error_log Do not log errors at all error_log lt log filename gt Store NeroCmd error messages in lt log filename nero log timestamp Adds a timestamp to the NeroAPI error log Useful for batch operations parameter_file parameter_file contains command line arguments drivename lt name gt lt name gt is either the full name of the drive or the drive letter real Forces the disk to be burned if not specified the process is only simulated tao Disk is burned in TAO Track At Once mode if not specified DAO Disk At Once is default svideocd Mandatory parameter for Super Video CDs speed lt speed gt Select desired speed speeatest Test speed before burning enable abort Notify which operations can and which cannot be aborted close session Close session not the whole disk video file 1 gt video file 2 gt List of video files At least one file needs to be specif
3. Disk is burned in TAO Track At Once mode if not specified DAO Disk At Once is default videocd Mandatory parameter for Video CDs speed lt speed gt speed is speed at which the CD will be burned speeatest Test speed before burning enable abort Notify which operations can and which cannot be aborted close session Close session not the whole disk video file 1 gt video file 2 gt List of video files At least one file needs to be specified iso lt volumename gt Name the ISO volume iso no joliet No long filenames iso mode2 Select ISO mode 2 speeatest Test speed before burning enable abort Notify which operations can and which cannot be aborted close session Close session not the whole disk detect non empty Detect if burn process is to take place on a non empty CDRW and offer to take certain actions force erase In combination with detect non empty cdrw this parameter will erase a non empty CDRW without prompting the user underrun prot Protect from underrun condition disable eject Disables CD ejection after burn completion lt disk file 1 gt disk file 2 At least one one disk file needs to be specified if ISO has been selected Ahead Software AG
4. NeroCmd error messages in log filename nero log timestamp Adds a timestamp to the NeroAPI error log Useful for batch operations parameter_file parameter file contains command line arguments drivename lt name gt lt name gt is either the full name of the drive or the drive letter filename Read contents of track with number XY into file filename The file name has to include the suffix Only will be accepted XY lt filename gt Read additional tracks Ahead Software AG 13 v1 5 User s Manual 5 9 Erase CDRW DVDRW media With this command CDRWs are erased either by doing a quick erase or by sweeping the whole CDRW to ensure that the data is unretrievably removed Command Function erase Erase CDRW Parameters Description no_error_log Do not log errors at all error_log lt log filename gt Store NeroCmd error messages in lt log filename gt nero_log_timestamp Adds a timestamp to the NeroAPI error log Useful for batch operations parameter_file parameter file contains command line arguments entire By default a quick erase is done where the actual content of the CDRW DVDRW is not erased The entire option sweeps the whole CDRW DVDRW insuring that no data can be retrieved by any
5. means afterwards drivename lt name gt name is either the full name of the drive or the drive letter 5 10 Eject CD This command will eject a CD that is loaded in a CD ROM drive Command Function eject Eject CD Parameters Description no error log Do not log errors at all error log log filename Store NeroCmd error messages in log filename nero log timestamp Adds a timestamp to the NeroAPI error log Useful for batch operations parameter_file parameter_file contains command line arguments drivename lt name gt name is either the full name of the drive or the drive letter Ahead Software AG 14 v1 5 User s Manual 5 11 Load CD This command will load a CD into a CD ROM drive Command Function load Loads a CD into the drive Parameters Description no_error_log Do not log errors at all error_log lt log filename gt Store NeroCmd error messages in lt log filename gt nero_log_timestamp Adds a timestamp to the NeroAPI error log Useful for batch operations parameter_file parameter_file contains command line arguments drivename lt name gt name is either the full name of the drive or the drive letter 5 12 Retrieve Version Information This command retri
6. to the NeroAPI error log s file name Useful for batch operations parameter_file parameter file contains command line arguments drivename lt name gt name is either the full name of the drive or the drive letter 5 3 Write Audio ISO CD or ISO CD DVD This function will burn ISO CDs DVDs and Audio ISO CDs allowing settings like Rockridge format UDF or import of ISO tracks Often referred to as CD EXTRA or CD Plus these Audio ISO discs contain two sessions The first session contains up to 98 audio tracks the second session contains the data track When played on an audio player it only sees the first session and so does not try to play the data session Command Function write Write Audio ISO Mixed Mode CD Parameters Description no error log Do not log errors at all error log log filename Store NeroCmd error messages in log filename nero log timestamp Adds a timestamp to the NeroAPI error log s file name Useful for batch operations parameter_file parameter file contains command line arguments drivename lt name gt lt name gt is either the full name of the drive or the drive letter real Forces the disk to be burned if not specified the process is only simulated tao Disk is burned in TAO Track At Once mode if not specified DAO Disk At Once is default artist lt artist gt Supply artist s name for Au
7. _log Do not log errors at all error_log lt log filename gt Store NeroCmd error messages in lt log filename nero log timestamp Adds a timestamp to the NeroAPI error log Useful for batch operations parameter_file parameter file contains command line arguments drivename lt name gt lt name gt is either the full name of the drive or the drive letter real Forces the disk to be burned if not specified the process is only simulated tao Disk is burned in TAO Track At Once mode if not specified DAO Disk At Once is default artist lt artist gt Supply artist s name for Audio CD title lt title gt Supply Audio CD title speed lt speed gt Select desired speed cdextra Select Mixed Mode import XY Import session number XY iso lt volumename gt Name the ISO volume freestyle mode1 lt filename gt Select freestyle mode 1 freestyle mode2 lt filename gt Select freestyle mode 2 freestyle audio lt filename gt Select iso no joliet No long filenames iso mode2 Select ISO mode 2 speeatest Test speed before burning enable abort Notify which operations can and which cannot be aborted close session Close session not the whole disk detect non empty Detect if burn process is to take plac
8. age for a new NEROAPI INIT DEMOVERSION EXPIRED constant Changed initialization to utilize the new shared API feature 1 4 October 28 2001 Added handling of the dvd parameter The DVD burning feature was introduced with NeroAPI 5 5 4 4 1 5 December 3 2001 Several Bugfixes UserDialog Input wasn t evaluated properly Buffer was overwritten occasionally causing the application to terminate with an error Improved Log File Handling Added force erase cdrw command line parameter to delete CDRW without user interaction when combined with detect non empty cdrw Added nero log timestamp to keep multiple versions of the NeroAPI error log for batch runs Ahead Software AG 17
9. cases a parameter list For example the following command will output information about the CD in drive D NeroCmd cdinfo drivename See the chapters below for valid parameter combinations Square brackets indicate that a parameter is optional However when writing an Audio ISO CD you have to supply at least one valid set of parameters 5 1 List Available Drives This command will output a formatted list of all available CD ROM drives Command Function listdrives List available drives Parameters Description no_error_log Do not log errors at all error_log lt log filename gt Store NeroCmd error messages in lt log filename nero log timestamp Adds a timestamp to the NeroAPI error log s file name Useful for batch operations parameter_file parameter file contains command line arguments Ahead Software AG v1 5 User s Manual 5 2 Obtain Information About A CD This command will output what kind of media the drive contains CD ROM CD R or CD RW It will also output additional information like CD title free capacity number of tracks track details etc Command Function cdinfo Obtain information about a CD Parameters Description no_error_log Do not log errors at all error_log lt log filename gt Store NeroCmd error messages in lt log filename gt nero_log_timestamp Adds a timestamp
10. de Dad 12 5 8 Read Audio Tracks oho etti tei estet id nd 13 5 9 14 MEME E M P E E 14 5 115 koad 15 5 12 Version Information on nar tte n er d debi 15 6 veal cate vaca ead EE OVER Ee Ce GE Or EE ee ET CREE EF RENE RN TEE 16 7 Software Version History ecce rer cr ane ako nnno cao aono tk ka arae kann ne aka rone eain 17 Ahead Software AG 2 v1 5 User s Manual 2 License Agreement IMPORTANT PLEASE READ THE SOFTWARE LICENSE AGREEMENT LICENSE CAREFULLY BEFORE USING THE SOFTWARE USING THE SOFTWARE INDICATES YOUR ACKNOWLEDGMENT THAT YOU HAVE READ THE LICENSE AND AGREE TO ITS TERMS The license agreement is contained in a text file NeroSDK License txt to be found in the root folder of the installation package Ahead Software AG 3 v1 5 User s Manual 3 Introduction 3 1 Motivation NeroCmd is a console application that facilitates the processing of commands understood by the This part of the documentation has been created for users w
11. dio CD title lt title gt Supply Audio CD title Ahead Software AG 7 v1 5 User s Manual Command Function write Write Audio ISO Mixed Mode CD continued Parameters Description speed lt gt speed is speed at which the CD will be burned audio lt file1 gt lt file2 gt Disk is burned with Audio information A list of Audio files to burn is supplied Allowed types are wav mp3 wma and pcm cdextra CD Extra will arrange the ISO track behind the audio tracks in a seperate session so the CD can be played by regular Audio CD players dvd Burn on DVD or DVDRW media This option cannot be used in combination Audio or mixed mode import XY Import session number XY iso lt volumename gt Name the ISO volume iso no joliet No long filenames iso mode2 Select ISO mode 2 speeatest Test speed before burning enable_abort Notify which operations can and which cannot be aborted close_session Close session not the whole disk detect_non_empty_cdrw Detect if burn process is to take place ona non empty CDRW and offer to take certain actions force erase In combination with detect non empty cdrw this parameter will erase a non empty CDRW without prompting the user cd text Wri
12. e on a non empty CDRW and offer to take certain actions force erase In combination with detect non empty cdrw this parameter will erase a non empty CDRW without prompting the user cd text Write CD Text if supported by device underrun prot Protect from underrun condition Ahead Software AG 12 v1 5 User s Manual Command Function write Write Freestyle CD continued Parameters Description import_rockridge Import Rockridge format import iso only Import ISO only prefer rockridge Prefer Rockridge format use rockridge Use Rockridge format iso fs Create ISO file system create udf fs Create UDF file system disable eject Disables CD ejection after burn completion verify Verify ISO filesystem after writing lt disk file 1 gt disk file 2 Any number of freestyle tracks can be specified up to 99 tracks 5 8 Read Audio Tracks CD ROM drives that have DAE Digital Audio Extraction capabilities can be used to create copies of the raw Audio data stored on Audio CDs This command relies on that capability Command Function read Read Audio track s Parameters Description no error log Do not log errors at all error log log filename Store
13. eves version information on the currently used NeroAPI Command Function version Retrieve version information Parameters Description no_error_log Do not log errors at all error_log lt log filename gt Store NeroCmd error messages in lt log filename nero log timestamp Adds a timestamp to the NeroAPI error log Useful for batch operations Gparameter file parameter file contains command line arguments Ahead Software AG 15 v1 5 User s Manual 6 Exit Code When NeroCmd application terminates it supplies an exit code which indicates whether the requested operation was executed successfully or an error has occured The following table lists the exit codes that NeroCmd will provide Exit Code Meaning 0 Unknown error 1 Ok 2 Bad usage 3 Internal error 4 NEROAPI DLL was not found 5 Serial number was not found 6 Serial number is invalid 7 NoCD was inserted 8 CDRW is not supported 9 There was an error erasing CDRW 10 There was an error obtaining a list of available drives 11 Drive name is missing 12 There was an error while trying to access the drive 13 Drive was not found 14 Unknown CD format 15 Invalid drive 16 Burn process failed 17 Functio
14. ho want to benefit from the functionality without having to understand the machinery inside If however you should be interested in finding out more about the inner mechanics of the software you will find a detailed discussion the NeroCmd Developer s Manual That paper will give you enough information to let you to change the NeroCmd parser to fit your own more refined requirements 3 2 Overview This paper will provide a comprehensive list of available options for NeroCmd and examples of use NeroCmd can perform the following tasks e Listall available drives Get CD info for a presently inserted CD into some drive Burn o ISO DVD o ISO Audio CD o Video CD o Super Video CD o CD from image o Freestyle CD Grab Audio tracks and store them in disk files Digital Audio Extraction Eject Load CD from drive Erase CD Rewritable DVD Rewritable Display NeroAPI version information 3 3 Requirements NeroCmd will work on any platform which is fit for hosting Nero 5 5 7 8 Nero needs to be installed and licensed prior to using NeroCmd NeroCmd will not work with Linux You can obtain the latest version of Nero from http www nero com Ahead Software AG v1 5 User s Manual 4 Using the Sample Parameter File A sample parameter file is provided with the NeroCmd application You can use and alter it as you wish Corp 1981 1999 Open a Co
15. ied iso lt volumename gt Name the ISO volume iso no joliet No long filenames iso mode2 Select ISO mode 2 speeatest Test speed before burning enable_abort Notify which operations can and which cannot be aborted close session Close session not the whole disk detect non empty Detect if burn process is to take place on a non empty CDRW and offer to take certain actions force erase In combination with detect non empty this parameter will erase a non empty CDRW without prompting the user underrun prot Protect from underrun condition disable eject Disables CD ejection after burn completion lt disk file 1 gt disk file 2 At least one one disk file needs to be specified if ISO has been selected Ahead Software AG 10 NeroCmd v1 5 User s Manual 5 6 Write Image This function will burn a CD image already existing on your harddisk to a CD R or CD RW Command Function write Write Image Parameters Description no error log Do not log errors at all error log log filename Store NeroCmd error messages in log filename nero log timestamp Adds a timestamp to the NeroAPI error log Useful for batch operations parameter_file parameter_file contains command line argume
16. mmand Shell and change to the drive and directory where NeroCmd exe is stored on your hard drive If NeroCmd exe is in d NeroCmd you would type d ENTER to change to drive D and then cd NeroCmd lt ENTER gt The sample parameter file is named ParameterFile txt Now type NeroCmd ParameterFile txt lt ENTER gt This will have the same effect as typing this line NewoCicl real tao Close Session import driveneme wudite 1 TeSt exe bleee log roa ENTER Here is what the content of ParameterFile looks like Parameter File for demonstration purposes Comments are started with semicolon select write command real tao no simulation track at once Glose session p close session rather than entirs cise import 0 import session 0 iso test TestFiles ex volume name is test Filles in TestFiles Cisalole drivenam do not eject disc after burning log Myfrrorlog tzt 7 Give the error log a mame Ahead Software AG v1 5 User s Manual 5 Using NeroCmd This application can read information about a CD burn audio CDs burn ISO CDs burn mixed mode CDs burn Video and Super Video CD extract CDA tracks Open a command window MS DOS shell and type NeroCmd followed by a command and in most
17. n was not allowed 18 Drive was not allowed 19 There was an error obtaining CD info 20 Track was not found 21 File type is unknown 22 Digital audio extraction failed 23 There was error openning the file 24 Out of memory 25 Error determining the length of input file 26 Eject Load failed 27 Invalid session number to import 28 Failed to create ISO track 29 Specified file was not found 30 User aborted 31 Demo version has expired Ahead Software AG 16 v1 5 User s Manual 7 Software Version History Version Date Comments 1 0 November 24 2000 Initial version 1 1 December 6 2000 Updates according to the changes in NeroAPI version 5 0 3 4 UserDialog callback function has been modified to support new DLG_NON_EMPTY_CDRW callback Two new command line parameters have been added One is detect_non_empty_cdrw and the other is cd_text The code around NerolmportlsoTrack has been updated according to the NeroAPI changes Error handling has been improved 1 2 April 5 2001 Updates according to the changes in NeroAPI version 5 5 0 6 Changed project name from NeroBATCH to NeroCmd 1 3 April 23 2001 Updates according to the changes in NeroAPI version 5 5 1 4 Added two cmd line options according to the two new NBF constants Added a new EXITCODE and a corresponding error mess
18. nts drivename lt name gt lt name gt is either the full name of the drive or the drive letter real Forces the disk to be burned if not specified the process is only simulated tao Disk is burned in TAO Track At Once mode if not specified DAO Disk At Once is default image image filename speed lt speed gt Select desired speed speedtest Test speed before burning enable abort Notify which operations can and which cannot be aborted close session Close session not the whole disk detect non empty Detect if burn process is to take place on a non empty CDRW and offer to take certain actions force erase In combination with detect non empty cdrw this parameter will erase a non empty CDRW without prompting the user underrun prot Protect from underrun condition disable eject Disables CD ejection after burn completion Ahead Software AG 11 v1 5 User s Manual 5 7 Write Freestyle CD This function will allow you to write any type of CD Layout e g containing a raw data track at the beginning of the disc instead of a self made ISO UDF filesystem This is good for writing iso images as can be downloaded everywhere on the net Command Function write Write Freestyle CD Parameters Description no_error
19. te CD Text if supported by device underrun prot Protect from underrun condition import_rockridge Import Rockridge format import iso only Import ISO only prefer rockridge Prefer Rockridge format use rockridge Use Rockridge format create iso fs Create ISO file system create fs Create UDF file system disable eject Disables CD ejection after burn completion verify Verify ISO filesystem after writing lt disk 1 gt disk file 2 gt At least one audio file or one disk file needs to be specified Ahead Software AG v1 5 User s Manual 5 4 Write Video CD This function will create a Video CD A video CD contains MPEG full motion video sequences Command Function write Write Video CD Parameters Description no_error_log Do not log errors at all error_log lt log filename gt Store NeroCmd error messages in lt log filename gt nero_log_timestamp Adds a timestamp to the NeroAPI error log Useful for batch operations parameter_file parameter file contains command line arguments drivename lt name gt lt name gt is either the full name of the drive or the drive letter real Forces the disk to be burned if not specified the process is only simulated tao
Download Pdf Manuals
Related Search