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

  Program:   Visualization Toolkit
  Module:    vtkSplitColumnComponents.h

  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.

=========================================================================*/
/*-------------------------------------------------------------------------
  Copyright 2008 Sandia Corporation.
  Under the terms of Contract DE-AC04-94AL85000 with Sandia Corporation,
  the U.S. Government retains certain rights in this software.
-------------------------------------------------------------------------*/
// .NAME vtkSplitColumnComponents - split multicomponent table columns
//
// .SECTION Description
// Splits any columns in a table that have more than one component into
// individual columns. Single component columns are passed through without
// any data duplication.
// NamingMode can be used to control how columns with multiple components are
// labelled in the output, e.g., if column names "Points" had three components
// this column would be split into "Points (0)", "Points (1)", and Points (2)"
// when NamingMode is NUMBERS_WITH_PARENS, into Points_0, Points_1, and Points_2
// when NamingMode is NUMBERS_WITH_UNDERSCORES, into "Points (X)", "Points (Y)",
// and "Points (Z)" when NamingMode is NAMES_WITH_PARENS, and into Points_X,
// Points_Y, and Points_Z when NamingMode is NAMES_WITH_UNDERSCORES.

#ifndef vtkSplitColumnComponents_h
#define vtkSplitColumnComponents_h

#include "vtkFiltersGeneralModule.h" // For export macro
#include "vtkTableAlgorithm.h"

class vtkStdString;
class VTKFILTERSGENERAL_EXPORT vtkSplitColumnComponents : public vtkTableAlgorithm
{
public:
  static vtkSplitColumnComponents* New();
  vtkTypeMacro(vtkSplitColumnComponents,vtkTableAlgorithm);
  void PrintSelf(ostream& os, vtkIndent indent);

  // Description:
  // If on this filter will calculate an additional magnitude column for all
  // columns it splits with two or more components.
  // Default is on.
  vtkSetMacro(CalculateMagnitudes, bool);
  vtkGetMacro(CalculateMagnitudes, bool);

  enum
    {
    NUMBERS_WITH_PARENS = 0,    // e.g Points (0)
    NAMES_WITH_PARENS = 1,      // e.g. Points (X)
    NUMBERS_WITH_UNDERSCORES=2, // e.g. Points_0
    NAMES_WITH_UNDERSCORES=3    // e.g. Points_X
    };

  // Description:
  // Get/Set the array naming mode.
  // Description is NUMBERS_WITH_PARENS.
  vtkSetClampMacro(NamingMode, int, NUMBERS_WITH_PARENS, NAMES_WITH_UNDERSCORES);
  void SetNamingModeToNumberWithParens()
    { this->SetNamingMode(NUMBERS_WITH_PARENS); }
  void SetNamingModeToNumberWithUnderscores()
    { this->SetNamingMode(NUMBERS_WITH_UNDERSCORES); }
  void SetNamingModeToNamesWithParens()
    { this->SetNamingMode(NAMES_WITH_PARENS); }
  void SetNamingModeToNamesWithUnderscores()
    { this->SetNamingMode(NAMES_WITH_UNDERSCORES); }
  vtkGetMacro(NamingMode, int);

protected:
  vtkSplitColumnComponents();
  ~vtkSplitColumnComponents();

  // Description:
  // Returns the label to use for the specific component in the array based on
  // this->NamingMode. Use component_no==-1 for magnitude.
  vtkStdString GetComponentLabel(vtkAbstractArray* array, int component_no);

  bool CalculateMagnitudes;

  int RequestData(
    vtkInformation*,
    vtkInformationVector**,
    vtkInformationVector*);

  int NamingMode;
private:
  vtkSplitColumnComponents(const vtkSplitColumnComponents&); // Not implemented
  void operator=(const vtkSplitColumnComponents&);   // Not implemented
};

#endif
