love-thread
When to use this skill
Allows you to work with threads. Threads are separate Lua environments, running in parallel to the main code. As their code runs separately, they can be used to compute complex operations without adversely affecting the frame rate of the main thread. However, as they are separate environments, they cannot access the variables and functions of the main thread, and communication between threads is limited. All LOVE objects (userdata) are shared among threads so you'll only have to send their references across threads. You may run into concurrency issues if you manipulate an object on multiple threads at the same time. When a Thread is started, it only loads the love.thread module. Every other module has to be loaded with require. Use this skill when working with multi-threading, parallel processing, background tasks, or any thread-related operations in LÖVE games.
Common use cases
- Running CPU-intensive operations in background threads
- Implementing parallel processing for performance
- Handling long-running tasks without blocking the main game loop
- Managing inter-thread communication and synchronization
- Loading resources asynchronously
Functions
love.thread.getChannel(name: string) -> channel: Channel: Creates or retrieves a named thread channel.love.thread.newChannel() -> channel: Channel: Create a new unnamed thread channel. One use for them is to pass new unnamed channels to other threads via Channel:push on a named channel.love.thread.newThread- Creates a new Thread from a filename, string or FileData object containing Lua code.love.thread.newThread(filename: string) -> thread: Thread: No descriptionlove.thread.newThread(fileData: FileData) -> thread: Thread: No descriptionlove.thread.newThread(codestring: string) -> thread: Thread: No description