skppy.material_loader

Load standalone SketchUp material packages.

skppy.material_loader.load_material(filepath: str | PathLike[str], *, import_vray_materials: bool = False) → Material[source]

Load one standalone SketchUp material package.

Package detection uses the ZIP contents rather than the filename suffix, so incorrectly named .skp downloads containing an SKM material are accepted as well as conventional .skm files.

Parameters:

  • filepath (str or os.PathLike) – Path to a SketchUp material ZIP containing document.xml.

  • import_vray_materials (bool, optional) – Prefer supported V-Ray PBR values embedded in the material XML.

Returns:

Material appearance and embedded base texture.

Return type:

Material

Raises:

InvalidSkmError – If the file is not a supported material package.