Skip to content

Commit

Permalink
Cleaned up README
Browse files Browse the repository at this point in the history
  • Loading branch information
Benjamin Glatzel committed May 27, 2017
1 parent 082d148 commit 762d808
Show file tree
Hide file tree
Showing 2 changed files with 90 additions and 89 deletions.
89 changes: 89 additions & 0 deletions GETTING_STARTED.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,89 @@
# Getting Started

## Windows

### Prerequisites

* Visual Studio 2015 or 2017
* CMake >= 3.2
* Qt >= 5.7 (>= 5.9 needed for Visual Studio 2017)
* Vulkan SDK >= 1.0.49.0
* PhysX 3.3
* FBX SDK 2015.1

### Setup Instructions

1. Download and install the Qt (open-source) distribution
2. Create a new environment variable `INTR_QTDIR` pointing to `...\QtX.X\X.X\msvc2015_64` or `...\QtX.X\X.X\msvc2017_64`

3. Download an install the Vulkan SDK

4. Get access to the latest PhysX SDK from NVIDIA: https://developer.nvidia.com/physx-sdk
5. Follow the instructions from NVIDIA and compile the PhysX libraries for the configurations *Release*, *Profile* and *Debug*

**NOTE:** Make sure that PhysX links the Runtime Library dynamically as Intrinsic does!

6. Download and install the Autodesk FBX SDK

7. Create a new directory called `Intrinsic_Dependencies` on the _same level_ as the Intrinsic repository folder
8. Inside, create a new folder `dependencies` containing two folders `physx` and `fbx`
9. Copy the static/dynamic libraries and header files of both SDKs to folders named `bin` (DLLs), `lib` (LIBs) and `include` respectively

10. Go to the `scripts_win32` folder in the Intrinsic repository dir
11. Execute `ConfigAndBuildDependencies.bat` or `ConfigAndBuildDependenciesVS15.bat` to build some of the remaining dependencies automatically
12. Execute `CopyDllsToAppDir_Debug.bat` and `CopyDllsToAppDir_Release.bat`
13. Execute `Config.bat` or `ConfigVS15` to create a Visual Studio 2015/2017 solution file and all project configurations
14. If everything went well, you'll find the solution in the newly created `build` folder

**NOTE:** You can also use one of the many build scripts: `Build_Release.bat`, ... to get started

15. Execute `Intrinsic.exe` or `IntrinsicEd.exe` in the `app` directory

16. You're all set - yey!

## Linux (tested with Ubuntu 16.10)

### Prerequisites

```
sudo apt install git cmake ninja-build libsdl2-dev
```

### Setup Instructions

1. Download and install the Qt (open-source) distribution

Add environment variables to your .zshrc or .bashrc:
```
# Intrinsic
export INTR_QTDIR="[...]/Qt/x.x/gcc_64"
```

2. Download and install the Vulkan SDK

Add environment variables to your .zshrc or .bashrc:
```
# Vulkan SDK
VULKAN_SDK=~/[...]/VulkanSDK/1.0.30.0/x86_64
VK_LAYER_PATH=$VULKAN_SDK/etc/explicit_layer.d
export VK_LAYER_PATH
export PATH=$VULKAN_SDK/bin:$PATH
```
3. Get access to the latest PhysX SDK
After cloning of the git repository apply patches from https://github.com/NVIDIAGameWorks/PhysX-3.3/pull/57
```
cd .../PhysX-3.3/PhysXSDK/Source/compiler/linux64
make release profile debug
```
Add environment variables to your .zshrc or .bashrc:
```
export PHYSX_HOME="$HOME/[...]/PhysX-3.3/PhysXSDK/"
```
4. Download and install Autodesk FBX SDK
5. Go to the `scripts_linux` folder in the Intrinsic repository dir
6. Execute following scripts: `ConfigAndBuildDependencies`, `Config_Release`, `Build` and last but not least `Run_Release`
7. You're all set - yey!
90 changes: 1 addition & 89 deletions README.md
Original file line number Diff line number Diff line change
Expand Up @@ -6,95 +6,7 @@ Intrinsic is a Vulkan based cross-platform game and rendering engine. The projec

![Intrinsic](media/screenshot_0.jpg)

# Getting Started

## Windows

### Prerequisites

* Visual Studio 2015 or 2017
* CMake >= 3.2
* Qt >= 5.7 (>= 5.9 needed for Visual Studio 2017)
* Vulkan SDK >= 1.0.49.0
* PhysX 3.3
* FBX SDK 2015.1

### Setup Instructions

1. Download and install the Qt (open-source) distribution
2. Create a new environment variable `INTR_QTDIR` pointing to `...\QtX.X\X.X\msvc2015_64` or `...\QtX.X\X.X\msvc2017_64`

3. Download an install the Vulkan SDK

4. Get access to the latest PhysX SDK from NVIDIA: https://developer.nvidia.com/physx-sdk
5. Follow the instructions from NVIDIA and compile the PhysX libraries for the configurations *Release*, *Profile* and *Debug*

**NOTE:** Make sure that PhysX links the Runtime Library dynamically as Intrinsic does!

6. Download and install the Autodesk FBX SDK

7. Create a new directory called `Intrinsic_Dependencies` on the _same level_ as the Intrinsic repository folder
8. Inside, create a new folder `dependencies` containing two folders `physx` and `fbx`
9. Copy the static/dynamic libraries and header files of both SDKs to folders named `bin` (DLLs), `lib` (LIBs) and `include` respectively

10. Go to the `scripts_win32` folder in the Intrinsic repository dir
11. Execute `ConfigAndBuildDependencies.bat` or `ConfigAndBuildDependenciesVS15.bat` to build some of the remaining dependencies automatically
12. Execute `CopyDllsToAppDir_Debug.bat` and `CopyDllsToAppDir_Release.bat`
13. Execute `Config.bat` or `ConfigVS15` to create a Visual Studio 2015/2017 solution file and all project configurations
14. If everything went well, you'll find the solution in the newly created `build` folder

**NOTE:** You can also use one of the many build scripts: `Build_Release.bat`, ... to get started

15. Execute `Intrinsic.exe` or `IntrinsicEd.exe` in the `app` directory

16. You're all set - yey!

## Linux (tested with Ubuntu 16.10)

### Prerequisites

```
sudo apt install git cmake ninja-build libsdl2-dev
```

### Setup Instructions

1. Download and install the Qt (open-source) distribution

Add environment variables to your .zshrc or .bashrc:
```
# Intrinsic
export INTR_QTDIR="[...]/Qt/x.x/gcc_64"
```

2. Download and install the Vulkan SDK

Add environment variables to your .zshrc or .bashrc:
```
# Vulkan SDK
VULKAN_SDK=~/[...]/VulkanSDK/1.0.30.0/x86_64
VK_LAYER_PATH=$VULKAN_SDK/etc/explicit_layer.d
export VK_LAYER_PATH
export PATH=$VULKAN_SDK/bin:$PATH
```
3. Get access to the latest PhysX SDK
After cloning of the git repository apply patches from https://github.com/NVIDIAGameWorks/PhysX-3.3/pull/57
```
cd .../PhysX-3.3/PhysXSDK/Source/compiler/linux64
make release profile debug
```
Add environment variables to your .zshrc or .bashrc:
```
export PHYSX_HOME="$HOME/[...]/PhysX-3.3/PhysXSDK/"
```
4. Download and install Autodesk FBX SDK
5. Go to the `scripts_linux` folder in the Intrinsic repository dir
6. Execute following scripts: `ConfigAndBuildDependencies`, `Config_Release`, `Build` and last but not least `Run_Release`
7. You're all set - yey!
You can find some simple build and setup instructions in `GETTING_STARTED.md`.

# Screenshots

Expand Down

0 comments on commit 762d808

Please sign in to comment.