Grimes: Created page with "{{Mission Scripting |fName= mist.marker.add |vNum = Mist 4.5 |desc= Used to create mark panels and shapes on the F10 map. This is a master function that is capable of creat..."

2021-08-16T09:02:39Z

Created page with "{{Mission Scripting |fName= mist.marker.add |vNum = Mist 4.5 |desc= Used to create mark panels and shapes on the F10 map. This is a master function that is capable of creat..."

New page

{{Mission Scripting

|fName= mist.marker.add

|vNum = Mist 4.5

|desc= Used to create mark panels and shapes on the F10 map. This is a master function that is capable of creating marks, circles, lines, arrows, polygons, and quad shapes. Output and functionality depends on the input values as different shapes require different parameters.

|rtnType= table

|reqType1= table

|reqName1= vars

|reqType2=

|optType1=

|varExamples= {{varsTable

|r1T= table
|r1N= pos

|r2T=
|r2N=

|o1T= string/number
|o1N= name/id

|o2T= number/string
|o2N= markType

|o3T= number
|o3N= radius

|o4T= string
|o4N= text

|o5T= table
|o5N= markFor

|o6T= number/string
|o6N= markForCoa
|o7T= table
|o7N= color
|o8T= table
|o8N= fillColor
|o9T= number
|o9N= lineType
|o10T= boolean
|o10N= readOnly
|o11T= text
|o11N= message
|o12T= number
|o12N= fontSize

|r1D= vec3 or table of vec3 points indexed numerically to define the shapes.

|r2D=
|r4D=
|r5D=
|r6D=

|o1D= is used to identify the mark, can be used to replace marks already created.
|o2D= is an identifier for the type of mark or shape to be created.
0 ; panel : mark panel (the circles with text that can appear on the map
1 ; line : line drawn between two points
2 ; circle : circle of a given radius drawn at a point
3 ; rect : rectangle with the two points defining two opposite corners
4 ; arrow : arrow with the first point being where the arrow is pointing
5 ; text : text drawn on the map
6 ; quad : a 4 point polygon
7 ; freeform : a n point polygon. Do not recommend going over 50 points.

|o3D= is only relevant if a circle is passed. Radius of the circle to be drawn in meters

|o4D= is relevant to panels and text. Is a string of the text that is to be displayed
|o5D= accepts a string or a table of strings as keywords to define which groups will receive the message. This table can be use a variety of values to send the message to a very specific group of players. Acceptable values are in a table forma similar to the following:
<pre>{
units = {...}, -- unit names.
coa = {...}, -- coa names
countries = {...}, -- country names
CA = {...}, -- looks just like coa.
unitTypes = { red = {TYPENAME}, blue = {}, all = {}, Russia = {},}
}
</pre>
|o6D= is simplified entry more meant for the shapes because the shapes can only be displayed to all or a specific coalition
|o7D= is the color of the outline of a shape in {r, g, b, alpha} table format. Values can are between 0 to 1. However mist supports 0-255 format. If the number is greater than 1 mist will assume it is in 0-255 format. By default if color is not defined mist will generate a color automatically based on who is to see the mark. 80% Red or Blue.
|o8D= is the fill color for the shape. Same rules as stated above apply
|o9D= is the format the outline will be in. By default if not present the value used is 2.

{{DCS_enum_lineTypes}}

|o10D= is a boolean value for whether or not the mark or shapes can be deleted by users. At present only applies to mark panels. If not present defaults to true.
|o11D= is text that will be displayed when the mark is created
|o12D= is only relevant to the text shape. Defines how large of font will be used when displaying the text on the F10 map. If not present the default font size is 16.

}}

|rtnExamples=

|example=
The following draws a shape based on the route of a group placed in the mission editor.
local v = {}
v.pos = mist.getGroupPoints('poly')
v.mType = 'freeform'
mist.marker.add(v)

The following creates a 3000 meter radius circle around airbases belonging to the red coalition for the red team.
<pre>
local ab = coalition.getAirbases(1)
for i = 1, #ab do
local v = {}
v.pos = ab[i]:getPoint()
v.markFor = {coa = {'red'}}
v.radius = 3000
v.mType = 'circle'
mist.marker.add(v)
end
</pre>

The following would create a circle with a radius of 10km around the unit "update" and if called again it would delete the previous mark and create a new one.

local v = {}
v.pos = Unit.getByName('update'):getPoint()
v.id = 5
v.markForCoa = 2
v.mType = 2
v.radius = 10000
mist.marker.add(v)

|notes=
|funcs= {{listOfMistMarkerFuncs}}

}}
[[Category: MIST|marker add]]

MIST markerAdd - Revision history

Grimes: Created page with "{{Mission Scripting |fName= mist.marker.add |vNum = Mist 4.5 |desc= Used to create mark panels and shapes on the F10 map. This is a master function that is capable of creat..."