Add 3D and map plotting tools

[Timi007]

When merged this pull request will:

• Add 3D and map plotting tools

This feature is meant to help the user measure distances and directions. The start and end positions can be either static or attached to an object, where the values are then updated dynamically. The user can toggle between different distance, speed, and azimuth formats. More formatters can be defined in class zen_plotting_formatters. The color can be changed in the CBA settings. Plotting is possible in 3D or on the map.

arma_plotting.mp4

TODO

• Fix line connections of rectangular cuboid
• Fix attaching plot to objects
• Optimize drawing (do not draw if outside screen) The overhead of checking if the positions are in view is too high ~2x perf decrease
• Add icons
• Handle text rendering when attaching multiple plots to objects Limited to one end point for a unit at a time
• Fix key handlers not always register input
• Add the time it takes to travel the distance depending on a speed

[mharis001]

Interesting functionality. Just some initial thoughts.

[Timi007]

Thanks for the initial feedback! Can you maybe provide feedback on following question too?

1. Currently, the max distance the lines and icons are rendered is hardcoded to 3km. Should this be a setting or maybe linked to the view distance?
2. What measurements units should be present? As a user of the metric system, do we need feet, yards, and miles?
3. For the line plot, I also want to add the time it takes to travel the distance depending on a speed. Should this speed be also a toggle like distance and azimuth formats? Or a setting? Or toggle + setting?
4. When attaching a plot point to an object, the formatted texts overlap. In 3D, we can solve this using the text Y offset. On the map there is no parameter. Should only the text of the last plot be shown? Or do we just restrict attaching one plot to one object?

[mharis001]

1. I think just a reasonable max value is fine. For example, the visibility component uses a max of 5 km.
2. You could combine it to "systems" instead of "units". So, metric: meters -> kilometers depending on distance, and imperial: feet -> yards -> miles. Not sure.
3. Probably just a toggle.
4. Even with multiple plots with offset text, it would be difficult to tell which one belongs to which plot. Again, not sure what the best UX here is.

[mharis001]

Should this be the relative direction?

[Timi007]

This is the direction from start to end pos and end to start. Both _startPos and _endPos are PosASL. I don't understand the relative part in your question.

[mharis001]

IIRC, when attached to objects the direction value being displayed did not seem intuitive. If that makes sense.

[Timi007]

Need to check what you mean. It should show the same value as the unit just opening their compass.

[mharis001]

I guess it just comes to whether we want to know that the position is 90 degrees relative to the vehicle or just the difference in their bearings. The former what what I assumed the value was.

[Timi007]

What purpose does relative bearing w.r.t. the attached unit have to the Zeus or any unit on the ground? I understand if you want the direction as a relative clock, but I have never given or received relative bearing. For artillery corrections, you also don't use relative directions.

[Timi007]

Should we only allow attaching one plot at a time for now? I honestly don't have a better solution.

[Timi007]

Push

[BrettMayson]

Doing Alt + R didn't change the speed format when I tested

[Timi007]

Doing Alt + R didn't change the speed format when I tested

Currently, I only implemented km/h as speed format. The toggle switch is there if anyone wants to add a custom speed format. I don't know if it makes sense to add mph or knots as speed formats?

[BrettMayson]

I thought I had seen MPH, but I was mistaken, so makes sense for just KM/H