ENH" AnnotatedCubeActor example

src/Cxx.md

@@ -819,6 +819,7 @@ See [this tutorial](http://www.vtk.org/Wiki/VTK/Tutorials/3DDataTypes) for a bri
 
 | Example Name | Classes Demonstrated | Description | Image |
 |--------------|----------------------|-------------|-------|
+[AnnotatedCubeActor](/Cxx/Visualization/AnnotatedCubeActor)| vtkAnnotatedCubeActor | Annotated cube.
 [Arbitrary3DCursor](/Cxx/Visualization/Arbitrary3DCursor)| vtkPointWidget |Track a 3D cursor.
 [AssignCellColorsFromLUT](/Cxx/Visualization/AssignCellColorsFromLUT)| vtkNamedColors vtkPlaneSource vtkLookupTable vtkColorTransferFunction | Demonstrates how to assign colors to cells in a vtkPolyData structure using lookup tables.
 [BackfaceCulling](/Cxx/Visualization/BackfaceCulling)| vtkActor | Backface culling.

src/Cxx/Visualization/AnnotatedCubeActor.cxx

+#include <vtkSmartPointer.h>
+#include <vtkAnnotatedCubeActor.h>
+#include <vtkCamera.h>
+#include <vtkProperty.h>
+#include <vtkRenderer.h>
+#include <vtkRenderWindow.h>
+#include <vtkRenderWindowInteractor.h>
+#include <vtkNamedColors.h>
+
+int main( int, char *[] )
+{
+  vtkSmartPointer<vtkAnnotatedCubeActor> cube =
+    vtkSmartPointer<vtkAnnotatedCubeActor>::New();
+  cube->SetFaceTextScale( 0.666667 );
+
+  // set up the renderer, window, and interactor
+  //
+  vtkSmartPointer<vtkNamedColors> colors =
+    vtkSmartPointer<vtkNamedColors>::New();
+
+  vtkSmartPointer<vtkRenderer> renderer =
+    vtkSmartPointer<vtkRenderer>::New();
+  renderer->SetBackground(colors->GetColor3d("Wheat").GetData());
+
+  vtkSmartPointer<vtkRenderWindow> renderWindow =
+    vtkSmartPointer<vtkRenderWindow>::New();
+  renderWindow->AddRenderer( renderer );
+  renderWindow->SetSize(640, 480);
+
+  vtkSmartPointer<vtkRenderWindowInteractor> interactor =
+    vtkSmartPointer<vtkRenderWindowInteractor>::New();
+  interactor->SetRenderWindow( renderWindow );
+
+  // anatomic labelling
+  //
+  cube->SetXPlusFaceText ( "A" );
+  cube->SetXMinusFaceText( "P" );
+  cube->SetYPlusFaceText ( "L" );
+  cube->SetYMinusFaceText( "R" );
+  cube->SetZPlusFaceText ( "S" );
+  cube->SetZMinusFaceText( "I" );
+
+  // change the vector text colors
+  //
+  cube->GetTextEdgesProperty()->SetColor(colors->GetColor3d("Black").GetData());
+  cube->GetTextEdgesProperty()->SetLineWidth(4);
+
+  vtkProperty *property;
+  property = cube->GetXPlusFaceProperty();
+  property->SetColor(colors->GetColor3d("Turquoise").GetData());
+  property = cube->GetXMinusFaceProperty();
+  property->SetColor(colors->GetColor3d("Turquoise").GetData());
+  property = cube->GetYPlusFaceProperty();
+  property->SetColor(colors->GetColor3d("Mint").GetData());
+  property = cube->GetYMinusFaceProperty();
+  property->SetColor(colors->GetColor3d("Mint").GetData());
+  property = cube->GetZPlusFaceProperty();
+  property->SetColor(colors->GetColor3d("Tomato").GetData());
+  property = cube->GetZMinusFaceProperty();
+  property->SetColor(colors->GetColor3d("Tomato").GetData());
+
+  renderer->AddActor(cube);
+
+  // set up an interesting view
+  //
+  vtkCamera* camera = renderer->GetActiveCamera();
+  camera->SetViewUp( 0, 0, 1 );
+  camera->SetFocalPoint( 0, 0, 0 );
+  camera->SetPosition( 4.5, 4.5, 2.5 );
+  renderer->ResetCamera();
+  camera->Dolly(1.3);
+  renderer->ResetCameraClippingRange();
+
+  renderWindow->Render();
+  interactor->Start();
+
+  return EXIT_SUCCESS;
+}