vtkCinemaDatabase.h

Go to the documentation of this file.

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

  Program:   Visualization Toolkit
  Module:    vtkCinemaDatabase.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.

=========================================================================*/
#ifndef vtkCinemaDatabase_h
#define vtkCinemaDatabase_h

#include "vtkObject.h"
#include "vtkRemotingCinemaModule.h" // for export macros
#include "vtkSmartPointer.h"         // for vtkSmartPointer

#include <string> // for string
#include <vector> // for vector

class vtkImageData;
class vtkCamera;

class VTKREMOTINGCINEMA_EXPORT vtkCinemaDatabase : public vtkObject
{
public:
  static vtkCinemaDatabase* New();
  vtkTypeMacro(vtkCinemaDatabase, vtkObject);
  void PrintSelf(ostream& os, vtkIndent indent) override;

  enum Spec
  {
    UNKNOWN = -1,
    CINEMA_SPEC_A,
    CINEMA_SPEC_C
  };

  bool Load(const char* fname);

  std::vector<std::string> GetPipelineObjects() const;

  std::vector<std::string> GetPipelineObjectParents(const std::string& objectname) const;

  bool GetPipelineObjectVisibility(const std::string& objectname) const;

  // Description:
  // Given a object's name, it returns a list of control parameters (may be empty).
  std::vector<std::string> GetControlParameters(const std::string& objectname) const;

  // Description:
  // Get values for a control parameter. For convenience they are returned as
  // strings.
  std::vector<std::string> GetControlParameterValues(const std::string& parameter) const;

  // Description:
  // Get the name for the field associated with the object. `GetFieldValues` will
  // returns values for this field.
  std::string GetFieldName(const std::string& objectname) const;

  // Description:
  // Given an object's name, returns a list of fields available for that object.
  std::vector<std::string> GetFieldValues(
    const std::string& objectname, const std::string& valuetype) const;

  bool GetFieldValueRange(
    const std::string& objectname, const std::string& fieldvalue, double range[2]) const;

  // Description:
  // Return timesteps available in the datastore. May returns an empty vector if
  // no timesteps are present in the dataset.
  std::vector<std::string> GetTimeSteps() const;

  std::vector<vtkSmartPointer<vtkImageData> > TranslateQuery(const std::string& query) const;

  std::vector<vtkSmartPointer<vtkCamera> > Cameras(
    const std::string& timestep = std::string()) const;

  int GetSpec() const;

  std::string GetNearestParameterValue(const std::string& param, double value) const;

protected:
  vtkCinemaDatabase();
  ~vtkCinemaDatabase() override;

private:
  vtkCinemaDatabase(const vtkCinemaDatabase&) = delete;
  void operator=(const vtkCinemaDatabase&) = delete;

  class vtkInternals;
  vtkInternals* Internals;
};

#endif