• 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-015a.js ./demo/canvas-016.js ./demo/canvas-017.js ./demo/canvas-018.js ./demo/canvas-019.js ./demo/canvas-019a.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/core-001.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/filters-001.js ./demo/filters-002.js ./demo/filters-002a.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-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/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/rapier-001.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-000.js ./demo/temp-001.js ./demo/temp-001a.js ./demo/temp-002.js ./demo/temp-003.js ./demo/temp-004.js ./demo/temp-005.js ./demo/temp-006.js ./demo/temp-007.js ./demo/temp-008.js ./demo/temp-009.js ./demo/temp-010.js ./demo/temp-011.js ./demo/temp-012.js ./demo/temp-013.js ./demo/temp-014.js ./demo/temp-015.js ./demo/temp-016.js ./demo/temp-017.js ./demo/temp-018.js ./demo/temp-018a.js ./demo/temp-019.js ./demo/temp-020.js ./demo/temp-021.js ./demo/temp-022.js ./demo/temp-023.js ./demo/temp-024.js ./demo/temp-025.js ./demo/temp-026.js ./demo/temp-027.js ./demo/temp-028.js ./demo/temp-029.js ./demo/temp-030.js ./demo/temp-031.js ./demo/temp-032.js ./demo/temp-033.js ./demo/temp-034.js ./demo/temp-035.js ./demo/temp-036.js ./demo/temp-037.js ./demo/temp-100.js ./demo/temp-101.js ./demo/temp-102.js ./demo/temp-103.js ./demo/temp-104.js ./demo/temp-200.js ./demo/temp-201.js ./demo/temp-301.js ./demo/temp-inkscapeSvgFilters.js ./demo/temp-lottie.js ./demo/tensorflow-001.js ./demo/tensorflow-002.js ./demo/utilities.js
  • §

    Demo Particles 008

    Net entity: generation and basic functionality, including Spring objects

  • §

    Run code

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

    Import image from DOM

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

    Scene setup

    let canvas = scrawl.library.artefact.mycanvas;
  • §

    For this Demo, we are creating a flag and pinning it to a pole. This is the pole.

    scrawl.makeLine({
    
        name: 'flagpole',
    
        startX: 'center',
        startY: 30,
        endX: 'center',
        endY: 'bottom',
    
        lineWidth: 8,
        lineCap: 'round',
        strokeStyle: 'brown',
    
        method: 'draw',
    })
  • §

    Particle physics animation scene

  • §

    Create a World object which we can then assign to the Net entity

    let myWorld = scrawl.makeWorld({
    
        name: 'demo-world',
        tickMultiplier: 2,
    
        userAttributes: [
            {
                key: 'wind', 
                defaultValue: 0,
            },
        ],
    });
  • §

    Create a ‘wind’ force; we will update the wind direction/strength as part of the Display cycle

    scrawl.makeForce({
    
        name: 'wind',
        action: (particle, world, host) => {
    
            particle.load.vectorAdd({
  • §

    @ts-expect-error

                x: world.wind,
                y: 0,
            });
        },
    });
    
    let changeWind = function () {
  • §

    @ts-expect-error

        let newWind = myWorld.wind + Math.random() - 0.5;
    
        if (newWind < -15) newWind = -15;
        if (newWind > 15) newWind = 15;
    
        myWorld.set({
  • §

    @ts-expect-error

            wind: newWind,
        });
    };
  • §

    Create a Net entity

    const myNet = scrawl.makeNet({
    
        name: 'test-net',
  • §

    Every net must be associated with a World object. The attribute’s value can be the World object’s String name value, or the object itself

        world: myWorld,
  • §

    The entity’s start coordinates determine where the first pin will be placed on the canvas

        startX: 'center',
        startY: 40,
  • §

    The Net entity comes with four pre-defined generate functions - we will be testing ‘weak-net’ and ‘strong-net’ in this demo.

    • We can define our own generate function if the pre-defined functions do not meet our needs.
        generate: 'weak-net',
  • §

    The postGenerate function runs immediately after the generate function has created all of the Net entity’s Particle and Spring objects.

    • If the generate function has defined particles and/or springs that we do not need, we can kill them here
    • We can also set the attributes of specified Particles, including making them static (immobile, unaffected by forces and springs applied to them)
        postGenerate: function () {
  • §

    Names for ‘weak-net’ and ‘strong-net’ Particles are consistent: ${Net-entity-name}-${row-number}-${column-number}

            const regex = RegExp('.*(-0-0|-4-0|-9-0)$');
  • §

    @ts-expect-error

            this.particleStore.forEach(p => {
    
                if (regex.test(p.name)) {
  • §

    Change the appearance of the selected Particles, and remove the forces acting on them

                    p.set({ 
                        fill: 'black',
                        stroke: 'black',
                        forces: [],
                    });
  • §

    Prevent Springs associated with the selected Particles from moving them @ts-expect-error

                    this.springs.forEach(s => {
    
                        if (s && s.particleFrom && s.particleFrom.name === p.name) {
    
                            s.particleFromIsStatic = true;
                        }
                        if (s && s.particleTo && s.particleTo.name === p.name) {
    
                            s.particleToIsStatic = true;
                        }
                    })
                }
            });
        },
  • §

    We tell the Net entity how many rows and columns of Particles we want it to create

        rows: 10,
        columns: 14,
  • §

    The distance between rows and columns can be set using either absolute (px) Number values, or relative % String values

        rowDistance: 15,
        columnDistance: '5%',
  • §

    We can get the Net entity to display its springs

        showSprings: true,
        showSpringsColor: 'green',
  • §

    Particle physics attributes

        mass: 1,
        forces: ['gravity', 'wind'],
        engine: 'runge-kutta',
        damperConstant: 5,
  • §

    We can assign an artefact that we will be using for the particle animation, or we can define it here as part of the Net factory

        artefact: scrawl.makeWheel({
    
            name: 'particle-wheel',
            radius: 3,
    
            handle: ['center', 'center'],
    
            method: 'fillThenDraw',
            fillStyle: 'gold',
            strokeStyle: 'blue',
    
            visibility: false, 
    
            globalAlpha: 1,
    
            noUserInteraction: true,
            noPositionDependencies: true,
            noFilters: true,
            noDeltaUpdates: true,
        }),
  • §

    The stampAction function describes the steps that our Net will take to draw each of its particles (and springs, hit regions) onto the host canvas screen.

        stampAction: function (artefact, particle, host) {
    
            let [r, z, ...start] = particle.history[0];
    
            artefact.simpleStamp(host, { 
                start,
                fillStyle: particle.fill, 
                strokeStyle: particle.stroke, 
            });
        },
    });
    
    scrawl.makePicture({
    
        name: 'my-flower',
        asset: 'iris',
    
        copyStartX: 0,
        copyStartY: 0,
    
        copyWidth: '100%',
        copyHeight: '100%',
    
        visibility: false,
    });
  • §

    Scene animation

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

    const report = reportSpeed('#reportmessage', function () {
  • §

    @ts-expect-error

        return `    Tick multiplier: ${tickMultiplier.value}\n    Particle mass: ${mass.value}\n    Rest length multiplier: ${restLength.value}\n    Wind speed: ${myWorld.wind.toFixed(2)}\n    Spring constant: ${springConst.value}\n    Damper constant: ${damperConst.value}`;
    });
  • §

    Create the Display cycle animation

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

    User interaction

    Setup form observer functionality

    const updateSprings = function (e) {
    
        if (e && e.target && e.target.id) {
    
            if (e.target.id === 'springConstant') myNet.set({ springConstant: parseFloat(e.target.value)});
            if (e.target.id === 'damperConstant') myNet.set({ damperConstant: parseFloat(e.target.value)});
            if (e.target.id === 'restLength') myNet.set({ restLength: parseFloat(e.target.value)});
            if (e.target.id === 'generate') myNet.set({ generate: e.target.value});
            if (e.target.id === 'engine') myNet.set({ engine: e.target.value});
            if (e.target.id === 'mass') myNet.set({ mass: parseFloat(e.target.value)});
            if (e.target.id === 'tickMultiplier') myWorld.set({ tickMultiplier: parseFloat(e.target.value)});
    
            myNet.restart();
        }
    };
    scrawl.addNativeListener(['input', 'change'], updateSprings, '.controlItem');
    
    const springConst = document.querySelector('#springConstant'),
        mass = document.querySelector('#mass'),
        restLength = document.querySelector('#restLength'),
        tickMultiplier = document.querySelector('#tickMultiplier'),
        damperConst = document.querySelector('#damperConstant');
  • §

    @ts-expect-error

    springConst.value = 50;
  • §

    @ts-expect-error

    damperConst.value = 5;
  • §

    @ts-expect-error

    restLength.value = 1;
  • §

    @ts-expect-error

    mass.value = 1;
  • §

    @ts-expect-error

    tickMultiplier.value = 2;
  • §

    @ts-expect-error

    document.querySelector('#generate').value = 'weak-net';
  • §

    @ts-expect-error

    document.querySelector('#engine').value = 'runge-kutta';
  • §

    Development and testing

    console.log(scrawl.library);