# Rotations

VTKExamples/Cxx/Rendering/Rotations

### Description

Rotations of a cow about her axes. In this model, the x axis is from the left to right; the y axis is from bottom to top; and the z axis emerges from the image. The camera location is the same in all four images.

Info

See Figure 3-31 in Chapter 3 the VTK Textbook.

Other Languages

See (Python)

### Code

Rotations.cxx

    #include <vtkActor.h>
    #include <vtkAxes.h>
    #include <vtkCamera.h>
    #include <vtkNamedColors.h>

    #include <vtkPolyDataMapper.h>
    #include <vtkPolyDataReader.h>
    #include <vtkProperty.h>
    #include <vtkRenderWindow.h>
    #include <vtkRenderWindowInteractor.h>
    #include <vtkRenderer.h>
    #include <vtkPLYReader.h>

    #include <vtkBYUReader.h>
    #include <vtkOBJReader.h>
    #include <vtkPolyDataReader.h>
    #include <vtkSTLReader.h>
    #include <vtkXMLPolyDataReader.h>
    #include <vtkSphereSource.h>

    #include <vtksys/SystemTools.hxx>

    #include <array>
    #include <string>

    namespace {
    vtkSmartPointer<vtkPolyData> ReadPolyData(const char* fileName);
    void RotateX(vtkSmartPointer<vtkRenderWindow>& renWin,
                 vtkSmartPointer<vtkActor>& actor);
    void RotateY(vtkSmartPointer<vtkRenderWindow>& renWin,
                 vtkSmartPointer<vtkActor>& actor);
    void RotateZ(vtkSmartPointer<vtkRenderWindow>& renWin,
                 vtkSmartPointer<vtkActor>& actor);
    void RotateXY(vtkSmartPointer<vtkRenderWindow>& renWin,
                  vtkSmartPointer<vtkActor>& actor);
    } // namespace

    int main(int argc, char* argv[])
    {
      /*
      To match the illustrations in VTKTextbook.pdf, use BkgColor as the background
        and Wheat as the cow colour.
      Also comment out the lines:
        modelActor->GetProperty()->SetSpecular(.6);
        modelActor->GetProperty()->SetSpecularPower(30);
      and use cow.g as the input data.
      */

      auto figure = 0;
      auto book_color = false;
      if (argc < 2)
      {
        std::cout << "Usage: " << argv[0] << " filename [figure] [book_color]"
                  << std::endl;
        std::cout << "where: filename is the file cow.obj" << std::endl;
        std::cout << "       figure is 0, 1, 2, or 3, default 0" << std::endl;
        std::cout << "       book_color: If 1 then the vtk textbook colors are "
                     "used, default 0."
                  << std::endl;
        return EXIT_FAILURE;
      }

      std::string fileName = argv[1];

      if (argc == 3)
      {
        figure = atoi(argv[2]);
      }
      else if (argc > 3)
      {
        figure = atoi(argv[2]);
        book_color = atoi(argv[3]) != 0;
      }

      // Create renderer stuff
      //
      vtkSmartPointer<vtkNamedColors> colors =
        vtkSmartPointer<vtkNamedColors>::New();

      // Set the background color.
      std::array<unsigned char, 4> bkg{{26, 51, 102, 255}};
      //std::array<unsigned char, 4> bkg{{60, 93, 144, 255}};
      colors->SetColor("BkgColor", bkg.data());

      vtkSmartPointer<vtkRenderer> ren1 =
        vtkSmartPointer<vtkRenderer>::New();

      vtkSmartPointer<vtkRenderWindow> renWin =
        vtkSmartPointer<vtkRenderWindow>::New();
      renWin->AddRenderer(ren1);

      vtkSmartPointer<vtkRenderWindowInteractor> iren =
        vtkSmartPointer<vtkRenderWindowInteractor>::New();
      iren->SetRenderWindow(renWin);

      // Create the pipeline.
      //
      vtkSmartPointer<vtkPolyData> polyData = ReadPolyData(fileName.c_str());

      vtkSmartPointer<vtkPolyDataMapper> modelMapper =
        vtkSmartPointer<vtkPolyDataMapper>::New();
      modelMapper->SetInputData(polyData);

      vtkSmartPointer<vtkActor> modelActor =
        vtkSmartPointer<vtkActor>::New();
      modelActor->SetMapper(modelMapper);
      if (book_color)
      {
        modelActor->GetProperty()->SetDiffuseColor(
            colors->GetColor3d("Wheat").GetData());
      }
      else
      {
        modelActor->GetProperty()->SetDiffuseColor(
            colors->GetColor3d("Crimson").GetData());
        modelActor->GetProperty()->SetSpecular(.6);
        modelActor->GetProperty()->SetSpecularPower(30);
      }

      vtkSmartPointer<vtkAxes> modelAxesSource =
        vtkSmartPointer<vtkAxes>::New();
      modelAxesSource->SetScaleFactor(10);
      modelAxesSource->SetOrigin(0, 0, 0);

      vtkSmartPointer<vtkPolyDataMapper> modelAxesMapper =
        vtkSmartPointer<vtkPolyDataMapper>::New();
      modelAxesMapper->SetInputConnection(modelAxesSource->GetOutputPort());

      vtkSmartPointer<vtkActor> modelAxes =
        vtkSmartPointer<vtkActor>::New();
      modelAxes->SetMapper(modelAxesMapper);

      ren1->AddActor(modelAxes);
      modelAxes->VisibilityOff();

      // Add the actors to the renderer, set the background and size.
      //
      ren1->AddActor(modelActor);
      if (book_color)
      {
        ren1->SetBackground(colors->GetColor3d("BkgColor").GetData());
      }
      else
      {
        ren1->SetBackground(colors->GetColor3d("Silver").GetData());
      }
      renWin->SetSize(640, 480);
      ren1->ResetCamera();
      ren1->GetActiveCamera()->Azimuth(0);
      ren1->GetActiveCamera()->SetClippingRange(.1, 1000.0);

      modelAxes->VisibilityOn();

      renWin->Render();
      renWin->Render();

      switch (figure)
      {
      default:
      case 0:
        RotateXY(renWin, modelActor);
        break;
      case 1:
        RotateX(renWin, modelActor);
        break;
      case 2:
        RotateY(renWin, modelActor);
        break;
      case 3:
        RotateZ(renWin, modelActor);
        break;
      }
      renWin->EraseOff();
      iren->Start();

      return EXIT_SUCCESS;
    }

    namespace {

    void RotateX(vtkSmartPointer<vtkRenderWindow>& renWin,
                 vtkSmartPointer<vtkActor>& actor)
    {
      actor->SetOrientation(0, 0, 0);
      renWin->Render();
      renWin->Render();
      renWin->EraseOff();

      for (auto i = 0; i < 6; ++i)
      {
        actor->RotateX(60);
        renWin->Render();
        renWin->Render();
      }
      renWin->EraseOn();
    }

    void RotateY(vtkSmartPointer<vtkRenderWindow>& renWin,
                 vtkSmartPointer<vtkActor>& actor)
    {
      actor->SetOrientation(0, 0, 0);
      renWin->Render();
      renWin->EraseOff();

      for (auto i = 0; i < 6; ++i)
      {
        actor->RotateY(60);
        renWin->Render();
        renWin->Render();
      }
      renWin->EraseOn();
    }

    void RotateZ(vtkSmartPointer<vtkRenderWindow>& renWin,
                 vtkSmartPointer<vtkActor>& actor)
    {
      actor->SetOrientation(0, 0, 0);
      renWin->Render();
      renWin->EraseOff();

      for (auto i = 0; i < 6; ++i)
      {
        actor->RotateZ(60);
        renWin->Render();
        renWin->Render();
      }
      renWin->EraseOn();
    }

    void RotateXY(vtkSmartPointer<vtkRenderWindow>& renWin,
                  vtkSmartPointer<vtkActor>& actor)
    {
      actor->SetOrientation(0, 0, 0);
      actor->RotateX(60);
      renWin->Render();
      renWin->Render();
      renWin->EraseOff();

      for (auto i = 0; i < 6; ++i)
      {
        actor->RotateY(60);
        renWin->Render();
        renWin->Render();
      }
      renWin->EraseOn();
    }

    vtkSmartPointer<vtkPolyData> ReadPolyData(const char* fileName)
    {
      vtkSmartPointer<vtkPolyData> polyData;
      std::string extension =
          vtksys::SystemTools::GetFilenameExtension(std::string(fileName));
      if (extension == ".ply")
      {
        vtkSmartPointer<vtkPLYReader> reader =
          vtkSmartPointer<vtkPLYReader>::New();
        reader->SetFileName(fileName);
        reader->Update();
        polyData = reader->GetOutput();
      }
      else if (extension == ".vtp")
      {
        vtkSmartPointer<vtkXMLPolyDataReader> reader =
          vtkSmartPointer<vtkXMLPolyDataReader>::New();
        reader->SetFileName(fileName);
        reader->Update();
        polyData = reader->GetOutput();
      }
      else if (extension == ".vtk")
      {
        vtkSmartPointer<vtkPolyDataReader> reader =
          vtkSmartPointer<vtkPolyDataReader>::New();
        reader->SetFileName(fileName);
        reader->Update();
        polyData = reader->GetOutput();
      }
      else if (extension == ".obj")
      {
        vtkSmartPointer<vtkOBJReader> reader =
          vtkSmartPointer<vtkOBJReader>::New();
        reader->SetFileName(fileName);
        reader->Update();
        polyData = reader->GetOutput();
      }
      else if (extension == ".stl")
      {
        vtkSmartPointer<vtkSTLReader> reader =
          vtkSmartPointer<vtkSTLReader>::New();
        reader->SetFileName(fileName);
        reader->Update();
        polyData = reader->GetOutput();
      }
      else if (extension == ".vtk")
      {
        vtkSmartPointer<vtkPolyDataReader> reader =
          vtkSmartPointer<vtkPolyDataReader>::New();
        reader->SetFileName(fileName);
        reader->Update();
        polyData = reader->GetOutput();
      }
      else if (extension == ".g")
      {
        vtkSmartPointer<vtkBYUReader> reader =
          vtkSmartPointer<vtkBYUReader>::New();
        reader->SetGeometryFileName(fileName);
        reader->Update();
        polyData = reader->GetOutput();
      }
      else
      {
        vtkSmartPointer<vtkSphereSource> source =
          vtkSmartPointer<vtkSphereSource>::New();
        source->Update();
        polyData = source->GetOutput();
      }
      return polyData;
    }
    } // namespace

### CMakeLists.txt

    cmake_minimum_required(VERSION 3.3 FATAL_ERROR)

    project(Rotations)

    find_package(VTK COMPONENTS
      vtkCommonColor
      vtkFiltersGeneral
      vtkFiltersSources
      vtkIOGeometry
      vtkIOLegacy
      vtkIOPLY
      vtkIOXML
      vtkInteractionStyle
      vtkRenderingContextOpenGL2
      vtkRenderingCore
      vtkRenderingFreeType
      vtkRenderingGL2PSOpenGL2
      vtkRenderingOpenGL2 QUIET)
    if (NOT VTK_FOUND)
      message("Skipping Rotations: ${VTK_NOT_FOUND_MESSAGE}")
      return ()
    endif()
    message (STATUS "VTK_VERSION: ${VTK_VERSION}")
    if (VTK_VERSION VERSION_LESS "8.90.0")
      # old system
      include(${VTK_USE_FILE})
      add_executable(Rotations MACOSX_BUNDLE Rotations.cxx )
      target_link_libraries(Rotations PRIVATE ${VTK_LIBRARIES})
    else ()
      # include all components
      add_executable(Rotations MACOSX_BUNDLE Rotations.cxx )
      target_link_libraries(Rotations PRIVATE ${VTK_LIBRARIES})
      # vtk_module_autoinit is needed
      vtk_module_autoinit(
        TARGETS Rotations
        MODULES ${VTK_LIBRARIES}
        )
    endif ()

### Download and Build Rotations

Click here to download Rotations and its CMakeLists.txt file. Once the tarball Rotations.tar has been downloaded and extracted,

    cd Rotations/build

If VTK is installed:

    cmake ..

If VTK is not installed but compiled on your system, you will need to specify the path to your VTK build:

    cmake -DVTK_DIR:PATH=/home/me/vtk_build ..

Build the project:

    make

and run it:

    ./Rotations

WINDOWS USERS

Be sure to add the VTK bin directory to your path. This will resolve the VTK dll's at run time.