.. _changelog_ide_v4_1_1:

v4.1.1
======

v4.1.1 focuses on the Examples menu: entries are now filtered to match the
connected board and sensor, with redundant folders collapsed and a clear
placeholder when nothing is connected. It also adds a live focus metric to the
framebuffer viewer, refreshes the bundled examples, and ships board firmware
4.5.1. Built on the Qt Creator 10.0.1 base; there is no Qt Creator rebase in
this release. Example filtering changes the default Examples-menu behavior --
see Breaking changes.

.. contents:: On this page
   :backlinks: none
   :local:
   :depth: 1

Highlights
----------

- **Example filtering** shows only examples relevant to your connected board
  and sensor, driven by an ``examples/index.csv`` config, with a ``Tools``
  menu toggle to disable it.
- **Focus metric** is now displayed live in the framebuffer viewer and
  terminal status bar to help you focus the lens.
- **Cleaner Examples menu**: redundant single-child board folders are
  collapsed and a placeholder is shown instead of an empty menu.
- **Soft-reboot line stripped** from the serial terminal so the console is no
  longer cluttered on each run.
- **Bundled board firmware** updated to 4.5.1 across the supported OpenMV and
  Arduino boards.

New features
------------

- **Example filtering.** The ``Examples`` menu now filters entries to only
  show examples relevant to the connected board and sensor. Initial
  board/sensor filtering was driven by a ``filters.txt`` config
  (`ef7190282 <https://github.com/openmv/qt-creator/commit/ef7190282>`__),
  later moved to ``examples/index.csv`` with per-board and per-sensor regexes
  plus a flatten column
  (`795cc20e9 <https://github.com/openmv/qt-creator/commit/795cc20e9>`__) and
  case-insensitive board-folder and sensor-type matching
  (`3e976cb9a <https://github.com/openmv/qt-creator/commit/3e976cb9a>`__). A
  new ``Tools`` > **Filter examples by board and sensor type** toggle (checked
  by default, state persisted) disables filtering
  (`fd3defe00 <https://github.com/openmv/qt-creator/commit/fd3defe00>`__).
- **Focus metric.** The framebuffer viewer and terminal status bar now display
  a live **Focus** value computed from the JPEG-compressed frame to help you
  focus the lens
  (`5834e3a41 <https://github.com/openmv/qt-creator/commit/5834e3a41>`__).

Other changes and improvements
------------------------------

- When connected, the ``Examples`` menu now collapses redundant single-child
  board folders and shows a clear "No examples found for your board" or
  "Connect to your board first" placeholder instead of an empty menu
  (`795cc20e9 <https://github.com/openmv/qt-creator/commit/795cc20e9>`__).
- The MicroPython ``MPY: soft reboot`` line is now stripped from the serial
  terminal output so it no longer clutters the console on each run
  (`b3cf63299 <https://github.com/openmv/qt-creator/commit/b3cf63299>`__).
- Bundled examples were reorganized into board-named folders (for example
  ``50-Board-Control``), updated with MIT license headers, and the Image
  Reader/Writer examples were simplified to use raw ``image.ImageIO`` video
  streams. The in-memory and on-disk "shadow removal" frame-differencing
  examples were removed
  (`1358eeb84 <https://github.com/openmv/qt-creator/commit/1358eeb84>`__,
  `7b32f2814 <https://github.com/openmv/qt-creator/commit/7b32f2814>`__,
  `9d89f1c62 <https://github.com/openmv/qt-creator/commit/9d89f1c62>`__).

Bug fixes
---------

- Forcing a specific bootloader firmware file now correctly uses the provided
  firmware path instead of always reverting to the board's default
  ``firmware.bin``
  (`a362c1c6b <https://github.com/openmv/qt-creator/commit/a362c1c6b>`__).
- Fixed i.MX (RT1060) device discovery on Windows that could fail due to an
  overly strict ``RawInputDeviceList`` count check
  (`49571962d <https://github.com/openmv/qt-creator/commit/49571962d>`__).
- Fixed a histogram overflow for large or bright images by widening the
  accumulation vector to 64-bit
  (`5aaf923a3 <https://github.com/openmv/qt-creator/commit/5aaf923a3>`__).
- Fixed sorting of example folders so unnumbered example entries order
  consistently
  (`3cb994433 <https://github.com/openmv/qt-creator/commit/3cb994433>`__).

Platform and tool support
-------------------------

- **Qt Creator base:** 10.0.1.
- **Bundled board firmware:** updated 4.5.0 -> 4.5.1 across the supported
  OpenMV and Arduino boards -- including OPENMV2/3/4/4P, OPENMV PT (Pure
  Thermal), OPENMV RT1060, ARDUINO GIGA, NICLA VISION, PORTENTA H7, NANO RP2040
  CONNECT, and NANO 33 BLE SENSE -- including UVC and bootloader images
  (`f6a5b12ba <https://github.com/openmv/qt-creator/commit/f6a5b12ba>`__).
- New-script generation now substitutes the grayscale pixformat for
  ``HM01B0``, ``HM0360``, ``MT9V0X2``, and ``MT9V0X4`` (the prior ``MT9V034``
  entry is replaced by ``MT9V0X2``/``MT9V0X4``)
  (`ef7190282 <https://github.com/openmv/qt-creator/commit/ef7190282>`__).

Breaking changes
----------------

The ``Examples`` menu now requires a connected board when filtering is enabled,
which is the new default. Until you connect, the menu shows "Connect to your
board first to see examples," and once connected it only shows examples
matching the connected board and sensor. Disable this via the new ``Tools`` >
**Filter examples by board and sensor type** toggle.