downscale.cpp.hpp

Go to the documentation of this file.

 
// BETA - NOT TESTED!!!
// VIBE CODED WITH AI
 
#include "fl/gfx/downscale.h"
#include "fl/stl/compiler_control.h"
#include "fl/stl/int.h"
 
#include "crgb.h"
#include "fl/stl/assert.h"
#include "fl/math/math.h"
#include "fl/math/xymap.h"
#include "fl/stl/noexcept.h"
 
FL_DISABLE_WARNING_PUSH
FL_DISABLE_WARNING(shift-count-overflow)
 
namespace fl {
 
void downscaleHalf(const CRGB *src, fl::u16 srcWidth, fl::u16 srcHeight,
                   CRGB *dst) FL_NO_EXCEPT {
    fl::u16 dstWidth = srcWidth / 2;
    fl::u16 dstHeight = srcHeight / 2;
 
    for (fl::u16 y = 0; y < dstHeight; ++y) {
        for (fl::u16 x = 0; x < dstWidth; ++x) {
            // Map to top-left of the 2x2 block in source
            fl::u16 srcX = x * 2;
            fl::u16 srcY = y * 2;
 
            // Fetch 2x2 block
            const CRGB &p00 = src[(srcY)*srcWidth + (srcX)];
            const CRGB &p10 = src[(srcY)*srcWidth + (srcX + 1)];
            const CRGB &p01 = src[(srcY + 1) * srcWidth + (srcX)];
            const CRGB &p11 = src[(srcY + 1) * srcWidth + (srcX + 1)];
 
            // Average each color channel
            fl::u16 r =
                (p00.r + p10.r + p01.r + p11.r + 2) / 4; // +2 for rounding
            fl::u16 g = (p00.g + p10.g + p01.g + p11.g + 2) / 4;
            fl::u16 b = (p00.b + p10.b + p01.b + p11.b + 2) / 4;
 
            // Store result
            dst[y * dstWidth + x] = CRGB((fl::u8)r, (fl::u8)g, (fl::u8)b);
        }
    }
}
 
void downscaleHalf(const CRGB *src, const XYMap &srcXY, CRGB *dst,
                   const XYMap &dstXY) FL_NO_EXCEPT {
    fl::u16 dstWidth = dstXY.getWidth();
    fl::u16 dstHeight = dstXY.getHeight();
 
    FASTLED_ASSERT(srcXY.getWidth() == dstXY.getWidth() * 2,
                   "Source width must be double the destination width");
    FASTLED_ASSERT(srcXY.getHeight() == dstXY.getHeight() * 2,
                   "Source height must be double the destination height");
 
    for (fl::u16 y = 0; y < dstHeight; ++y) {
        for (fl::u16 x = 0; x < dstWidth; ++x) {
            // Map to top-left of the 2x2 block in source
            fl::u16 srcX = x * 2;
            fl::u16 srcY = y * 2;
 
            // Fetch 2x2 block
            const CRGB &p00 = src[srcXY.mapToIndex(srcX, srcY)];
            const CRGB &p10 = src[srcXY.mapToIndex(srcX + 1, srcY)];
            const CRGB &p01 = src[srcXY.mapToIndex(srcX, srcY + 1)];
            const CRGB &p11 = src[srcXY.mapToIndex(srcX + 1, srcY + 1)];
 
            // Average each color channel
            fl::u16 r =
                (p00.r + p10.r + p01.r + p11.r + 2) / 4; // +2 for rounding
            fl::u16 g = (p00.g + p10.g + p01.g + p11.g + 2) / 4;
            fl::u16 b = (p00.b + p10.b + p01.b + p11.b + 2) / 4;
 
            // Store result
            dst[dstXY.mapToIndex(x, y)] =
                CRGB((fl::u8)r, (fl::u8)g, (fl::u8)b);
        }
    }
}
 
void downscaleArbitrary(const CRGB *src, const XYMap &srcXY, CRGB *dst,
                        const XYMap &dstXY) FL_NO_EXCEPT {
    const fl::u16 srcWidth = srcXY.getWidth();
    const fl::u16 srcHeight = srcXY.getHeight();
    const fl::u16 dstWidth = dstXY.getWidth();
    const fl::u16 dstHeight = dstXY.getHeight();
 
    const fl::u32 FP_ONE = 256; // Q8.8 fixed-point multiplier
 
    FASTLED_ASSERT(dstWidth <= srcWidth,
                   "Destination width must be <= source width");
    FASTLED_ASSERT(dstHeight <= srcHeight,
                   "Destination height must be <= source height");
 
    for (fl::u16 dy = 0; dy < dstHeight; ++dy) {
        // Fractional boundaries in Q8.8
        fl::u32 dstY0 = (dy * srcHeight * FP_ONE) / dstHeight;
        fl::u32 dstY1 = ((dy + 1) * srcHeight * FP_ONE) / dstHeight;
 
        for (fl::u16 dx = 0; dx < dstWidth; ++dx) {
            fl::u32 dstX0 = (dx * srcWidth * FP_ONE) / dstWidth;
            fl::u32 dstX1 = ((dx + 1) * srcWidth * FP_ONE) / dstWidth;
 
            fl::u64 rSum = 0, gSum = 0, bSum = 0;
            fl::u32 totalWeight = 0;
 
            // Find covered source pixels
            fl::u16 srcY_start = dstY0 / FP_ONE;
            fl::u16 srcY_end = (dstY1 + FP_ONE - 1) / FP_ONE; // ceil
 
            fl::u16 srcX_start = dstX0 / FP_ONE;
            fl::u16 srcX_end = (dstX1 + FP_ONE - 1) / FP_ONE; // ceil
 
            for (fl::u16 sy = srcY_start; sy < srcY_end; ++sy) {
                // Calculate vertical overlap in Q8.8
                fl::u32 sy0 = sy * FP_ONE;
                fl::u32 sy1 = (sy + 1) * FP_ONE;
                fl::u32 y_overlap = fl::min(dstY1, sy1) - fl::max(dstY0, sy0);
                if (y_overlap == 0)
                    continue;
 
                for (fl::u16 sx = srcX_start; sx < srcX_end; ++sx) {
                    fl::u32 sx0 = sx * FP_ONE;
                    fl::u32 sx1 = (sx + 1) * FP_ONE;
                    fl::u32 x_overlap = fl::min(dstX1, sx1) - fl::max(dstX0, sx0);
                    if (x_overlap == 0)
                        continue;
 
                    fl::u32 weight = (x_overlap * y_overlap + (FP_ONE >> 1)) >>
                                      8; // Q8.8 * Q8.8 → Q16.16 → Q8.8
 
                    const CRGB &p = src[srcXY.mapToIndex(sx, sy)];
                    rSum += p.r * weight;
                    gSum += p.g * weight;
                    bSum += p.b * weight;
                    totalWeight += weight;
                }
            }
 
            // Final division, rounding
            fl::u8 r =
                totalWeight ? (rSum + (totalWeight >> 1)) / totalWeight : 0;
            fl::u8 g =
                totalWeight ? (gSum + (totalWeight >> 1)) / totalWeight : 0;
            fl::u8 b =
                totalWeight ? (bSum + (totalWeight >> 1)) / totalWeight : 0;
 
            dst[dstXY.mapToIndex(dx, dy)] = CRGB(r, g, b);
        }
    }
}
 
void downscale(const CRGB *src, const XYMap &srcXY, CRGB *dst,
               const XYMap &dstXY) FL_NO_EXCEPT {
    fl::u16 srcWidth = srcXY.getWidth();
    fl::u16 srcHeight = srcXY.getHeight();
    fl::u16 dstWidth = dstXY.getWidth();
    fl::u16 dstHeight = dstXY.getHeight();
 
    FASTLED_ASSERT(dstWidth <= srcWidth,
                   "Destination width must be <= source width");
    FASTLED_ASSERT(dstHeight <= srcHeight,
                   "Destination height must be <= source height");
    const bool destination_is_half_of_source =
        (dstWidth * 2 == srcWidth) && (dstHeight * 2 == srcHeight);
    // Attempt to use the downscaleHalf function if the destination is half the
    // size of the source.
    if (destination_is_half_of_source) {
        const bool both_rectangles = (srcXY.getType() == XYMap::kLineByLine) &&
                                     (dstXY.getType() == XYMap::kLineByLine);
        if (both_rectangles) {
            // If both source and destination are rectangular, we can use the
            // optimized version
            downscaleHalf(src, srcWidth, srcHeight, dst);
        } else {
            // Otherwise, we need to use the mapped version
            downscaleHalf(src, srcXY, dst, dstXY);
        }
        return;
    }
 
    downscaleArbitrary(src, srcXY, dst, dstXY);
}
 
} // namespace fl
 
FL_DISABLE_WARNING_POP