-- The theme is what decides what's actually shown on screen, what kind of -- transitions are available (if any), and what kind of inputs there are, -- if any. In general, it drives the entire display logic by creating Movit -- chains, setting their parameters and then deciding which to show when. -- -- Themes are written in Lua, which reflects a simplified form of the Movit API -- where all the low-level details (such as texture formats) are handled by the -- C++ side and you generally just build chains. -- -- This is a much simpler theme than the default theme; it only allows you to -- switch between inputs and set white balance, no transitions or the likes. -- Thus, it should be simpler to understand. local input_neutral_color = {{0.5, 0.5, 0.5}, {0.5, 0.5, 0.5}} local live_signal_num = 0 local preview_signal_num = 1 -- A chain to show a single input, with white balance. In a real example, -- we'd probably want to support deinterlacing and high-quality scaling -- (if the input isn't exactly what we want). However, we don't want these -- things always on, so we'd need to generate more chains for the various -- cases. In such a simple example, just having two is fine. function make_simple_chain(hq) local chain = EffectChain.new(16, 9) local input = chain:add_live_input(false, false) -- No deinterlacing, no bounce override. input:connect_signal(0) -- First input card. Can be changed whenever you want. local wb_effect = chain:add_effect(WhiteBalanceEffect.new()) chain:finalize(hq) return { chain = chain, input = input, wb_effect = wb_effect, } end -- We only make two chains; one for the live view and one for the previews. -- (Since they have different outputs, you cannot mix and match them.) local simple_hq_chain = make_simple_chain(true) local simple_lq_chain = make_simple_chain(false) -- API ENTRY POINT -- Returns the number of outputs in addition to the live (0) and preview (1). -- Called only once, at the start of the program. function num_channels() return 2 end -- API ENTRY POINT -- Returns the name for each additional channel (starting from 2). -- Called at the start of the program, and then each frame for live -- channels in case they change resolution. function channel_name(channel) if channel == 2 then return "First input" elseif channel == 3 then return "Second input" end end -- API ENTRY POINT -- Returns, given a channel number, which signal it corresponds to (starting from 0). -- Should return -1 if the channel does not correspond to a simple signal. -- (The information is used for whether right-click on the channel should bring up -- an input selector or not.) -- Called once for each channel, at the start of the program. -- Will never be called for live (0) or preview (1). function channel_signal(channel) if channel == 2 then return 0 elseif channel == 3 then return 1 else return -1 end end -- API ENTRY POINT -- Called every frame. Returns the color (if any) to paint around the given -- channel. Returns a CSS color (typically to mark live and preview signals); -- "transparent" is allowed. -- Will never be called for live (0) or preview (1). function channel_color(channel) return "transparent" end -- API ENTRY POINT -- Returns if a given channel supports setting white balance (starting from 2). -- Called only once for each channel, at the start of the program. function supports_set_wb(channel) return channel == 2 or channel == 3 end -- API ENTRY POINT -- Gets called with a new gray point when the white balance is changing. -- The color is in linear light (not sRGB gamma). function set_wb(channel, red, green, blue) if channel == 2 then input_neutral_color[1] = { red, green, blue } elseif channel == 3 then input_neutral_color[2] = { red, green, blue } end end -- API ENTRY POINT -- Called every frame. function get_transitions(t) if live_signal_num == preview_signal_num then -- No transitions possible. return {} else return {"Cut"} end end -- API ENTRY POINT -- Called when the user clicks a transition button. For our case, -- we only do cuts, so we ignore the parameters; just switch live and preview. function transition_clicked(num, t) local temp = live_signal_num live_signal_num = preview_signal_num preview_signal_num = temp end -- API ENTRY POINT function channel_clicked(num) preview_signal_num = num end -- API ENTRY POINT -- Called every frame. Get the chain for displaying at input , -- where 0 is live, 1 is preview, 2 is the first channel to display -- in the bottom bar, and so on up to num_channels()+1. t is the -- current time in seconds. width and height are the dimensions of -- the output, although you can ignore them if you don't need them -- (they're useful if you want to e.g. know what to resample by). -- -- is basically an exposed InputState, which you can use to -- query for information about the signals at the point of the current -- frame. In particular, you can call get_width() and get_height() -- for any signal number, and use that to e.g. assist in chain selection. -- -- You should return two objects; the chain itself, and then a -- function (taking no parameters) that is run just before rendering. -- The function needs to call connect_signal on any inputs, so that -- it gets updated video data for the given frame. (You are allowed -- to switch which input your input is getting from between frames, -- but not calling connect_signal results in undefined behavior.) -- If you want to change any parameters in the chain, this is also -- the right place. -- -- NOTE: The chain returned must be finalized with the Y'CbCr flag -- if and only if num==0. function get_chain(num, t, width, height, signals) local chain, signal_num if num == 0 then -- Live (right pane). chain = simple_hq_chain signal_num = live_signal_num elseif num == 1 then -- Preview (left pane). chain = simple_lq_chain signal_num = preview_signal_num else -- One of the two previews (bottom panes). chain = simple_lq_chain signal_num = num - 2 end -- Make a copy of the current neutral color before returning, so that the -- returned prepare function is unaffected by state changes made by the UI -- before it is rendered. local color = input_neutral_color[signal_num + 1] local prepare = function() chain.input:connect_signal(signal_num) chain.wb_effect:set_vec3("neutral_color", color[1], color[2], color[3]) end return chain.chain, prepare end