LuaScript
The Lua script that returns the rectangle(s).
Specify one of the following:
- the absolute path to the Lua script file. To strengthen security, Media Server can be configured to read files only from specified directories. For information about the directories that Media Server is permitted to read from, see the parameter AllowedInputDirectories.
- the path to the Lua script file, relative to the LuaDirectory.
- a string that matches one of your
AdditionalDataLabels
, (if you use theAdditionalData
andAdditionalDataLabels
action parameters to upload the Lua script file as part of the Process action).
The Lua script must define a function named rectangle
. The function takes a single argument, an input record, and must return either nil
(to output nothing), a single rectangle (to produce one record corresponding to the input record), or an array of rectangles (to produce multiple records corresponding to the input record).
The following is an example Lua script that you could use to take a region that exists in the input records and add a new region that is 50 pixels further left and 50 pixels higher in the image:
function rectangle(r) return { left=r.RegionData.left - 50, top=r.RegionData.top - 50, width=r.RegionData.width, height=r.RegionData.height } end
The following example returns an array of rectangles:
function rectangle(r) return { { left=r.RegionData.left - 50, top=r.RegionData.top - 50, width=r.RegionData.width, height=r.RegionData.height }, { left=r.RegionData.left + 50, top=r.RegionData.top + 50, width=r.RegionData.width, height=r.RegionData.height } } end
If your Lua function returns nil
, the task does not output any records for that input record.
Type: | String |
Default: | |
Required: | Yes |
Configuration Section: | TaskName |
Example: | LuaScript=rectangle.lua
|
See Also: |