• Jump To … +
    ./demo/canvas-001.js ./demo/canvas-002.js ./demo/canvas-003.js ./demo/canvas-004.js ./demo/canvas-005.js ./demo/canvas-006.js ./demo/canvas-007.js ./demo/canvas-008.js ./demo/canvas-009.js ./demo/canvas-010.js ./demo/canvas-011.js ./demo/canvas-012.js ./demo/canvas-013.js ./demo/canvas-014.js ./demo/canvas-015.js ./demo/canvas-016.js ./demo/canvas-017.js ./demo/canvas-018.js ./demo/canvas-019.js ./demo/canvas-020.js ./demo/canvas-021.js ./demo/canvas-022.js ./demo/canvas-023.js ./demo/canvas-024.js ./demo/canvas-025.js ./demo/canvas-026.js ./demo/canvas-027.js ./demo/canvas-028.js ./demo/canvas-029.js ./demo/canvas-030.js ./demo/canvas-031.js ./demo/canvas-032.js ./demo/canvas-033.js ./demo/canvas-034.js ./demo/canvas-035.js ./demo/canvas-036.js ./demo/canvas-037.js ./demo/canvas-038.js ./demo/canvas-039.js ./demo/canvas-040.js ./demo/canvas-041.js ./demo/canvas-042.js ./demo/canvas-043.js ./demo/canvas-044.js ./demo/canvas-045.js ./demo/canvas-046.js ./demo/canvas-047.js ./demo/canvas-048.js ./demo/canvas-049.js ./demo/canvas-050.js ./demo/canvas-051.js ./demo/canvas-052.js ./demo/canvas-053.js ./demo/canvas-054.js ./demo/canvas-055.js ./demo/canvas-056.js ./demo/canvas-057.js ./demo/canvas-058.js ./demo/canvas-059.js ./demo/canvas-060.js ./demo/canvas-061.js ./demo/canvas-062.js ./demo/canvas-063.js ./demo/canvas-064.js ./demo/canvas-065.js ./demo/canvas-066.js ./demo/canvas-067.js ./demo/canvas-068.js ./demo/canvas-069.js ./demo/canvas-070.js ./demo/canvas-071.js ./demo/canvas-072.js ./demo/canvas-073.js ./demo/canvas-201.js ./demo/canvas-202.js ./demo/canvas-203.js ./demo/canvas-204.js ./demo/canvas-205.js ./demo/canvas-206.js ./demo/canvas-207.js ./demo/canvas-208.js ./demo/canvas-209.js ./demo/canvas-210.js ./demo/canvas-211.js ./demo/canvas-212.js ./demo/delaunator-001.js ./demo/delaunator-002.js ./demo/dom-001.js ./demo/dom-002.js ./demo/dom-003.js ./demo/dom-004.js ./demo/dom-005.js ./demo/dom-006.js ./demo/dom-007.js ./demo/dom-008.js ./demo/dom-009.js ./demo/dom-010.js ./demo/dom-011.js ./demo/dom-012.js ./demo/dom-013.js ./demo/dom-015.js ./demo/dom-016.js ./demo/dom-017.js ./demo/dom-018.js ./demo/dom-019.js ./demo/dom-020.js ./demo/dom-021.js ./demo/filters-001.js ./demo/filters-002.js ./demo/filters-003.js ./demo/filters-004.js ./demo/filters-005.js ./demo/filters-006.js ./demo/filters-007.js ./demo/filters-008.js ./demo/filters-009.js ./demo/filters-010.js ./demo/filters-011.js ./demo/filters-012.js ./demo/filters-013.js ./demo/filters-014.js ./demo/filters-015.js ./demo/filters-016.js ./demo/filters-017.js ./demo/filters-018.js ./demo/filters-019.js ./demo/filters-020.js ./demo/filters-021.js ./demo/filters-022.js ./demo/filters-023.js ./demo/filters-024.js ./demo/filters-025.js ./demo/filters-026.js ./demo/filters-027.js ./demo/filters-028.js ./demo/filters-029.js ./demo/filters-030.js ./demo/filters-031.js ./demo/filters-032.js ./demo/filters-033.js ./demo/filters-034.js ./demo/filters-035.js ./demo/filters-036.js ./demo/filters-037.js ./demo/filters-038.js ./demo/filters-039.js ./demo/filters-040.js ./demo/filters-041.js ./demo/filters-042.js ./demo/filters-101.js ./demo/filters-102.js ./demo/filters-103.js ./demo/filters-104.js ./demo/filters-105.js ./demo/filters-501.js ./demo/filters-502.js ./demo/filters-503.js ./demo/filters-504.js ./demo/filters-505.js ./demo/mediapipe-001.js ./demo/mediapipe-002.js ./demo/mediapipe-003.js ./demo/modules-001.js ./demo/modules-002.js ./demo/modules-003.js ./demo/modules-004.js ./demo/modules-005.js ./demo/modules-006.js ./demo/packets-001.js ./demo/packets-002.js ./demo/particles-001.js ./demo/particles-002.js ./demo/particles-003.js ./demo/particles-004.js ./demo/particles-005.js ./demo/particles-006.js ./demo/particles-007.js ./demo/particles-008.js ./demo/particles-009.js ./demo/particles-010.js ./demo/particles-011.js ./demo/particles-012.js ./demo/particles-013.js ./demo/particles-014.js ./demo/particles-015.js ./demo/particles-016.js ./demo/particles-017.js ./demo/snippets-001.js ./demo/snippets-002.js ./demo/snippets-003.js ./demo/snippets-004.js ./demo/snippets-005.js ./demo/snippets-006.js ./demo/temp-001.js ./demo/temp-shape-scale-investigation.js ./demo/tensorflow-001.js ./demo/tensorflow-002.js ./demo/utilities.js
  • §

    Demo Filters 038

    Using the matrix filter to create directional blur effects

  • §

    Run code

    import * as scrawl from '../source/scrawl.js';
    
    import { reportSpeed, addImageDragAndDrop, addCheckerboardBackground } from './utilities.js';
  • §

    Scene setup

    const canvas = scrawl.findCanvas('mycanvas');
  • §

    Namespacing boilerplate

    const namespace = canvas.name;
    const name = (n) => `${namespace}-${n}`;
  • §

    Import the initial image used by the Picture entity

    scrawl.importDomImage('.flowers');
  • §

    Create the background

    addCheckerboardBackground(scrawl, canvas, namespace);
  • §

    Create the filter

    • Legacy filter methods only cover 3x3 or 5x5 matrix kernels
    • For differently shaped kernels we need to use the modern filter actions approach
    const matrix = scrawl.makeFilter({
    
        name: name('matrix'),
        actions: [{
            action: 'matrix',
            width: 9,
            height: 1,
            offsetX: 4,
            offsetY: 0,
            includeRed: true,
            includeGreen: true,
            includeBlue: true,
            includeAlpha: false,
            weights: [1/9, 1/9, 1/9, 1/9, 1/9, 1/9, 1/9, 1/9, 1/9],
            premultiply: false,
            useInputAsMask: false,
        }],
    });
    
    const action = matrix.actions[0];
  • §

    Build a directional 2D kernel by rasterizing a line through the center:

    • length = total tap count (odd)
    • angleDeg measured CCW, 0° = +X (to the right).
    • profile: “box” | “gauss”
    • sigma used only for gauss (in taps, e.g. length/3)
    const makeDirectionalKernel = (length, angleDeg, profile = "box", sigma = length / 3) => {
    
        if (length % 2 === 0) length += 1;
    
        const r = (length - 1) >> 1,
            size = 2 * r + 1;
    
        const cx = r,
            cy = r;
    
        const theta = angleDeg * Math.PI / 180;
    
        const dx = Math.cos(theta), dy = Math.sin(theta),
            x0 = cx - r * dx, y0 = cy - r * dy,
            x1 = cx + r * dx, y1 = cy + r * dy;
    
        const steps = Math.max(Math.abs(x1 - x0), Math.abs(y1 - y0)) | 0,
            wx = (x1 - x0) / steps, wy = (y1 - y0) / steps;
    
        const weights = new Float32Array(size * size);
    
        const hits = [];
    
        let ax = x0,
            ay = y0,
            i, xi, yi, idx;
    
        for (i = 0; i <= steps; i++, ax += wx, ay += wy) {
    
            xi = Math.round(ax);
            yi = Math.round(ay);
    
            idx = yi * size + xi;
    
            if (xi >= 0 && xi < size && yi >= 0 && yi < size) hits.push({ idx, t: i - steps / 2 });
        }
    
        let sum = 0,
            w;
    
        for (const h of hits) {
    
            w = (profile === "gauss")
                ? Math.exp(-0.5 * (h.t / sigma) * (h.t / sigma))
                : 1;
    
            weights[h.idx] += w;
            sum += w;
        }
    
        if (sum > 0) {
    
            for (let i = 0; i < weights.length; i++) {
    
                weights[i] /= sum;
            }
        }
    
        return {
            width: size,
            height: size,
            offsetX: cx,
            offsetY: cy,
            weights,
        };
    };
  • §

    Create the target entity

    const piccy = scrawl.makePicture({
    
        name: name('image'),
        asset: 'iris',
        copyDimensions: ['100%', '100%'],
        dimensions: ['95%', '95%'],
        handle: ['center', 'center'],
        start: ['center', 'center'],
    
        filters: [name('matrix')],
    });
  • §

    Scene animation

    Function to display frames-per-second data, and other information relevant to the demo

    const report = reportSpeed('#reportmessage', function () {
    
        const w = action.weights.join(', ');
    
        return `
        Length: ${dom.length.value}
        Angle: ${dom.angle.value}
        Sigma: ${dom.sigma.value}
    
        Matrix actions array: [{
            width: ${action.width},
            height: ${action.height},
            offsetX: ${action.offsetX},
            offsetY: ${action.offsetY},
            weights: [${w}],
        }]
    
        Opacity: ${dom.opacity.value}`;
    });
  • §

    Create the Display cycle animation

    scrawl.makeRender({
    
        name: name('animation'),
        target: canvas,
        afterShow: report,
    });
  • §

    User interaction

    Setup form

    const dom = scrawl.initializeDomInputs([
        ['input', 'length', '9'],
        ['input', 'angle', '0'],
        ['input', 'sigma', '2'],
        ['input', 'opacity', '1'],
        ['select', 'profile', 0],
        ['select', 'includeRed', 1],
        ['select', 'includeGreen', 1],
        ['select', 'includeBlue', 1],
        ['select', 'includeAlpha', 0],
        ['select', 'premultiply', 0],
        ['select', 'useInputAsMask', 0],
        ['select', 'memoizeFilterOutput', 0],
    ]);
    
    
    const memoize = () => {
    
        piccy.set({
            memoizeFilterOutput: dom.memoizeFilterOutput.value === '0' ? false : true,
        });
    };
    scrawl.addNativeListener(['input', 'change'], memoize, '#memoizeFilterOutput');
  • §

    Manage filter updates

    const updateMatrix = () => {
    
        action.opacity = parseFloat(dom.opacity.value);
        action.includeRed = !!(parseInt(dom.includeRed.value, 10));
        action.includeGreen = !!(parseInt(dom.includeGreen.value, 10));
        action.includeBlue = !!(parseInt(dom.includeBlue.value, 10));
        action.includeAlpha = !!(parseInt(dom.includeAlpha.value, 10));
        action.useInputAsMask = !!(parseInt(dom.useInputAsMask.value, 10));
        action.premultiply = !!(parseInt(dom.premultiply.value, 10));
    
        matrix.set({
            actions: [action],
        });
    };
    scrawl.addNativeListener(['input', 'change'], updateMatrix, '.filter-control');
    
    const recalculateMatrix = () => {
    
        const length = parseInt(dom.length.value, 10),
            angle = parseInt(dom.angle.value, 10),
            sigma = parseFloat(dom.sigma.value),
            profile = dom.profile.value;
    
        const vals = makeDirectionalKernel(length, angle, profile, sigma);
    
        action.width = vals.width;
        action.height = vals.height;
        action.offsetX = vals.offsetX;
        action.offsetY = vals.offsetY;
        action.weights = [...vals.weights];
    
        matrix.set({
            actions: [action],
        });
    };
    scrawl.addNativeListener(['input', 'change'], recalculateMatrix, '.filter-compute');
  • §

    Drag-and-Drop image loading functionality

    addImageDragAndDrop(scrawl, canvas, `#${namespace} .assets`, piccy);
  • §

    Development and testing

    console.log(scrawl.library);