Add a very simple example input deck.

This adds the "dropbox" example to the **build directory**
named `Examples/vegaFem/dropbox`. Running `vegaFem` on the
`dropbox.config` file will simulate a cube being dropped onto a plane.
This example is intended for debugging and testing purposes.

CMake/SuperBuild/External_VegaFEM.cmake

@@ -75,7 +75,7 @@ if(NOT DEFINED VegaFEM_DIR)
       -DVegaFEM_ENABLE_PTHREADS_SUPPORT:BOOL=ON
       -DVegaFEM_ENABLE_OpenGL_SUPPORT:BOOL=OFF
       -DVegaFEM_BUILD_MODEL_REDUCTION:BOOL=OFF
-      -DVegaFEM_BUILD_UTILITIES:BOOL=OFF
+      -DVegaFEM_BUILD_UTILITIES:BOOL=ON
       -DCMAKE_INCLUDE_PATH:STRING=${SimMedTK_CMAKE_INCLUDE_PATH}
       -DCMAKE_LIBRARY_PATH:STRING=${SimMedTK_CMAKE_LIBRARY_PATH}
       -DCMAKE_REQUIRED_INCLUDES:STRING=${ep_install_dir}/include

Examples/vegaFem/CMakeLists.txt

-
 add_executable(vegaFemExample main.cpp)
 target_link_libraries(vegaFemExample
   Core
@@ -13,4 +12,54 @@ target_link_libraries(vegaFemExample
   Event
   ExamplesCommon
   IO
+)
+
+# Configure an example to run in the build directory:
+set(dropbox_files
+  dropbox.bou
+  dropbox.config
+  dropbox.lights
+  dropbox.mtl
+  dropbox.obj
+  dropbox.veg
+)
+
+set(SimMedTK_VEGA_EXAMPLE_DIR "${CMAKE_CURRENT_BINARY_DIR}")
+foreach (_file ${dropbox_files})
+  configure_file(
+    ${CMAKE_CURRENT_SOURCE_DIR}/dropbox/${_file}.in
+    ${CMAKE_CURRENT_BINARY_DIR}/dropbox/${_file}
+    @ONLY
   )
+endforeach()
+# Generate the mass-matrix and interpolation simulation
+# inputs from the volume mesh and surface mesh.
+add_custom_command(
+  OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.mass"
+  COMMAND
+    "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/generateMassMatrix"
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.veg"
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.mass"
+  MAIN_DEPENDENCY
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.veg"
+  COMMENT "Generating mass matrix for dropbox example."
+)
+add_custom_command(
+  OUTPUT "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.interp"
+  COMMAND
+    "${CMAKE_RUNTIME_OUTPUT_DIRECTORY}/generateInterpolant"
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.veg"
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.obj"
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.interp"
+  MAIN_DEPENDENCY
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.veg"
+  DEPENDS
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.obj"
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.mtl"
+  COMMENT "Generating surface interpolation weights for dropbox example."
+)
+add_custom_target(dropbox_aux ALL
+  DEPENDS
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.interp"
+    "${CMAKE_CURRENT_BINARY_DIR}/dropbox/dropbox.mass"
+)

Examples/vegaFem/dropbox/dropbox.config.in

+*volumetricMeshFilename
+@SimMedTK_VEGA_EXAMPLE_DIR@/dropbox/dropbox.veg
+
+*solver
+implicitBackwardEuler
+#implicitNewmark
+#symplecticEuler
+#Euler
+
+*deformableObjectMethod
+#StVK
+InvertibleFEM
+#CLFEM
+#LinearFEM
+
+# for InvertibleFEM
+*inversionThreshold
+0.1
+
+# for InvertibleFEM
+*invertibleMaterial
+StVK
+#neoHookean
+#MooneyRivlin
+
+*fixedVerticesFilename
+@SimMedTK_VEGA_EXAMPLE_DIR@/dropbox/dropbox.bou
+
+*massMatrixFilename
+@SimMedTK_VEGA_EXAMPLE_DIR@/dropbox/dropbox.mass
+
+*renderingMeshFilename
+@SimMedTK_VEGA_EXAMPLE_DIR@/dropbox/dropbox.veg.obj
+
+*secondaryRenderingMeshFilename
+@SimMedTK_VEGA_EXAMPLE_DIR@/dropbox/dropbox.obj
+
+*secondaryRenderingMeshInterpolationFilename
+@SimMedTK_VEGA_EXAMPLE_DIR@/dropbox/dropbox.interp
+
+*timestep
+0.02
+
+*syncTimestepWithGraphics
+0
+
+*dampingMassCoef
+0.0
+#1.0
+
+*dampingStiffnessCoef
+0.01
+#0.001
+
+*deformableObjectCompliance
+30.0
+
+*baseFrequency
+1.0
+
+*numInternalForceThreads
+4
+
+*numSolverThreads
+2
+
+*renderSecondaryDeformableObject
+0
+
+*lightingConfigFilename
+@SimMedTK_VEGA_EXAMPLE_DIR@/dropbox/dropbox.lights
+
+*cameraRadius
+11.76
+
+*cameraLongitude
+-302.934
+
+*cameraLattitude
+14.8434
+
+*focusPositionX
+1.0
+
+*focusPositionY
+0.0
+
+*focusPositionZ
+0.0
+

Examples/vegaFem/dropbox/dropbox.lights.in

+*globalAmbientIntensity
+0.2
+
+*enableSpecularTerm
+true
+
+*twoSidedLighting
+true
+
+#### light 3
+
+*lightEnabled_3
+true
+
+*position_3_X
+-10
+*position_3_Y
+10
+*position_3_Z
+-10
+
+*lightIntensity_3
+0.8
+
+#### light 6
+
+*lightEnabled_6
+true
+
+*position_6_X
+10
+*position_6_Y
+10
+*position_6_Z
+10
+
+*lightIntensity_6
+0.8

Examples/vegaFem/dropbox/dropbox.mtl.in

+newmtl box
+illum 4
+Kd 0.00 0.60 0.00
+Ka 0.00 0.10 0.00
+Tf 1.00 1.00 1.00
+Ni 1.00
+Ks 0.35 0.35 0.35
+Ns 200

Examples/vegaFem/dropbox/dropbox.obj.in

+# Generated by the objfile class
+# Number of vertices: 8
+# Number of texture coordinates: 0
+# Number of normals: 6
+# Number of faces: 12
+# Number of groups: 1
+
+mtllib dropbox.mtl
+
+v  0 0 0
+v  1 0 0
+v  1 1 0
+v  0 1 0
+v  0 0 1
+v  1 0 1
+v  1 1 1
+v  0 1 1
+
+vn 0 0 -1
+vn 0 0  1
+vn 0 -1 0
+vn 0  1 0
+vn -1 0 0
+vn  1 0 0
+
+g box
+usemtl box
+f 1//1 3//1 2//1
+f 1//1 4//1 3//1
+f 5//2 6//2 7//2
+f 5//2 7//2 8//2
+f 1//3 2//3 5//3
+f 1//3 5//3 4//3
+f 3//4 4//4 8//4
+f 3//4 8//4 7//4
+f 1//5 5//5 8//5
+f 1//5 8//5 4//5
+f 2//6 3//6 6//6
+f 6//6 3//6 7//6

Examples/vegaFem/dropbox/dropbox.veg.in

+# Vega mesh file.
+# 8 vertices, 5 elements
+
+*VERTICES
+8 3 0 0
+1  0 0 0
+2  1 0 0
+3  1 1 0
+4  0 1 0
+5  0 0 1
+6  1 0 1
+7  1 1 1
+8  0 1 1
+
+*ELEMENTS
+TET
+5 4 0
+1  1 2 3 6
+2  3 4 1 8
+3  1 6 8 5
+4  3 8 6 7
+5  1 3 8 6
+
+*MATERIAL defaultMaterial
+ENU, 1000, 1000000000, 0.45
+
+*SET defaultSet
+1, 2, 3, 4, 5, 6, 7, 8,
+
+*MATERIAL BODY
+ENU, 1000, 10000000, 0.4
+
+*REGION
+allElements, BODY
+