Data API Changelog

Version 2021.1.3

Corrections

• Fix LightGroup.list_lights() not returning the right light type.

• Fix enums returning wrong values in some cases when using the direct .p3d access API.

• Fix exception when duplicating a MaterialGroup.

• Fix crash when creating a camera on Matter with no product open.

Version 2021.1.0

New APIs

• AxfCPA2Material: Add properties to change the material color.

• Product: Add properties for SSAO.

• Visibility Layer: Add VisibilityLayer.import_triangle_mesh() and VisibilityLayer.import_indexed_triangle_mesh() to create surfaces from meshes.

Corrections

• Fix some methods not using their arguments properly.

Version 2020.2.4

Corrections

• Fix AspectLayer.get_material_assignment not returning the right material type.

Version 2020.2.2

New APIs

• Aspect Layer Group: Add AspectLayerGroup class.

• Aspect Layer: Add AspectLayer class. This allows you to assign materials to surfaces or query the material of a surface.

• Environment Layer: Add EnvironmentLayer class. This allows you to assign environments to surfaces or change the global environment of the product.

• Product: Add Product class.

• Model: Add Model.create_product(), Model.find_product() and Model.list_products() methods.

Corrections

• Fix Database.active_material not returning the right material type.

• Fix crash when setting Database.active_material.

• Fix no default model, visibility layer and lighting created when creating a database using P3DFile.create().

Version 2020.2.1

New APIs

• Database:

  • Add Database.active_material, Database.active_background, Database.active_environment, Database.active_overlay, Database.active_postprocess and Database.active_sensor attributes.

  • Add Database.active_texture_group, Database.active_background_group, Database.active_environment_group, Database.active_overlay_group, Database.active_postprocess_group and Database.active_sensor_group attributes.

  • Add Database.create_texture_group(), Database.find_texture_group() and Database.list_texture_groups() methods.

  • Add Database.create_background_group(), Database.find_background_group() and Database.list_background_groups() methods.

  • Add Database.create_environment_group(), Database.find_environment_group() and Database.list_environment_groups() methods.

  • Add Database.create_overlay_group(), Database.find_overlay_group() and Database.list_overlay_groups() methods.

  • Add Database.create_postprocess_group(), Database.find_postprocess_group() and Database.list_postprocess_groups() methods.

  • Add Database.create_sensor_group(), Database.find_sensor_group() and Database.list_sensor_groups() methods.

• Background Group: Add BackgroundGroup class.

• Background: Add Background class.

• Camera: Add Camera.sensor attribute.

• Material: Add StandardMaterial.diffuse_gradient_ramp_enabled, StandardMaterial.velvet_gradient_ramp_enabled, MultiLayerMaterialDiffuseLayer.gradient_ramp_enabled and MultiLayerMaterialIlluminationLayer.gradient_ramp_enabled properties.

• Environment Group: Add EnvironmentGroup class.

• Environment: Add Environment class.

• Overlay Group: Add OverlayGroup class.

• Overlay: Add Overlay and OverlayLayer classes.

• Postprocess Group: Add PostprocessGroup class.

• Postprocess:

  • Add Postprocess class.

  • Add PostprocessingEffect base class with some subclasses (more to come): PostprocessingEffectBloom and PostprocessingEffectBlur.

• Sensor Group: Add SensorGroup class.

• Sensor: Add Sensor class.

Corrections

• Fix crash when setting Database.active_material_group to None.

Version 2020.2.0

New APIs

• Material Group:

  • Add MaterialGroup.import_kmt() method to import a material from .kmt file.

  • Add material creation methods: MaterialGroup.create_standard_material(), MaterialGroup.create_multi_layer_material(), MaterialGroup.create_mirror_material(), MaterialGroup.create_matte_material() and MaterialGroup.create_env_material().

• Material:

  • Add Material.duplicate() and Material.remove() methods.

  • Add Material.export_kmt() method to export a material to .kmt file.

  • Add FlakesDistribution, LabelMode, RepetitionMode and StandardMaterialType enums.

  • Add MultiLayerMaterialLayer base class with its subclasses: MultiLayerMaterialDiffuseLayer, MultiLayerMaterialFlakesLayer, MultiLayerMaterialIlluminationLayer and MultiLayerMaterialSpecularLayer.

  • Add material-specific methods to get/set 1 their properties. Currently it is not possible to get/set material gradients, this will come in a future release.

• Texture Group:

  • Add TextureGroup class.

  • Textures can be imported using TextureGroup.import_from_encoded_data().

• Texture:

  • Add Texture class.

  • The texture data can be retrieved (in encoded format only currently) using the Texture.encoded_data() method.

Corrections

• Fix crash when creating a visibility layer

• Fix creating a visibility layer not working properly when using P3DFile API.

• Fix wrong database version after saving a file opened with P3DFile API.

• Fix no default groups created in Matter library when creating a database using P3DFile.create().

Version 2020.1.0

Initial release

Footnotes

1

Except SeamMaterial where it is not possible to set the properties as it is a deprecated material.