class_docstr: 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.
  
  Parameters
  ----------
  lookup_table : pyvista.LookupTable, optional
      Lookup table to set the color and opacity transfer functions.
  
  interpolation_type : str, optional
      Value must be either ``'linear'`` or ``'nearest'``.
  
  ambient : float, optional
      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.
  
  diffuse : float, optional
      The diffuse lighting coefficient.
  
  specular : float, optional
      The specular lighting coefficient.
  
  specular_power : float, optional
      The specular power. Between 0.0 and 128.0.
  
  shade : bool, optional
      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 ``ambient=1``, ``diffuse=0``,
      ``specular=0``. Shading can be independently turned on/off per
      component.
  
  opacity_unit_distance : float, optional
      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.
  
  Examples
  --------
  Create a sample dataset from perlin noise and apply a lookup table to the
  :class:`VolumeProperty`.
  
  >>> 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()
docstr: Initialize the vtkVolumeProperty class.
docstr_tok: ["Initialize","the","vtkVolumeProperty","class","."]
code: def __init__(
      self,
      lookup_table=None,
      interpolation_type=None,
      ambient=None,
      diffuse=None,
      specular=None,
      specular_power=None,
      shade=None,
      opacity_unit_distance=None,
  ):
      """Initialize the vtkVolumeProperty class."""
      super().__init__()
      if lookup_table is not None:
          self.apply_lookup_table(lookup_table)
      if interpolation_type is not None:
          self.interpolation_type = interpolation_type
      if ambient is not None:
          self.ambient = ambient
      if diffuse is not None:
          self.diffuse = diffuse
      if specular is not None:
          self.specular = specular
      if specular_power is not None:
          self.specular_power = specular_power
      if shade is not None:
          self.shade = shade
      if opacity_unit_distance is not None:
          self.opacity_unit_distance = opacity_unit_distance
  
imports: import pyvista
  from pyvista.core.utilities.misc import no_new_attr
  from .None import _vtk
label_desc: Use image node_id 1 to create a new VolumeProperty object from inherited base classes: _vtk with example: obj = VolumeProperty(lookup_table, interpolation_type, ambient, diffuse, specular, specular_power, shade, opacity_unit_distance)