The Magic Lantern Rehearsal Player allows one to test Magic Lantern titles without mastering to a target platform. The Rehearsal Player uses the Digital Workprint to specify corresponding parts (Actors/Roles/Sets) that utiltize Open Inventor technology.

Table of Contents

• Dependencies
• Details
  • Build the Magic Lantern Rehearsal Player
  • Running the Magic Lantern Rehearsal Player
  • Rehearsal Player Titles
• Debugging Titles
  • Debugging mtea Title

Dependencies

Before building the Magic Lantern Rehearsal Player for Linux, the Magic Lantern SDK for the Linux Platform must be constructed. Instructions for doing this may be found on the SDK Build Environment for Linux Platform wiki page.

In addition to the SDK dependencies, the Rehearsal Player has the following dependencies:

1. Version 1.7.0 of simage is built and installed.
   • Instructions assume that the installation directory is ~/bin/Coin3D.
   • The most recent version can be found at https://github.com/magic-lantern-studio/simage.
   • To build the source , use the instructions on simage 1.8.0 Build Instructions For Linux.

Details

After building the Magic Lantern SDK, use the following instructions to build and execute the Rehearsal Player.

Build the Magic Lantern Rehearsal Player

These instructions build the Magic Lantern Rehearsal Player.

• Eclipse Makefile: "$MLE_HOME/Players/rehearsal/build/linux/.project"

Import the above Eclipse project by selecting "File->Import...". This will bring up a Import dialog where you can choose "Existing Projects into Workspace" under the "General" tree item. Select "Next>" button to continue and browse to the above linux project.

In the Eclipse ProjectExplorer, right-click on the MlePlayers project and select "Build Project" from the pop-up menu.

The executable components that are built include

Executable	Directory Location	Component
player	"$MLE_ROOT/bin"	Magic Lantern Rehearsal Player (Debug)

Note: Make sure that $MLEROOT/bin is in your environment PATH.

Batch Build Instructions for players

Use the following instructions to build the players in batch mode (without Eclipse):

1. cd $MLE_HOME/build/linux
2. make players_install

Running the Magic Lantern Rehearsal Player

To run the Rehearsal Player on Linux, the LD_LIBRARY_PATH environment variable must be set to reference where the Magic Lantern components have been installed. For example:

$ export LD_LIBRARY_PATH=$MLE_ROOT/lib:$MLE_ROOT/lib/mle/rehearsal:/usr/local/lib

where MLE_ROOT=/opt/MagicLantern. /usr/local/lib must be specifed in order to pick up the Coin and SoXt libraries.

Rehearsal Player Titles

The following titles may be used to test the Magic Lantern Rehearsal Player:

• Null Title for Rehearsal Player
• Moving Teapot Title for Rehearsal Player

Debugging Titles

Debugging mtea Title

For information on how to debug the Moving Teapot title using the Rehearsal Player, please refer to the Debugging Moving Teapot Title on Linux Platform wiki page.