Copyright © 2003-2015 MultiMedia Soft

Files to be included with your application

Previous pageReturn to chapter overviewNext page

 

 

Important note about installed version

 

This section of the documentation applies to the full purchased version only: the trial version of the component comes with an internal protection schema against fraudulent uses which will reset properties of 3D buttons and will turn them into black or gray rectangles when the component is redistributed outside of the development machine where the trial version was originally installed through the provided setup program.

 

 

 

Files that you need to redistribute with your application depend upon the platform target:

 

If compiling for "Any CPU"

  - the component's assembly

Ctl3DMagic.dll if your application was targeted for .NET framework 2.0, 3.0 or 3.5 and the reference to Ctl3DMagic was used inside the project (*)

Ctl3DMagicF4.dll if your application was targeted for .NET framework 4.0 or higher and the reference to Ctl3DMagicF4 was used inside the project (*)

  - the x86 version of the 3D engine BTN3DMMS.dll

  - the x64 version of the 3D engine BTN3DMMS64.dll

 

If compiling specifically for x86

  - the component's assembly

Ctl3DMagic.dll if your application was targeted for .NET framework 2.0, 3.0 or 3.5 and the reference to Ctl3DMagic was used inside the project (*)

Ctl3DMagicF4.dll if your application was targeted for .NET framework 4.0 or higher and the reference to Ctl3DMagicF4 was used inside the project (*)

  - the x86 version of the 3D engine BTN3DMMS.dll

 

If compiling specifically for x64

  - the component's assembly

Ctl3DMagic.dll if your application was targeted for .NET framework 2.0, 3.0 or 3.5 and the reference to Ctl3DMagic was used inside the project (*)

Ctl3DMagicF4.dll if your application was targeted for .NET framework 4.0 or higher and the reference to Ctl3DMagicF4 was used inside the project (*)

  - the x64 version of the 3D engine BTN3DMMS64.dll

 

You can find redistributable files mentioned above inside the folder in which you installed 3D Control Magic (default C:\Program Files\3D Control Magic for .NET\Redist).

 

 

Important note about the folder chosen for installing our files

 

In order to avoid the "DLL Hell" problem, it's strongly recommended that you install the mentioned files into the same folder in which you will install the EXE of your container application on the target system and not inside the Windows\System32 or Windows\SysWOW64 folders.

 

 

 

How to create a "ClickOnce" setup containing our component using Visual Studio .NET

 

Inside the "Solution Explorer" open "References"
Locate and select the reference to Ctl3dMagic
Inside the "Properties" window locate the "Copy Local" property and set it to "True"

 

Inside the "Solution Explorer" right-click the project name
From the context menu select "Add\Existing Item..."
Inside the "Objects of type" combobox select "Executable files"
Locate the directory where Btn3dmms.dll and Btn3dmms64.dll are installed (by default should be under "C:\Program Files\3D Control Magic for .NET\Redist")
Select Btn3dmms.dll and Btn3dmms64.dll and press the "Add" button
for both of them change the "Copy to Output Directory" property to "Copy always"
Rebuild the ClickOnce package

 

 

(*) Projects originally developed with versions of the components older than 3.3 always use Ctl3DMagic reference: if you want to develop an application that can run directly into a Windows system where versions 2.0, 3.0 or 3.5 are not installed (such as clean installations of Windows 8 and Windows 10), you should set your applications to use ".NET framework 4" (or higher) as target framework and you should replace the original reference to Ctl3DMagic with the newest Ctl3DMagicF4. The tutorial How to port existing projects for compilation for .NET framework 4 explains how to perform the porting of your application's project.