launch_decode(3)

💖 launch_decode(3) 💖

Okay bestie, this is launch_decode(3) from the Arcan Lua API, and it's literally here to launch a video decoding frameserver. No cap. 🎬✨

🎀 NAME 🎀

launch_decode — Launch a video decoding frameserver

🌈 SYNOPSIS 🌈

The synopsis starts with vid, aid sitting right up top, then gives you these call shapes:

vid, aid
launch_decode( string:resource, func:callback(vid:source, strtbl:status)
)
launch_decode( string:resource, string:opts, func:callback(vid:source,
strtbl:status) )
launch_decode( nil, string:opts, func:callback(vid:source,
strtbl:status) )

✨ DESCRIPTION ✨

So what's the vibe? It spawns a new decode frameserver process, with the input resource defined by resource. The callback function behaves similarly to that of launch_target — iykyk. 🫶

If opts is provided, it will be processed based on the capabilities of the decode frameserver. Wanna view those capabilities? Run it from a command-line, like this: ARCAN_ARG =help afsrv_decode.

🚨 Legacy alert, bestie: due to an unfortunate legacy, certain resource names are reserved for special purposes and are prefixed as device:, capture: and stream:. Those prefixes are reserved, periodt. 💅

🌸 EXAMPLE 🌸

function launch_decode0()
      vid = launch_decode("test.avi", function(source, status)
            print(status.kind);
      end);
      show_image(vid);
      resize_image(vid, VRESW, VRESH);
end

👀 SEE ALSO: 👀

• targetcontrol

---

xoxo, bestie 💖 — source/version: targetcontrol, date: October 2026, page: launch_decode(3) ✨🦋