Click or drag to resize
DigitalRuneFiles, Folders and Dependencies
Caution note 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:

General

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.

Folders

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.

Builds and platforms

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.

Dependencies

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.

Dependency Graph
Screenshot: Dependency Graph
XNA and MonoGame

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.

MonoGame stub DLL

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.

Binaries

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).