Function to find zones in a branch. For example,
this.parent uses the parent layer of the script module as branch. If recursive is set to
true, subbranches will also be searched. The function returns an array with the element objects of the found zones. Particular zones can be searched by name or through a filter function. If searching by name, findZones accepts only the element objects that match the specified name. The filter function uses the element object of each zone as argument. Only those element objects that return
true for the search criteria defined in the filter function will be accepted by findZones. Without a name or filter function the element objects of all zones in the searched branches will be returned.
Available in: Controller, Processor.
|recursive||If set to ||boolean|
|nameOrFilterFunction||The name of the zones searched for or a filter function. Only the element objects that match the name or return ||string or function, optional|
Returns an array with the element objects of the found zones.
-- find all zones and print their names zones = this.program:findZones(true) if zones then for i, zone in ipairs(zones) do print(zone.name) end else print("Could not find any zones!") end