~~NOTOC~~
<=[[4rpl:start| Index]] \\
<=[[4rpl:start#beams| Beams]]

====== DestroyAllAttachedBeams ======
DestroyAllAttachedBeams(<-unitUID)

===== Description =====
Destroys all beams attached to a unit. Destruction permanently removes the beam. Note that beams that are attached to units are automatically destroyed when the unit is destroyed.

===== Examples =====
<code 4rpl>
once
   GetUnitPosition(self) ->unitPos
   #Fire a beam to extends off screen but is at the same height as the unit
   #We will attach the beam to ourselves, so that the start point is relative to our unit
   3 ->brightness
   4 ->width
   CreateBeam("orange" <-brightness <-width) ->beam
   AttachBeam(<-beam self "")
   SetBeamStart(<-beam V3(0 0 0))
   SetBeamEnd(<-beam V3(10000 0 10000))
endonce

if (GetUnitUpdateCount eq (900))
   DestroyAllAttachedBeams(self)
endif

</code>
<=[[4rpl:start| Index]]