@@ -16,17 +16,25 @@ This plugin implements an OBS filter which continuously sends the frame number o
4. launch cmake-gui
- set the source to the root of this repository
- set the build to the build directory
- you'll have to set these CMake variables (bold ones need to be set explicitly, the others are usually found automatically):
-**LIBOBS_DIR** (path) : location of the libobs subfolder in the build of OBS studio
-**OBS_FRONTEND_LIB** (filepath) : location of the obs-frontend-api.lib file
- LSL\_DIR (path) : location of liblsl share/LSL directory
- you'll have to set these CMake entries (the ones in bold must be entered manually, the others will show up when you press "configure" although you may need to do so after each time the configuration progresses)
-**LSL\_INSTALL\_ROOT** (path) : location of liblsl directory
- FREETYPE\_INCLUDE\_DIR (path) : in the <obsdependencies>/win64/include/freetype/ (the ones retrieved to build OBS studio)
- FREETYPE\_INCLUDE_DIR\_ft2build (path) : in the <obsdependencies>/win64/include/ (the ones retrieved to build OBS studio)
- FREETYPE\_LIBRARY\_RELEASE (filepath) : in the <obsdependencies>/win64/bin/freetype.lib (the ones retrieved to build OBS studio)
- LIBOBS\_DIR (path) : location of the libobs subfolder in the build folder of OBS studio source
-**LIBOBS\_INCLUDE\_DIR**: location of the libobs subfolder in root of OBS studio source
- OBS\_FRONTEND\_LIBRARY (filepath) : location of the obs-frontend-api.lib file
-**OBS\_PLUGIN\_DIR**: location where to install the plugin (should be C:/ProgramFiles/obs-studio/plugins/64bit/ )
5. configure, and if everything is okay then generate the build files
6. use the build tool you selected in cmake-gui to compile the code
KNOWN ISSUES: visual studio error LNK1181 cannot open some .lib files (obs-frontend-api.lib and freetype.lib). Problem is that the paths to these libraries are not well defined for visual studio after cmake-gui configuration (probably can be fixed in the cmakelists.txt file in the future).
Temporary solution: In visual studio go to the project properties -> Linker -> Input and edit the "Additional Dependencies" such that the two offending libraries have the full path.
#### installation
1. copy the `lsl_plugin.dll` to the appropriate folder in `<obs-studio-install-dir>/obs-plugins/`
2. copy `liblsl32/64.dll` to the same directory
3. also copy the contents of the `obsplugin/data/` directory to the `bin` directory of obs-studio (where the obs-studio.exe is located)
copy `lsl-obs-plugin.dll`, `data/Roboto-Black.tff`, `data/text-default.effect``liblsl64.dll` to the `OBS_PLUGIN_DIR`
cmake -DLIBOBS_INCLUDE_DIR="<path to the libobs sub-folder in obs-studio's source code>" -DCMAKE_INSTALL_PREFIX=/usr ..
cmake -DLIBOBS_INCLUDE_DIR="<path to the libobs sub-folder in obs-studio's source code>" -DOBS_PLUGIN_DIR="<plugin installation path>" -DCMAKE_INSTALL_PREFIX=/usr ..
make -j4
sudo make install
```
normally, `OBS_PLUGIN_DIR` in linux should be `/usr/lib/obs-plugins/`
#### installation
1. Copy the `lsl_plugin.so` to /usr/lib/obs-plugins/
2. also copy the contents of the `obsplugin/data/` directory to the `bin` directory of obs-studio (where the obs-studio executable is located)
```
sudo make install
```
## Using the plugin
This plugin implements a source in obs. To use, add the LSL plugin source and adjust settings as desired.