LookingGlass/c-host
2019-06-19 09:13:03 +10:00
..
cmake [c-host] added initial nvfbc support 2019-04-10 13:07:42 +10:00
include/interface [c-host] initial agnostic option api and parser 2019-05-09 22:06:58 +10:00
platform [c-host] not all versions of mingw support wcstombs_s 2019-06-12 15:31:18 +10:00
src [c-host] dxgi: fix invalid cursor type define 2019-05-28 15:17:11 +10:00
.gitignore [c-host] restructure project to use cmake 2019-04-09 16:28:11 +10:00
CMakeLists.txt [all] allow disable of backtrace support during build 2019-06-19 09:13:03 +10:00
README.md [c-host] correct NvFBC information in the README.md 2019-05-23 14:31:05 +10:00
toolchain-mingw64.cmake [c-host] fixed project for cross compliation for Win on Linux 2019-05-22 14:59:19 +10:00

General Questions

What is this?

This is a rewrite of the host application in pure C using the MinGW toolchain.

Why make this?

Several reasons:

  1. The client is written in C and I would like to unify the project's language
  2. The host is currently hard to build using MinGW and is very Windows specific
  3. The host is a jumbled mess of code from all the experimentation going on
  4. I would eventually like to be able to port this to run on Linux guests

When will it be ready?

Soon :)

Will it replace the C++ host?

Yes, but only when it is feature complete.

Why doesn't this use CMake?

It does now... Because win-builds doesn't distribute it, so to make it easy for everyone to compile we do not require it.

How do I build it?

For Windows on Windows

mkdir build
cd build
cmake -G "MSYS Makefiles" ..
make

For Linux on Linux

mkdir build
cd build
cmake ..
make

For Windows cross compiling on Linux

mkdir build
cd build
cmake -DCMAKE_TOOLCHAIN_FILE=../toolchain-mingw64.cmake ..
make

Where is the log?

It is in your user's temp directory:

%TEMP%\looking-glass-host.txt

For example:

C:\Users\YourUser\AppData\Local\Temp\looking-glass-host.txt

You can also open it by simply right clicking the tray icon and selecting "Open Log File"

Why does this version require Administrator privileges

This is intentional for several reasons.

  1. NvFBC requires a system wide hook to correctly obtain the cursor position as NVIDIA decided to not provide this as part of the cursor updates.
  2. NvFBC requires administrator level access to enable the interface in the first place. (WIP)
  3. DXGI performance can be improved if we have this. (WIP)

NvFBC (NVIDIA Frame Buffer Capture)

Why isn't there a build with NvFBC support available.

Because NVIDIA have decided to put restrictions on the NvFBC API that simply make it incompatible with the GPL/2 licence. Providing a pre-built binary with NvFBC support would violate the EULA I have agreed to in order to access the NVidia Capture SDK.

Either I miss-read the License Agreement or it has been updated, it is now viable to produce a "derived work" from the capture SDK.

1.1 License Grant. Subject to the terms of this Agreement, NVIDIA hereby grants you a nonexclusive, non-transferable, worldwide, revocable, limited, royalty-free, fully paid-up license during the term of this Agreement to: (i) install, use and reproduce the Licensed Software delivered by NVIDIA plus make modifications and create derivative works of the source code and header files delivered by NVIDIA, provided that the software is executed only in hardware products as specified by NVIDIA in the accompanying documentation (such as release notes) as supported, to develop, test and service your products (each, a “Customer Product”) that are interoperable with supported hardware products. If the NVIDIA documentation is silent, the supported hardware consists of certain NVIDIA GPUs; and

To be safe we are still not including the NVIDIA headers in the repository, but I am now providing pre-built binaries with NvFBC support included.

See: https://looking-glass.hostfission.com/downloads

Why can't I compile NvFBC support into the host

You must download and install the NVidia Capture SDK. Please note that by doing so you will be agreeing to NVIDIA's SDK License agreement.

-Geoff