439 lines
13 KiB
Text
439 lines
13 KiB
Text
# Dynamic Cockpit View manager. Tries to simulate the pilot's most likely
|
|
# deliberate view direction. Doesn't consider forced view changes due to
|
|
# acceleration.
|
|
#
|
|
# To override the default recipes, put something like this into one of
|
|
# your aircraft's Nasal files:
|
|
#
|
|
# dynamic_view.register(func {
|
|
# # me.default_plane(); # uncomment one of these if you want
|
|
# # me.default_helicopter(); # to base your code on the defaults
|
|
#
|
|
# # positive values rotate (deg) or move (m)
|
|
# me.heading_offset = ... # left
|
|
# me.pitch_offset = ... # up
|
|
# me.roll_offset = ... # right
|
|
# me.x_offset = ... # right (transversal axis)
|
|
# me.y_offset = ... # up (vertical axis)
|
|
# me.z_offset = ... # back/aft (longitudinal axis)
|
|
# me.fov_offset = ... # zoom out (field of view)
|
|
# });
|
|
#
|
|
# All offsets are by default 0, and you only need to set them if they should
|
|
# be non-zero. The registered function is called for each frame and the respective
|
|
# view parameters are set accordingly. The function can access all internal
|
|
# variables of the view_manager class, such as me.roll, me.pitch, etc., and it
|
|
# can, of course, also use module variables from the file where it's defined.
|
|
#
|
|
# The following commands move smoothly to a fixed view position and back.
|
|
# All values are relative to aircraft origin (absolute), not relative to
|
|
# the default cockpit view position. The time and field-of-view argument
|
|
# is optional.
|
|
#
|
|
# dynamic_view.lookat(hdg, pitch, roll, x, y, z [, time=0.2 [, fov=55]]);
|
|
# dynamic_view.resume();
|
|
|
|
|
|
var FREEZE_DURATION = 2;
|
|
var BLEND_TIME = 0.2;
|
|
|
|
|
|
var sin = func(a) { math.sin(a * math.pi / 180.0) }
|
|
var cos = func(a) { math.cos(a * math.pi / 180.0) }
|
|
var sigmoid = func(x) { 1 / (1 + math.exp(-x)) }
|
|
var nsigmoid = func(x) { 2 / (1 + math.exp(-x)) - 1 }
|
|
var pow = func(v, w) { v < 0 ? nil : v == 0 ? 0 : math.exp(math.ln(v) * w) }
|
|
var npow = func(v, w) { v == 0 ? 0 : math.exp(math.ln(abs(v)) * w) * (v < 0 ? -1 : 1) }
|
|
var clamp = func(v, min, max) { v < min ? min : v > max ? max : v }
|
|
var normatan = func(x) { math.atan2(x, 1) * 2 / math.pi }
|
|
|
|
var normdeg = func(a) {
|
|
while (a >= 180)
|
|
a -= 360;
|
|
while (a < -180)
|
|
a += 360;
|
|
return a;
|
|
}
|
|
|
|
|
|
|
|
# Class that reads a property value, applies factor & offset, clamps to min & max,
|
|
# and optionally lowpass filters.
|
|
#
|
|
var Input = {
|
|
new : func(prop = "/null", factor = 1, offset = 0, filter = 0, min = nil, max = nil) {
|
|
var m = { parents : [Input] };
|
|
m.prop = isa(props.Node, prop) ? prop : props.globals.getNode(prop, 1);
|
|
m.factor = factor;
|
|
m.offset = offset;
|
|
m.min = min;
|
|
m.max = max;
|
|
m.lowpass = filter ? aircraft.lowpass.new(filter) : nil;
|
|
return m;
|
|
},
|
|
get : func {
|
|
var v = me.prop.getValue() * me.factor + me.offset;
|
|
if (me.min != nil and v < me.min)
|
|
v = me.min;
|
|
if (me.max != nil and v > me.max)
|
|
v = me.max;
|
|
|
|
return me.lowpass == nil ? v : me.lowpass.filter(v);
|
|
},
|
|
set : func(v) {
|
|
me.prop.setDoubleValue(v);
|
|
},
|
|
};
|
|
|
|
|
|
|
|
# Class that maintains one sim/current-view/goal-*-offset-deg property.
|
|
#
|
|
var ViewAxis = {
|
|
new : func(prop) {
|
|
var m = { parents : [ViewAxis] };
|
|
m.prop = props.globals.getNode(prop, 1);
|
|
if (m.prop.getType() == "NONE")
|
|
m.prop.setDoubleValue(0);
|
|
|
|
m.reset();
|
|
return m;
|
|
},
|
|
reset : func {
|
|
me.applied_offset = 0;
|
|
},
|
|
add_offset : func {
|
|
me.prop.setValue(me.prop.getValue() + me.applied_offset);
|
|
},
|
|
sub_offset : func {
|
|
var raw = me.prop.getValue() - me.applied_offset;
|
|
me.prop.setValue(raw);
|
|
return raw;
|
|
},
|
|
apply : func(v) {
|
|
var raw = me.prop.getValue() - me.applied_offset;
|
|
me.applied_offset = v;
|
|
me.prop.setDoubleValue(raw + me.applied_offset);
|
|
},
|
|
static : func(v) {
|
|
normdeg(v - me.prop.getValue() + me.applied_offset);
|
|
},
|
|
};
|
|
|
|
|
|
|
|
# Singleton class that manages a dynamic cockpit view by manipulating
|
|
# sim/current-view/goal-*-offset-deg properties.
|
|
#
|
|
var view_manager = {
|
|
init : func {
|
|
me.elapsedN = props.globals.getNode("/sim/time/elapsed-sec", 1);
|
|
me.deltaN = props.globals.getNode("/sim/time/delta-realtime-sec", 1);
|
|
|
|
me.headingN = props.globals.getNode("/orientation/heading-deg", 1);
|
|
me.pitchN = props.globals.getNode("/orientation/pitch-deg", 1);
|
|
me.rollN = props.globals.getNode("/orientation/roll-deg", 1);
|
|
me.slipN = props.globals.getNode("/orientation/side-slip-deg", 1);
|
|
me.speedN = props.globals.getNode("velocities/airspeed-kt", 1);
|
|
|
|
me.wind_dirN = props.globals.getNode("/environment/wind-from-heading-deg", 1);
|
|
me.wind_speedN = props.globals.getNode("/environment/wind-speed-kt", 1);
|
|
|
|
me.axes = [
|
|
me.heading_axis = ViewAxis.new("/sim/current-view/goal-heading-offset-deg"),
|
|
me.pitch_axis = ViewAxis.new("/sim/current-view/goal-pitch-offset-deg"),
|
|
me.roll_axis = ViewAxis.new("/sim/current-view/goal-roll-offset-deg"),
|
|
me.x_axis = ViewAxis.new("/sim/current-view/x-offset-m"),
|
|
me.y_axis = ViewAxis.new("/sim/current-view/y-offset-m"),
|
|
me.z_axis = ViewAxis.new("/sim/current-view/z-offset-m"),
|
|
me.fov_axis = ViewAxis.new("/sim/current-view/field-of-view"),
|
|
];
|
|
|
|
# accelerations are converted to G (Earth gravitation is omitted)
|
|
me.ax = Input.new("/accelerations/pilot/x-accel-fps_sec", 0.03108095, 0, 0.58, 0);
|
|
me.ay = Input.new("/accelerations/pilot/y-accel-fps_sec", 0.03108095, 0, 0.95);
|
|
me.az = Input.new("/accelerations/pilot/z-accel-fps_sec", -0.03108095, -1, 0.46);
|
|
|
|
# velocities are converted to knots
|
|
me.vx = Input.new("/velocities/uBody-fps", 0.5924838, 0, 0.45);
|
|
me.vy = Input.new("/velocities/vBody-fps", 0.5924838, 0);
|
|
me.vz = Input.new("/velocities/wBody-fps", 0.5924838, 0);
|
|
|
|
# turn WoW bool into smooth values ranging from 0 to 1
|
|
me.wow = Input.new("/gear/gear/wow", 1, 0, 0.74);
|
|
me.hdg_change = aircraft.lowpass.new(0.95);
|
|
me.ubody = aircraft.lowpass.new(0.95);
|
|
me.last_heading = me.headingN.getValue();
|
|
me.size_factor = getprop("/sim/chase-distance-m") / -25;
|
|
|
|
# "lookat" blending
|
|
me.blendN = props.globals.getNode("/sim/view/dynamic/blend", 1);
|
|
me.blendN.setDoubleValue(0);
|
|
me.blendtime = BLEND_TIME;
|
|
me.frozen = 0;
|
|
|
|
if (props.globals.getNode("rotors", 0) != nil)
|
|
me.calculate = me.default_helicopter;
|
|
else
|
|
me.calculate = me.default_plane;
|
|
me.reset();
|
|
},
|
|
reset : func {
|
|
me.heading_offset = me.heading = me.target_heading = 0;
|
|
me.pitch_offset = me.pitch = me.target_pitch = 0;
|
|
me.roll_offset = me.roll = me.target_roll = 0;
|
|
me.x_offset = me.x = me.target_x = 0;
|
|
me.y_offset = me.y = me.target_y = 0;
|
|
me.z_offset = me.z = me.target_z = 0;
|
|
me.fov_offset = me.fov = me.target_fov = 0;
|
|
|
|
interpolate(me.blendN);
|
|
me.blendN.setDoubleValue(0);
|
|
foreach (var a; me.axes)
|
|
a.reset();
|
|
|
|
me.add_offset();
|
|
},
|
|
add_offset : func {
|
|
me.heading_axis.add_offset();
|
|
me.pitch_axis.add_offset();
|
|
me.roll_axis.add_offset();
|
|
me.fov_axis.add_offset();
|
|
},
|
|
apply : func {
|
|
if (me.elapsedN.getValue() < me.frozen)
|
|
return;
|
|
elsif (me.frozen)
|
|
me.unfreeze();
|
|
|
|
me.pitch = me.pitchN.getValue();
|
|
me.roll = me.rollN.getValue();
|
|
|
|
me.calculate();
|
|
|
|
var b = me.blendN.getValue();
|
|
var B = 1 - b;
|
|
me.heading = me.target_heading * b + me.heading_offset * B;
|
|
me.pitch = me.target_pitch * b + me.pitch_offset * B;
|
|
me.roll = me.target_roll * b + me.roll_offset * B;
|
|
me.x = me.target_x * b + me.x_offset * B;
|
|
me.y = me.target_y * b + me.y_offset * B;
|
|
me.z = me.target_z * b + me.z_offset * B;
|
|
me.fov = me.target_fov * b + me.fov_offset * B;
|
|
|
|
me.heading_axis.apply(me.heading);
|
|
me.pitch_axis.apply(me.pitch);
|
|
me.roll_axis.apply(me.roll);
|
|
me.x_axis.apply(me.x);
|
|
me.y_axis.apply(me.y);
|
|
me.z_axis.apply(me.z);
|
|
me.fov_axis.apply(me.fov);
|
|
},
|
|
lookat : func(heading, pitch, roll, x, y, z, time, fov) {
|
|
me.target_heading = me.heading_axis.static(heading);
|
|
me.target_pitch = me.pitch_axis.static(pitch);
|
|
me.target_roll = me.roll_axis.static(roll);
|
|
me.target_x = me.x_axis.static(x);
|
|
me.target_y = me.y_axis.static(y);
|
|
me.target_z = me.z_axis.static(z);
|
|
me.target_fov = me.fov_axis.static(fov);
|
|
|
|
me.blendtime = time;
|
|
me.blendN.setValue(0);
|
|
interpolate(me.blendN, 1, me.blendtime);
|
|
},
|
|
resume : func {
|
|
interpolate(me.blendN, 0, me.blendtime);
|
|
me.blendtime = BLEND_TIME;
|
|
},
|
|
freeze : func {
|
|
if (!me.frozen) {
|
|
me.target_heading = me.heading;
|
|
me.target_pitch = me.pitch;
|
|
me.target_roll = me.roll;
|
|
me.target_x = me.x;
|
|
me.target_y = me.y;
|
|
me.target_z = me.z;
|
|
me.target_fov = me.fov;
|
|
me.blendN.setDoubleValue(1);
|
|
}
|
|
me.frozen = me.elapsedN.getValue() + FREEZE_DURATION;
|
|
},
|
|
unfreeze : func {
|
|
if (me.frozen) {
|
|
me.frozen = 0;
|
|
me.resume();
|
|
}
|
|
},
|
|
};
|
|
|
|
|
|
|
|
# default calculations for a plane
|
|
#
|
|
view_manager.default_plane = func {
|
|
var wow = me.wow.get();
|
|
|
|
# calculate steering factor
|
|
var hdg = me.headingN.getValue();
|
|
var hdiff = normdeg(me.last_heading - hdg);
|
|
me.last_heading = hdg;
|
|
var steering = normatan(me.hdg_change.filter(hdiff)) * me.size_factor;
|
|
|
|
var az = me.az.get();
|
|
var vx = me.vx.get();
|
|
|
|
# calculate sideslip factor (zeroed when no forward ground speed)
|
|
var wspd = me.wind_speedN.getValue();
|
|
var wdir = me.headingN.getValue() - me.wind_dirN.getValue();
|
|
var u = vx - wspd * cos(wdir);
|
|
var slip = sin(me.slipN.getValue()) * me.ubody.filter(normatan(u / 10));
|
|
|
|
me.heading_offset = # view heading
|
|
-15 * sin(me.roll) * cos(me.pitch) # due to roll
|
|
+ 40 * steering * wow # due to ground steering
|
|
+ 10 * slip * (1 - wow); # due to sideslip (in air)
|
|
|
|
me.pitch_offset = # view pitch
|
|
10 * sin(me.roll) * sin(me.roll) # due to roll
|
|
+ 30 * (1 / (1 + math.exp(2 - az)) # due to G load
|
|
- 0.119202922); # [move to origin; 1/(1+exp(2)) ]
|
|
|
|
me.roll_offset = 0;
|
|
}
|
|
|
|
|
|
|
|
# default calculations for a helicopter
|
|
#
|
|
view_manager.default_helicopter = func {
|
|
var lowspeed = 1 - normatan(me.speedN.getValue() / 20);
|
|
|
|
me.heading_offset = # view heading due to
|
|
-50 * npow(sin(me.roll) * cos(me.pitch), 2); # roll
|
|
|
|
me.pitch_offset = # view pitch due to
|
|
(me.pitch < 0 ? -35 : -40) * sin(me.pitch) * lowspeed # pitch
|
|
+ 15 * sin(me.roll) * sin(me.roll); # roll
|
|
|
|
me.roll_offset = # view roll due to
|
|
-15 * sin(me.roll) * cos(me.pitch) * lowspeed; # roll
|
|
}
|
|
|
|
|
|
|
|
# Update loop for the whole dynamic view manager. It only runs if
|
|
# /sim/view[0]/dynamic/enabled is true.
|
|
#
|
|
var main_loop = func(id) {
|
|
id == loop_id or return;
|
|
if (cockpit_view and !panel_visible) {
|
|
if (mouse_button)
|
|
freeze();
|
|
else
|
|
view_manager.apply();
|
|
}
|
|
settimer(func { main_loop(id) }, 0);
|
|
}
|
|
|
|
|
|
|
|
var freeze = func {
|
|
if (mouse_mode == 0)
|
|
view_manager.freeze();
|
|
}
|
|
|
|
var register = func(f) {
|
|
view_manager.calculate = f;
|
|
}
|
|
|
|
var reset = func {
|
|
view_manager.reset();
|
|
}
|
|
|
|
var lookat = func {
|
|
call(view_manager.lookat, arg, view_manager);
|
|
}
|
|
|
|
var resume = func {
|
|
view_manager.resume();
|
|
}
|
|
|
|
|
|
var original_resetView = nil;
|
|
var panel_visibilityN = nil;
|
|
var dynamic_view = nil;
|
|
|
|
var cockpit_view = nil;
|
|
var panel_visible = nil; # whether 2D panel is visible
|
|
var elapsedN = nil;
|
|
var mouse_mode = nil;
|
|
var mouse_button = nil;
|
|
var enabled = props.globals.getNode("/sim").getChildren("view");
|
|
|
|
var loop_id = 0;
|
|
|
|
|
|
# Initialization.
|
|
#
|
|
_setlistener("/sim/signals/nasal-dir-initialized", func {
|
|
# disable menu entry and return for inappropriate FDMs (see Main/fg_init.cxx)
|
|
var fdms = {
|
|
acms:0, ada:0, balloon:0, external:0,
|
|
jsb:1, larcsim:1, magic:0, network:0,
|
|
null:0, pipe:0, ufo:0, yasim:1,
|
|
};
|
|
var fdm = getprop("/sim/flight-model");
|
|
if (!contains(fdms, fdm) or !fdms[fdm])
|
|
return gui.menuEnable("dynamic-view", 0);
|
|
|
|
forindex (var i; enabled)
|
|
enabled[i] = ((var n = enabled[i].getNode("config/dynamic-view")) != nil) and n.getBoolValue();
|
|
|
|
# some properties may still be unavailable or nil
|
|
props.globals.getNode("/accelerations/pilot/x-accel-fps_sec", 1).setDoubleValue(0);
|
|
props.globals.getNode("/accelerations/pilot/y-accel-fps_sec", 1).setDoubleValue(0);
|
|
props.globals.getNode("/accelerations/pilot/z-accel-fps_sec", 1).setDoubleValue(-32);
|
|
props.globals.getNode("/orientation/side-slip-deg", 1).setDoubleValue(0);
|
|
props.globals.getNode("/gear/gear/wow", 1).setBoolValue(1);
|
|
elapsedN = props.globals.getNode("/sim/time/elapsed-sec", 1);
|
|
|
|
# let listeners keep some variables up-to-date, so that they don't have
|
|
# to be queried in the loop
|
|
setlistener("/sim/panel/visibility", func { panel_visible = cmdarg().getValue() }, 1);
|
|
setlistener("/sim/current-view/view-number", func { cockpit_view = enabled[cmdarg().getValue()] }, 1);
|
|
setlistener("/devices/status/mice/mouse/button", func { mouse_button = cmdarg().getValue() }, 1);
|
|
setlistener("/devices/status/mice/mouse/x", freeze);
|
|
setlistener("/devices/status/mice/mouse/y", freeze);
|
|
setlistener("/devices/status/mice/mouse/mode", func {
|
|
if (mouse_mode = cmdarg().getValue())
|
|
view_manager.unfreeze();
|
|
}, 1);
|
|
|
|
setlistener("/sim/signals/reinit", func {
|
|
cmdarg().getValue() and return;
|
|
cockpit_view = enabled[getprop("/sim/current-view/view-number")];
|
|
view_manager.reset();
|
|
}, 0);
|
|
|
|
view_manager.init();
|
|
|
|
original_resetView = view.resetView;
|
|
view.resetView = func {
|
|
original_resetView();
|
|
if (cockpit_view and dynamic_view)
|
|
view_manager.add_offset();
|
|
}
|
|
|
|
settimer(func {
|
|
setlistener("/sim/view/dynamic/enabled", func {
|
|
dynamic_view = cmdarg().getBoolValue();
|
|
loop_id += 1;
|
|
view.resetView();
|
|
if (dynamic_view)
|
|
main_loop(loop_id);
|
|
}, 1);
|
|
}, 0);
|
|
});
|
|
|
|
|