Instructions.md

Sensum Deployment Instructions

Instuctions written by @mniafi, Sensum by @martinjanas.

Disclaimer:
The software is distributed as source code only

From Installing Tools to Building DLL's
Host OS: Windows 10 Version 2004 (19041.928)

Step 1 - Installing Visual Studio

Go to Microsoft's webpage. Press the "Free download" button on left as shown on Screenshot #1:
You want to download Visual Studio Community.

Open the installer and wait until the installer shows up:

After some time you will see something like this:

Select Desktop development with C++ and click Install :

Now wait for installation...

After installing You will get this window:

if you have Microsoft account u can Sign In. if not just click Not now, maybe later

(Optional) Next step, select color theme , i use dark one. Click on Start Visual Studio :

After some time, VS will appear:

Close it with X.

Step 2 - Downloading DirectX SDK

Just download this package DXSDK_Jun10.exe. (572MB)

After downloading, run the installer:

Click Next , Accept Terms in the license agreement:

Click Next and Select one of the options:

Click Next Select Destination Folder (dont change this) and click Next again. Dont change here anything, just click Next

Finish installation.

Step 3 - Sensum

First of all, go to the original Sensum Github for latest version.

version history on my Github page

MartiN's Github page:

click on Green code button and select Download ZIP

You will get file named: Sensum-master.zip , extract it to Desktop:

Run sensum.sln from folder you extracted:

Select Second one here:

Here just click OK

Here change Debug x86

to Release x86

CPU Instruction Set

By default, Sensum is configured for SSE2 Instruction set.
It's not neccessary to change but if you want to gain more performance, You can change it to AVX, AVX2 or AVX512.
Every CPU has different instruction set.
Google your CPU to see what instruction set it supports.

For example, host has i7 3770 CPU

Google: i7 3770 and click on intel's webpage

looks like this:

lookup for something like this:

here you can see, that my CPU is using SSE and AVX

Project Configuration

So I can enable AVX in Source; Go to Project > Properties

Next go to C++ > Code Generation

Selecting AVX because my CPU SUPPORTS this

Click OK button and window will close.

Done! Few steps to get DLL!

Building Sensum.dll

Now Go to Build > Build Solution

Wait for build...

After Succesful build you will get this:

1>Sensum.vcxproj -> C:\Users\user\Desktop\Sensum-master\bin\Release\Sensum.dll
1>Done building project "Sensum.vcxproj".
========== Build: 1 succeeded, 0 failed, 0 up-to-date, 0 skipped ==========

Congrats! Sensum.dll builded!

FAQ

1. DirectX SDK Error while installation:
   1.1 S1023 Error Fix by Microsoft:

   To resolve this issue, you must uninstall all versions of the Visual C++ 2010 Redistributable before installing the June 2010 DirectX SDK. You may have one or more of the following products installed: Microsoft Visual C++ 2010 x86 Redistributable Microsoft Visual C++ 2010 x64 Redistributable You can use Add or Remove Programs in Control Panel to uninstall the products. Or, you can run the following commands from an administrator command prompt:

   MsiExec.exe /passive /X {F0C3E5D1-1ADE-321E-8167-68EF0DE699A5}
   
   MsiExec.exe /passive /X {1D8E6291-B0D5-35EC-8441-6616F567A0F7}

   After uninstalling the Microsoft Visual C++ 2010 Redistributable products, you may install the DirectX Software Development Kit, VC Redist 2015-2019 x86 and VC Redist 2015-2019 x64

2. Config Location for Sensum is in "__C:\Sensum\configs__"

3. To make skinchanger work, put skin_kits.json into "C:\Sensum"
   

How to Create Issue Correctly	Developer Board (ToDo,In Progress)	Feature Request