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

====== DestroyBeam ======
DestroyBeam(<-beamUID)

===== Description =====
Destroys a beam. Destruction permanently removes the beam. Note that beams that are attached to units are automatically destroyed when the unit is destroyed.
Beams that are not attached to units must be manually destroyed to remove them.

===== 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))
   DestroyBeam(<-beam)
endif

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