https://github.com/frabert/ogler

Use GLSL shaders in REAPER
https://github.com/frabert/ogler

cpp reaper reaper-plugin vulkan

Last synced: 2 months ago
JSON representation

Use GLSL shaders in REAPER

• Host: GitHub
• URL: https://github.com/frabert/ogler
• Owner: frabert
• License: gpl-3.0
• Created: 2023-04-20T19:44:18.000Z (over 1 year ago)
• Default Branch: main
• Last Pushed: 2023-11-23T13:10:54.000Z (about 1 year ago)
• Last Synced: 2024-08-02T20:44:29.448Z (5 months ago)
• Topics: cpp, reaper, reaper-plugin, vulkan
• Language: C++
• Homepage:
• Size: 324 KB
• Stars: 8
• Watchers: 3
• Forks: 1
• Open Issues: 4
• Metadata Files:
  • Readme: README.md
  • License: LICENSE

Awesome Lists containing this project

• awesome-reaper - ogler - VST plugin for writing video processing effects using GLSL shaders in Reaper. [Forum thread](https://forums.cockos.com/showthread.php?t=278451). (Video Editing)

README

        
# Ogler

Ogler is a CLAP plugin for REAPER that allows writing video (and audio?) effects using GLSL, similar to what happens in ShaderToy.

## How do I write shaders?

If you have previous experience with writing ShaderToys or shaders in general, see the [Reference Manual](/docs/Reference.md).

If you need an introduction to shaders, see the [Tutorial](/docs/Tutorial.md).

## Compiling

You will need LunarG's Vulkan SDK and re2c installed and reachable by CMake. Both can be installed using Chocolatey, but any other method will work as long you take care to update the relevant environment variables:

    choco install vulkan-sdk re2c

### Obtaining Sciter

Ogler uses [Sciter](https://sciter.com/) for its GUI. Sciter is not free (as in freedom) software, but a free (as in beer) version is available with the caveat that it's only available as a binary, dynamically linked library.

If you compile ogler using this dynamically linked version of Sciter, you will need to put `sciter.dll` beside REAPER's binary in order to use ogler.

### Using vcpkg

Vcpkg is the only officially supported way of compiling ogler.

    git clone https://github.com/frabert/ogler

    cmake --toolchain $PATH_TO_VCPKG/scripts/buildsystems/vcpkg.cmake -DVCPKG_TARGET_TRIPLET=x64-windows-dynamic-sciter -S ogler -B build-ogler

    cmake --build build-ogler

## System requirements

You'll need modern graphics drivers.

And by modern I mean they need to support Vulkan 1.0, so not _that_ modern, but still.

## Licensing

Ogler is released under the terms of the GPLv3 license. A special exception is made for linking against Sciter: you are allowed to freely distribute copies of ogler's source code and binary artifacts without having to also distribute Sciter's source code, whether you linked ogler against Sciter statically or dynamically.