aboutsummaryrefslogtreecommitdiffstats
path: root/README.md
diff options
context:
space:
mode:
authors-ol <s+removethis@s-ol.nu>2025-03-21 12:25:10 +0000
committers-ol <s+removethis@s-ol.nu>2025-03-21 12:37:22 +0000
commit8987c88bba84125e358319c2d4085f958401ff11 (patch)
treeda54035fb9e2ef25c92660a7ea886c2d7275d421 /README.md
parentas lib (diff)
downloadlua-texture-share-vk-8987c88bba84125e358319c2d4085f958401ff11.tar.gz
lua-texture-share-vk-8987c88bba84125e358319c2d4085f958401ff11.zip
package for luarocks
Diffstat (limited to 'README.md')
-rw-r--r--README.md14
1 files changed, 14 insertions, 0 deletions
diff --git a/README.md b/README.md
new file mode 100644
index 0000000..c234d19
--- /dev/null
+++ b/README.md
@@ -0,0 +1,14 @@
+# lua texture-share-vk
+
+A LÖVE library for sharing GPU textures between processes.
+
+This wraps the OpenGL C API of [texture-share-vk](https://github.com/DigitOtter/texture-share-vk) and allows publishing a LÖVE Canvas object.
+
+## API
+
+- `tvs.new()`: creates a new `Client` object (`texture-share-gl` client).
+- `Client:newSharedCanvas(name, ...)`: creates a new `SharedCanvas` object by delegating to [`love.graphics.newCanvas(...)`](https://love2d.org/wiki/love.graphics.newCanvas) and publishes it.
+- `Canvas.name`: the name passed in the SharedCanvas constructor
+- `Canvas.canvas`: the love2d `Canvas` object
+- `Canvas:send()`: Sends the current contents of the Canvas to subscribers, call this after drawing to the Canvas.
+- `Canvas:any_other_method()`: delegated to the love2d `Canvas` object