mrcrowbar.lib.audio.voc module¶

File format classes for the Creative Voice audio format.

Sources: http://www.shikadi.net/moddingwiki/VOC_Format

class mrcrowbar.lib.audio.voc.VOC(*args, **kwargs)[source]¶

Bases: mrcrowbar.blocks.Block

audio_chunk¶

checksum = <Bytes: offset=0x18, length=2>¶

chunks = <ChunkField: 0x00007f3bddf6dd10>¶

header_size = <UInt16_LE: offset=0x14>¶

magic = <Bytes: offset=0x0, length=20>¶

version = <Bytes: offset=0x16, length=2>¶

class mrcrowbar.lib.audio.voc.VOCCodec[source]¶

Bases: enum.IntEnum

An enumeration.

ADPCM_CREATIVE_2_8 = 3¶

ADPCM_CREATIVE_3_8 = 2¶

ADPCM_CREATIVE_4_8 = 1¶

PCM_ALAW = 6¶

PCM_INT16 = 4¶

PCM_UINT8 = 0¶

PCM_ULAW = 7¶

class mrcrowbar.lib.audio.voc.VOCExtra(source_data=None, *, parent=None, preload_attrs=None, endian=None, cache_bytes=False, path_hint=None, strict=False)[source]¶

Bases: mrcrowbar.blocks.Block

Base class for Blocks.

source_data: Source data to construct Block with. Can be a byte string, dictionary of attribute: value pairs, or another Block object.
parent: Parent Block object where this Block is defined. Used for e.g. evaluating Refs.
preload_attrs: Attributes on the Block to set before importing the data. Used for linking in dependencies before loading.
endian: Platform endianness to use when interpreting the Block data. Useful for Blocks which have the same data layout but different endianness for stored numbers. Has no effect on fields with an predefined endianness.
cache_bytes: Cache the bytes equivalent of the Block. Useful for debugging the loading procedure. Defaults to False.
path_hint: Cache a string containing the path of the current Block, relative to the root.
strict: Throw an exception if parsing a BlockField fails, instead of logging a warning and returning an Unknown. Defaults to False.

channels¶

channels_raw = <UInt8: offset=0x3>¶

codec = <UInt8: offset=0x2>¶

freq_divisor = <UInt16_LE: offset=0x0>¶

sample_rate¶

class mrcrowbar.lib.audio.voc.VOCMarker(source_data=None, *, parent=None, preload_attrs=None, endian=None, cache_bytes=False, path_hint=None, strict=False)[source]¶

Bases: mrcrowbar.blocks.Block

Base class for Blocks.

source_data: Source data to construct Block with. Can be a byte string, dictionary of attribute: value pairs, or another Block object.
parent: Parent Block object where this Block is defined. Used for e.g. evaluating Refs.
preload_attrs: Attributes on the Block to set before importing the data. Used for linking in dependencies before loading.
endian: Platform endianness to use when interpreting the Block data. Useful for Blocks which have the same data layout but different endianness for stored numbers. Has no effect on fields with an predefined endianness.
cache_bytes: Cache the bytes equivalent of the Block. Useful for debugging the loading procedure. Defaults to False.
path_hint: Cache a string containing the path of the current Block, relative to the root.
strict: Throw an exception if parsing a BlockField fails, instead of logging a warning and returning an Unknown. Defaults to False.

value = <UInt16_LE: offset=0x0>¶

class mrcrowbar.lib.audio.voc.VOCRepeatEnd(source_data=None, *, parent=None, preload_attrs=None, endian=None, cache_bytes=False, path_hint=None, strict=False)[source]¶

Bases: mrcrowbar.blocks.Block

Base class for Blocks.

source_data: Source data to construct Block with. Can be a byte string, dictionary of attribute: value pairs, or another Block object.
parent: Parent Block object where this Block is defined. Used for e.g. evaluating Refs.
preload_attrs: Attributes on the Block to set before importing the data. Used for linking in dependencies before loading.
endian: Platform endianness to use when interpreting the Block data. Useful for Blocks which have the same data layout but different endianness for stored numbers. Has no effect on fields with an predefined endianness.
cache_bytes: Cache the bytes equivalent of the Block. Useful for debugging the loading procedure. Defaults to False.
path_hint: Cache a string containing the path of the current Block, relative to the root.
strict: Throw an exception if parsing a BlockField fails, instead of logging a warning and returning an Unknown. Defaults to False.

class mrcrowbar.lib.audio.voc.VOCRepeatStart(source_data=None, *, parent=None, preload_attrs=None, endian=None, cache_bytes=False, path_hint=None, strict=False)[source]¶

Bases: mrcrowbar.blocks.Block

Base class for Blocks.

source_data: Source data to construct Block with. Can be a byte string, dictionary of attribute: value pairs, or another Block object.
parent: Parent Block object where this Block is defined. Used for e.g. evaluating Refs.
preload_attrs: Attributes on the Block to set before importing the data. Used for linking in dependencies before loading.
endian: Platform endianness to use when interpreting the Block data. Useful for Blocks which have the same data layout but different endianness for stored numbers. Has no effect on fields with an predefined endianness.
cache_bytes: Cache the bytes equivalent of the Block. Useful for debugging the loading procedure. Defaults to False.
path_hint: Cache a string containing the path of the current Block, relative to the root.
strict: Throw an exception if parsing a BlockField fails, instead of logging a warning and returning an Unknown. Defaults to False.

count¶

count_raw = <UInt16_LE: offset=0x0>¶

class mrcrowbar.lib.audio.voc.VOCSilence(source_data=None, *, parent=None, preload_attrs=None, endian=None, cache_bytes=False, path_hint=None, strict=False)[source]¶

Bases: mrcrowbar.blocks.Block

Base class for Blocks.

source_data: Source data to construct Block with. Can be a byte string, dictionary of attribute: value pairs, or another Block object.
parent: Parent Block object where this Block is defined. Used for e.g. evaluating Refs.
preload_attrs: Attributes on the Block to set before importing the data. Used for linking in dependencies before loading.
endian: Platform endianness to use when interpreting the Block data. Useful for Blocks which have the same data layout but different endianness for stored numbers. Has no effect on fields with an predefined endianness.
cache_bytes: Cache the bytes equivalent of the Block. Useful for debugging the loading procedure. Defaults to False.
path_hint: Cache a string containing the path of the current Block, relative to the root.
strict: Throw an exception if parsing a BlockField fails, instead of logging a warning and returning an Unknown. Defaults to False.

freq_divisor = <UInt8: offset=0x0>¶

length¶

length_raw = <UInt16_LE: offset=0x0>¶

sample_rate¶

class mrcrowbar.lib.audio.voc.VOCSoundData(source_data=None, *, parent=None, preload_attrs=None, endian=None, cache_bytes=False, path_hint=None, strict=False)[source]¶

Bases: mrcrowbar.blocks.Block

Base class for Blocks.

source_data: Source data to construct Block with. Can be a byte string, dictionary of attribute: value pairs, or another Block object.
parent: Parent Block object where this Block is defined. Used for e.g. evaluating Refs.
preload_attrs: Attributes on the Block to set before importing the data. Used for linking in dependencies before loading.
endian: Platform endianness to use when interpreting the Block data. Useful for Blocks which have the same data layout but different endianness for stored numbers. Has no effect on fields with an predefined endianness.
cache_bytes: Cache the bytes equivalent of the Block. Useful for debugging the loading procedure. Defaults to False.
path_hint: Cache a string containing the path of the current Block, relative to the root.
strict: Throw an exception if parsing a BlockField fails, instead of logging a warning and returning an Unknown. Defaults to False.

data = <Bytes: offset=0x0>¶

class mrcrowbar.lib.audio.voc.VOCSoundData12(source_data=None, *, parent=None, preload_attrs=None, endian=None, cache_bytes=False, path_hint=None, strict=False)[source]¶

Bases: mrcrowbar.blocks.Block

Base class for Blocks.

source_data: Source data to construct Block with. Can be a byte string, dictionary of attribute: value pairs, or another Block object.
parent: Parent Block object where this Block is defined. Used for e.g. evaluating Refs.
preload_attrs: Attributes on the Block to set before importing the data. Used for linking in dependencies before loading.
endian: Platform endianness to use when interpreting the Block data. Useful for Blocks which have the same data layout but different endianness for stored numbers. Has no effect on fields with an predefined endianness.
cache_bytes: Cache the bytes equivalent of the Block. Useful for debugging the loading procedure. Defaults to False.
path_hint: Cache a string containing the path of the current Block, relative to the root.
strict: Throw an exception if parsing a BlockField fails, instead of logging a warning and returning an Unknown. Defaults to False.

channels¶

channels_raw = <UInt8: offset=0x5>¶

codec = <UInt16_LE: offset=0x6>¶

data = <Bytes: offset=0xc>¶

reserved = <UInt32_LE: offset=0x8>¶

sample_bits = <UInt8: offset=0x4>¶

sample_rate = <UInt32_LE: offset=0x0>¶

class mrcrowbar.lib.audio.voc.VOCText(source_data=None, *, parent=None, preload_attrs=None, endian=None, cache_bytes=False, path_hint=None, strict=False)[source]¶

Bases: mrcrowbar.blocks.Block

Base class for Blocks.

source_data: Source data to construct Block with. Can be a byte string, dictionary of attribute: value pairs, or another Block object.
parent: Parent Block object where this Block is defined. Used for e.g. evaluating Refs.
preload_attrs: Attributes on the Block to set before importing the data. Used for linking in dependencies before loading.
endian: Platform endianness to use when interpreting the Block data. Useful for Blocks which have the same data layout but different endianness for stored numbers. Has no effect on fields with an predefined endianness.
cache_bytes: Cache the bytes equivalent of the Block. Useful for debugging the loading procedure. Defaults to False.
path_hint: Cache a string containing the path of the current Block, relative to the root.
strict: Throw an exception if parsing a BlockField fails, instead of logging a warning and returning an Unknown. Defaults to False.

text = <CString: offset=0x0>¶

class mrcrowbar.lib.audio.voc.VOCTypedSoundData(source_data=None, *, parent=None, preload_attrs=None, endian=None, cache_bytes=False, path_hint=None, strict=False)[source]¶

Bases: mrcrowbar.blocks.Block

Base class for Blocks.

source_data: Source data to construct Block with. Can be a byte string, dictionary of attribute: value pairs, or another Block object.
parent: Parent Block object where this Block is defined. Used for e.g. evaluating Refs.
preload_attrs: Attributes on the Block to set before importing the data. Used for linking in dependencies before loading.
endian: Platform endianness to use when interpreting the Block data. Useful for Blocks which have the same data layout but different endianness for stored numbers. Has no effect on fields with an predefined endianness.
cache_bytes: Cache the bytes equivalent of the Block. Useful for debugging the loading procedure. Defaults to False.
path_hint: Cache a string containing the path of the current Block, relative to the root.
strict: Throw an exception if parsing a BlockField fails, instead of logging a warning and returning an Unknown. Defaults to False.

codec = <UInt8: offset=0x1>¶

data = <Bytes: offset=0x2>¶

freq_divisor = <UInt8: offset=0x0>¶

sample_rate¶

sample_width¶

signedness¶