• 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/component-001.js ./demo/component-002.js ./demo/component-003.js ./demo/component-004.js ./demo/component-005.js ./demo/component-006.js ./demo/component-007.js ./demo/core-001.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-014a.js ./demo/dom-014b.js ./demo/dom-014c.js ./demo/dom-015.js ./demo/dom-016.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-501.js ./demo/filters-502.js ./demo/filters-503.js ./demo/filters-504.js ./demo/filters-505.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/temp-001.js ./demo/temp-inkscapeSvgFilters.js
  • ¶

    Demo Particles 008

    Net entity: generation and basic functionality, including Spring objects

  • ¶

    Run code

    import scrawl from '../source/scrawl.js'
  • ¶

    Import image from DOM

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

    Scene setup

    let canvas = scrawl.library.artefact.mycanvas;
    
    canvas.setBase({
        backgroundColor: 'aliceblue',
    });
  • ¶

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

    scrawl.makeLine({
    
        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({
                x: world.wind,
                y: 0,
            });
        },
    });
    
    let changeWind = function () {
    
        let newWind = myWorld.wind + Math.random() - 0.5;
    
        if (newWind < -15) newWind = -15;
        if (newWind > 15) newWind = 15;
    
        myWorld.set({
            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)$');
    
            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

                    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,
    });
  • ¶

    The Loom entity definition

    let myMesh = scrawl.makeMesh({
    
        name: 'display-mesh',
    
        net: 'test-net',
        source: 'my-flower',
    
        method: 'fillThenDraw',
    
        visibility: false,
    });
  • ¶

    Scene animation

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

    let report = function () {
    
        let testTicker = Date.now(),
            testTime, testNow, dragging,
            testMessage = document.querySelector('#reportmessage');
    
        let springConst = document.querySelector('#springConstant'),
            mass = document.querySelector('#mass'),
            restLength = document.querySelector('#restLength'),
            tickMultiplier = document.querySelector('#tickMultiplier'),
            damperConst = document.querySelector('#damperConstant');
    
        return function () {
    
            testNow = Date.now();
            testTime = testNow - testTicker;
            testTicker = testNow;
    
            testMessage.textContent = `Screen refresh: ${Math.ceil(testTime)}ms; fps: ${Math.floor(1000 / testTime)}
        Tick multiplier: ${tickMultiplier.value}
        Particle mass: ${mass.value}
        Rest length multiplier: ${restLength.value}
        Wind speed: ${myWorld.wind.toFixed(2)}
        Spring constant: ${springConst.value}
        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)});
            if (e.target.id === 'mesh') {
                if (parseInt(e.target.value, 10)) {
                    myNet.set({
                        showSprings: false,
                    });
                    myNet.artefact.set({
                        globalAlpha: 0,
                    });
                    myMesh.set({
                        visibility: true,
                    });
                }
                else {
                    myNet.set({
                        showSprings: true,
                    });
                    myNet.artefact.set({
                        globalAlpha: 1,
                    });
                    myMesh.set({
                        visibility: false,
                    });
                }
            }
    
            myNet.restart();
        }
    };
    scrawl.addNativeListener(['input', 'change'], updateSprings, '.controlItem');
    
    document.querySelector('#generate').value = 'weak-net';
    document.querySelector('#springConstant').value = 50;
    document.querySelector('#damperConstant').value = 5;
    document.querySelector('#restLength').value = 1;
    document.querySelector('#mass').value = 1;
    document.querySelector('#engine').value = 'runge-kutta';
    document.querySelector('#tickMultiplier').value = 2;
    document.querySelector('#mesh').value = '0';
  • ¶

    Development and testing

    console.log(scrawl.library);