Platforms to show: All Mac Windows Linux Cross-Platform
Back to DRFileMBS class.
DRFileMBS.calculateSizeOfFile(fork as Integer, estimating as boolean) as uint64
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| event | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No |
This method may be sent at any time after the file object has been instantiated. Requests that the recevier calculate the file size of file fork (for instance data or resource).
If estimate is true, you are being asked for an estimate of the final fork size, perhaps to provide an estimate of the track size, and do not have to be exact. Estimates should err on the high side; it's better to overestimate than underestimate.
An estimate call may be made at any time.
If estimate is false, you are being asked for the actual fork size, to be used in the burn. This call is only made in the burn phase.
fork: The fork of the file whose size is to be calculated.
estimate: If the file size should be estimated or exact.
Return the length of the file's fork.
Some examples using this event:
DRFileMBS.cleanupFileAfterBurn
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| event | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Sent to the receiver after the burn completes. This would be an appropriate place to close files, or do any other teardown work needed. This message will always be sent regardless of whether the burn succeeded or failed.
DRFileMBS.prepareFileForBurn as boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| event | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Sent to the recevier before the burn begins. This would be an appropriate
method to open files, or do any other prep work needed. The disc's entire
hierarchy is completely in place and can be queried if needed.
After this call, the burn's content is locked down, and you should be
able to respond to the calculateSizeOfFile messages with exact values.
Some examples using this event:
DRFileMBS.prepareFileForVerification as boolean
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| event | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Called during the burn (after production, before the cleanupFileAfterBurn event is called) to indicate that verification is about to begin. Now would be a good time to rewind to the start of the file, reset state machines, or do whatever else is needed to prepare to produce again.
Some examples using this event:
DRFileMBS.produceFile(fork as Integer, buffer as memoryblock, Bufferlen as uint32, address as uint64, blocksize as uint32) as uint32
| Type | Topic | Plugin | Version | macOS | Windows | Linux | iOS | Targets |
| event | DiscRecording | MBS MacControls Plugin | 7.4 | ✅ Yes | ❌ No | ❌ No | ❌ No |
Sent during the burn (after the prepareFileForBurn message) requesting that the receiver produce the data fork contents.
The recevier should fill up the buffer passed in as full as possible and then return control to the caller. Since while burning, keeping the drive's buffer full is of utmost importance, you should not perform lengthy operations or block for data in this method. This method should return the number of bytes actually in the buffer or 0 to indicate that there was an error producing the data.
You may be asked to produce twice, once during the actual burn and once during verification.
fork: The fork of the file to produce.
buffer: The buffer to produce data into.
bufferLength: The length of the buffer to produce data into
blockSize: The size of the track blocks
Return the number of bytes produced.
Some examples using this event:
The items on this page are in the following plugins: MBS MacControls Plugin.
