WC3 JASS.com
"The Jass Vault" plus vJASS and Zinc

Introduction

---

Before I start, I would just like to credit Moyack for patience with testing and pointing out certain flaws, especially with how the code is presented.

Description

---

I have created a function, that can group units in line with; a distance-value that is unchanged no matter where the end-point may be, a radius-value, a optional spread-value (determined in radians, easiest way to get the spread-angle you want is to create a constant with the spreadangle * bj_DEGTORAD) and an optional boolean exp-filter.

Requirements

---

 - vJass


Actual Code

---

What it does: it takes a group to fill (a group already existing), 4 coordinates (startx, starty, endx, endy), a real value distance (how far will this line go from the start-coordinates. It could reach and go further than the end-point or it could not get that far at all), a real angle expressed in radians that tells if and how much the line should change as it goes further (0.262 would give a 15~deg spread in angle, 0 will give a straight line) and a boolexpr "bex", this to actually lessen the cpu-usage in some cases, as the more units getting filtered away with the boolexpr, the less units it has to calculate for (just set this for null if you want it to take all units in the line)

How to import: Easiest way; download the testmap, open it with the NGJP-world editor, find the trigger named LineGroup and copy it, and paste it in your map. Alt. copy all text inside the LineGroup-trig and paste it in an empty text-trigger.

How to use:
Create a group with locals or use a group from an global variable, then call LineGroup with the group as the first value, and the rest with the values in the order told at a number of places in this text.


Sample Code

---

And a little extra, the code won't empty the group itself, so you could make some special stuff, like fan-shapes and stuff (this might require some further math, if someone is interested, I could show how.)

If you find any trouble with this, know a way to improve it or just have a question, just ask in this thread or PM me.
(the map have a non-other-than-me-user-friendly version of the TickTack, or ChainTimer as I have comed to call it. Dont mind that.. )

Allright, thanks! (:
However, isn't library a vJass-function?

It was a pretty good idea of you to allow the user to pass in his own group.
This makes memory management easier because he'd see the CreateGroup() and the respective DestroyGroup(g) in his own code.

The group doesn't need to be constant though.
If it's constant, the name should be GR :p

Either way, approved.