Bug: Numerical result out of range exception

[devloberto]

I don't know what's changed ... I used the app for weeks / months without any issue.
For a few days now, WebCamControl dies with the following exception when I click on an arrow button to move the insta360 link 2 webcam (or in other words: to change the angle by the "Pan and Tilt" feature) 🙁

This happens with the binary as well as the flatpak.

binary bug view

Version: 1.1.1+7bf90c26a2ff66a1e5e70b1d6d08fa1fb0eb0fa5
System: TUXEDO OS

Exception:

WebCamControl.Core.Exceptions.InteropException: Numerical result out of range
   at WebCamControl.Core.Exceptions.InteropException.ThrowIfError()
   at WebCamControl.Core.Linux.LinuxCameraControl.set_Value(Int32 value)
   at WebCamControl.Core.AngleControl.set_Value(Single value)
   at WebCamControl.Gtk.Widgets.PanAndTiltButtons.<AttachEvents>b__8_3(Object _, EventArgs _)
   at WebCamControl.Gtk.Widgets.PressAndHoldButton.<AttachEvents>b__5_1(GestureClick _, PressedSignalArgs _)
   at GObject.Signal`2.<>c__DisplayClass11_0.<Connect>b__0(Value returnValue, Value[] parameters)
   at GObject.Closure.InternalCallback(IntPtr closure, IntPtr returnValuePtr, UInt32 nParamValues, IntPtr paramValuesData, IntPtr invocationHint, IntPtr userData)

flatpak bug view

Version: 1.1.1+7bf90c26a2ff66a1e5e70b1d6d08fa1fb0eb0fa5
System: GNOME 47 (Flatpak runtime)

Exception:

WebCamControl.Core.Exceptions.InteropException: Numerical result out of range
   at WebCamControl.Core.Exceptions.InteropException.ThrowIfError() in /run/build/WebCamControl/src/WebCamControl.Core/Exceptions/InteropException.cs:line 21
   at WebCamControl.Core.Linux.LinuxCameraControl.set_Value(Int32 value) in /run/build/WebCamControl/src/WebCamControl.Core/Linux/LinuxCameraControl.cs:line 82
   at WebCamControl.Core.AngleControl.set_Value(Single value) in /run/build/WebCamControl/src/WebCamControl.Core/AngleControl.cs:line 19
   at WebCamControl.Gtk.Widgets.PanAndTiltButtons.<AttachEvents>b__8_1(Object _, EventArgs _) in /run/build/WebCamControl/src/WebCamControl.Gtk/Widgets/PanAndTiltButtons.cs:line 45
   at WebCamControl.Gtk.Widgets.PressAndHoldButton.<AttachEvents>b__5_1(GestureClick _, PressedSignalArgs _) in /run/build/WebCamControl/src/WebCamControl.Gtk/Widgets/PressAndHoldButton.cs:line 29
   at GObject.Signal`2.<>c__DisplayClass11_0.<Connect>b__0(Value returnValue, Value[] parameters)
   at GObject.Closure.InternalCallback(IntPtr closure, IntPtr returnValuePtr, UInt32 nParamValues, IntPtr paramValuesData, IntPtr invocationHint, IntPtr userData)

flatpak screencast

Screencast_2026-01-21_11.18.11.mp4

[devloberto]

I'm wondering if it's related to #33 because it's the same exception but not the same stack trace. 🤔

[Konkrad]

Hello,
I had a similar bug. After I seen you other comment on #33 I tried it with the update. After the update I had the feeling it was working but after a retry I get

WebCamControl.Core.Exceptions.InteropException: Numerical result out of range
   at WebCamControl.Core.Exceptions.InteropException.ThrowIfError() in /run/build/WebCamControl/src/WebCamControl.Core/Exceptions/InteropException.cs:line 21
   at WebCamControl.Core.Linux.LinuxCameraControl.set_Value(Int32 value) in /run/build/WebCamControl/src/WebCamControl.Core/Linux/LinuxCameraControl.cs:line 82
   at WebCamControl.Core.AngleControl.set_Value(Single value) in /run/build/WebCamControl/src/WebCamControl.Core/AngleControl.cs:line 19
   at WebCamControl.Gtk.Widgets.PanAndTiltButtons.<AttachEvents>b__8_1(Object _, EventArgs _) in /run/build/WebCamControl/src/WebCamControl.Gtk/Widgets/PanAndTiltButtons.cs:line 45
   at WebCamControl.Gtk.Widgets.PressAndHoldButton.<AttachEvents>b__5_1(GestureClick _, PressedSignalArgs _) in /run/build/WebCamControl/src/WebCamControl.Gtk/Widgets/PressAndHoldButton.cs:line 29
   at GObject.Signal`2.<>c__DisplayClass11_0.<Connect>b__0(Value returnValue, Value[] parameters)
   at GObject.Closure.InternalCallback(IntPtr closure, IntPtr returnValuePtr, UInt32 nParamValues, IntPtr paramValuesData, IntPtr invocationHint, IntPtr userData)

[Daniel15]

Sorry for the delay in replying, @devloberto and @Konkrad!

This error is confusing. It says that the value is out of range, but there's already code to ensure that values are within the correct range:

https://github.com/Daniel15/WebCamControl/blame/baaa180f990e6d1b807f60858b4462a7107f9301/src/WebCamControl.Core/Linux/LinuxCameraControl.cs#L95-L120

Unfortunately I haven't been able to reproduce the issue with an Insta360 Link. My wife has a Link 2 so I'll try use hers for a while and see if I can repro.

After getting this error, can you please run this command and provide the output:

v4l2-ctl -d /dev/video0 --list-ctrls

(replace /dev/video0 with the correct device name)

In particular, I'm curious about if thevalue value is less than min or greater than max.

[Daniel15]

@devloberto, @Konkrad - can you please try the latest build?

https://nightly.link/Daniel15/WebCamControl/actions/runs/24643179127/artifact.zip

I fixed one potential issue, and also updated the error message to be more descriptive. If you still hit the error, please provide the new error message. Thanks!

[devloberto]

Hey @Daniel15 I am using the flatpak build and didn't notice the issue for a while after running some flatpak updates. Unfortunately, I actually don't know what has changed.

What I can tell you is that I upgraded the flatpak minutes ago and it still works flawlessly:

~ > flatpak update com.daniel15.wcc


Looking for updates…


        ID                                                Branch                 Op            Remote             Download
 1. [✓] org.freedesktop.Platform.GL.default               25.08                  u             flathub             26,0 MB / 142,4 MB
 2. [✓] org.freedesktop.Platform.GL.default               25.08-extra            u             flathub             26,1 MB / 142,4 MB
 3. [✓] org.freedesktop.Platform.VAAPI.Intel              25.08                  u             flathub              4,3 kB / 13,7 MB
 4. [✓] org.freedesktop.Platform.codecs-extra             25.08-extra            u             flathub            222,5 kB / 14,3 MB
 5. [✓] org.gnome.Platform.Locale                         50                     u             flathub             18,5 kB / 385,9 MB
 6. [✓] org.gnome.Platform                                50                     u             flathub            131,0 MB / 409,5 MB
 7. [✓] com.daniel15.wcc                                  stable                 u             flathub             34,1 MB / 34,3 MB
 8. [-] org.gnome.Platform.Locale                         47                     r
 9. [-] org.gnome.Platform                                47                     r

Changes complete.

The nightly build (from your url https://nightly.link/Daniel15/WebCamControl/actions/runs/24643179127/artifact.zip) worked flawlessly as well. This is the console output of the binary: console-output.debug

I know this is not that much information for a bug report but I don't know what else would make sense to share with you. Sorry for that.

And thank you for mentioning the command v4l2-ctl -d /dev/video0 --list-ctrls - I will definitely keep it in mind.

[Konkrad]

thanks for providing the nightly build. I was not as lucky. I get

Version: `1.2.0+cab1054075f54044d098b13d21797da87e4914a7`
System: `Ubuntu 24.04.4 LTS`

Exception:
System.Exception: 	Could not set `PanAbsolute`: Numerical result out of range (34). 
    Min = -522000, Max = 522000, Step = 3600
    Current = 36805668, New = 36812868, ClampedNew = 522000.
    This could be caused by a bug in your camera's driver or firmware. Make sure the firmware is up-to-date."
   at WebCamControl.Core.Linux.LinuxCameraControl.set_Value(Int32 value) in /home/runner/work/WebCamControl/WebCamControl/src/WebCamControl.Core/Linux/LinuxCameraControl.cs:line 88
   at WebCamControl.Core.AngleControl.set_Value(Single value) in /home/runner/work/WebCamControl/WebCamControl/src/WebCamControl.Core/AngleControl.cs:line 19
   at WebCamControl.Gtk.Widgets.PanAndTiltButtons.<AttachEvents>b__8_1(Object _, EventArgs _) in /home/runner/work/WebCamControl/WebCamControl/src/WebCamControl.Gtk/Widgets/PanAndTiltButtons.cs:line 45
   at WebCamControl.Gtk.Widgets.PressAndHoldButton.<AttachEvents>b__5_1(GestureClick _, PressedSignalArgs _) in /home/runner/work/WebCamControl/WebCamControl/src/WebCamControl.Gtk/Widgets/PressAndHoldButton.cs:line 29
   at GObject.Signal`2.<>c__DisplayClass11_0.<Connect>b__0(Value returnValue, Value[] parameters)
   at GObject.Closure.InternalCallback(IntPtr closure, IntPtr returnValuePtr, UInt32 nParamValues, IntPtr paramValuesData, IntPtr invocationHint, IntPtr userData)

With the output of the other command

v4l2-ctl -d /dev/video3 --list-ctrls

User Controls

                     brightness 0x00980900 (int)    : min=0 max=100 step=1 default=50 value=36 flags=0x00001000
                       contrast 0x00980901 (int)    : min=0 max=100 step=1 default=50 value=50 flags=0x00001000
                     saturation 0x00980902 (int)    : min=0 max=100 step=1 default=50 value=50 flags=0x00001000
                            hue 0x00980903 (int)    : min=-15 max=15 step=1 default=0 value=0 flags=0x00001000
        white_balance_automatic 0x0098090c (bool)   : default=1 value=1
           power_line_frequency 0x00980918 (menu)   : min=0 max=2 default=3 value=1 (50 Hz)
      white_balance_temperature 0x0098091a (int)    : min=2000 max=10000 step=1 default=6400 value=5500 flags=inactive, 0x00001000
                      sharpness 0x0098091b (int)    : min=0 max=100 step=1 default=50 value=50 flags=0x00001000

Camera Controls

                   pan_absolute 0x009a0908 (int)    : min=-522000 max=522000 step=3600 default=0 value=36805668 flags=0x00001000
                  tilt_absolute 0x009a0909 (int)    : min=-324000 max=360000 step=3600 default=0 value=-402456063 flags=0x00001000
                 focus_absolute 0x009a090a (int)    : min=0 max=100 step=1 default=50 value=94 flags=inactive, 0x00001000
     focus_automatic_continuous 0x009a090c (bool)   : default=0 value=1
                  zoom_absolute 0x009a090d (int)    : min=100 max=400 step=1 default=100 value=100 flags=0x00001000

[Daniel15]

Min = -522000, Max = 522000, Step = 3600

Current = 36805668, New = 36812868, ClampedNew = 522000.

@Konkrad This is weird. The camera is saying that the value should be between -522000 and 522000, but the current value is outside that range (36805668)!

WebCamControl tries to do the right thing and clamps the new value (attempts to set it to the maximum possible, 522000), but the camera driver throws a "Numerical result out of range" range, even though it's clearly within the range.

You can see in your v4l2-ctl output that both the pan and tilt are out of range:

                   pan_absolute 0x009a0908 (int)    : min=-522000 max=522000 step=3600 default=0 value=36805668 flags=0x00001000
                  tilt_absolute 0x009a0909 (int)    : min=-324000 max=360000 step=3600 default=0 value=-402456063 flags=0x00001000

I think the only reasonable approach here is for WebCamControl to check all the values at startup, and offer to reset any out-of-range values back to the default value. I'll work on that for the next release.