Files, Folders and Dependencies |
Caution |
---|
The information on this page is outdated. It does not apply to the open source project. |
Here is an overview of files that are distributed with the DigitalRune products.
This topic contains the following sections:
This page gives an overview of the files and folders distributed with the DigitalRune libraries.
Most DigitalRune libraries include multiple builds to support different versions of the Microsoft .NET Framework, Silverlight and the XNA Framework.
When you download one of the DigitalRune libraries you will receive a package with the following folders:
Folder | Description |
---|---|
Content | Contains XNA content projects and pre-built assets (e.g. shaders, textures) used by DigitalRune libraries. |
Documentation | Contains links to view the documentation online or to download the documentation. |
References | Contains the pre-built binaries (DLLs) for different platforms. |
Samples | Contains example applications that demonstrate how to use the DigitalRune libraries. |
Source | Contains the source code of the DigitalRune libraries. (The source code of selected libraries may be available for free. The full source code is only available if you have bought a source code license. See DigitalRune Website for more information.) |
Tools | Contains command-line tools. |
Different builds of the DigitalRune libraries are included to support various platforms and .NET Framework versions. The pre-built binaries (DLLs) are sorted into the following folders:
Folder | Description |
---|---|
References/.NETCore/ | Contains the build for Windows Store Universal Apps (Windows + Windows Phone). No XNA/MonoGame-specific functionality. |
References/.NETFramework/ | Contains the build for the Microsoft .NET Framework and Mono. No XNA/MonoGame-specific functionality. |
References/.NETPortable/ | Contains the Portable Class Library (PCL) builds supporting Profile328: .NET 4 + Silverlight 5 + Windows 8 + Windows Phone 8 + Xamarin.Android + Xamarin.iOS. Platform-specific functionality will throw NotImplementedExceptions. Use these builds if you need to reference the DigitalRune assemblies from a portable class library. (See also Advanced PCL / Bait and Switch PCL) |
References/Android/ | Contains the build for Xamarin.Android. No XNA/MonoGame-specific functionality. |
References/iOS/ | Contains the build for Xamarin.iOS. No XNA/MonoGame-specific functionality. |
References/MonoGame/Windows/ | Contains MonoGame and the DigitalRune libraries built for Windows desktop using DirectX11 (SharpDX). |
References/MonoGame/WindowsPhone/ | Contains MonoGame and the DigitalRune libraries built for Windows Phone 8.1 apps. |
References/MonoGame/WindowsStore/ | Contains MonoGame and the DigitalRune libraries built for the Windows Store 8.1 apps (WinRT). |
References/MonoGame/WindowsUniversal/ | Contains MonoGame and the DigitalRune libraries built for the Universal Windows Platform (UWP). |
References/MonoGame/Linux/ | Contains MonoGame and the DigitalRune libraries built for Linux. |
References/MonoGame/MacOS/ | Contains MonoGame and the DigitalRune libraries built for Mac OS X. |
References/MonoGame/Android/ | Contains MonoGame and the DigitalRune libraries built for Android. |
References/MonoGame/iOS/ | Contains MonoGame and the DigitalRune libraries built for iOS. |
References/Silverlight/ | Contains the build for Microsoft Silverlight 5. No XNA/MonoGame-specific functionality. |
References/Unity/ | Contains the build for the Unity game engine. No XNA/MonoGame-specific functionality. The Unity assemblies were built for the .NET Framework 3.5. DigitalRune.ServiceLocation.dll is not available in Unity. |
References/XNA/Windows/ | Contains the Windows (x86) build for the Microsoft XNA Framework. |
References/XNA/Xbox360/ | Contains the Xbox 360 build for the Microsoft XNA Framework. |
References/XNA/Xbox360/ | Contains the Windows Phone 7 build for the Microsoft XNA Framework. |
The following graph illustrates the dependencies between the DigitalRune assemblies and third-party assemblies.
It is usually not necessary to worry about these dependencies as long as all assemblies are included in the application. But if you want to minimize the size of your package, you can include only the assemblies relevant to your application.
As you can see from this graph, the assemblies DigitalRune.Game.Input.dll, DigitalRune.Game.UI.dll and DigitalRune.Graphics.dll require XNA or MonoGame. The other assemblies can be used without XNA or MonoGame.
The assemblies DigitalRune.Mathematics.dll, DigitalRune.Geometry.dll, DigitalRune.Animation.dll, DigitalRune.Particles.dll, DigitalRune.Physics.dll and DigitalRune.Physics.Specialize.dll optionally support XNA/MonoGame: For example, conversion between DigitialRune and XNA data types, XNA content serialization, XNA avatar ragdolls, etc. These additional features are optional, i.e. these DigitalRune assemblies can also be used without XNA or MonoGame.
The XNA/MonoGame-independent builds (References/.NETCore, References/.NETFramework, etc.) contain MonoGame.Framework.dll. This is a PCL stub DLL which implements the MonoGame API but does not actually implement all MonoGame functions. The XNA/MonoGame-independent builds require this DLL. However, calling any MonoGame- specific functions, e.g. 3D graphics, audio, will raise a NotImplementedException.
Here is a description of files that can be found in the build folders.
File | Description |
---|---|
DigitalRune.dll | The DigitalRune Base library, required by most DigitalRune libraries. |
DigitalRune.xml | The XML documentation file for DigitalRune.dll. |
DigitalRune.Animation.dll | The DigitalRune Animation library. |
DigitalRune.Animation.xml | The XML documentation file for DigitalRune.Animation.dll. |
DigitalRune.Animation.Content.Pipeline.dll | An XNA Content Pipeline project that contains the content importers, processors and type writers for DigitalRune Animation. |
DigitalRune.Game.dll | The DigitalRune Game library, required by DigitalRune Game UI. |
DigitalRune.Game.xml | The XML documentation file for DigitalRune.Game.dll. |
DigitalRune.Game.Input.dll | The input processing of the DigitalRune Game UI library. |
DigitalRune.Game.Input.xml | The XML documentation file for DigitalRune.Game.Input.dll. |
DigitalRune.Game.UI.dll | The GUI classes of the DigitalRune Game UI library. |
DigitalRune.Game.UI.xml | The XML documentation file for DigitalRune.Game.UI.dll. |
DigitalRune.Game.UI.Content.Pipeline.dll | An XNA Content Pipeline project that contains the content importers, processors and type writers for DigitalRune Game UI. |
DigitalRune.Game.UI.Content.Pipeline.xml | The XML documentation file for DigitalRune.Game.UI.Content.Pipeline.dll. |
DigitalRune.Geometry.dll | The DigitalRune Geometry library. |
DigitalRune.Geometry.xml | The XML documentation file for DigitalRune.Geometry.dll. |
DigitalRune.Geometry.Content.Pipeline.dll | An XNA Content Pipeline project that contains the content type writers for DigitalRune.Geometry. |
DigitalRune.Geometry.Content.Pipeline.xml | The XML documentation file for DigitalRune.Geometry.Content.Pipeline.dll. |
DigitalRune.Graphics.dll | The DigitalRune Graphics library. |
DigitalRune.Graphics.xml | The XML documentation file for DigitalRune.Geometry.dll. |
DigitalRune.Graphics.Content.Pipeline.dll | An XNA Content Pipeline project that contains the content type writers for DigitalRune.Graphics. |
DigitalRune.Graphics.Content.Pipeline.xml | The XML documentation file for DigitalRune.Graphics.Content.Pipeline.dll. |
DigitalRune.Mathematics.dll | The DigitalRune Mathematics library. |
DigitalRune.Mathematics.xml | The XML documentation file for DigitalRune.Mathematics.dll. |
DigitalRune.Mathematics.Content.Pipeline.dll | An XNA Content Pipeline project that contains the content type writers for DigitalRune.Mathematics. |
DigitalRune.Mathematics.Content.Pipeline.xml | The XML documentation file for DigitalRune.Mathematics.Content.Pipeline.dll. |
DigitalRune.Particles.dll | The DigitalRune Particles library. |
DigitalRune.Particles.xml | The XML documentation file for DigitalRune.Particles.dll. |
DigitalRune.Physics.dll | The DigitalRune Physics library. |
DigitalRune.Physics.xml | The XML documentation file for DigitalRune.Physics.dll. |
DigitalRune.Physics.Specialized.dll | Contains specialized physics modules: ragdolls for Xbox LIVE Avatars, general character controllers and vehicle physics. |
DigitalRune.Physics.Specialized.xml | The XML documentation file for DigitalRune.Physics.Specialized.dll. |
DigitalRune.ServiceLocation.dll | An optional library that comes with the DigitalRune Base library. Contains an Inversion of Control (IoC) container. |
DigitalRune.ServiceLocation.xml | The XML documentation file for DigitalRune.ServiceLocation.dll. |
Microsoft.Practices.ServiceLocation.dll | The Common Service Locator library from Microsoft patterns and practices. This library is required by DigitalRune.ServiceLocation.dll. |
Microsoft.Practices.ServiceLocation.xml | The XML documentation file for Microsoft.Practices.ServiceLocation.dll. |
MonoGame.Framework.dll | The actual MonoGame library or a stub DLL (see details above). |