Property

class Property(*args, **kwargs)

Wrap vtkProperty and expose it pythonically.

This class is used to set the property of actors.

Parameters:

themepyvista.plotting.themes.Theme, optional

Plot-specific theme.

interpolationstr, default: pyvista.plotting.themes._LightingConfig.interpolation

Set the method of shading. One of the following:

• 'Physically based rendering' - Physically based rendering.

• 'pbr' - Alias for Physically based rendering.

• 'Phong' - Phong shading.

• 'Gouraud' - Gouraud shading.

• 'Flat' - Flat Shading.

This parameter is case insensitive.

colorColorLike, default: pyvista.plotting.themes.Theme.color

Used to make the entire mesh have a single solid color. Either a string, RGB list, or hex color string. For example: color='white', color='w', color=[1.0, 1.0, 1.0], or color='#FFFFFF'. Color will be overridden if scalars are specified.

stylestr, default: ‘surface’

Visualization style of the mesh. One of the following: style='surface', style='wireframe', style='points'. Note that 'wireframe' only shows a wireframe of the outer geometry.

metallicfloat, default: pyvista.plotting.themes._LightingConfig.metallic

This parameter is only used by PBR interpolation. Must be in the range [0.0, 1.0]. A value of 0.0 is a non-metal such as plastic and 1.0 is a bare metal; values in between are valid but uncommon for a real material.

roughnessfloat, default: pyvista.plotting.themes._LightingConfig.roughness

A glossy material has reflections and a high specular part. This parameter is only used by PBR interpolation. Must be in the range [0.0, 1.0]. A value of 0.0 is glossy and 1.0 is rough.

point_sizefloat, default: pyvista.plotting.themes.Theme.point_size

Size of the points represented by this property, expressed in screen units. Must be in the range [0.0, inf).

opacityfloat, default: pyvista.plotting.themes.Theme.opacity

Opacity of the mesh. A single float value that will be applied globally opacity of the mesh and uniformly applied everywhere. Must be in the range [0.0, 1.0]. A value of 1.0 is totally opaque and 0.0 is completely transparent.

ambientfloat, default: pyvista.plotting.themes._LightingConfig.ambient

When lighting is enabled, this is the amount of light that reaches the actor when not directed at the light source emitted from the viewer. Must be in the range [0.0, 1.0]. A value of 0.0 adds no ambient light and 1.0 lights every surface fully, regardless of where the light is.

diffusefloat, default: pyvista.plotting.themes._LightingConfig.diffuse

The diffuse lighting coefficient. Must be in the range [0.0, 1.0]. A value of 0.0 reflects no light from the light source and 1.0 reflects the full amount.

specularfloat, default: pyvista.plotting.themes._LightingConfig.specular

The specular lighting coefficient. Must be in the range [0.0, 1.0]. A value of 0.0 has no highlight and 1.0 has a full-intensity one.

specular_powerfloat, default: pyvista.plotting.themes._LightingConfig.specular_power

The specular power. Must be in the range [0.0, 128.0]. A value of 0.0 spreads the highlight over the whole surface and 128.0 concentrates it into a small, sharp spot.

show_edgesbool, default: pyvista.plotting.themes.Theme.show_edges

Shows the edges. Does not apply to a wireframe representation.

edge_colorColorLike, default: pyvista.plotting.themes.Theme.edge_color

The solid color to give the edges when show_edges=True. Either a string, RGB list, or hex color string.

render_points_as_spheresbool, default: pyvista.plotting.themes.Theme.render_points_as_spheres

Render points as spheres rather than dots.

render_lines_as_tubesbool, default: pyvista.plotting.themes.Theme.render_lines_as_tubes

Show lines as thick tubes rather than flat lines. Control the width with line_width.

lightingbool, default: pyvista.plotting.themes.Theme.lighting

Enable or disable view direction lighting.

line_widthfloat, default: pyvista.plotting.themes.Theme.line_width

Thickness of lines. Only valid for wireframe and surface representations, expressed in screen units. Must be in the range [0.0, inf).

cullingstr | bool, optional

Does not render faces that are culled. This can be helpful for dense surface meshes, especially when edges are visible, but can cause flat meshes to be partially displayed. Defaults to 'none'. One of the following:

• True, 'b', 'back', 'backface' - Enable backface culling

• 'f', 'front', 'frontface' - Enable frontface culling

• False, 'none' - Disable both backface and frontface culling

edge_opacityfloat, default: pyvista.plotting.themes.Theme.edge_opacity

Edge opacity of the mesh. A single float value that will be applied globally edge opacity of the mesh and uniformly applied everywhere. Must be in the range [0.0, 1.0]. A value of 1.0 is totally opaque and 0.0 is completely transparent.

Note

edge_opacity uses SetEdgeOpacity as the underlying method which requires VTK version 9.3 or higher. If SetEdgeOpacity is not available, edge_opacity is set to 1.

Examples

Download Python source code | Download Jupyter notebook

Create a pyvista.Actor and assign properties to it.

>>> import pyvista as pv
>>> actor = pv.Actor()
>>> actor.prop = pv.Property(
...     color='r',
...     show_edges=True,
...     interpolation='Physically based rendering',
...     metallic=0.5,
...     roughness=0.1,
... )

Visualize how the property would look when applied to a mesh.

>>> actor.prop.plot()

Static Scene

Interactive Scene

Set custom properties not directly available in pyvista.Plotter.add_mesh(). Here, we set diffuse, ambient, and specular power and colors.

>>> pl = pv.Plotter()
>>> actor = pl.add_mesh(pv.Sphere())
>>> prop = actor.prop
>>> prop.diffuse = 0.6
>>> prop.diffuse_color = 'w'
>>> prop.ambient = 0.3
>>> prop.ambient_color = 'r'
>>> prop.specular = 0.5
>>> prop.specular_color = 'b'
>>> pl.show()

Static Scene

Interactive Scene

Used In

API Examples

• Property.ambient (1 use)
• Property.ambient_color (1 use)
• Property.anisotropy (1 use)
• Property.anisotropy_rotation (1 use)
• Property.color (1 use)
• 24 more

  • Property.copy (1 use)
  • Property.culling (1 use)
  • Property.diffuse (1 use)
  • Property.diffuse_color (1 use)
  • Property.edge_color (1 use)
  • Property.edge_opacity (1 use)
  • Property.index_of_refraction (1 use)
  • Property.interpolation (1 use)
  • Property.lighting (1 use)
  • Property.line_width (1 use)
  • Property.metallic (1 use)
  • Property.opacity (1 use)
  • Property.plot (1 use)
  • Property.point_shape (1 use)
  • Property.point_size (1 use)
  • Property.render_lines_as_tubes (1 use)
  • Property.render_points_as_spheres (1 use)
  • Property.representation (1 use)
  • Property.roughness (1 use)
  • Property.show_edges (1 use)
  • Property.specular (1 use)
  • Property.specular_color (1 use)
  • Property.specular_power (1 use)
  • Property.style (1 use)

Inheritance

Wraps vtkProperty.

Attributes

Property.ambient	Return or set ambient.
Property.ambient_color	Return or set the ambient color of this property.
Property.anisotropy	Return or set the anisotropy coefficient.
Property.anisotropy_rotation	Return or set the anisotropy rotation coefficient.
Property.color	Return or set the color of this property.
Property.culling	Return or set face culling.
Property.diffuse	Return or set the diffuse lighting coefficient.
Property.diffuse_color	Return or set the diffuse color of this property.
Property.edge_color	Return or set the edge color of this property.
Property.edge_opacity	Return or set the edge opacity of this property.
Property.index_of_refraction	Return or set the index of refraction of the base layer.
Property.interpolation	Return or set the method of shading.
Property.lighting	Return or set view direction lighting.
Property.line_width	Return or set the line width.
Property.metallic	Return or set metallic.
Property.opacity	Return or set the opacity of this property.
Property.point_shape	Return or set the shape of flat point primitives.
Property.point_size	Return or set the point size.
Property.render_lines_as_tubes	Return or set rendering lines as tubes.
Property.render_points_as_spheres	Return or set rendering points as spheres.
Property.representation	Return or set the visualization representation of the mesh.
Property.roughness	Return or set roughness.
Property.show_edges	Return or set the visibility of edges.
Property.specular	Return or set specular.
Property.specular_color	Return or set the specular color of this property.
Property.specular_power	Return or set specular power.
Property.style	Return or set the visualization style of the mesh.

Methods

Property.copy()	Create a deep copy of this property.
Property.plot(**kwargs)	Plot this property on the Stanford Bunny.