blenderproc.python.loader.CCMaterialLoader module

class blenderproc.python.loader.CCMaterialLoader.CCMaterialLoader

Bases: object

static create_material(new_mat, base_image_path, ambient_occlusion_image_path, metallic_image_path, roughness_image_path, alpha_image_path, normal_image_path, displacement_image_path)

Create a material for the cctexture datatset, the combination used here is calibrated to this.

Parameters:

• new_mat (Material) – The new material, which will get all the given textures
• base_image_path (str) – The path to the color image
• ambient_occlusion_image_path (str) – The path to the ambient occlusion image
• metallic_image_path (str) – The path to the metallic image
• roughness_image_path (str) – The path to the roughness image
• alpha_image_path (str) – The path to the alpha image (when this was written there was no alpha image provided in the haven dataset)
• normal_image_path (str) – The path to the normal image
• displacement_image_path (str) – The path to the displacement image

blenderproc.python.loader.CCMaterialLoader.load_ccmaterials(folder_path='resources/cctextures', used_assets=None, preload=False, fill_used_empty_materials=False, add_custom_properties=None, use_all_materials=False)

This method loads all textures obtained from https://cc0textures.com, use the script (scripts/download_cc_textures.py) to download all the textures to your pc.

All textures here support Physically based rendering (PBR), which makes the textures more realistic.

All materials will have the custom property “is_cc_texture”: True, which will make the selection later on easier.

Parameters:

• folder_path (str) – The path to the downloaded cc0textures.
• used_assets (Optional[list]) – A list of all asset names, you want to use. The asset-name must not be typed in completely, only the beginning the name starts with. By default all assets will be loaded, specified by an empty list.
• preload (bool) – If set true, only the material names are loaded and not the complete material.
• fill_used_empty_materials (bool) – If set true, the preloaded materials, which are used are now loaded completely.
• add_custom_properties (Optional[dict]) – A dictionary of materials and the respective properties.
• use_all_materials (bool) – If this is false only a selection of probably useful textures is used. This excludes some see through texture and non tileable texture.

:return a list of all loaded materials, if preload is active these materials do not contain any textures yet

and have to be filled before rendering (by calling this function again, no need to save the prior returned list)

Return type:List[Material]