vtkTransferAttributes.h

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

Program:   Visualization Toolkit
Module:    vtkTransferAttributes.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.
  -------------------------------------------------------------------------*/
/**
 * @class   vtkTransferAttributes
 * @brief   transfer data from a graph representation
 * to a tree representation using direct mapping or pedigree ids.
 *
 *
 * The filter requires
 * both a vtkGraph and vtkTree as input.  The tree vertices must be a
 * superset of the graph vertices.  A common example is when the graph vertices
 * correspond to the leaves of the tree, but the internal vertices of the tree
 * represent groupings of graph vertices.  The algorithm matches the vertices
 * using the array "PedigreeId".  The user may alternately set the
 * DirectMapping flag to indicate that the two structures must have directly
 * corresponding offsets (i.e. node i in the graph must correspond to node i in
 * the tree).
 *
*/

#ifndef vtkTransferAttributes_h
#define vtkTransferAttributes_h

#include "vtkInfovisCoreModule.h" // For export macro
#include "vtkPassInputTypeAlgorithm.h"
#include "vtkVariant.h" //For vtkVariant method arguments

class VTKINFOVISCORE_EXPORT vtkTransferAttributes : public vtkPassInputTypeAlgorithm
{
public:
  /**
   * Create a vtkTransferAttributes object.
   * Initial values are DirectMapping = false, DefaultValue = 1,
   * SourceArrayName=0, TargetArrayName = 0,
   * SourceFieldType=vtkDataObject::FIELD_ASSOCIATION_POINTS,
   * TargetFieldType=vtkDataObject::FIELD_ASSOCIATION_POINTS
   */
  static vtkTransferAttributes *New();

  vtkTypeMacro(vtkTransferAttributes,vtkPassInputTypeAlgorithm);
  void PrintSelf(ostream& os, vtkIndent indent) override;

  //@{
  /**
   * If on, uses direct mapping from tree to graph vertices.
   * If off, both the graph and tree must contain PedigreeId arrays
   * which are used to match graph and tree vertices.
   * Default is off.
   */
  vtkSetMacro(DirectMapping, bool);
  vtkGetMacro(DirectMapping, bool);
  vtkBooleanMacro(DirectMapping, bool);
  //@}

  //@{
  /**
   * The field name to use for storing the source array.
   */
  vtkGetStringMacro(SourceArrayName);
  vtkSetStringMacro(SourceArrayName);
  //@}

  //@{
  /**
   * The field name to use for storing the source array.
   */
  vtkGetStringMacro(TargetArrayName);
  vtkSetStringMacro(TargetArrayName);
  //@}

  //@{
  /**
   * The source field type for accessing the source array. Valid values are
   * those from enum vtkDataObject::FieldAssociations.
   */
  vtkGetMacro(SourceFieldType, int);
  vtkSetMacro(SourceFieldType, int);
  //@}

  //@{
  /**
   * The target field type for accessing the target array. Valid values are
   * those from enum vtkDataObject::FieldAssociations.
   */
  vtkGetMacro(TargetFieldType, int);
  vtkSetMacro(TargetFieldType, int);
  //@}

  //@{
  /**
   * Method to get/set the default value.
   */
  vtkVariant GetDefaultValue();
  void SetDefaultValue(vtkVariant value);
  //@}

  /**
   * Set the input type of the algorithm to vtkGraph.
   */
  int FillInputPortInformation(int port, vtkInformation* info) override;

protected:
  vtkTransferAttributes();
  ~vtkTransferAttributes() override;

  bool DirectMapping;
  char* SourceArrayName;
  char* TargetArrayName;
  int SourceFieldType;
  int TargetFieldType;

  vtkVariant DefaultValue;

  /**
   * Convert the vtkGraph into vtkPolyData.
   */
  int RequestData(vtkInformation *, vtkInformationVector **, vtkInformationVector *) override;

private:
  vtkTransferAttributes(const vtkTransferAttributes&) = delete;
  void operator=(const vtkTransferAttributes&) = delete;
};

#endif