= class Burn::WriteOptions
Options relative to writing operations.

== Object Hierarchy
* Object
  * Burn::WriteOptions

== Class Methods
--- Burn::WriteOptions.new(drive)
    Creates a new Burn::WriteOptions for burning to the specified drive.
    * drive: the drive to write with (as a Burn::Drive).  
    * Returns: a newly allocated Burn::WriteOptions object.

== Instance Methods
--- set_perform_opc(state)
    Sets whether the drive should use opc or not.
    * state: if true, optical power calibration will be performed at start of burn.  
    * Returns: self.

--- set_simulate(state)
    Sets wheither the drive should perform a simulation instead of a burn or
    not.
    * state: if true, the drive will perform a simulation instead of a burn.  
    * Returns: true on success, false otherwise.

--- set_toc_entries(*toc_entries)
    Supplies toc entries for writing - not normally required for cd mastering.
    * toc_entries: TOC entries (as a list of Burn::TocEntry objects).  
    * Returns: self.

--- set_underrun_proof(state)
    Controls buffer underrun prevention.
    * state: if true, buffer underrun protection is enabled.   
    * Returns: true on success, false otherwise.

--- set_write_type(write_type, block_type)
    Sets the write type.
    * block_type: the block type to use (either Burn::BLOCK_RAW0, Burn::BLOCK_RAW16, Burn::BLOCK_RAW96P, Burn::BLOCK_RAW96R, Burn::BLOCK_MODE1, Burn::BLOCK_MODE2_PATHETIC, Burn::BLOCK_MODE2_LAME, Burn::BLOCK_MODE2_OBSCURE, Burn::BLOCK_MODE2_OK, Burn::BLOCK_MODE2R).  
    * write_type: the write type to use (either Burn::WriteOptions::TYPE_PACKET, Burn::WriteOptions::TYPE_TAO, Burn::WriteOptions::TYPE_SAO, Burn::WriteOptions::TYPE_RAW). 
    * Returns: true on success, false otherwise.

== Constants
--- TYPE_PACKET
    Packet writing.

--- TYPE_RAW
    Raw disc at once recording. All subcodes must be provided by lib
    or user. Only raw block types are supported.

--- TYPE_SAO
    Session At Once.

--- TYPE_TAO
    Track At Once recording. 2s gaps between tracks, no fonky lead-ins.

== See Also
((<Burn>)).

- ((<lrz>))
