Tools.BuildNewMarkerPointTable
| Environment: | Mission Scripting | |
|---|---|---|
| Function: | tools.BuildNewMarkerPointTable | |
| Function Description: | Creates a table of marker points from a specified group, with options to define position mode and skip the first waypoint. The function uses internal waypoint processing to derive positions either as world coordinates, relative to the first unit, or via heading and distance. Returns a table of waypoints or nil if invalid input. | |
| File Location: | cmm.tools.lua | |
| Syntax: | CMM.tools.BuildNewMarkerPointTable( string GroupName , number Mode , boolean SkipFirst ) | |
| Return Value: | table or nil | |
| Parameters: | Name | Description |
| GroupName | Name of the group in the mission editor containing waypoints to extract. Must be valid and defined in the mission. | |
| Mode | Mode for position derivation: 0 = world positions, 1 = relative to first unit (default), 2 = heading and distance from first unit. Defaults to 1 if not specified. | |
| SkipFirst | If true, the first waypoint in the group is skipped. Defaults to false. | |
| Example: | CMM.tools.BuildNewMarkerPointTable("DebrisArea",1,false) | |
| Example Description: | Generates a table of waypoints from the group "DebrisArea" using relative positioning to the first unit, without skipping the first point. | |
| Related Functions: | ||
| Notes: | ||