Platforms to show: All Mac Windows Linux Cross-Platform
DRBurnMBS class
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
class | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Each time you want to burn to a disc, an instance of DRBurnMBS needs to be created.
When an instance is created, you pass in an instance of DRDevice to let the DRBurn object know what device to use. This object is retained for the life of the DRBurn instance. Before burning, you can set several options that control the behavior of the burn and the handling of the disc once the burn completes.
A DRBurn object will send out notifications through the DRNotificationCenter mechanism to broadcast the burn state to any interested observers. However, if for some reason you don't want to use notifications, you can poll the burn object at any time for the current status using the status properties. This is not recommended in any application using a run loop, because it involves polling.
All methods in this class will catch exceptions from Cocoa and raise a NSExceptionMBS instead. Using the message, name and reason properties you can see what was the reason for this exception. Please report if you find a method which does not handle exceptions correct.
- 11 properties
- property appendable as boolean
- property BurnFailureAction as string
- property completionAction as string
- property DoubleLayerL0DataZoneBlocks as Double
- property MediaCatalogNumber as memoryblock
- property Overwrite as boolean
- property properties as dictionary
- property requestedBurnSpeed as single
- property Testing as boolean
- property UnderrunProtection as boolean
- property verifyDisc as boolean
- 8 methods
- method abort
- method Constructor(device as DRDeviceMBS)
- method device as DRDeviceMBS
- method status as dictionary
- method writeImageFile(ImageFile as FolderItem) as boolean
- method writeImageFile(ImagePath as String) as boolean
- method writeLayout(track as DRTrackMBS)
- method writeLayout(tracks() as DRTrackMBS)
- 54 shared methods
- shared method burnForDevice(device as DRDeviceMBS) as DRBurnMBS
- shared method DRBurnAppendableKey as string
- shared method DRBurnCompletionActionEject as string
- shared method DRBurnCompletionActionKey as string
- shared method DRBurnCompletionActionMount as string
- shared method DRBurnDoubleLayerL0DataZoneBlocksKey as string
- shared method DRBurnFailureActionEject as string
- shared method DRBurnFailureActionKey as string
- shared method DRBurnFailureActionNone as string
- shared method DRBurnOverwriteDiscKey as string
- shared method DRBurnRequestedSpeedKey as string
- shared method DRBurnStatusChangedNotification as string
- shared method DRBurnStrategyBDDAO as string
- shared method DRBurnStrategyCDSAO as string
- shared method DRBurnStrategyCDTAO as string
- shared method DRBurnStrategyDVDDAO as string
- shared method DRBurnStrategyIsRequiredKey as string
- shared method DRBurnStrategyKey as string
- shared method DRBurnTestingKey as string
- shared method DRBurnUnderrunProtectionKey as string
- shared method DRBurnVerifyDiscKey as string
- shared method DRCDTextKey as string
- shared method DRErrorStatusAdditionalSenseStringKey as string
- shared method DRErrorStatusErrorInfoStringKey as string
- shared method DRErrorStatusErrorKey as string
- shared method DRErrorStatusErrorStringKey as string
- shared method DRErrorStatusKey as string
- shared method DRErrorStatusSenseCodeStringKey as string
- shared method DRErrorStatusSenseKey as string
- shared method DRMediaCatalogNumberKey as string
- shared method DRStatusCurrentSessionKey as string
- shared method DRStatusCurrentSpeedKey as string
- shared method DRStatusCurrentTrackKey as string
- shared method DRStatusEraseTypeKey as string
- shared method DRStatusPercentCompleteKey as string
- shared method DRStatusProgressCurrentKPS as string
- shared method DRStatusProgressCurrentXFactor as string
- shared method DRStatusProgressInfoKey as string
- shared method DRStatusStateDone as string
- shared method DRStatusStateErasing as string
- shared method DRStatusStateFailed as string
- shared method DRStatusStateFinishing as string
- shared method DRStatusStateKey as string
- shared method DRStatusStateNone as string
- shared method DRStatusStatePreparing as string
- shared method DRStatusStateSessionClose as string
- shared method DRStatusStateSessionOpen as string
- shared method DRStatusStateTrackClose as string
- shared method DRStatusStateTrackOpen as string
- shared method DRStatusStateTrackWrite as string
- shared method DRStatusStateVerifying as string
- shared method DRStatusTotalSessionsKey as string
- shared method DRStatusTotalTracksKey as string
- shared method DRSynchronousBehaviorKey as string
This class has no sub classes.
Some methods using this class:
- DRBurnProgressPanelMBS.beginProgressPanelForBurn(burn as DRBurnMBS, track as DRTrackMBS)
- DRBurnProgressPanelMBS.beginProgressPanelForBurn(burn as DRBurnMBS, tracks() as DRTrackMBS)
- DRBurnProgressPanelMBS.beginProgressPanelForImageFile(burn as DRBurnMBS, file as folderitem) as boolean
- DRBurnProgressPanelMBS.beginProgressPanelForImageFile(burn as DRBurnMBS, file as string) as boolean
- DRBurnProgressPanelMBS.beginProgressSheetForBurn(burn as DRBurnMBS, track as DRTrackMBS, docWindow as NSWindowMBS)
- DRBurnProgressPanelMBS.beginProgressSheetForBurn(burn as DRBurnMBS, tracks() as DRTrackMBS, docWindow as NSWindowMBS)
- DRBurnProgressPanelMBS.beginProgressSheetForImageFile(burn as DRBurnMBS, file as folderitem, docWindow as NSWindowMBS) as boolean
- DRBurnProgressPanelMBS.beginProgressSheetForImageFile(burn as DRBurnMBS, file as string, docWindow as NSWindowMBS) as boolean
- DRBurnSetupPanelMBS.burnObject as DRBurnMBS
Some events using this class:
- DRBurnProgressPanelMBS.burnProgressPanelBurnDidFinish(burn as DRBurnMBS) as boolean
- DRTrackMBS.prepareTrack(burn as DRBurnMBS) as boolean
Some examples using this class:
- /MacCocoa/DiscRecording/DataBurn with Events
- /MacCocoa/DiscRecording/DataBurn with Events and Notification
- /MacCocoa/DiscRecording/DataBurn with Track Events
- /MacCocoa/DiscRecording/DataBurn with Track Events with ISRC and MCN
Blog Entries
- MBS Real Studio Plugins, version 11.3pr1
- MBS REALbasic Plugins Version 10.4 release notes
- MBS REALbasic Plugins, version 10.4pr7
- MonkeyBread Software Releases the MBS Plugins 8.2
The items on this page are in the following plugins: MBS MacControls Plugin.
DragItem - DRBurnProgressPanelMBS