vtkGridAxesActor2D.h

Go to the documentation of this file.

// SPDX-FileCopyrightText: Copyright (c) Kitware Inc.
// SPDX-FileCopyrightText: Copyright (c) Ken Martin, Will Schroeder, Bill Lorensen
// SPDX-License-Identifier: BSD-3-Clause
#ifndef vtkGridAxesActor2D_h
#define vtkGridAxesActor2D_h
 
#include "vtkProp3D.h"
#include "vtkRenderingGridAxesModule.h" //needed for exports
 
#include "vtkGridAxesHelper.h"       // needed of Helper
#include "vtkGridAxesPlaneActor2D.h" // needed for inline methods
#include "vtkNew.h"                  // needed for vtkNew.
#include "vtkSmartPointer.h"         // needed for vtkSmartPointer.
 
#include <functional> // for std::function
 
VTK_ABI_NAMESPACE_BEGIN
class vtkAxis;
class vtkContextScene;
class vtkDoubleArray;
class vtkProperty;
class vtkTextProperty;
 
class VTKRENDERINGGRIDAXES_EXPORT vtkGridAxesActor2D : public vtkProp3D
{
public:
  static vtkGridAxesActor2D* New();
  vtkTypeMacro(vtkGridAxesActor2D, vtkProp3D);
  void PrintSelf(ostream& os, vtkIndent indent) override;
 
 
  vtkSetVector6Macro(GridBounds, double);
  vtkGetVector6Macro(GridBounds, double);
 
 
  vtkSetClampMacro(Face, int, vtkGridAxesHelper::MIN_YZ, vtkGridAxesHelper::MAX_XY);
  vtkGetMacro(Face, int);
 
 
  vtkSetMacro(LabelMask, unsigned int);
  vtkGetMacro(LabelMask, unsigned int);
 
  void GetActors(vtkPropCollection*) override;
 
  void UpdateGeometry(vtkViewport* viewport, bool doRegularUpdate);
 
 
  void SetProperty(vtkProperty*);
  vtkProperty* GetProperty();
 
 
  void SetTitleTextProperty(int axis, vtkTextProperty*);
  vtkTextProperty* GetTitleTextProperty(int axis);
 
 
  void SetLabelTextProperty(int axis, vtkTextProperty*);
  vtkTextProperty* GetLabelTextProperty(int axis);
 
 
  void SetTitle(int axis, const std::string& title);
  const std::string& GetTitle(int axis);
 
 
  void SetNotation(int axis, int notation);
  int GetNotation(int axis);
 
 
  void SetPrecision(int axis, int val);
  int GetPrecision(int axis);
 
 
  void SetTickLabelFunction(int axis, std::function<double(double)> func);
  std::function<double(double)> GetTickLabelFunction(int axis);
 
  void SetCustomTickPositions(int axis, vtkDoubleArray* positions);
 
  //---------------------------------------------------------------------------
  // *** Properties to control grid rendering ***
  //---------------------------------------------------------------------------
 
 
  void SetGenerateGrid(bool val) { this->PlaneActor->SetGenerateGrid(val); }
  bool GetGenerateGrid() { return this->PlaneActor->GetGenerateGrid(); }
  vtkBooleanMacro(GenerateGrid, bool);
 
 
  void SetGenerateEdges(bool val) { this->PlaneActor->SetGenerateEdges(val); }
  bool GetGenerateEdges() { return this->PlaneActor->GetGenerateEdges(); }
  vtkBooleanMacro(GenerateEdges, bool);
 
 
  void SetGenerateTicks(bool val) { this->PlaneActor->SetGenerateTicks(val); }
  bool GetGenerateTicks() { return this->PlaneActor->GetGenerateTicks(); }
  vtkBooleanMacro(GenerateTicks, bool);
 
  //--------------------------------------------------------------------------
  // Methods for vtkProp3D API.
  //--------------------------------------------------------------------------
 
 
  double* GetBounds() override
  {
    this->GetGridBounds(this->Bounds);
    return this->Bounds;
  }
 
 
  vtkSetMacro(ForceOpaque, bool);
  vtkGetMacro(ForceOpaque, bool);
  vtkBooleanMacro(ForceOpaque, bool);
 
 
  int RenderOpaqueGeometry(vtkViewport*) override;
  int RenderTranslucentPolygonalGeometry(vtkViewport* viewport) override;
  int RenderOverlay(vtkViewport* viewport) override;
  vtkTypeBool HasTranslucentPolygonalGeometry() override;
 
  void ReleaseGraphicsResources(vtkWindow*) override;
 
  vtkMTimeType GetMTime() override;
 
 
  vtkSetVector2Macro(LabelDisplayOffset, int);
  vtkGetVector2Macro(LabelDisplayOffset, int);
 
protected:
  vtkGridAxesActor2D();
  ~vtkGridAxesActor2D() override;
 
  bool Update(vtkViewport* viewport);
  void UpdateTextProperties(vtkViewport* viewport);
  void UpdateLabelPositions(vtkViewport* viewport);
  void UpdateTextActors(vtkViewport* viewport);
  friend class vtkGridAxesActor3D;
 
private:
  vtkGridAxesActor2D(const vtkGridAxesActor2D&) = delete;
  void operator=(const vtkGridAxesActor2D&) = delete;
 
  class vtkLabels;
  vtkLabels* Labels;
  friend class vtkLabels;
 
  bool DoRender;
 
  double GridBounds[6];
  int Face = vtkGridAxesHelper::MIN_YZ;
  unsigned int LabelMask = 0xff;
 
  vtkTuple<vtkSmartPointer<vtkTextProperty>, 3> TitleTextProperty;
  vtkTuple<vtkSmartPointer<vtkTextProperty>, 3> LabelTextProperty;
  vtkTuple<std::string, 3> Titles;
 
  vtkNew<vtkGridAxesHelper> Helper;
  vtkSmartPointer<vtkGridAxesPlaneActor2D> PlaneActor;
  vtkNew<vtkAxis> AxisHelpers[3];
  vtkNew<vtkContextScene> AxisHelperScene;
  vtkTimeStamp UpdateLabelTextPropertiesMTime;
  int LabelDisplayOffset[2] = { 0, 0 };
 
  bool ForceOpaque = false;
  std::function<double(double)> TickLabelFunction[3] = { nullptr, nullptr, nullptr };
};
 
VTK_ABI_NAMESPACE_END
#endif