Platforms to show: All Mac Windows Linux Cross-Platform
Back to DRBurnMBS class.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
When this method returns the burn might not actually be fully stopped but it has been cancelled and only cleanup is going on. If a burn has not completed writing data to disc, you just made a coaster.
Typically this method is only used as a result of the user hitting a cancel/stop button somewhere in the user interface.
DRBurnMBS.appendable as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
When a burn completes, it can mark the disc so that no more data can be written to it. This creates a closed or non-appendable disc (which is the most compatible with audio CD players). If this method returns false, then the disc will be marked as closed and no data can be appended to it. A return value of true indicates further burns can be appended to the disc.
(Read and Write computed property)
DRBurnMBS.BurnFailureAction as string
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 7.5 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The burn property whose value is a string containing a one of the failure actions possible for the disc handling.
If this key is not present, the burn will default to a value of DRBurnFailureActionEject and the disc will be ejected.
(Read and Write computed property)
DRBurnMBS.completionAction as string
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Value must be DRBurnCompletionActionEject, DRBurnCompletionActionMount or empty for default.
(Read and Write computed property)
DRBurnMBS.Constructor(device as DRDeviceMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Once a burn is created with this method, the object is ready to write data to the disc.
DRBurnMBS.device as DRDeviceMBS
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Returns nil on any error.
DRBurnMBS.DoubleLayerL0DataZoneBlocks as Double
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 8.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The size of the layer 0 data zone dictates where the transition point is from layer 0 to layer 1. If this key is present, the data zone size will be set prior to the start of the burn using the value for this key. If it is not present, the default layer 0 data zone will be used (half the available blocks on an empty disc).
The transition point can be specified two ways. If the value specified in this key is greater than 1.0, then it will designate an absolute block number for the transition point. In this case, the block number should be a multiple of 16 and at least &h40000 per specification. If the value is less than 1.0, it will specify the percentage of the burn that should reside on layer 0. A typical value is 0.5, designating half the burn for each layer. A value of 0.0 or 1.0 will not change the layer 0 transition point.
(Read and Write computed property)
DRBurnMBS.MediaCatalogNumber as memoryblock
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 7.5 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The burn property whose value is a memoryblock containing exactly 13 bytes of data, which will be written to the disc as the Media Catalog Number. If this key is not present, it will default to all zeroes, indicating that a MCN is not supplied.
This value is the UPC/EAN product number, and should conform to the specifications of the UCC and EAN. See
http://www.ean-int.org/
and
http://www.uc-council.org/
for more details on the UPC/EAN standard.
(Read and Write computed property)
Some examples using this property:
DRBurnMBS.Overwrite as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 8.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
If this key is not present, the burn will default to a value of false and the disc will be appended.
(Read and Write computed property)
DRBurnMBS.properties as dictionary
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 10.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
(Read and Write computed property)
DRBurnMBS.requestedBurnSpeed as single
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The actual speed also depends on the capabilities of the bus the device is on, the maximum speed of the device itself, and the media used.
Value is a float indicating the speed the burn should run at in kilobytes per second.
(Read and Write computed property)
DRBurnMBS.status as dictionary
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DiscRecording | MBS MacControls Plugin | 10.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
The same dictionary is returned through the DRBurnStatusChangedNotification notification.
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 8.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
When this is set and the burn starts, the entire burn process proceeds as if data would be written to the disc, but the laser is not turned on to full power, so the physical disc is not modified.
If this key is not present or the selected burning device does not support test burning, the burn will default to a value of false and a normal burn will occur.
(Read and Write computed property)
DRBurnMBS.UnderrunProtection as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 8.2 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
For those devices which support it, burn underrun protection is enabled by default.
If the device supports burn underrun protection and this key is not present, the burn will default to a value of <i>true</i> and burn underrun protection will be enabled.
(Read and Write computed property)
DRBurnMBS.verifyDisc as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
property | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
After data is written to disc, the data can be verified. The verification
process will read the data on the disc back into memory and compare it to the
data originally used to write to disc. The type of verification is determined
by a track property on a track-by-track basis. See the DRTrackMBS documentation for more information on verification types.
(Read and Write computed property)
DRBurnMBS.writeImageFile(ImageFile as FolderItem) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DiscRecording | MBS MacControls Plugin | 7.5 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Requires Mac OS X 10.4.
ImageFile: The path to the image file. This file must be one that can be read by DiscRecording. The supported image types include: .dmg, .iso, .cue, and .toc. For .cue and .toc files the corresponding data files (.bin, .img, etc) must also be present and correctly referenced in the .cue/.toc file.
Returns true on success and false on failure.
See also:
DRBurnMBS.writeImageFile(ImagePath as String) as boolean
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DiscRecording | MBS MacControls Plugin | 7.5 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
Requires Mac OS X 10.4.
ImageFile: The path to the image file. This file must be one that can be read by DiscRecording. The supported image types include: .dmg, .iso, .cue, and .toc. For .cue and .toc files the corresponding data files (.bin, .img, etc) must also be present and correctly referenced in the .cue/.toc file.
Returns true on success and false on failure.
See also:
DRBurnMBS.writeLayout(track as DRTrackMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
A single session disc will be created with the given track.
See also:
Some examples using this method:
DRBurnMBS.writeLayout(tracks() as DRTrackMBS)
Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
method | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No | Desktop only |
A multi session disc will be created with the given tracks.
See also:
The items on this page are in the following plugins: MBS MacControls Plugin.