Adds various controls for customising the Sonic Beam weapon effect.

[CCHyper]

Closes #540, Closes #547

This pull request adds various controls for customising the Sonic Beam weapon effect. It also implements a possible fix for the common "WaveClass" crashes see on older hardware (see issue #540).

Special thanks to @askhati and @MortonPL for assistance with the math calculations, and @tomsons26 with the drawing code.

SonicBeamColor=<r,g,b>
Color of the sonic beam, in 24-bit RGB. This color entry is used to enable the new drawing system, so you may need to experiment with the options below to get the desired drawing effect.

SonicBeamIsClear=<boolean>
Is the sonic beam clear (no color)? Defaults to false.

SonicBeamAlpha=<float>
The alpha blending of the sonic beam. Defaults to 0.5.

SonicBeamSineDuration=<float>
The duration of one wave effect pattern cycle. Defaults to 0.125.

SonicBeamSineAmplitude=<float>
The amplitude of the sonic beam pattern effect. Defaults to 12.0.

SonicBeamOffset=<float>
The amount to offset the pixel data under the sonic beam. Defaults to 0.49.

SonicBeamStartPinLeft=<x,y,z> Defaults to -30.0, -100.0, 0.0
SonicBeamStartPinRight=<x,y,z> Defaults to -30.0, 100.0, 0.0
SonicBeamEndPinLeft=<x,y,z> Defaults to 30.0, -100.0, 0.0
SonicBeamEndPinRight=<x,y,z> Defaults to 30.0, 100.0, 0.0
Start and end pins for the shape of the sonic beam.

SonicBeamSurfacePattern=<string>
The pattern for the sonic beam effect. Available options are; circle, ellipse, rhombus, and square. Defaults to circle.

SonicBeamSinePattern=<string>
The sine wave pattern for the sonic beam effect. Available options are; circle, square, sawtooth, and triangle. Defaults to circle.

Example screenshot;

[github-actions]

This comment is automaticly generated by Nightly.link and allows non-registered users to get download the artifacts for this pull request. This link is also updated when the pull request is pushed to.

• vinifera-preview-40ec39c.zip

[Bittah]

I tried out all different keys and while they all seemed to have some sort of effect, I wasn't clear on the exact effect or purpose of all of the different keys.

The keys that I was at least clear about worked fully as intended; these being SonicBeamColor, SonicBeamIsClear, SonicBeamStartPinLeft, SonicBeamStartPinRight ,SonicBeamEndPinLeft, and SonicBeamEndPinRight.

I expected that SonicBeamAlpha would control the beam's opacity, but it actually only controlled the color tint (higher values made the beam brighter and less saturated, while lower values made the beam darker and more saturated).

One thing that's still missing from this is a key to customize the duration for which the beam is actually fired, since this still appears to be hardcoded.