MultiLineText

VTKExamples/Cxx/Annotation/MultiLineText


Description

This example demonstrates the use of multiline 2D text using vtkTextMapper. It shows several justifications as well as single-line and multiple-line text inputs.

Code

MultiLineText.cxx

// This example demonstrates the use of multiline 2D text using
// vtkTextMappers.  It shows several justifications as well as
// single-line and multiple-line text inputs.

#include <vtkSmartPointer.h>

#include <vtkNamedColors.h>
#include <vtkActor2D.h>
#include <vtkCamera.h>
#include <vtkCellArray.h>
#include <vtkCoordinate.h>
#include <vtkPoints.h>
#include <vtkPolyData.h>
#include <vtkPolyDataMapper2D.h>
#include <vtkProperty2D.h>
#include <vtkRenderWindow.h>
#include <vtkRenderWindowInteractor.h>
#include <vtkRenderer.h>
#include <vtkTextMapper.h>
#include <vtkTextProperty.h>

int main (int, char*[])
{
  int font_size = 24;;

// Create the text mappers and the associated Actor2Ds.

// The font and text properties (except justification) are the same for
// each single line mapper. Let's create a common text property object
  vtkSmartPointer<vtkTextProperty> singleLineTextProp =
    vtkSmartPointer<vtkTextProperty>::New();

  singleLineTextProp->SetFontSize(font_size);
  singleLineTextProp->SetFontFamilyToArial();
  singleLineTextProp->BoldOff();
  singleLineTextProp->ItalicOff();
  singleLineTextProp->ShadowOff();

// The font and text properties (except justification) are the same for
// each multi line mapper. Let's create a common text property object
  vtkSmartPointer<vtkTextProperty> multiLineTextProp =
    vtkSmartPointer<vtkTextProperty>::New();

  multiLineTextProp->ShallowCopy(singleLineTextProp);
  multiLineTextProp->BoldOn();
  multiLineTextProp->ItalicOn();
  multiLineTextProp->ShadowOn();
  multiLineTextProp->SetLineSpacing(0.8);

  vtkSmartPointer<vtkNamedColors> colors =
    vtkSmartPointer<vtkNamedColors>::New();

// The text is on a single line and bottom-justified.
  vtkSmartPointer<vtkTextMapper> singleLineTextB =
    vtkSmartPointer<vtkTextMapper>::New();
  singleLineTextB->SetInput("Single line (bottom)");
  vtkTextProperty *tprop = singleLineTextB->GetTextProperty();
  tprop->ShallowCopy(singleLineTextProp);;
  tprop->SetVerticalJustificationToBottom();
  tprop->SetColor(colors->GetColor3d("Tomato").GetData());

  vtkSmartPointer<vtkActor2D> singleLineTextActorB =
    vtkSmartPointer<vtkActor2D>::New();
  singleLineTextActorB->SetMapper(singleLineTextB);
  singleLineTextActorB->GetPositionCoordinate()->SetCoordinateSystemToNormalizedDisplay();
  singleLineTextActorB->GetPositionCoordinate()->SetValue(0.05, 0.85);

// The text is on a single line and center-justified (vertical
// justification).
  vtkSmartPointer<vtkTextMapper> singleLineTextC =
    vtkSmartPointer<vtkTextMapper>::New();
  singleLineTextC->SetInput("Single line (centered)");
  tprop = singleLineTextC->GetTextProperty();
  tprop->ShallowCopy(singleLineTextProp);
  tprop->SetVerticalJustificationToCentered();
  tprop->SetColor(colors->GetColor3d("DarkGreen").GetData());
  vtkSmartPointer<vtkActor2D> singleLineTextActorC =
    vtkSmartPointer<vtkActor2D>::New();

  singleLineTextActorC->SetMapper(singleLineTextC);
  singleLineTextActorC->GetPositionCoordinate()->SetCoordinateSystemToNormalizedDisplay();
  singleLineTextActorC->GetPositionCoordinate()->SetValue(0.05, 0.75);

// The text is on a single line and top-justified.
  vtkSmartPointer<vtkTextMapper> singleLineTextT =
    vtkSmartPointer<vtkTextMapper>::New();
  singleLineTextT->SetInput("Single line (top)");
  tprop = singleLineTextT->GetTextProperty();
  tprop->ShallowCopy(singleLineTextProp);
  tprop->SetVerticalJustificationToTop();
  tprop->SetColor(colors->GetColor3d("Peacock").GetData());

  vtkSmartPointer<vtkActor2D> singleLineTextActorT =
    vtkSmartPointer<vtkActor2D>::New();
  singleLineTextActorT->SetMapper(singleLineTextT);
  singleLineTextActorT->GetPositionCoordinate()->SetCoordinateSystemToNormalizedDisplay();
  singleLineTextActorT->GetPositionCoordinate()->SetValue(0.05, 0.65);

// The text is on multiple lines and left- and top-justified.
  vtkSmartPointer<vtkTextMapper> textMapperL =
    vtkSmartPointer<vtkTextMapper>::New();
  textMapperL->SetInput("This is\nmulti-line\ntext output\n(left-top)");
  tprop = textMapperL->GetTextProperty();
  tprop->ShallowCopy(multiLineTextProp);
  tprop->SetJustificationToLeft();
  tprop->SetVerticalJustificationToTop();
  tprop->SetColor(colors->GetColor3d("Tomato").GetData());

  vtkSmartPointer<vtkActor2D> textActorL =
    vtkSmartPointer<vtkActor2D>::New();
  textActorL->SetMapper(textMapperL);
  textActorL->GetPositionCoordinate()->SetCoordinateSystemToNormalizedDisplay();
  textActorL->GetPositionCoordinate()->SetValue(0.05, 0.5);

// The text is on multiple lines and center-justified (both horizontal and
// vertical).
  vtkSmartPointer<vtkTextMapper> textMapperC =
    vtkSmartPointer<vtkTextMapper>::New();
  textMapperC->SetInput("This is\nmulti-line\ntext output\n(centered)");
  tprop = textMapperC->GetTextProperty();
  tprop->ShallowCopy(multiLineTextProp);
  tprop->SetJustificationToCentered();
  tprop->SetVerticalJustificationToCentered();
  tprop->SetColor(colors->GetColor3d("DarkGreen").GetData());

  vtkSmartPointer<vtkActor2D> textActorC =
    vtkSmartPointer<vtkActor2D>::New();
  textActorC->SetMapper(textMapperC);
  textActorC->GetPositionCoordinate()->SetCoordinateSystemToNormalizedDisplay();
  textActorC->GetPositionCoordinate()->SetValue(0.5, 0.5);

// The text is on multiple lines and right- and bottom-justified.
  vtkSmartPointer<vtkTextMapper> textMapperR =
    vtkSmartPointer<vtkTextMapper>::New();
  textMapperR->SetInput("This is\nmulti-line\ntext output\n(right-bottom)");
  tprop = textMapperR->GetTextProperty();
  tprop->ShallowCopy(multiLineTextProp);
  tprop->SetJustificationToRight();
  tprop->SetVerticalJustificationToBottom();
  tprop->SetColor(colors->GetColor3d("Peacock").GetData());

  vtkSmartPointer<vtkActor2D> textActorR =
    vtkSmartPointer<vtkActor2D>::New();
  textActorR->SetMapper(textMapperR);
  textActorR->GetPositionCoordinate()->SetCoordinateSystemToNormalizedDisplay();
  textActorR->GetPositionCoordinate()->SetValue(0.95, 0.5);

// Draw the grid to demonstrate the placement of the text.

// Set up the necessary points.
  vtkSmartPointer<vtkPoints> Pts =
    vtkSmartPointer<vtkPoints>::New();
  Pts->InsertNextPoint(0.05, 0.0, 0.0);
  Pts->InsertNextPoint(0.05, 1.0, 0.0);
  Pts->InsertNextPoint(0.5, 0.0, 0.0);
  Pts->InsertNextPoint(0.5, 1.0, 0.0);
  Pts->InsertNextPoint(0.95, 0.0, 0.0);
  Pts->InsertNextPoint(0.95, 1.0, 0.0);
  Pts->InsertNextPoint(0.0, 0.5, 0.0);
  Pts->InsertNextPoint(1.0, 0.5, 0.0);
  Pts->InsertNextPoint(0.00, 0.85, 0.0);
  Pts->InsertNextPoint(0.50, 0.85, 0.0);
  Pts->InsertNextPoint(0.00, 0.75, 0.0);
  Pts->InsertNextPoint(0.50, 0.75, 0.0);
  Pts->InsertNextPoint(0.00, 0.65, 0.0);
  Pts->InsertNextPoint(0.50, 0.65, 0.0);

// Set up the lines that use these points.
  vtkSmartPointer<vtkCellArray> Lines =
    vtkSmartPointer<vtkCellArray>::New();
  Lines->InsertNextCell(2);
  Lines->InsertCellPoint(0);
  Lines->InsertCellPoint(1);
  Lines->InsertNextCell(2);
  Lines->InsertCellPoint(2);
  Lines->InsertCellPoint(3);
  Lines->InsertNextCell(2);
  Lines->InsertCellPoint(4);
  Lines->InsertCellPoint(5);
  Lines->InsertNextCell(2);
  Lines->InsertCellPoint(6);
  Lines->InsertCellPoint(7);
  Lines->InsertNextCell(2);
  Lines->InsertCellPoint(8);
  Lines->InsertCellPoint(9);
  Lines->InsertNextCell(2);
  Lines->InsertCellPoint(10);
  Lines->InsertCellPoint(11);
  Lines->InsertNextCell(2);
  Lines->InsertCellPoint(12);
  Lines->InsertCellPoint(13);

// Create a grid that uses these points and lines.
  vtkSmartPointer<vtkPolyData> Grid =
    vtkSmartPointer<vtkPolyData>::New();
  Grid->SetPoints(Pts);
  Grid->SetLines(Lines);
// Set up the coordinate system.
  vtkSmartPointer<vtkCoordinate> normCoords =
    vtkSmartPointer<vtkCoordinate>::New();
  normCoords->SetCoordinateSystemToNormalizedViewport();

// Set up the mapper and actor (2D) for the grid.
  vtkSmartPointer<vtkPolyDataMapper2D> mapper =
    vtkSmartPointer<vtkPolyDataMapper2D>::New();
  mapper->SetInputData(Grid);
  mapper->SetTransformCoordinate(normCoords);
  vtkSmartPointer<vtkActor2D> gridActor =
    vtkSmartPointer<vtkActor2D>::New();
  gridActor->SetMapper(mapper);
  gridActor->GetProperty()->SetColor(colors->GetColor3d("DimGray").GetData());

// Create the Renderer, RenderWindow, and RenderWindowInteractor
  vtkSmartPointer<vtkRenderer> renderer =
    vtkSmartPointer<vtkRenderer>::New();
  vtkSmartPointer<vtkRenderWindow> renderWindow =
    vtkSmartPointer<vtkRenderWindow>::New();

  renderWindow->AddRenderer(renderer);
  vtkSmartPointer<vtkRenderWindowInteractor> interactor =
    vtkSmartPointer<vtkRenderWindowInteractor>::New();
  interactor->SetRenderWindow(renderWindow);

// Add the actors to the renderer; set the background and size; zoom in
// closer to the image; render
  renderer->AddActor2D(textActorL);
  renderer->AddActor2D(textActorC);
  renderer->AddActor2D(textActorR);
  renderer->AddActor2D(singleLineTextActorB);
  renderer->AddActor2D(singleLineTextActorC);
  renderer->AddActor2D(singleLineTextActorT);
  renderer->AddActor2D(gridActor);

  renderer->SetBackground(colors->GetColor3d("Silver").GetData());
  renderWindow->SetSize(640, 480);
  renderer->GetActiveCamera()->Zoom(1.5);

  interactor->Initialize();
  renderWindow->Render();
  interactor->Start();

  return EXIT_SUCCESS;
}

CMakeLists.txt

cmake_minimum_required(VERSION 2.8)

PROJECT(MultiLineText)

find_package(VTK REQUIRED)
include(${VTK_USE_FILE})

add_executable(MultiLineText MACOSX_BUNDLE MultiLineText.cxx )

target_link_libraries(MultiLineText ${VTK_LIBRARIES})

Download and Build MultiLineText

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

cd MultiLineText/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:

./MultiLineText

WINDOWS USERS

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