class_docstr: Class to support multiple render passes for a renderer.
  
  Notes
  -----
  Passes are organized here as "primary" (vtkOpenGLRenderPass) that act
  within the renderer and "post-processing" (vtkImageProcessingPass) passes,
  which act on the image generated from the renderer.
  
  The primary passes are added as part of a vtk.vtkRenderPassCollection or
  are "stacked", while the post-processing passes are added as a final pass
  to the rendered image.
  
  Parameters
  ----------
  renderer : vtk.vtkRenderer
      Renderer to initialize render passes for.
docstr: Enable the depth of field pass.
  
  Parameters
  ----------
  automatic_focal_distance : bool, default: True
      If ``True``, the depth of field effect will automatically compute
      the focal distance. If ``False``, the user must specify the distance.
  
  Returns
  -------
  vtk.vtkDepthOfFieldPass
      The enabled depth of field pass.
docstr_tok: ["Enable","the","depth","of","field","pass",".","Parameters","--","--","--","--","--","automatic_focal_distance",":","bool",",","default",":","True","If","``","True","``",",","the","depth","of","field","effect","will","automatically","compute","the","focal","distance",".","If","``","False","``",",","the","user","must","specify","the","distance",".","Returns","--","--","--","-","vtk.vtkDepthOfFieldPass","The","enabled","depth","of","field","pass","."]
code: def enable_depth_of_field_pass(self, automatic_focal_distance=True):
      """Enable the depth of field pass.
  
      Parameters
      ----------
      automatic_focal_distance : bool, default: True
          If ``True``, the depth of field effect will automatically compute
          the focal distance. If ``False``, the user must specify the distance.
  
      Returns
      -------
      vtk.vtkDepthOfFieldPass
          The enabled depth of field pass.
  
      """
      if self._dof_pass is not None:
          return
  
      if self._ssao_pass is not None:
          raise RuntimeError(
              "Depth of field pass is incompatible with the SSAO pass."
          )
  
      self._dof_pass = _vtk.vtkDepthOfFieldPass()
      self._dof_pass.SetAutomaticFocalDistance(automatic_focal_distance)
      self._add_pass(self._dof_pass)
      return self._dof_pass
  
imports: import weakref
  from .None import _vtk
label_desc: Use image node_id 14 for calling the RenderPasses obj's underlying member method code with example usage: obj.enable_depth_of_field_pass(automatic_focal_distance) and returns: self