Hladké cesty

Sestaví kubickou Hermite křivku a poskytne sampling podle vzdálenosti.

build_smooth() doplní tangenty, vytvoří nativní PathConstraintPathHermite, přenáší stabilní normal podél křivky, aplikuje roll jednotlivých bodů a připraví přibližnou tabulku délky oblouku.

Syntaxe#

track.build_smooth(smoothness=1.0);

Požadavky#

Pravidlo automatických tangent#

• Vnitřní body otevřené cesty a všechny body loopu používají 0.5 × smoothness × (next − previous).
• Koncové body otevřené cesty používají smoothness násobené sousedním segmentem.
• Tangenty z add_point_tangent() zůstávají beze změny.

Sampling podle délky oblouku#

var midpoint = track.get_position(0.5);
var direction = track.get_direction(0.5);

var distance = track.get_length() * 0.25;
var position = track.get_position_at_distance(distance);
var tangent = track.get_direction_at_distance(distance);

Veřejná fraction představuje normalizovanou přibližnou délku oblouku, ne surový Hermite parametr segmentu. Hodnota 0.5 je proto fyzický střed cesty.

Frame a prostorové dotazy#

var euler = track.get_rotation(0.5);
var quaternion = track.get_rotation_quaternion(0.5);
var nearest = track.get_closest_point(x, y, z);
var bounds = track.get_bounds();

Ověřené kontrakty operací#

Následující kontrakty rozlišují jednotky, návratové hodnoty, chyby a životnost podle aktuální implementace. Nevynechávej kontrolu výsledku: false, 0 a undefined mohou mít u různých metod odlišný význam.