Primera PTBurn SDK User Manual
  1. Manuals
  2. Brands
  3. Primera Manuals
  4. Software
  5. PTBurn SDK
  6. User manual

Primera PTBurn SDK User Manual

Network-capable, text-based, shared folder burning & printing
Hide thumbs
Table of Contents

Advertisement

Quick Links

Download this manual
PTBurn SDK
Network-capable, text-based, shared folder burning &
Printing
Primera Technology Inc.

Advertisement

Table of Contents
loading
Need help?

Need help?

Do you have a question about the PTBurn SDK and is the answer not in the manual?

Questions and answers

Related Manuals for Primera PTBurn SDK

Summary of Contents for Primera PTBurn SDK

  • Page 1 PTBurn SDK Network-capable, text-based, shared folder burning & Printing Primera Technology Inc.
  • Page 2 PTBurn SDK Page 2 of 53 May 4, 2006 / Revision 2.61 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 3: Table Of Contents

    Burn and Print job of 5 discs with many options specified ........16 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 4 PxWaveSWVer ..................... 23 3.4.20 PxHelp20SWVer....................24 3.4.21 RoboFWVer......................24 3.4.22 DriveDescX......................24 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 5 Appendix C: Job and System Error Codes ................41 Appendix D: Loading/Unloading Override ................. 50 Revision History ........................52 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 6: Introduction

    PT Burn Supports the Disc Publisher, Disc Publisher II, the Disc Publisher PRO, ComposerMAX, Disc Publisher XR and Disc Publisher XRP. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 7: Jrq File Command Structure

    If SessionX is not given then it will be burned into the first (and only) session. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 8: Audiofile

    This specifies the name (including path) of an already-mastered disc image to be burned. The acceptable disc image types include .GI or .ISO. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 9: Deletefiles

    Note that using the wrong value here can cause the image to not fit and lead to an unusable disc. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks...

  • Page 10: Dataimagetype

    This specifies how many copies you want created. The range of values is from 1 to 10,000. The default is 1 if this key is not given. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 11: Printlabel

    If this feature is used, the ClientID key must be set to the client’s computer name. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 12: Cdtextdisctitle

    This key forces the recording engine to preserve the file name as is even if it is out of specification. Possible values: © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 13: Readdatato

    This key will cause PTBurn to check the disc prior to recording to see if the SystemID value in the PVD matches the value of this key. CheckSystemIDOnDisc=PTBurn © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 14: Checkvolumeidondisc

    LoadUnloadOverride This key will enable the manual load and unload functionality. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 15: Premasterdata

    AudioFile = c:\MyMusic\MyTrack1.wav AudioFile = c:\MyMusic\MyTrack2.mp3, Pregap75 AudioFile = c:\MyMusic\MyTrack3.wma, Pregap150 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 16: Burn And Print Job Of 5 Discs With Many Options Specified

    2.2.5 Read Data Job of 3 Discs ClientID=MyComputer JobID=Job0 Importance=2 Copies=3 NotifyClient=Message © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 17: Read Global Image Job Of 3 Discs

    This will create a GI global image file for each of the 3 discs at the following locations: \\MyComputer\PTBurnJobs\ReadData_1.gi \\MyComputer\PTBurnJobs\ReadData_2.gi \\MyComputer\PTBurnJobs\ReadData_3.gi © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 18: Status Information

    Job0, the next job is Job1, etc. So, an example might be: © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 19: Job Details Section

    String that describes what is currently going on with this job. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 20: Timecreated

    (e.g. the first disc of the job = 1, second disc of the job = 2, etc.). © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 21: Discerrornumberx

    2 = Disc Processing 3 = Disc Processed (hold state) 4 = Disc Unloading © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 22: Loaddiscdrivex

    Format is: MM/DD/YYYY hh:mm:ss XX where XX is either AM or PM. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 23: Drivespace

    String that contains the version of PxMas.dll. 3.4.19 PxWaveSWVer String that contains the version of PxWave.dll. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 24: Pxhelp20Swver

    String that contains the name of the job that the recorder is currently assigned to. The X represents an index if multiple robotically controlled drives are present. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 25: Drivediscx

    Number that contains the type of the cartridge. The X is an index when 0 is the left most cartridge. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 26: Drive Statistics Section

    3.6 Example of PTStatus.txt [System] SysErrorString=No Errors SysErrorNumber=0 PtburnSWVer=2, 5, 0, 0 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 27 VerifyingErrorsMedia=0 DriveNotReady=0 [Publisher Drive Top] GoodDiscs=9 BadDiscs=2 ReadingErrors=0 ReadingErrorsMedia=0 RecordingErrors=0 RecordingErrorsMedia=1 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 28 DiscErrorString0 = The media (CD/DVD) is not blank [MyJob2] JobID = Kevin’s music © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 29 TimeCompleted = 12:15:33 4/15/2003 JobState = 2 JobErrorNumber =0 JobErrorString= No Errors © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 30: Client Commands

    The .ptm file can have any name and should be formatted as follows: © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 31: Align Printer Command

    LoadUnloadOverride was set to YES in the jobs jrq file. Message= PROCESS_DISC DiscID=X © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 32: Unload Command

    The ClientID should ALWAYS be fixed to “Administrator”. This command will only work if there are no jobs in the system. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 33 PTBurn SDK Page 33 of 53 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 34: Appendix A: Ptsetup.ini

    ; How long before a lower priority job will be processed over a higher priority job ; (in minutes). © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks...
  • Page 35 ;Used only when you want to specify a bin for each type of media (DVD and CD). The Possible values are © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks...
  • Page 36 ;This key will force PTBurn only to burn to one drive at a time. BurnToOnlyOneDrive=FALSE ; end of PTSETUP.INI © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 37 ; This determines if the printing dialog is minimized or not. ; 0 = not minimized ; 1 = minimized MinimizePrint=1 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 38 PTBurn SDK Page 38 of 53 ; end of Disc Publisher II_CFG.INI © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 39: Appendix B: Deployment Details

    Files\PTBurn”. These files are not location dependent and can be installed to another location if © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 40 PTSETUP.ini BitmapPTBurn.std Disc Publisher_CFG.INI Disc Publisher II_CFG.INI Disc Publisher PRO_CFG.INI PxRobo_MAX.INI © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 41: Appendix C: Job And System Error Codes

    30 Administrator attention: This printer is not compatible with a pigment based cartridge. 31 Administrator attention: The alignment print failed. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 42 Note: This error is specific to Disc Publisher I, and not Disc Publisher II. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 43 Printer tray. Then close the cover and press the left button.” System Error 20 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 44 System Error 29 ** Only used on the DiscPublisherPRO ** © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 45 “The alignment print failed. Would you like to retry the alignment now? Click “Yes” to align the printer, or “No” to quit the application. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 46 33 The PVD data is invalid 34 Invalid job type for specifying PVD Data © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 47 This error will occur when attempting to burn more data than is available on the recordable media. This error will cause the disc to fail. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 48 This error will not occur in the SDK version of PTBurn. Job/Disc Error 23 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 49 This error will occur if PVD fields are specified for any jobs except Data Disc Jobs. This error will cause the job to fail. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 50: Appendix D: Loading/Unloading Override

    This will cause the hold state to end, and the disc will fail and be rejected appropriately. The contents of JobXYZ.ptm would be: © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 51 Here are the contents of JobXYZ.ptm: Message= UNLOAD_DISC DiscID=0 © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

  • Page 52: Revision History

    • Replaced Bravo with Disc Publisher. 1/20/05 - document version 2.5 (initial release of PTBurn 2.5) © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.
  • Page 53 • Many System Errors added. System Error 22 through Error 31 added. • Job/Disc Errors added. Error 31 through 34 added. © 2005, Primera Technology, Inc. Primera is a registered trademark and Bravo is a trademark of Primera Technology, Inc. All other trademarks are the property of their respective companies.

Table of Contents