Microsoft MSBuild 64 bit Targets - magic-lantern-studio/mle-documentation GitHub Wiki

This page describes how to use the Microsoft build tool, msbuild.

Table of Contents

Build Instructions

Use the following command to build Magic Lantern components:

msbuild build.msvc17.proj /p:Action={Clean|Build|Rebuild} /t:<target>

where <target> is one of the supported targets listed below. For example

msbuild build.msvc17.proj /t:BuildSDK64

Note

You can also specify the build configuration with /p:Configuration="Release;Debug" option.

Available Build Targets

The following build targets are available:

Top Level Targets

These targets are used to build the SDK, Studio and Rehearsal Player components.

Target Components Location Description
Build64 Build all the Magic Lantern components for the 64-bit platform
BuildSDK64 Build all the SDK components for the 64-bit platform
BuildRehearsal64 Build all the Rehearsal Player components for the 64-bit platform
BuildStudio64 Build all the Studio components for the 64-bit platform

util Libraries

Target Components Location Description
BuildUtil64 Build all the util components for the 64-bit platform
mlutil.lib "$MLE_ROOT\lib64\rehearsal" Magic Lantern 64-bit Utility Library for rehearsal target (Release)
mlutild.lib "$MLE_ROOT\lib64\rehearsal" Magic Lantern 64-bit Utility Library for rehearsal target (Debug)
mlutil.lib "$MLE_ROOT\lib64\tools" Magic Lantern 64-bit Utility Library for tools target (Release)
mlutild.lib "$MLE_ROOT\lib64\tools" Magic Lantern 64-bit Utility Library for tools target (Debug)
mlutil.lib "$MLE_ROOT\lib64\runtime\cdecl" Magic Lantern 64-bit Utility Library for runtime target (Release)
mlutild.lib "$MLE_ROOT\lib64\runtime\cdecl" Magic Lantern 64-bit Utility Library for runtime target (Debug)

math Libraries

Target Components Location Description
BuildMath64 Build all the math components for the 64-bit platform
mlmath.lib "$MLE_ROOT\lib64\runtime\stdcall" Magic Lantern 64-bit Math Library for runtime target (BRender Floating-point Release)
mlmathd.lib "$MLE_ROOT\lib64\runtime\stdcall" Magic Lantern 64-bit Math Library for runtime target (BRender Floating-point Debug)
mlfmath.lib "$MLE_ROOT\lib64\runtime\stdcall" Magic Lantern 64-bit Math Library for runtime target (BRender Fixed-point Release)
mlfmathd.lib "$MLE_ROOT\lib64\runtime\stdcall" Magic Lantern 64-bit Math Library for runtime target (BRender Fixed-point Debug)
mlmath.lib "$MLE_ROOT\lib64\runtime\cdecl" Magic Lantern 64-bit Math Library for runtime target (Floating-point Release)
mlmathd.lib "$MLE_ROOT\lib64\runtime\cdecl" Magic Lantern 64-bit Math Library for runtime target (Floating-point Debug)
mlmath.lib "$MLE_ROOT\lib64\tools" Magic Lantern 64-bit Math Library for tools target (Floating-point Release)
mlmathd.lib "$MLE_ROOT\lib64\tools" Magic Lantern 64-bit Math Library for tools target (Floating-point Debug)
mlmath.dll "$MLE_ROOT\bin64\rehearsal" Magic Lantern 64-bit Math Library for rehearsal target (Floating-point Release DLL)
mlmath.lib "$MLE_ROOT\lib64\rehearsal" Magic Lantern 64-bit Math Library for rehearsal target (Floating-point Release DLL Symbols)
mlmathd.dl "$MLE_ROOT\bin64\rehearsal" Magic Lantern 64-bit Math Library for rehearsal target (Floating-point Debug DLL)
mlmathd.lib "$MLE_ROOT\lib64\rehearsal" Magic Lantern 64-bit Math Library for rehearsal target (Floating-point Debug DLL Symbols)

Digital Workprint (DWP) Libraries

Target Components Location Description
BuildDwp64 Build all the Digital Workprint components for the 64-bit platform
DWPBase.lib "$MLE_ROOT\lib64\tools" DWP Base library, Magic Lantern 64-bit Studio (Release)
DWPBased.lib "$MLE_ROOT\lib64\tools" DWP Base library, Magic Lantern 64-bit Studio (Debug)
DWPType.lib "$MLE_ROOT\lib64\tools" DWP Type library, Magic Lantern 64-bit Studio (Release)
DWPTyped.lib "$MLE_ROOT\lib64\tools" DWP Type library, Magic Lantern 64-bit Studio (Debug)
DWPModel.lib "$MLE_ROOT\lib64\tools" DWP Model library, Magic Lantern 64-bit Studio (Release)
DWPModeld.lib "$MLE_ROOT\lib64\tools" DWP Model library, Magic Lantern 64-bit Studio (Debug)
DWP.lib "$MLE_ROOT\lib64\tools" DWP SDK library, Magic Lantern 64-bit Studio (Release)
DWPd.lib "$MLE_ROOT\lib64\tools" DWP SDK library, Magic Lantern 64-bit Studio (Debug)
DWP.dll "$MLE_ROOT\bin64\rehearsal" DWP SDK library, Magic Lantern 64-bit Studio (Release DLL)
DWP.lib "$MLE_ROOT\lib64\rehearsal" DWP SDK library, Magic Lantern 64-bit Studio (Release DLL Symbols)
DWPd.dll "$MLE_ROOT\bin64\rehearsal DWP SDK library, Magic Lantern 64-bit Studio (Debug DLL)
DWPd.lib "$MLE_ROOT\lib64\rehearsal" DWP SDK library, Magic Lantern 64-bit Studio (Debug DLL Symbols)
DWPChecker.exe "$MLE_ROOT\bin64" DWP Validation tool, Magic Lantern 64-bit Studio (Release)

Digital Playprint (DPP) Libraries

Target Components Location Description
BuildDpp64 Build all the Digital Playprint library components for the 64-bit platform
DPPBase.lib "$MLE_ROOT\lib64\tools" DPP Base library, Magic Lantern 64-bit Studio (Release)
DPPBased.lib "$MLE_ROOT\lib64\tools" DPP Base library, Magic Lantern 64-bit Studio (Debug)
DPPType.lib "$MLE_ROOT\lib64\tools" DPP Type library, Magic Lantern 64-bit Studio (Release)
DPPTyped.lib "$MLE_ROOT\lib64\tools" DPP Type library, Magic Lantern 64-bit Studio (Debug)
DPPModel.lib "$MLE_ROOT\lib64\tools" DPP Model library, Magic Lantern 64-bit Studio (Release)
DPPModeld.lib "$MLE_ROOT\lib64\tools" DPP Model library, Magic Lantern 64-bit Studio (Debug)
DPP.lib "$MLE_ROOT\lib64\tools" DPP SDK library, Magic Lantern 64-bit Studio (Release)
DPPd.lib "$MLE_ROOT\lib64\tools" DPP SDK library, Magic Lantern 64-bit Studio (Debug)

playprint Libraries

Target Components Location Description
BuildDppRuntime64 Build all the Digital Playprint runtime components for the 64-bit platform
playprint.lib "$MLE_ROOT\lib64\tools" Magic Lantern Studio (Release)
playprint.lib "$MLE_ROOT\lib64\runtime\stdcall" Magic Lantern 64-bit SDK (BRender Release - not used)
playprint.lib "$MLE_ROOT\lib64\runtime\cdecl" Magic Lantern 64-bit SDK (Other Release)
playprintd.lib "$MLE_ROOT\lib64\tools" Magic Lantern 64-bit Studio (Debug)
playprintd.lib "$MLE_ROOT\lib64\runtime\stdcall" Magic Lantern 64-bit SDK (BRender Debug - not used)
playprintd.lib "$MLE_ROOT\lib64\runtime\cdecl" Magic Lantern 64-bit SDK (Other Debug)

Mastering Applications

Target Components Location Description
BuildDppMaster64 Build all the Digital Playprint mastering components for the 64-bit platform
DPPGen.lib "$MLE_ROOT\lib64\tools" Magic Lantern 64-bit Studio Mastering Library (Release)
DPPGend.lib "$MLE_ROOT\lib64\tools" Magic Lantern 64-bit Studio Mastering Library (Debug)
gentables.exe "$MLE_ROOT\bin64" Generates the tables (source code) for the title (Release)
gengroup.exe "$MLE_ROOT\bin64" Generates the Group chunks for the DPP (Release)
genscene.exe "$MLE_ROOT\bin64" Generates the Scene chunks for the DPP (Release)
genmedia.exe "$MLE_ROOT\bin64" Generates the MediaRef chunks for the DPP (Release)
gendppscript.exe "$MLE_ROOT\bin64" Generates a TCL script for laying out the DPP (Release)
gendpp.exe "$MLE_ROOT\bin64" Generates a DPP using the TCL script (Release)
genmakefile.exe "$MLE_ROOT\bin64" Generates a Makefile for the title (Release)
dumpgroup.exe "$MLE_ROOT\bin64" Dump the contents of a Group chunk (Release)
dumpmedia.exe "$MLE_ROOT\bin64" Dump the contents of a MediaRef chunk (Release)
dumpscene.exe "$MLE_ROOT\bin64" Dump the contenst of a Scene chunk (Release)
dumpdpp.exe "$MLE_ROOT\bin64" Dump the contents of a Digital Playprint (Release)

Runtime Engine Libraries

Target Components Location Description
BuildRuntime64 Build all the runtime engine components for the 64-bit platform
mlert.lib "$MLE_ROOT\lib64\runtime\stdcall" Magic Lantern 64-bit Runtime Engine (BRender Release)
mlert.lib "$MLE_ROOT\lib64\runtime\cdecl" Magic Lantern 64-bit Runtime Engine (Release)
mlertd.lib "$MLE_ROOT\lib64\runtime\stdcall" Magic Lantern 64-bit Runtime Engine (BRender Debug)
mlertd.lib "$MLE_ROOT\lib64\runtime\cdecl" Magic Lantern 64-bit Runtime Engine (Debug)
mlert.dll "$MLE_ROOT\bin64\rehearsal" Magic Lantern 64-bitRuntime Engine (Release DLL)
mlert.lib "$MLE_ROOT\lib64\rehearsal" Magic Lantern 64-bit Runtime Engine (Release DLL Symbols)
mlertd.dll "$MLE_ROOT\bin64\rehearsal" Magic Lantern 64-bit Runtime Engine (Debug DLL)
mlertd.lib "$MLE_ROOT\lib64\rehearsal" Magic Lantern 64-bit Runtime Engine (Debug DLL Symbols)

Authoring Toolkit Libraries

Target Components Location Description
BuildATK64 Build all the authoring toolkit components for the 64-bit platform
mleatk.lib "$MLE_ROOT\lib64\rehearsal" Magic Lantern 64-bit Studio ATK (Release)
mleatkd.lib "$MLE_ROOT\lib64\rehearsal" Magic Lantern 64-bit Studio ATK (Debug)

Property Headers

Target Components Location Description
BuildProperties64 Build all the props components for the 64-bit platform

Set Libraries

Target Components Location Description
BuildRehearsalSets64 Build all the Rehearsal Player set components for the 64-bit platform
Mle2dSet.dll "$MLE_ROOT\bin64\rehearsal" Set for 2-dimensional rendering (Release Dll)
Mle2dSet.lib "$MLE_ROOT\lib64\rehearsal" Set for 2-dimensional rendering (Release DLL Symbols)
Mle2dSetd.dll "$MLE_ROOT\bin64\rehearsal" Set for 2-dimensional rendering (Debug DLL)
Mle2dSetd.lib "$MLE_ROOT\lib64\rehearsal" Set for 2-dimensional rendering (Debug DLL Symbols)
Mle3dSet.dll "$MLE_ROOT\bin64\rehearsal" Set for 3-dimensional rendering (Release DLL)
Mle3dSet.lib "$MLE_ROOT\lib64\rehearsal" Set for 3-dimensional rendering (Release DLL Symbols)
Mle3dSetd.dll "$MLE_ROOT\bin64\rehearsal" Set for 3-dimensional rendering (Debug DLL)
Mle3dSetd.lib "$MLE_ROOT\lib64\rehearsal" Set for 3-dimensional rendering (Debug DLL Symbols)

Role Libraries

Target Components Location Description
BuildRehearsalRoles64 Build all the Rehearsal Player role components for the 64-bit platform
ivroles.lib "$MLE_ROOT\lib64\rehearsal" Magic Lantern Studio SDK (Inventor Release)
ivrolesd.lib "$MLE_ROOT\lib64\rehearsal" Magic Lantern Studio SDK (Inventor Debug)
Mle2dRole.dll "$MLE_ROOT\bin64\rehearsal" Role for 2-dimensional rendering (Release DLL)
Mle2dRole.lib "$MLE_ROOT\lib64\rehearsal" Role for 2-dimensional rendering (Release DLL Symbols)
Mle2dRoled.dll "$MLE_ROOT\bin64\rehearsal" Role for 2-dimensional rendering (Debug DLL)
Mle2dRoled.lib "$MLE_ROOT\lib64\rehearsal" Role for 2-dimensional rendering (Debug DLL Symbols)
Mle2dImageRole.dll "$MLE_ROOT\bin64\rehearsal" Role for 2-dimensional image (Release DLL)
Mle2dImageRole.lib "$MLE_ROOT\lib64\rehearsal" Role for 2-dimensional image (Release DLL Symbols)
Mle2dImageRoled.dll "$MLE_ROOT\bin64\rehearsal" Role for 2-dimensional image (Debug DLL)
Mle2dImageRoled.lib "$MLE_ROOT\lib64\rehearsal" Role for 2-dimensional image (Debug DLL Symbols)
Mle3dRole.dll "$MLE_ROOT\bin64\rehearsal" Role for 3-dimensional rendering (Release DLL)
Mle3dRole.lib "$MLE_ROOT\lib64\rehearsal" Role for 3-dimensional rendering (Release DLL Symbols)
Mle3dRoled.dll "$MLE_ROOT\bin64\rehearsal" Role for 3-dimensional rendering (Debug DLL)
Mle3dRoled.lib "$MLE_ROOT\lib64\rehearsal" Role for 3-dimensional rendering (Debug DLL Symbols)

Media Reference Libraries

Target Components Location Description
BuildRehearsalMediaRefs64 Build all the Rehearsal Player mediaref components for the 64-bit platform
Mle2dImageMediaRef.dll "$MLE_ROOT\bin64\rehearsal" 2D Image MediaRef (Release DLL)
Mle2dImageMediaRef.lib "$MLE_ROOT\lib64\rehearsal" 2D Image MediaRef (Release DLL Symbols)
Mle2dImageMediaRefd.dll "$MLE_ROOT\bin64\rehearsal" 2D Image MediaRef (Debug DLL)
Mle2dImageMediaRefd.lib "$MLE_ROOT\lib64\rehearsal" 2D Image MediaRef (Debug DLL Symbols)
Mle3dColorMapMediaRef.dll "$MLE_ROOT\bin64\rehearsal" 3D Color Map MediaRef (Release DLL)
Mle3dColorMapMediaRef.lib "$MLE_ROOT\lib64\rehearsal" 3D Color Map MediaRef (Release DLL Symbols)
Mle3dColorMapMediaRefd.dll "$MLE_ROOT\bin64\rehearsal" 3D Color Map MediaRef (Debug DLL)
Mle3dColorMapMediaRefd.lib "$MLE_ROOT\lib64\rehearsal" 3D Color Map MediaRef (Debug DLL Symbols)
Mle3dModelMediaRef.dll "$MLE_ROOT\bin64\rehearsal" 3D Model MediaRef (Release DLL)
Mle3dModelMediaRef.lib "$MLE_ROOT\lib64\rehearsal" 3D Model MediaRef (Release DLL Symbols)
Mle3dModelMediaRefd.dll "$MLE_ROOT\bin64\rehearsal" 3D Model MediaRef (Debug DLL)
Mle3dModelMediaRefd.lib "$MLE_ROOT\lib64\rehearsal" 3D Model MediaRef (Debug DLL Symbols)
Mle3dTextureMapMediaRef.dll "$MLE_ROOT\bin64\rehearsal" 3D Texture Map MediaRef (Release DLL)
Mle3dTextureMapMediaRef.lib "$MLE_ROOT\lib64\rehearsal" 3D Texture Map MediaRef (Release DLL Symbols)
Mle3dTextureMapMediaRefd.dll "$MLE_ROOT\bin64\rehearsal" 3D Texture Map MediaRef (Debug DLL)
Mle3dTextureMapMediaRefd.lib "$MLE_ROOT\lib64\rehearsal" 3D Texture Map MediaRef (Debug DLL Symbols)

Actor Libraries

Target Components Location Description
BuildRehearsalActors64 Build all the Rehearsal Player actor components for the 64-bit platform
MleEscapeActor.dll "$MLE_ROOT\bin64\rehearsal" Escape Key Actor (Release DLL)
MleEscapeActor.lib "$MLE_ROOT\lib64\rehearsal" Escape Key Actor (Release DLL Symbols)
MleEscapeActord.dll "$MLE_ROOT\bin64\rehearsal" Escape Key Actor (Debug DLL)
MleEscapeActord.lib "$MLE_ROOT\lib64\rehearsal" Escape Key Actor (Debug DLL Symbols)
Mle3dCameraActor.dll "$MLE_ROOT\bin64\rehearsal" 3D Camera Actor (Release DLL)
Mle3dCameraActor.lib "$MLE_ROOT\lib64\rehearsal" 3D Camera Actor (Release DLL Symbols)
Mle3dCameraActord.dll "$MLE_ROOT\bin64\rehearsal" 3D Camera Actor (Debug DLL)
Mle3dCameraActord.lib "$MLE_ROOT\lib64\rehearsal" 3D Camera Actor (Debug DLL Symbols)
Mle2dImageActor.dll "$MLE_ROOT\bin64\rehearsal" Image Actor (Release DLL)
Mle2dImageActor.lib "$MLE_ROOT\lib64\rehearsal" Image Actor (Release DLL Symbols)
Mle2dImageActord.dll "$MLE_ROOT\bin64\rehearsal" Image Actor (Debug DLL)
Mle2dImageActord.lib "$MLE_ROOT\lib64\rehearsal" Image Actor (Debug DLL Symbols)

Stage Libraries

Target Components Location Description
BuildRehearsalStage64 Build all the Rehearsal Player stage components for the 64-bit platform
MleIvStage.dll "$MLE_ROOT\bin64\rehearsal" Inventor 64-bit Stage (Release DLL)
MleIvStage.lib "$MLE_ROOT\lib64\rehearsal" Inventor 64-bit Stage (Release DLL Symbols)
MleIvStaged.dll "$MLE_ROOT\bin64\rehearsal" Inventor 64-bit Stage (Debug DLL)
MleIvStaged.lib "$MLE_ROOT\lib64rehearsal" Inventor 64-bit Stage (Debug DLL Symbols)

Player Applications

Target Components Location Description
BuildRehearsalPlayer64 Build all the Rehearsal Player for the 64-bit platform
player.exe "$MLE_ROOT\bin64\rehearsal" Magic Lantern 64-bit Rehearsal Player (Release)
⚠️ **GitHub.com Fallback** ⚠️