rstdoc: update Invert, add ShowCRC32, update readme_history.txt

Author: pinterf

distrib/Readme/readme_history.txt

@@ -8,8 +8,30 @@ For online documentation check https://avisynthplus.readthedocs.io/en/latest/
 
 Actual:
 https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/changelist376.html
-20260430 3.7.5.rXXXX (pre 3.7.6)
+
+20260506 3.7.5.r4589 (pre 3.7.6)
 --------------------------------
+TL;DR (since r4565):
+- Layer/Overlay/Merge: weighted and masked-merge kernels unified into a shared family (C/SSE4.1/AVX2/NEON);
+  SIMD chroma-placement mask downsampling for 4:2:0/4:2:2/4:1:1 sources;
+  "placement" parameter for Overlay "blend" (new) and Layer (new "top_left" option added):
+  values are "mpeg2" (default), "mpeg1", "top_left".
+- Layer: new "mulovr" mode (Overlay-compatible YUV multiply with luma-driven chroma desaturation);
+  new "top_left" placement option; legacy MMX/iSSE removed.
+- Merge (non-masked) C/SIMD integer arithmetic unified.
+- SIMD additions: AVX2/SSE4.1/NEON float chroma-mask row preparation; AVX2 float weighted merge.
+- Further optimizations: Invert (AVX2/SSE2), ExtractX (direct packed-RGB path),
+  ConvertBits int depth-reduce C loop, PlanarRGB(A)->RGB32/64 (AVX2).
+- SetFilterProp: conditional injection by filter argument value; capture mode;
+  SetFilterPropPassthrough helper; GetFilterProps() diagnostics function.
+  See also: https://github.com/AviSynth/AviSynthPlus/issues/393
+  and the online documentation at https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/corefilters/setfilterprop.html
+
+- Bug fixes: Text("\n") crash on zero-length lines; Layer no longer silently rounds odd x/y
+  offsets on subsampled YUV — accepts them as-is like Overlay; ceiling formula for
+  non-grid-aligned positions — last chroma column/row is no longer skipped in either filter.
+Full change list: https://avisynthplus.readthedocs.io/en/latest/avisynthdoc/changelist376.html
+
 - Layer: add "mulovr" mode — Overlay-style multiply for YUV(A) formats only (RGB raises an error).
   The overlay luma (Y) plane drives darkening of all base planes: dark overlay Y pulls base luma toward
   black and simultaneously desaturates base chroma toward neutral (128d for 8-bit integer, 0.0 for float).

distrib/docs/english/source/avisynthdoc/changelist376.rst

@@ -263,6 +263,16 @@ Bugfixes
   in v3.7.5, intermediate calculations could slightly exceed the boundary (e.g., 360.00000000000006
   when interpolating from 0 to 360.0 in 564 steps), requiring this clamp to prevent out-of-range errors.
 - Fix: ``Text`` filter crash when input contains a zero-length line (e.g. ``Text("\n")``).
+- Fix: "Layer"/"Overlay" subsampled YUV chroma alignment:
+
+  * "Layer": x/y offsets that are not aligned to the chroma grid (e.g. odd x for 4:2:0/4:2:2)
+    are now accepted as-is, matching "Overlay" behaviour.  Previously they were silently snapped
+    to the nearest aligned value; that snap also incorrectly shifted the luma start position,
+    causing a one-pixel luma displacement that did not occur in Overlay.
+  * "Layer"/"Overlay": the last chroma column/row of the blend region is now correctly processed
+    when the overlay position is not chroma-grid-aligned.  A ceiling formula replaces the old
+    floor division, which caused the rightmost column or bottom row of affected chroma pixels
+    to be skipped.
 
 
 Optimizations
@@ -349,6 +359,8 @@ Documentation
   See :ref:`Ubuntu->Windows mingw crosscompilation<compiling_avsplus_crosscompiling2>`
 - Add :doc:`ColorBarsUHD <./corefilters/colorbarsuhd>`
 - Add :doc:`SetFilterProp / SetFilterPropPassthrough <./corefilters/setfilterprop>`
+- Add ``ShowCRC32`` documentation to :doc:`showframes <./corefilters/showframes>`
+  (filter exists since 3.7.0; rst page was not updated at the time).
 - Update :doc:`Layer <./corefilters/layer>` with ``"mulovr"`` mode, ``"top_left"`` placement
   option, and related chroma-placement refactoring notes.
 - Update :doc:`Overlay <./corefilters/overlay>` with ``"placement"`` parameter for ``"blend"`` mode.

distrib/docs/english/source/avisynthdoc/corefilters/invert.rst

@@ -33,6 +33,36 @@ Syntax and Parameters
     Default: "RGBA" if input clip is RGB, "YUVA" if input clip is YUV.
 
 
+Notes
+-----
+
+**Integer formats (8–16 bit)**
+
+*Luma and RGB channels* are inverted by ``max - value`` (equivalent to XOR with the maximum
+sample value, e.g. ``255 - value`` for 8-bit).
+
+*Chroma channels (U/V) in planar YUV* are inverted by reflecting around the neutral value:
+``result = 2 × neutral - value``, clamped to the valid range.
+For 8-bit this means ``256 - value``:
+
+- sample value 1 → 255, value 255 → 1
+- neutral value 128 → 128 (unchanged)
+- value 0 has no proper inverse (it would require 256, which is out of range) and is mapped to 255
+
+**32-bit float**
+
+*Luma and RGB channels* are inverted as ``1.0 - value``, reflecting around the midpoint of
+the ``[0.0, 1.0]`` luma range.  No clamping is applied.
+
+*Chroma channels (U/V)* are negated: ``result = -value``.
+In AviSynth+ 32-bit float YUV the chroma planes are signed, ranging from ``-0.5`` to ``+0.5``
+with ``0.0`` as the neutral.  Negation is an exact mirror around that neutral, with no clamping
+needed (``0.5 → -0.5``, ``-0.5 → 0.5``, ``0.0 → 0.0``).
+
+**YUY2** still inverts chroma by XOR with 255 (``255 - value``), which does *not* preserve
+the neutral value.  Convert to a planar format first if correct chroma inversion is needed.
+
+
 Examples
 ---------
 
@@ -56,6 +86,13 @@ Changelog
 +-----------------+--------------------------------------------------------+
 | Version         | Changes                                                |
 +=================+========================================================+
+| AviSynth+ 3.7.6 | Planar YUV: U/V chroma inversion changed from XOR with |
+|                 | maximum to pivot around neutral (``256 - value`` for   |
+|                 | 8-bit). Value 0 maps to 255 (no valid inverse).        |
+|                 | YUY2 retains the old XOR behaviour.                    |
+|                 | Added proper AVX2 and SSE2 SIMD paths for planar       |
+|                 | luma and chroma.                                       |
++-----------------+--------------------------------------------------------+
 | AviSynth+ r2487 | Added support for YUV(A)/PlanarRGB(A) 8,10-16,32 bit,  |
 |                 | RGB48/64 color formats, with SSE2.                     |
 +-----------------+--------------------------------------------------------+
@@ -66,4 +103,4 @@ Changelog
 | AviSynth 2.5.3  | Initial Release.                                       |
 +-----------------+--------------------------------------------------------+
 
-$Date: 2022/03/20 16:58:20 $
+$Date: 2026/05/08 11:03:00 $

distrib/docs/english/source/avisynthdoc/corefilters/showframes.rst

@@ -2,11 +2,12 @@
 ShowFrames
 ==========
 
-Set of filters to overlay frame numbers and timecodes onto a video clip:
+Set of filters to overlay frame numbers, timecodes, and debug information onto a video clip:
 
 * `ShowFrameNumber`_ displays the frame number on each frame.
 * `ShowSMPTE`_ displays SMPTE timecodes.
 * `ShowTime`_ displays time for the current frame.
+* `ShowCRC32`_ computes and displays the CRC32 checksum of the default plane (debug filter).
 
 See the `Examples`_ section for visuals.
 
@@ -392,6 +393,107 @@ See the :ref:`ShowTime examples <ShowTime-examples>` section.
 
     Default: false
 
+.. _ShowCRC32:
+
+ShowCRC32
+---------
+
+A debug filter that computes the CRC32 checksum of the **default plane** of each frame
+and overlays the result as an 8-character uppercase hexadecimal string (e.g. ``"AB12CD34"``).
+Only the default plane is checksummed: luma (Y) for YUV clips, the green plane for planar RGB,
+or the interleaved data for packed formats such as YUY2.
+
+The text placement and scrolling behaviour are identical to `ShowFrameNumber`_.
+
+.. rubric:: Syntax and Parameters
+
+::
+
+    ShowCRC32 (clip, bool "scroll", int "offset", float "x", float "y", string "font", float "size",
+               int "text_color", int "halo_color", float "font_width", float "font_angle",
+               bool "bold", bool "italic", bool "noaa")
+
+.. describe:: clip
+
+    Source clip; all color formats supported.
+
+.. describe:: scroll
+
+    | If *true*, the checksum will be drawn only once on the video and
+      scroll from top to bottom;
+    | If *false*, it will be drawn on one side, stacked vertically as often
+      as it fits.
+
+    Default: false
+
+.. describe:: offset
+
+    Frame number offset added to the internal counter. A positive value makes the
+    display start from a later logical frame; a negative value from an earlier one.
+
+    Default: 0
+
+.. describe:: x, y
+
+    Text position. Their interpretation corresponds to :doc:`Subtitle's <subtitle>`
+    *align=4*. ``x`` and ``y`` must be used together or not at all; when present,
+    the ``scroll`` option is ignored.
+
+    Default: 0.0, 0.0
+
+.. describe:: font
+
+    Font name; can be the name of any installed Windows font.
+
+    Default: "Arial"
+
+.. describe:: size
+
+    Height of the text in pixels.
+
+    Default: 24
+
+.. describe:: text_color, halo_color
+
+    | Colors for font fill and outline respectively. Default is yellow and black.
+    | See :doc:`Subtitle <subtitle>` and the :doc:`colors <../syntax/syntax_colors>`
+      page for more information on specifying colors.
+
+    Default: $00FFFF00, $00000000
+
+.. describe:: font_width
+
+    | Set character width in logical units, to the nearest 0.125 unit.
+    | See the example section of :doc:`Subtitle <subtitle>` for an example.
+
+    Default: 0 (use Windows' default width)
+
+.. describe:: font_angle
+
+    Adjust the baseline angle of text in degrees anti-clockwise to the
+    nearest 0.1 degree.
+
+    Default: 0.0 (no rotation)
+
+.. describe:: bold
+
+    Using bold letters or not.
+
+    Default: true on Windows GDI, false otherwise (e.g. Linux)
+
+.. describe:: italic
+
+    Using italic letters or not.
+
+    Default: false
+
+.. describe:: noaa
+
+    Disables antialiasing when drawing the text.
+
+    Default: false
+
+
 Examples
 --------
 
@@ -492,6 +594,8 @@ Changelog
 +=================+=============================================================================+
 | AviSynth+ 3.7.3 | Add ``bold``, ``italic`` and ``noaa``                                       |
 +-----------------+-----------------------------------------------------------------------------+
+| AviSynth+ 3.7.0 | Added ``ShowCRC32``.                                                        |
++-----------------+-----------------------------------------------------------------------------+
 | AviSynth 2.6.0  || All functions: position (x,y) can be float (previously int) (with 0.125    |
 |                 |  pixel granularity).                                                        |
 |                 || ShowSMPTE: added drop-frame for other framerates (other than 30).          |
@@ -502,7 +606,7 @@ Changelog
 | AviSynth 2.5.6  | Added ``offset`` and other options.                                         |
 +-----------------+-----------------------------------------------------------------------------+
 
-$Date: 2023/11/03 11:15:00 $
+$Date: 2026/05/08 11:02:00 $
 
 .. _Interlaced Fieldbased:
     http://avisynth.nl/index.php/Interlaced_fieldbased