- class VolumeProperty(lookup_table=None, interpolation_type=None, ambient=None, diffuse=None, specular=None, specular_power=None, shade=None, opacity_unit_distance=None)[source]#
Wrap the VTK class vtkVolumeProperty.
This class is used to represent common properties associated with volume rendering. This includes properties for determining the type of interpolation to use when sampling a volume, the color of a volume, the scalar opacity of a volume, the gradient opacity of a volume, and the shading parameters of a volume.
Lookup table to set the color and opacity transfer functions.
Value must be either
When lighting is enabled, this is the amount of light in the range of 0 to 1 (default 0.0) that reaches the actor when not directed at the light source emitted from the viewer.
The diffuse lighting coefficient.
The specular lighting coefficient.
The specular power. Between 0.0 and 128.0.
Enable or disable volume shading. If shading is turned off, then the mapper for the volume will not perform shading calculations. If shading is turned on, the mapper may perform shading calculations - in some cases shading does not apply (for example, in a maximum intensity projection) and therefore shading will not be performed even if this flag is on. For a compositing type of mapper, turning shading off is generally the same as setting
specular=0. Shading can be independently turned on/off per component.
This is the unit distance on which the scalar opacity transfer function is defined. By default this is 1.0, meaning that over a distance of 1.0 units, a given opacity (from the transfer function) is accumulated. This is adjusted for the actual sampling distance during rendering.
Create a sample dataset from perlin noise and apply a lookup table to the
>>> import pyvista as pv >>> noise = pv.perlin_noise(1, (1, 3, 5), (0, 0, 0)) >>> grid = pv.sample_function( ... noise, [0, 3.0, -0, 1.0, 0, 1.0], dim=(40, 40, 40) ... ) >>> grid['scalars'] -= grid['scalars'].min() >>> grid['scalars'] *= 255 / grid['scalars'].max() >>> pl = pv.Plotter() >>> actor = pl.add_volume(grid, show_scalar_bar=False) >>> lut = pv.LookupTable(cmap='bwr') >>> lut.apply_opacity([1.0, 0.0, 0.0, 0.3, 0.0, 0.0, 0.0, 0.3]) >>> actor.prop.apply_lookup_table(lut) >>> pl.show()
Apply a lookup table to the volume property.
Create a deep copy of this property.
Return or set ambient lighting coefficient.
Return or set the diffuse lighting coefficient.
Return or set independent components.
Return or set the interpolation type.
Return or set the opacity unit distance.
Return or set shading of a volume.
Return or set specular.
Return or set specular power.