Ashlar checks / tooling (push) Successful in 5s
- Shoulder view, auto shoulder switch, standing preview, deferred preview rotation, move 360, smooth view change and [Game] smooth movement are on by default. - Collision ease-out: the camera still snaps in on collision but eases back out (0.15 s half-life, 60 u/s minimum speed). - Aim mode: with a ranged weapon or a spell readied in third person the view stays over the shoulder, moves closer and narrows the FOV. Camera interface v2 adds getAimWeight and enable/disable functions. - Pure math in camera/ease.lua with unit tests; SCENARIO=camera with PASS/FAIL checks; docs in docs/ashlar/CAMERA.md. - ashlar-run.sh deletes stored Lua settings before each run so changed defaults are tested. Closes #29 Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
114 lines
4.3 KiB
Lua
114 lines
4.3 KiB
Lua
local storage = require('openmw.storage')
|
|
local async = require('openmw.async')
|
|
local I = require('openmw.interfaces')
|
|
|
|
I.Settings.registerPage({
|
|
key = 'OMWCamera',
|
|
l10n = 'OMWCamera',
|
|
name = 'Camera',
|
|
description = 'settingsPageDescription',
|
|
})
|
|
|
|
local thirdPersonGroup = 'SettingsOMWCameraThirdPerson'
|
|
local headBobbingGroup = 'SettingsOMWCameraHeadBobbing'
|
|
|
|
local function boolSetting(prefix, key, default)
|
|
return {
|
|
key = key,
|
|
renderer = 'checkbox',
|
|
name = prefix .. key,
|
|
description = prefix .. key .. 'Description',
|
|
default = default,
|
|
}
|
|
end
|
|
|
|
local function floatSetting(prefix, key, default)
|
|
return {
|
|
key = key,
|
|
renderer = 'number',
|
|
name = prefix .. key,
|
|
description = prefix .. key .. 'Description',
|
|
default = default,
|
|
}
|
|
end
|
|
|
|
I.Settings.registerGroup({
|
|
key = thirdPersonGroup,
|
|
page = 'OMWCamera',
|
|
l10n = 'OMWCamera',
|
|
name = 'thirdPersonSettings',
|
|
permanentStorage = true,
|
|
order = 0,
|
|
settings = {
|
|
floatSetting('', 'maxDistance', 800),
|
|
boolSetting('', 'viewOverShoulder', true),
|
|
floatSetting('', 'shoulderOffsetX', 30),
|
|
floatSetting('', 'shoulderOffsetY', -10),
|
|
boolSetting('', 'autoSwitchShoulder', true),
|
|
floatSetting('', 'zoomOutWhenMoveCoef', 20),
|
|
boolSetting('', 'previewIfStandStill', true),
|
|
boolSetting('', 'deferredPreviewRotation', true),
|
|
boolSetting('', 'ignoreNC', false),
|
|
boolSetting('', 'move360', true),
|
|
floatSetting('', 'move360TurnSpeed', 5),
|
|
boolSetting('', 'slowViewChange', true),
|
|
boolSetting('', 'povAutoSwitch', false),
|
|
-- Ashlar: collision ease-out and aim mode (see third_person.lua and ease.lua).
|
|
boolSetting('', 'collisionEaseOut', true),
|
|
floatSetting('', 'collisionEaseOutTime', 0.15),
|
|
boolSetting('', 'aimMode', true),
|
|
floatSetting('', 'aimDistance', 0.7),
|
|
floatSetting('', 'aimFieldOfView', 0.9),
|
|
},
|
|
})
|
|
|
|
I.Settings.registerGroup({
|
|
key = headBobbingGroup,
|
|
page = 'OMWCamera',
|
|
l10n = 'OMWCamera',
|
|
name = 'headBobbingSettings',
|
|
permanentStorage = true,
|
|
order = 1,
|
|
settings = {
|
|
boolSetting('headBobbing_', 'enabled', false),
|
|
floatSetting('headBobbing_', 'step', 90),
|
|
floatSetting('headBobbing_', 'height', 3),
|
|
floatSetting('headBobbing_', 'roll', 0.2),
|
|
},
|
|
})
|
|
|
|
local thirdPerson = storage.playerSection(thirdPersonGroup)
|
|
local headBobbing = storage.playerSection(headBobbingGroup)
|
|
|
|
local function updateViewOverShoulderDisabled()
|
|
I.Settings.updateRendererArgument(thirdPersonGroup, 'maxDistance', { min = 30, max = 2400 })
|
|
|
|
local shoulderDisabled = not thirdPerson:get('viewOverShoulder')
|
|
I.Settings.updateRendererArgument(thirdPersonGroup, 'shoulderOffsetX', { disabled = shoulderDisabled })
|
|
I.Settings.updateRendererArgument(thirdPersonGroup, 'shoulderOffsetY', { disabled = shoulderDisabled })
|
|
I.Settings.updateRendererArgument(thirdPersonGroup, 'autoSwitchShoulder', { disabled = shoulderDisabled })
|
|
I.Settings.updateRendererArgument(thirdPersonGroup, 'zoomOutWhenMoveCoef', { disabled = shoulderDisabled })
|
|
|
|
local move360Disabled = not thirdPerson:get('move360')
|
|
I.Settings.updateRendererArgument(thirdPersonGroup, 'move360TurnSpeed', { disabled = move360Disabled })
|
|
|
|
I.Settings.updateRendererArgument(thirdPersonGroup, 'collisionEaseOutTime',
|
|
{ disabled = not thirdPerson:get('collisionEaseOut'), min = 0, max = 2 })
|
|
local aimDisabled = not thirdPerson:get('aimMode')
|
|
I.Settings.updateRendererArgument(thirdPersonGroup, 'aimDistance', { disabled = aimDisabled, min = 0.3, max = 1 })
|
|
I.Settings.updateRendererArgument(thirdPersonGroup, 'aimFieldOfView', { disabled = aimDisabled, min = 0.5, max = 1 })
|
|
end
|
|
|
|
local function updateHeadBobbingDisabled()
|
|
local disabled = not headBobbing:get('enabled')
|
|
I.Settings.updateRendererArgument(headBobbingGroup, 'step', { disabled = disabled, min = 1 })
|
|
I.Settings.updateRendererArgument(headBobbingGroup, 'height', { disabled = disabled })
|
|
I.Settings.updateRendererArgument(headBobbingGroup, 'roll', { disabled = disabled, min = 0, max = 90 })
|
|
end
|
|
|
|
updateViewOverShoulderDisabled()
|
|
updateHeadBobbingDisabled()
|
|
|
|
thirdPerson:subscribe(async:callback(updateViewOverShoulderDisabled))
|
|
headBobbing:subscribe(async:callback(updateHeadBobbingDisabled))
|