static_scene:add_input(static_image) -- Note: Locks this input to images only.
static_scene:finalize()
--- Set some global state.
-Nageru.set_num_channels(4) -- Can only be called at the start of the program.
+-- Set some global state. Unless marked otherwise, these can only be set once,
+-- at the start of the program.
+Nageru.set_num_channels(4)
+
+-- Sets, for each channel, which signal it corresponds to (starting from 0).
+-- The information is used for whether right-click on the channel should bring up
+-- an input selector or not. Only call this for channels that actually correspond
+-- directly to a signal (ie., live inputs, not live (0) or preview (1)).
+Nageru.set_channel_signal(2, 0)
+Nageru.set_channel_signal(3, 1)
+
+-- Set whether a given channel supports setting white balance. (Default is false.)
+Nageru.set_supports_wb(2, true)
+Nageru.set_supports_wb(3, true)
+
+-- These can be set at any time.
Nageru.set_channel_name(SBS_SIGNAL_NUM + 2, "Side-by-side")
Nageru.set_channel_name(STATIC_SIGNAL_NUM + 2, "Static picture")
-function is_plain_signal(num)
- return num == INPUT0_SIGNAL_NUM or num == INPUT1_SIGNAL_NUM
-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
--- (one connected to a capture card, or a video input). The information is used for
--- whether right-click on the channel should bring up a context menu or not,
--- typically containing an input selector, resolution menu etc.
---
--- 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);
return "transparent"
end
+function is_plain_signal(num)
+ return num == INPUT0_SIGNAL_NUM or num == INPUT1_SIGNAL_NUM
+end
+
function channel_involved_in(channel, signal_num)
if is_plain_signal(signal_num) then
return channel == (signal_num + 2)
return false
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 is_plain_signal(channel - 2)
-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).
--
-- <signals> 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()
+-- frame. In particular, you can call get_frame_width() and get_frame_height()
-- for any signal number, and use that to e.g. assist in scene selection.
+-- (You can also use get_width() and get_height(), which return the
+-- _field_ size. This has half the height for interlaced signals.)
--
-- You should return scene to use, after having set any parameters you
-- want to set (through set_int() etc.). The parameters will be snapshot
local input_resolution = {}
for signal_num=0,1 do
local res = {
- width = signals:get_width(signal_num),
- height = signals:get_height(signal_num),
- interlaced = signals:get_interlaced(signal_num),
- is_connected = signals:get_is_connected(signal_num),
- has_signal = signals:get_has_signal(signal_num),
- frame_rate_nom = signals:get_frame_rate_nom(signal_num),
- frame_rate_den = signals:get_frame_rate_den(signal_num)
+ width = signals:get_frame_width(signal_num),
+ height = signals:get_frame_height(signal_num),
}
-
- if res.interlaced then
- -- Convert height from frame height to field height.
- -- (Needed for e.g. place_rectangle.)
- res.height = res.height * 2
-
- -- Show field rate instead of frame rate; really for cosmetics only
- -- (and actually contrary to EBU recommendations, although in line
- -- with typical user expectations).
- res.frame_rate_nom = res.frame_rate_nom * 2
- end
-
input_resolution[signal_num] = res
local text_res = signals:get_human_readable_resolution(signal_num)