libcamera v0.3.0

abi-compliance checker reports 99.7% binary compatibility and 99.9% source
compatibility between v0.2.0 and v0.3.0. The SONAME has been updated
accordingly and applications must be relinked against this version of
libcamera.

 Total binary compatibility problems: 2, warnings: 0
 Total source compatibility problems: 2, warnings: 0

Specifically, the symbol
  - ControlList::merge(struct ControlList const& source )
 has been replaced with the new symbol:
  - ControlList::merge ( struct ControlList const& source, enum ControlList::MergePolicy policy )

The following commits in this release relate to either a bug fix or improvement
to existing commit.

 - utils: ipc: extract-docs: Fix escape characters in regex
   - Reported-by: Nicolas Dufresne <nicolas@ndufresne.ca>
 - libcamera: Remove empty formats.c
   - Fixes: e0a51061bc69 ("libcamera: formats: Add 14-bits Bayer RAW formats")
 - libcamera: bayer_format: Add Y12 to bayerToFormat
   - Fixes: ec6309571654 ("libcamera: bayer_format: Add unpacked mono 12-bit format to the conversion table")
 - apps: common: dng_writer: Add a default case for switch-case on a modulo
   - Bug: https://bugs.libcamera.org/show_bug.cgi?id=207
 - utils: mojom: Fix build error caused by the mojom tool update
   - Fixes: d17de86904f0 ("utils: ipc: Update mojo")
 - libcamera: formats: Fix planes bounds check
   - Fixes: e83727a194b5 ("libcamera: PixelFormatInfo: Add functions stride and frameSize")
 - utils: ipu3: Fix return value check on file output
   - Fixes: 23ac77dc4a09 ("utils: ipu3: Add IPU3 raw capture unpack utility")
 - ipa: libipa: histogram: Fix documentation of constructor
   - Fixes: 1dc01bc9e6c3 ("ipa: libipa: histogram: Add transform parameter to constructor")
 - gstreamer: Fix string memory leak
   - Fixes: fc9783acc6083a ("gstreamer: Provide colorimetry <> ColorSpace mappings")
 - gstreamer: Use copied camera name
   - Fixes: 58feb69f852289 ("gst: libcamerasrc: Implement selection and acquisition")

core:
 - include: linux: Update kernel headers to version v6.7
 - libcamera: v4l2_subdevice: Enable streams API when supported
 - libcamera: base: signal: Update Qt documentation link to Qt 6
 - Documentation: Update Qt documentation links to Qt 6
 - test: gstreamer: Use env instead of registry edit
 - libcamera: Remove empty formats.c
 - libcamera: formats: Add 16-bit mono format
 - libcamera: formats: Fix sort ordering of R10_CSI2P
 - libcamera: bayer_format: Add Y12 to bayerToFormat
 - libcamera: v4l2_subdevice: Explain sort order of formatInfoMap
 - libcamera: object: Fix thread-bound reference in documentation
 - libcamera: signal: Replace object.h inclusion with forward declatation
 - test: object-delete: Test deferred delete just before thread stops
 - libcamera: thread: Ensure deferred deletion of all objects before stopping
 - test: event-thread: Destroy Object from correct thread context
 - test: message: Remove incorrect slow receiver test
 - test: message: Destroy Object from correct thread context
 - test: signal-threads: Destroy Object from correct thread context
 - test: timer-thread: Move timer start from wrong thread to separate test
 - test: timer-thread: Destroy Object from correct thread context
 - libcamera: object: Document and ensure Object deletion constraints
 - libcamera: object: Add and use thread-bound assertion
 - utils: mojom: Fix build error caused by the mojom tool update
 - include: linux: Add RKISP1_V_IMX8MP version
 - libcamera: utils: Add to_underlying() helper function
 - libcamera: Use utils::to_underlying()
 - libcamera: formats: Fix typos in PixelFormatInfo documentation
 - utils: checkstyle.py: Don't presume python3 location
 - utils: checkstyle.py: Update LogCategoryChecker regexp
 - utils: rkisp1: gen-csc-table.py: Don't presume python3 location
 - libcamera: formats: Fix planes bounds check
 - utils: ipu3: Fix return value check on file output
 - README.rst: Report py dependencies
 - meson_options: Autodetect pycamera support
 - libcamera: controls: Fix typo on thermal
 - guides: pipeline-handler: Fix controlInfo_ initialization
 - libcamera: v4l2_subdevice: Add 14-bit Bayer formats
 - utils: checkstyle.py: Add Co-developed-by to known_trailers
 - utils: checkstyle.py: Fix known_trailers sort order
 - libcamera: framebuffer_allocator: Move from argument in constructor
 - libcamera: framebuffer_allocator: Use default destructor
 - libcamera: framebuffer_allocator: Remove entry if allocation fails
 - libcamera: controls: Add policy parameter to ControlList::merge()
 - libcamera: v4l2_subdevice: Rename V4L2SubdeviceFormatInfo
 - libcamera: v4l2_subdevice: Add code member to MediaBusFormatInfo
 - libcamera: v4l2_subdevice: Expose media bus format info as internal API
 - libcamera: v4l2_subdevice: Extend MediaBusFormatInfo with metadata formats
 - libcamera: v4l2_subdevice: Drop V4L2SubdeviceFormat::bitsPerPixel()
 - libcamera: v4l2_subdevice: Rename V4L2SubdeviceFormat::mbus_code to code
 - libcamera: v4l2_subdevice: Add stream support to get/set functions
 - libcamera: v4l2_subdevice: Replace Routing::toString() with operator<<()
 - libcamera: v4l2_subdevice: Add V4L2Subdevice::Route structure
 - libcamera: camera_sensor: Move related classes to subdirectory
 - libcamera: camera_sensor: Drop updateControlInfo() function
 - libcamera: camera_sensor: Reorder functions
 - libcamera: camera_sensor: Test for read-only HBLANK with READ_ONLY flag
 - libcamera: camera_sensor: Expose the Bayer order
 - checkstyle: Work around bug in difflib
 - utils: tuning: readme: Improve names of dependency packages
 - libcamera: internal: Move dma_heaps.[h, cpp] to common directories
 - libcamera: dma_heaps: extend DmaHeap class to support system heap
 - libcamera: internal: Move SharedMemObject class to a common directory
 - libcamera: shared_mem_object: Rename SIZE constant to `size'
 - libcamera: shared_mem_object: Reorganize the code and document the SharedMemObject class
 - libcamera: software_isp: Add SwStatsCpu class
 - libcamera: software_isp: Add Debayer base class
 - libcamera: software_isp: Add DebayerCpu class
 - libcamera: Introduce SoftwareIsp
 - libcamera: swstats_cpu: Add support for 8, 10 and 12 bpp unpacked bayer input
 - libcamera: debayer_cpu: Add support for 8, 10 and 12 bpp unpacked bayer input
 - libcamera: debayer_cpu: Add BGR888 output support
 - libcamera: Add "Software ISP benchmarking" documentation
 - libcamera: software_isp: Apply black level compensation
 - Documentation: coding-style: Clean up header guard style
 - utils: checkstyle.py: Use r'' strings for regular expressions
 - utils: checkstyle.py: Drop period at end of Doxygen one liners
 - libcamera: device_enumerator: Fix spell error
 - libcamera: Fix output spelling error
 - libcamera: utils: Avoid infinite recursion with strtod()
 - libcamera: shared_mem_object: Fix compilation with uClibc
 - meson: Deprecate bitwise operations between different enumeration type
 - Revert "meson: Deprecate bitwise operations between different enumeration type"
 - test: Don't add current build directory to include path
 - libcamera: controls: Generate enum value-name maps
 - libcamera: Drop file name from header comment blocks
 - libcamera: Drop file name from header comment blocks in templates
 - libcamera: Drop remaining file name from header comment blocks
 - test: gstreamer: Simplify single stream test
 - Documentation: Add option to treat Doxygen warnings as errors
 - libcamera: camera_manager: Add environment variable to order pipelines match
 - include: linux: Add RGB48 formats
 - libcamera: formats: Add RGB48 formats
 - include: linux: Add PiSP specific image and config buffer formats
 - libcamera: formats: Add PiSP specific image and config buffer formats
 - libcamera: v4l2_subdevice: Add missing MEDIA_BUS_FMT_xxxx16_1X16 info

pipeline:
 - pipeline: rpi: Always initialize the embedded buffer in tryRunPipeline
 - pipeline: rpi: vc4: Use an unpacked format if no packed one is available
 - pipeline: simple: Add support for MediaTek MT8365 platforms
 - libcamera: pipeline: Add Mali-C55 ISP pipeline
 - libcamera: pipeline: simple: fix size adjustment in validate()
 - libcamera: pipeline: simple: Rename converterBuffers_ and related vars
 - libcamera: pipeline: simple: Enable use of Soft ISP and Soft IPA
 - ipu3: Use posix basename
 - pipeline: rpi: Avoid duplicating size range for the same pixel format
 - libcamera: pipeline: Rename pipelines to a shorter name
 - libcamera: pipeline: Add a get factory by name helper

ipa:
 - libipa: camera_sensor_helper: Mark createInstance() with override
 - utils: ipc: extract-docs: Fix escape characters in regex
 - ipa: rkisp1: agc: Wrap variable length C arrays in spans
 - ipa: rkisp1: Store hardware parameters in IPA context
 - ipa: rkisp1: Fix histogram weights configuration
 - ipa: rkisp1: Support the i.MX8MP ISP version
 - ipa: rpi: cam_helper: Extend embedded data parsing to RAW14 modes
 - utils: ipc: Fix event functions with no parameters
 - utils: ipc: Fix async main interface functions with no parameters
 - libcamera: ipa: Add Soft IPA
 - libcamera: libipa: camera_sensor: Add Sony IMX283 sensor properties
 - libcamera: libipa: camera_sensor: Add Sony IMX335 sensor properties
 - libcamera: libipa: camera_sensor: Add Sony IMX415 sensor properties
 - ipa: libipa: Allow creation of empty Histogram
 - ipa: libipa: Add ExposureModeHelper
 - ipa: libipa: Add AgcMeanLuminance base class
 - ipa: ipu3: Derive ipu3::algorithms::Agc from AgcMeanLuminance
 - ipa: ipu3: Remove bespoke AGC functions from IPU3
 - ipa: rkisp1: Derive rkisp1::algorithms::Agc from AgcMeanLuminance
 - ipa: rkisp1: Remove bespoke Agc functions
 - ipa: libipa: histogram: Add transform parameter to constructor
 - ipa: rpi: Fix for incorrectly reported max shutter speed
 - ipa: rkisp1: agc: Fix histogram construction
 - ipa: libipa: histogram: Fix documentation of constructor
 - ipa: rpi: Add HDR support
 - ipa: rpi: Add accessor function for monoSensor_

apps:
 - gstreamer: Add meson devenv support
 - apps: common: dng_writer: Add a default case for switch-case on a modulo
 - doc: gstreamer: Add missing queues
 - gstreamer: Map R8/R16 pixel format
 - gstreamer: Map 10/12/14/16 bayer formats supports
 - cam: capture_script: Make parseRectangles work for non-array
 - apps: lc-compliance: Check that requests complete successfully
 - apps: lc-compliance: Fix typo in comment
 - apps: lc-compliance: Re-organize source directory
 - android: camera_device: Save capture settings unconditionally
 - v4l2: Unset _TIME_BITS in addition to _FILE_OFFSET_BITS
 - v4l2: meson: Keep defines sorted alphabetically
 - apps: cam: Add support for PPM output format
 - android: camera_device: Always clear descriptors_ in stop()
 - apps: cam: Fix C++20 deprecation warning
 - apps: qcam: Use standard key sequence for quit action
 - gstreamer: Fix string memory leak
 - gstreamer: Use copied camera name

Acked-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>

libcamera v0.2.0

ABI Compliance:

abi-compliance-checker reports  94.6% binary compatibilty and 97.6% source
compatibility between 0.1.0 and 0.2.0. The SONAME has been updated accordingly
and applications must be relinked against this version of libcamera.

 - Binary compatibility: 94.6%
 - Source compatibility: 97.6%
 - Total binary compatibility problems: 5, warnings: 2
 - Total source compatibility problems: 3, warnings: 3

The key ABI/API differences here are:

 - AeFlicker

   The control "SceneFlicker" has been removed and replaced by
   AeFlickerMode, AeFlickerDetected and AeFlickerPeriod.

 - struct CameraConfiguration

   Field transform has been removed from the middle position of this structural type.
   Field orientation has been added at the middle position of this structural type.
   Field sensorConfig has been added at the middle position of this structural type.
   Size of this type has been changed from 40 bytes to 96 bytes.

Bugs:

The following bugs are resolved with this release:

 https://bugs.libcamera.org:
 - Bug 91 - libcamerasrc is missing EOS handling
 - Bug 199 - Install error on Ubuntu for Orange Pi 5
 - Bug 205 - ipa_proxy_worker.cpp fails to compile if an interface function has
             two arguments of SharedFD type
 - Bug 206 - Fails to build with Python 3.12

 https://github.com/raspberrypi/libcamera/issues:
 - Assertion '!this->empty()' failed in libcamera::utils::Duration - libcamera-tools 0.0.5-1 #64

Integration overview:

core:
 - utils: checkstyle.py: Treat Malformed trailers as a CommitIssue
 - utils: checkstyle.py: Initialise staged trailers
 - utils: checkstyle.py: Derive Amendment from Commit
 - utils: checkstyle.py: Check trailers for Amendment commits
 - libcamera: controls: Add controls for AEC/AGC flicker avoidance
 - libcamera: yaml: Increase the YAML parser limit
 - utils: checkstyle.py: Extract title and trailers with one command
 - meson: Correctly locate libc++
 - Documentation: theme: Fix compilation with Sphinx >= 7.0.0
 - libcamera: Remove duplicated SortIncludes in `.clang-format`
 - libcamera: stream: Document stride will be 0 for compressed formats
 - README.rst: Drop recommendation to install meson using pip3
 - meson: Don't set _FORTIFY_SOURCE for ChromeOS
 - meson: Simplify check for _FORTIFY_SOURCE
 - libcamera: formats: Fix typo in YV444 V4L2PixelFormat listing
 - Documentation: Introduce Camera Sensor Model
 - libcamera: camera: Introduce SensorConfiguration
 - libcamera: camera_sensor: Support SensorConfiguration
 - libcamera: converter: A few fixes to ConverterFactoryBase documentation
 - libcamera: converter: drop unnecessary #include directive
 - utils: update-kernel-headers: Support git worktrees
 - libcamera: camera_sensor: Cache rotationTransform_
 - libcamera: camera: Introduce Orientation
 - Documentation: Add figures to document Orientation
 - libcamera: properties: Make 'Rotation' the mounting rotation
 - libcamera: transform: Add functions to convert Orientation
 - libcamera: transform: Invert operator*() operands
 - libcamera: transform: Add operations with Orientation
 - test: Add unit test for Transform and Orientation
 - libcamera: Use CameraConfiguration::orientation
 - libcamera: camera_sensor: Cache mounting orientation instead of transform
 - libcamera: transform: Fold transformToOrientation() in its only caller
 - libcamera: transform: Make the transformFromOrientation() function static
 - libcamera: controls: Add controls for HDR
 - libcamera: camera_sensor: Only access V4L_CID_HBLANK if existing
 - Documentation: Add code of conduct
 - Documentation: code-of-conduct: Convert to reStructuredText
 - Documentation: code-of-conduct: Add license information
 - Documentation: code-of-conduct: Add contact information
 - Documentation: contributing: Integrate the code of conduct
 - README.rst: Use code directive for all code examples
 - Documentation: Fix list indentation
 - controls: Add vendor control/property support to generation scripts
 - controls: Update argument handling for controls generation scripts
 - build: controls: Rework how controls and properties are generated
 - libcamera: control: Add vendor control id range reservation
 - libcamera: controls: Use vendor tags for draft controls and properties
 - documentation: Document vendor specific controls and properties handling
 - README.rst: Drop indirect dependencies on Qt5 packages
 - README.rst: Document dependencies for the Python bindings
 - meson_options: Sort options alphabetically
 - meson: Tag all installed files
 - test: log: log_process: Log an error when failing due to incorrect message
 - test: log: log_process: Fix uninitialized variable on process exit failure
 - test: log: log_process: Improve debugging on process exit failures
 - test: log: log_process: Increase process exit timeout
 - test: ipc: unixsocket: Increase process exit timeout
 - test: gstreamer: Remove videoconvert element from pipeline
 - README.rst: Add missing libgtest-dev dependency for lc-compliance
 - meson: Replace hack with usage of '@BASENAME@'
 - libcamera: camera: Fix unused variable compiler warning
 - Documentation: camera-sensor-model: Support Sphinx < 2.0
 - libcamera: camera_sensor: Add OV64A40 sensor properties
 - utils: ipc: Fix deserialization of multiple fd parameters
 - libcamera: device_enumerator: ensure deviceNode is not empty
 - utils: ipc: mojom_libcamera_generator.py: Fix Python warning
 - libcamera: framebuffer_allocator: Remove unnecessary `clear()`
 - hooks: pre-push: Disable interpretation of escape sequences
 - libcamera: geometry: Correct doxygen reference to classes
 - utils: update-mojo.sh: Properly remove old sources
 - utils: update-mojo.sh: Exit immediately on error
 - utils: update-mojo.sh: Change to the libcamera source directory
 - utils: update-mojo.sh: Reject a dirty libcamera tree
 - utils: update-mojo.sh: Commit the mojo update
 - utils: ipc: generate.py: Add bindings directory to Python path
 - utils: ipc: generate.py: Disable attributes checker
 - utils: ipc: Update mojo

pipeline:
 - libcamera: rpi: pipeline_base: Remove populateSensorFormats()
 - libcamera: rpi: pipeline_base: Move findBestFormat to CameraData
 - libcamera: rpi: pipeline_base: Cache sensor format
 - pipeline: rpi: Don't call toV4L2DeviceFormat() from validate()
 - pipeline: rpi: Increase buffer import count to 32
 - pipeline: rpi: Remove additional external dma buf handling logic
 - pipeline: rpi: Rename RPi::Stream::setExternalBuffer()
 - pipeline: rpi: Simplify buffer id generation
 - pipeline: rpi: Reset the frame lengths queue during configure
 - libcamera: rpi: Handle SensorConfiguration
 - libcamera: rpi: Allow platformValidate() to adjust format strides
 - libcamera: rpi: Fix wrong comment indentation
 - libcamera: rpi: Make isRaw/isYuv/isRgb static functions
 - libcamera: rpi: Cache rawStreams and outStreams
 - libcamera: rpi: Add some helpers to PipelineHandlerBase
 - libcamera: rpi: Simplify validate() and configure() for RAW streams
 - libcamera: rpi: Change default stream formats
 - libcamera: rpi: Simplify validate() and configure() for YUV/RGB streams
 - pipeline: rpi: Add RequiresMmap flag to RPi::Stream
 - pipeline: rpi: Add Recurrent and Needs32bitConv flags to RPi::Stream
 - pipeline: rpi: Add SharedMemObject class
 - pipeline: rpi: Add SW downscale status to RPi::Stream
 - pipeline: rpi: Move flip handling validation code
 - pipeline: rpi: Make color space members in RPiCameraConfiguration public
 - pipeline: rpi: vc4: Allocate more embedded data buffers
 - pipeline: rpi: Remove unused variable
 - pipeline: rpi: vc4: Fix drop frame bug when no ISP streams are configured
 - pipeline: rpi: Add some useful logging messages
 - libcamera: pipeline: Fix c++20 compile warning
 - pipeline: rpi: Respect provided stride

ipa:
 - ipa: rpi: common: Handle AEC/AGC flicker controls
 - utils: raspberrypi: ctt: Improved color matrix fitting
 - ipa: rpi: vc4: data: Updated color matrices for RPi Cameras
 - utils: raspberrypi: ctt: Code tidying
 - ipa: rpi: Fix the reporting of Focus FoMs
 - ipa: rpi: imx290: Hide one frame on startup
 - ipa: rpi: agc: Fetch AWB status in process method, not prepare
 - ipa: rpi: agc: Filter exposures before dealing with digital gain
 - ipa: rpi: agc: Split AgcStatus into AgcStatus and AgcPrepareStatus
 - ipa: rpi: vc4: Make the StatisticsPtr construction clearer
 - ipa: rpi: histogram: Add interBinMean()
 - ipa: rpi: agc: Reorganise code for multi-channel AGC
 - ipa: rpi: agc: Implementation of multi-channel AGC
 - ipa: rpi: agc: Add AgcChannelConstraint class
 - ipa: rpi: agc: Use channel constraints in the AGC algorithm
 - ipa: rpi: Fix segfault when parsing invalid json file
 - ipa: rpi: Fix frame count logic when running algorithms
 - ipa: rpi: Avoid skipping IPAs on the first frame after the drop frames
 - ipa: rpi: Add IpaBase::platformStart() member function
 - mojom: pipeline: ipa: rpi: Add fields for PiSP objects
 - ipa: rpi: Add try_lock() to RPiController::Metadata
 - ipa: rpi: Add statsInline to the Controller hardware description
 - ipa: rpi: Add PiSP definitions to the Controller hardware description
 - ipa: rpi: Prepare ALSC for PiSP support
 - ipa: rpi: Prepare AWB for PiSP support
 - ipa: rpi: Add new algorithms for PiSP
 - build: ipa: Fix bug in building multiple IPA interfaces with the same mojom file
 - ipa: rpi: agc: Add an AGC stable region
 - ipa: rpi: contrast: Allow adaptive contrast enhancement to be disabled
 - ipa: rpi: denoise: Support different denoise configurations
 - ipa: rpi: agc: Avoid overwriting caller's statistics pointer
 - ipa: rpi: agc: When AGC channels are changed, start with the 1st channel
 - ipa: rpi: hdr: Add the ability to alter the LSC table
 - ipa: rpi: alsc: Do not re-read the alsc.status metadata
 - ipa: rpi: agc: Allow AGC channels to avoid using "fast desaturation"
 - ipa: rpi: vc4: Move denoise control handling into the VC4 derived IPA
 - ipa: rpi: agc: Fetch AWB status in the prepare method
 - ipa: rpi: agc: Make AGC controls affect all channels
 - ipa: rpi: alsc: Do not allow zero colour ratio statistics
 - ipa: rpi: agc: Fix bug where AeLocked was never getting set
 - ipa: rpi: cac: Minor code improvements and tidying
 - ipa: rpi: Add hardware line rate constraints
 - ipa: rpi: Allow the mean of an empty histogram interval
 - ipa: rpi: black_level: Add an initialValues method
 - ipa: rpi: awb: Add an initialValues method
 - utils: raspberrypi: ctt: Improve the Macbeth Chart search reliability
 - build: controls: Add Raspberry Pi vendor specific controls
 - ipa: vc4: Implement the StatsOutputEnable vendor control
 - ipa: rpi: Provide a Camera Helper for the OV64A40
 - libipa: camera_sensor_helper: Add OV64A40 helper
 - ipa: rpi: vc4: Add OV64A40 tuning files
 - ipa: rpi: Implement HDR control
 - ipa: rpi: vc4: data: Update tuning files for HDR

apps:
 - android: camera_device: Fix requestedStream handling
 - py: Add the SensorConfiguration class
 - py: gen-py-controls: Remove SceneFlicker workaround
 - apps: qcam: Add support for RGB565
 - py: libcamera: Define and use Orientation
 - apps: cam: Add option to set stream orientation
 - py: cam: Add option to set stream orientation
 - gstreamer: Implement element EOS handling
 - gstreamer: Fix unused variable error
 - test: gstreamer: Fix indentation in comments
 - gstreamer: Move negotiation logic to separate function
 - gstreamer: Add GstLibcameraSrcState::clearRequests method
 - gstreamer: Implement renegotiation
 - lc-compliance: Set minimum version for gtest dependency
 - gstreamer: Support for pre-1.16 GstEvent
 - apps: lc-compliance: Fix source file ordering in meson.build

Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>

libcamera v0.1.0

ABI Compliance:

abi-compliance-checker reports 99% binary compatibility and 81.4% source
compatibilty between version 0.0.5 and 0.1.

 - Binary compatibility: 99%
 - Source compatibility: 81.4%
 - Total binary compatibility problems: 4, warnings: 2
 - Total source compatibility problems: 165, warnings: 7

Now that we have funtional ABI validation, the soname has been updated from
libcamera.so.0.0.5 to libcamera.so.0.1.

Future releases will now maintain the same soname until an ABI breakage is
detected to reduce the repackaging and rebuilding of other components that may
use libcamera. The abi-compatibility report can now be generated with the new
utility './utils/abi-compat.sh'.

Key differences here are due to preventing the installation of internal and
private headers in the packaging process, and most of this API compatibility
should not be visible to applications with the exception of:

- Camera::generateConfiguration ( StreamRoles const& roles )

  The StreamRoles type definition has been removed. This is now handled as a
  Span<StreamRole> to prevent unnecessary allocations and copies.

- CameraManager::addCamera ( std::shared_ptr<struct Camera> camera, std::vector<unsigned long>const& devnums )
- CameraManager::get ( dev_t devnum )
- CameraManager::removeCamera ( std::shared_ptr<struct Camera> camera )

  These functions of the CameraManager were for use exclusively by the V4L2
  adaptation layer, and not intended for use by applications. This has now been
  reworked to use the new SystemDevices and the redundant functions removed.

The ABI/API breakages have been introduced by:

  5ca0c9276f28 ("libcamera: CameraManager: Remove ::get(dev_t)")
  26a4b83d1b94 ("libcamera: Remove `StreamRoles` alias")
  63966ae587d7 ("libcamera: base: Do not install private headers")

Core:
 - libcamera: v4l2_videodevice: Use O_CLOEXEC when exporting DMA buffers
 - libcamera: ipa_manager: Allow IPA loading in nested subdirs
 - meson: Fix usage of overwritten pipeline variable
 - subprojects: Drop leftovers of pybind11
 - camera_sensor: ipa: core: Add CFA pattern to IPACameraSensorInfo
 - libcamera: controls: Define a default lens position behaviour
 - libcamera: internal: request: convert to pragma once
 - libcamera: camera_manager: Move private implementation to internal
 - libcamera: camera_manager: Move {add,remove}Camera to internal
 - libcamera: properties: Provide a Devices camera property
 - libcamera: pipeline: Register device numbers with camera
 - libcamera: camera_sensor: Adjust properties::Rotation
 - libcamera: meson: Allow PH to change libcamera_deps
 - libcamera: base: Move thread_annotations to private
 - libcamera: base: Do not install private headers
 - utils: ABI Compatibility checker
 - meson: Use x.y soname versioning
 - libcamera: camera: Take span of StreamRole instead of vector
 - libcamera: Remove `StreamRoles` alias
 - utils: ipu3-capture.sh: Fix the script to work with recent media-ctl versions
 - Documentation: Add predefined macros from config.h to Doxyfile
 - utils: checkstyle: Add __repr__ method to CommitFile class
 - utils: checkstyle: Support running checkers selectively
 - utils: checkstyle: Don't include commit ID in commit title
 - utils: checkstyle: Add trailers checker
 - tests: gstreamer: Test cameras' enumeration from GstDeviceProvider
 - meson: Fix space around colon issues
 - libcamera: Add option to configure udev support
 - libcamera: CameraManager: Remove ::get(dev_t)
 - tests: gstreamer: Fix compiler error with gcc 8.4.0

ipa:
 - meson: ipa: Add mapping for pipeline handler to mojom interface file
 - libcamera: ipa: Remove character restriction on the IPA name
 - ipa: meson: Allow nested IPA directory structures
 - ipa: raspberrypi: Introduce IpaBase class
 - ipa: raspberrypi: agc: Move weights out of AGC
 - ipa: rkisp1: agc: drop hard-coded analogue gain range
 - libipa: camera_sensor_helper: Add IMX327 helper
 - pipeline: rpi: ipa_base: Parse config files after platformRegister()
 - libcamera: camera_sensor: Add Sony IMX327 sensor properties
 - ipa: rpi: imx296: Small refinements to the IMX296 mono sensor tuning
 - ipa: rpi: Handle controls for mono variant sensors
 - libcamera: controls: Drop reference to IPA in controls documentation
 - libipa: camera_sensor_helper: Restore alphabetical order
 - ipa: ipu3: agc: Drop hard-codec analogue gain max
 - ipa: rkisp1: agc: Restore minimum analogue gain limit
 - pipeline: ipa: rpi: Return lens controls from ipa->configure()
 - ipa: rpi: Set lens position to hyperfocal on startup
 - ipa: rpi: tunings: Add missing short and long exposure profiles
 - ipa: rpi: agc: Use std::string instead of char arrays
 - ipa: rpi: agc: Gracefully handle missing agc modes
 - ipa: rpi: agc: Do not switch to a default if a mode is unavailable
 - ipa: rpi: imx708: Fix mode switch drop frame count
 - ipa: rpi: imx296_mono: Disable all colour shading

pipeline:
 - libcamera: pipeline: simple: Add support for ST's DCMIPP
 - pipeline: meson: Allow nested pipeline handler directory structures
 - pipeline: ipa: raspberrypi: Refactor and move the Raspberry Pi code
 - pipeline: raspberrypi: rpi_stream: Set invalid buffer to id == 0
 - pipeline: ipa: raspberrypi: Restructure the IPA mojom interface
 - pipeline: raspberrypi: Make RPi::Stream::name() return const std::string &
 - pipeline: raspberrypi: Introduce PipelineHandlerBase class
 - pipeline: raspberrypi: Add stream flags to RPi::Stream
 - libcamera: rkisp1: Generate config using main path
 - libcamera: rkisp1: Crop on ISP before downscaling
 - libcamera: rkisp1: Assign sizes to roles
 - libcamera: rkisp1: Fix enumeration of RAW formats
 - pipeline: rpi: Do not return an error from pipeline config file handling
 - libcamera: pipeline: simple: Support TI CSI-RX
 - pipeline: rpi: Account for Bayer packing when validating format

apps:
 - apps: qcam: Remove redundant check
 - v4l2: Move the v4l2 compat layer to libexec/libcamera
 - android: mm: generic: use GRALLOC_HARDWARE_MODULE_ID
 - android: mm: Stub libhardware for build tests
 - py: Fix CameraManager.version property
 - py: Move ColorSpace and Transform classes to separate files
 - py: Use exceptions instead of returning error codes
 - py: unittests.py: Add weakref helpers and use del
 - py: Move to mainline pybind11 version
 - py: Fix code formatting
 - py: unittests.py: Fix type checker warnings
 - gstreamer: Add enable_auto_focus option to the GStreamer plugin
 - gstreamer: Drop libcamera_private dependency
 - apps: Add ipa-verify application
 - v4l2: v4l2_camera_proxy: Prevent ioctl sign-extensions
 - v4l2: Use SystemDevices properties to identify cameras

Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>

libcamera v0.0.5

Bugfixes:
- meson: Ignore -Wredundant-move with gcc-13 and newer
- cam: file_sink: Workaround gcc-13 dangling-reference false positive
- libcamera: Open files with O_CLOEXEC
- meson: Fix git version parsing
- libcamera: camera_manager: Stop exponential explosive calls to createPipelineHandlers
- py: cam: Fix demosaic overflow issue
- libcamera: base: Make the registration of log categories atomic

Core:
- test: controls: control_info_map: Test default constructor
- controls: guard ControlInfoMap against nullptr idmap_
- device_enumerator_udev: Use std::string_view
- formats: Add 14-bits Bayer RAW formats
- device_enumerator_udev: Remove devnum from dependency map
- meson: libcamera: Report IPA signature method
- meson: Align handling of build metadata
- converter: Check converter validity
- Keep using syslog for isolated IPA modules
- utils: ipc: Update parser.py
- utils: checkstyle.py: Don't run commit title checker on staged commits
- framebuffer: Allow inheritance of FrameBuffer
- Remove transform from V4L2SubdeviceFormat
- libcamera: camera_sensor: Add tryFormat()
- camera_sensor: Fix typo in comment
- camera_sensor: Demote flip support message to Debug
- internal: tracepoints: Use correct include directive
- libcamera: camera: Ensure queued requests are invalid

ipa:
- doc: Clarify IPA acronym in its namespace description
- rkisp1: Add tuning files for PinephonePro sensors
- rkisp1: Add tuning files for Google DRU "Scarlet" sensors
- rkisp1: lsc: Fix integer division error
- libipa: Add OV2685 Camera Sensor Helper
- libipa: Add OV5647 Camera Sensor Helper
- raspberrypi: agc: Add "shadows" constraint mode
- raspberrypi: generalise algorithms
- raspberrypi: Fix default frame durations calculation
- raspberrypi: Ensure shutter speed and gain are clipped in the AGC
- raspberrypi: Use the new sensor limits fields in CameraMode
- raspberrypi: Add sensor mode limits to CameraMode
- raspberrypi: Fix crash under LTO
- raspberrypi: imx296: Minor tuning updates
- raspberrypi: agc: Fix overflow in Y value calculation
- raspberrypi: Better heuristics for calculating Unicam timeout
- raspberrypi: Generalise statistics
- raspberrypi: Change Unicam timeout handling

pipeline:
- simple: Validate transform
- imx8-isi: Remove mbusCode from formatsMap_
- imx8-isi: Automatically select media bus code
- imx8-isi: Split Bayer/YUV config generation
- imx8-isi: Break out RAW/YUV format selection
- raspberrypi: Iterate over all Unicam instances in match()
- raspberrypi: Add a Unicam timeout override config options
- raspberrypi: Always use ColorSpace::Raw for raw streams
- raspberrypi: Drop unused code
- ipu3: Drop unused code

apps:
 - cam: kms_sink: Drop unique_ptr<> from DRM::AtomicRequest
 - cam Return std::optional<> from StreamKeyValueParser::parseRole()
 - android: jpeg: Add JEA implementation

ABI Compliance:

 * abi-compliance-checker reports 98.6% ABI and 100% API compatibility with
   with v0.0.4

  Total binary compatibility problems: 1, warnings: 1
  Total source compatibility problems: 0, warnings: 0

 - First virtual method ~__dt ( ) has been added to this class.
   1) The layout of type structure has been shifted by 8 bytes by the added v-table pointer.
   2) Size of class has been increased by 8 bytes.

affected symbols: 6 (1.4%)
  FrameBuffer::releaseFence ( )
  FrameBuffer::setCookie ( uint64_t cookie )
  FrameBuffer::cookie ( )
  FrameBuffer::planes ( )
  FrameBuffer::request ( )
  FrameBuffer::metadata ( )

This ABI breakage was introduced by:
  4843bfa66dc1 ("libcamera: framebuffer: Allow inheritance of FrameBuffer")

Acked-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>

libcamera v0.0.4

Bugfixes:
 * libcamera: yaml_parser: Use C locale
 * libcamera: base: utils: Support C libraries lacking locale support
 * py: cam.py: Fix duplicate metadata output if more than one stream
 * libcamera: camera: Fix validateColorSpaces to choose main colour space
 * pipeline: raspberrypi: Fix handling of colour spaces

Core:
 * test: Fix/Enable testing with ASan
 * test: Remove redundant pipeline tests
 * meson: Only build pipeline handlers needed in host architecture
 * meson: Add 'all' choice to pipelines option
 * utils: checkstyle.py: Add commit title checker
 * libcamera: ipa_module: Relax ipaModuleInfo symbol size check
 * pipeline: Support configuration file paths

ipa:
 * camera_sensor: Improve h/v flip handling
 * camera_sensor: Add AR0521 Sensor support
 * camera_sensor: Add OV4689 Sensor support
 * camera_sensor: Add support for OmniVision OV8858
 * raspberrypi: Support Autofocus with PDAF
 * raspberrypi: Support for the Sony IMX708 sensor
 * rkisp1: Raise maximum analogue gain

pipeline:
 * raspberrypi: Support parameters from a configuration file
 * raspberrypi: Add a parameter to disable startup drop frames
 * libcamera: rkisp1: Add support for Transform

apps:
 * gstreamer: Add bayer8 support to libcamerasrc
 * qcam: Show string representation of pixel format

ABI Compliance:
 * abi-compliance-checker reports 100% ABI and API compatibility with
   with v0.0.3

Acked-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>

libcamera v0.0.3

Key bug fixes:

 * Segfault in the ContolInfo() constructor for an empty V4L2 menu
   Bug: https://bugs.libcamera.org/show_bug.cgi?id=167
   Fix: libcamera: v4l2_device: Workaround faulty control menus

   This resolves and prevents crashes that have occured in Pipewire when
   users connect poorly implemented UVC devices.

ABI Compliance:

abi-compliance-checker reports 100% ABI and API compatibility with with
v0.0.2, however 81e7689bb168 ("libcamera: stream: Turn StreamRole into
scoped enumeration") modifies an enum into a class enum. This may need
minor updates to applications, and didn't appear to be picked up by
abi-compliance-checker.

- See https://git.libcamera.org/libcamera/libcamera.git/commit/?id=81e7689bb168a for more details.

Highlights:

Core:
 * Fix tracing when built as a subproject
 * Avoid double map lookups in framebuffer_allocator
 * Workaround faulty control menus
 * controls: Change LensPosition units to dioptres
 * camera_sensor: Add IMX519 sensor properties
 * Documentation: contributing: Add commit message guidelines
 * Declare generic converter interface

utils:
 * Add libtuning
 * Add initial libtuning script support for rkisp1 and raspberrypi.
 * checkstyle.py: Check new header file on new and renamed meson.build files

ipa:
 * Move IPA sensor controls validation to CameraSensor (IPU3/RKISP1)

rkisp1:
 * Support FrameDurationLimits control for FrameRate management
 * Support raw capture (IPA, configuration, and runtime)
 * Add support for manual gain and exposure
 * Fix stream size validation
 * Add additional default values to controls

imx8-isi:
 * Enumerate supported stream formats
 * Set SensorTimestamp metadata

Raspberry Pi:
 * Remove generic "pause" mechanism from Algorithm
 - Remove enum BuffferMask from the mojom interface
 - Fix digital gain calculations for manual mode
 - Fix bug in IPA frame drop logic
 - imx477: Update tuning file for the latest camera modules
 - Add a "scientific" tuning for the IMX477

Apps:
 - cam: kms: Avoid 'unused-parameter' warnings
 - cam: Support parsing array controls in capture scripts
 - gstreamer: Improve control id lookups
 - lc-compliance: simple_capture: Free Requests properly

python:
 - Support controls that use an array of Rectangles
 - Expose the Request Sequence Number in Python Bindings

test:
 - Validate CameraSensor Ancillary Devices (focusLens)
 - controls: control_info: Test default def() values

Acked-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>

libcamera v0.0.2

This release contains all the work merged to libcamera over the last 5
weeks, including the following summary highlights:

Highlights:

Core:
 * New pipeline handler for the IMX ISI
 * Fixed memory leak in the logging infrastructure
 * Fixed meson support for 0.56
 * Additional Thread Safety annotations added throughout
 * Add a release method to pipeline handlers to support
   freeing resources when a camera is released, but not
   deleted.
 * Group test applications under src/apps
 * Make libdl optional to support Android builds

Application layers:
 * Added DNG File output to cam
 * Fixes for building against Android
 * gstreamer framerate control and negotiation

IPA:
 * Support setting metadata directly from (libipa) algorithms
 * Set AGC and AWB metadata for both RKISP1 and IPU3.
 * Support for enum serialization and Flags
 * Support multiple lens shading tables for different colour
   temperatures on RKISP1/i.MX8MP.

Raspberry Pi IPA:
 * Full line length control
 * Better HBLANK synchronisation and full line length control
 * Support ov9281 as ov9281_mono
 * Update colour temperature whenever manual gains change

abi-compliance-checker tells me that this release is 100% abi compatible
with v0.0.1.

Acked-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>

libcamera v0.0.1

This patch release commences the package release procedures for the
project.

Initial releases will include a bump to the patch (0.0.x) version
number, as well as a corresponding increment to the soname.

Acked-by: Kieran Bingham <kieran.bingham@ideasonboard.com>
Signed-off-by: Kieran Bingham <kieran.bingham@ideasonboard.com>

Repository creation