SpatialDirection

package com.socketsvc.client.api;

public record SpatialDirection(double x, double y, double z, float innerAngle, float outerAngle, float outerGain) { ... }

Which way a positional channel points, and how much quieter it is off-axis.

The standard cone: full volume inside innerAngle, falling to outerGain at outerAngle, and staying there beyond it. A speaker stack facing the seats is louder in front of it than behind, which is the difference between audio placed in a room and audio glued to the listener's head.

A direction is a gain calculation, not a second audio path: it multiplies into the distance gain the channel already computes. That is what makes it cheap enough to be worth having, and it is why the same model belongs on the server's own speaker API - a cone is a property of a loudspeaker, not of who is listening.

Components複製段落連結

Methods複製段落連結

cone複製段落連結

public static SpatialDirection cone(double x, double y, double z, float inner, float outer, float outerGain)

A cone pointing along (x, y, z), full volume within the inner-degree-wide cone and falling to outerGain by the outer-degree-wide one. Both are full widths, not half-angles.

directional複製段落連結

public boolean directional()

Whether this direction actually attenuates anything, so a channel that does not point anywhere skips the work entirely.

gain複製段落連結

public double gain(double dx, double dy, double dz)

How loudly this channel is heard by somebody dx, dy, dz away from it.

1 inside the inner cone, outerGain outside the outer one, and a smooth ride between - cosine-interpolated rather than linear in the angle, because the ear follows loudness rather than degrees and a linear ramp is heard as a step near the edges.

A listener standing exactly on the speaker gets 1: there is no direction from a point to itself, and going silent there would be the one place a cone must not be heard.