🧊 MCVD

MCVD Format.

Name:

Trace Model / Animation Set

Handler:

McvdDecoder

Content:

ModelContent

Suffix:

.mcvd

Support:

✅ FULL

Versions:

7.0, 8.0, 9.0, 10.0, 11.0, 12.0, 15.0

Features:

UV, UV2, Normals, Tangents, Skeleton, Blend Shapes, Bone Animation, Morph Animation

Wiki:

https://sc-file.rtfd.io/page/formats.html#mcvd

Usage Example:

from scfile import formats

with formats.McvdDecoder("file.mcvd") as mcvd:
    data = mcvd.decode()

Decoder

class McvdDecoder(stream, options=None)

Bases: McsaDecoder

format: ClassVar[FileFormat] = 'mcvd'

Format handled by this handler.

close()

Close the owned binary resource.

Return type:

None

property closed: bool

Whether the owned binary resource is closed.

content_type

alias of ModelContent

property context: Mapping[str, Any]

Read-only view of the format specific working context.

convert(encoder, options=None)

Decode source data and return encoded bytes.

Parameters:

• encoder (type[Encoder[TypeVar(ContentType, bound= BaseContent), TypeVar(WriterType, bound= StructWriter)]]) – Encoder class for the target format.

• options (optional) – Options for the target encoder. Defaults to decoder options.

Return type:

bytes

Returns:

Encoded bytes.

convert_to(encoder, options=None, output=None)

Decode source data and return a target encoder.

Parameters:

• encoder (type[Encoder[TypeVar(ContentType, bound= BaseContent), TypeVar(WriterType, bound= StructWriter)]]) – Encoder class for the target format.

• options (optional) – Options for the target encoder. Defaults to decoder options.

• output (optional) – Output file path or binary stream. Defaults to in-memory buffer.

Return type:

Encoder[TypeVar(ContentType, bound= BaseContent), TypeVar(WriterType, bound= StructWriter)]

Returns:

Open target encoder with decoded content.

decode()

Decode source data and return content.

Return type:

TypeVar(ContentType, bound= BaseContent)

features: ClassVar[Features] = (Feature.UV, Feature.UV2, Feature.NORMALS, Feature.TANGENTS, Feature.SKELETON, Feature.BLEND_SHAPES, Feature.BONE_ANIMATION, Feature.MORPH_ANIMATION)

Features supported by this decoder.

io_factory

alias of ModelReader

property location: str

Location of the owned binary resource.

order: ClassVar[ByteOrder] = '<'

Default byte order for structured I/O.

signature: ClassVar[bytes | None] = b'MCSA'

Expected binary signature.

standalone: ClassVar[bool] = True

Whether the source can be converted without related assets.

property state: HandlerState

Current operation lifecycle state.

classmethod suffix()

Return the format suffix.

Return type:

str

classmethod supports(feature)

Return whether this decoder supports a feature.

Return type:

bool

io: IOType

Structured I/O owned by this handler.

options: Options

Options applied by this handler.