/*=========================================================================

  Program:   Visualization Toolkit
  Module:    $RCSfile: vtkChooserPainter.h,v $

  Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
  All rights reserved.
  See Copyright.txt or http://www.kitware.com/Copyright.htm for details.

     This software is distributed WITHOUT ANY WARRANTY; without even
     the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR
     PURPOSE.  See the above copyright notice for more information.

=========================================================================*/
// .NAME vtkChooserPainter - Painter that selects painters to render
// primitives.
//
// .SECTION Description
//
// This painter does not actually do any painting.  Instead, it picks other
// painters based on the current state of itself and its poly data.  It then
// delegates the work to these other painters.
//


#ifndef __vtkChooserPainter_h
#define __vtkChooserPainter_h

#include "vtkPolyDataPainter.h"

class VTK_RENDERING_EXPORT vtkChooserPainter : public vtkPolyDataPainter
{
public:
  static vtkChooserPainter *New();
  vtkTypeRevisionMacro(vtkChooserPainter, vtkPolyDataPainter);
  void PrintSelf(ostream &os, vtkIndent indent);

  void SetVertPainter(vtkPolyDataPainter*);
  void SetLinePainter(vtkPolyDataPainter*);
  void SetPolyPainter(vtkPolyDataPainter*);
  void SetStripPainter(vtkPolyDataPainter*);

  // Description:
  // When set, the lines painter is used for drawing wireframes (off by
  // default, except on Mac, where it's on by default).
  vtkSetMacro(UseLinesPainterForWireframes, int);
  vtkGetMacro(UseLinesPainterForWireframes, int);
  vtkBooleanMacro(UseLinesPainterForWireframes, int);

  // Description:
  // Release any graphics resources that are being consumed by this mapper.
  // The parameter window could be used to determine which graphic
  // resources to release. Merely propagates the call to the painter.
//  void ReleaseGraphicsResources(vtkWindow *);
protected:
  vtkChooserPainter();
  ~vtkChooserPainter();

  vtkPolyDataPainter *VertPainter;
  vtkPolyDataPainter *LinePainter;
  vtkPolyDataPainter *PolyPainter;
  vtkPolyDataPainter *StripPainter;


  
  // Description:
  // Some subclasses may need to do some preprocessing
  // before the actual rendering can be done eg. build effecient
  // representation for the data etc. This should be done here.
  // This method get called after the ProcessInformation()
  // but before RenderInternal().
  // Overridden to setup the the painters if needed.
  virtual void PrepareForRendering(vtkRenderer*, vtkActor*);
 
  // Description:
  // Called to pick which painters to used based on the current state of
  // this painter and the poly data.
  virtual void ChoosePainters(vtkRenderer *renderer, vtkActor*);

  // Description:
  // Called from ChoosePainters.  Returns a string for the type of
  // each painter.  The painters will be built with CreatePainter.
  virtual void SelectPainters(vtkRenderer *renderer, vtkActor* actor,
                              const char *&vertpaintertype,
                              const char *&linepaintertype,
                              const char *&polypaintertype,
                              const char *&strippaintertype);

  // Description:
  // Passes on the information and the data to the choosen painters.
  virtual void UpdateChoosenPainters();

  // Description:
  // Creates a painter of the given type.
  virtual vtkPolyDataPainter *CreatePainter(const char *paintertype);

  // Description:
  // Performs the actual rendering. Subclasses may override this method.
  // default implementation merely call a Render on the DelegatePainter,
  // if any. When RenderInternal() is called, it is assured that the 
  // DelegatePainter is in sync with this painter i.e. UpdatePainter()
  // has been called.
  virtual void RenderInternal(vtkRenderer* renderer, vtkActor* actor, 
                              unsigned long typeflags, bool forceCompileOnly);

  // Description:
  // Take part in garbage collection.
  virtual void ReportReferences(vtkGarbageCollector *collector);

  vtkRenderer *LastRenderer;
  vtkTimeStamp PaintersChoiceTime;

  int UseLinesPainterForWireframes;
private:
  vtkChooserPainter(const vtkChooserPainter &); // Not implemented
  void operator=(const vtkChooserPainter &);    // Not implemented
};

#endif //_vtkChooserPainter_h

