• 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-074.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-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 Canvas 074

    Import and use ImageBitmap objects as assets

  • §

    Run code

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

    Scene setup

    Get a handle to the Canvas wrapper

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

    Namespacing boilerplate

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

    Create SC assets from DOM <img> elements

    For the DOM images, we will generate ImageBitmap based assets from them

    • ImageBitmap generation is asynchronous, the createImageBitmap function returns a Promise
    • This is a more involved process compared to SC’s importDomImage functionality
    const domImages = document.querySelectorAll('.dom-images'),
        rawImageBitmapsPromises = [];
    
    /** @ts-expect-error */
    [...domImages].forEach(img => rawImageBitmapsPromises.push(createImageBitmap(img)));
  • §

    We’re importing 2 images from the DOM; we wait until both promises have completed

    • We must assume that the order of the images returned by querySelectorAll matches the order of the images in the DOM, but this is not guaranteed
    Promise.all(rawImageBitmapsPromises)
    .then(rawImageBitmaps => {
  • §

    Import the bitmaps

        const results = scrawl.importImageBitmap(
  • §

    This should be an image of an iris (flower)

    • But we don’t know that, and we take a risk by importing the ImageBitmap directly
            rawImageBitmaps[0],
  • §

    The better approach is to wrap the ImageBitmap in a JS object, assigning it to a src attribute

    • This then allows us to give the resulting asset a known name, which we can (in this instance) define from the DOM element’s id value
    /** @ts-expect-error */
            {
                name: domImages[1].id,
                src: rawImageBitmaps[1],
            }
        );
  • §

    We know this asset’s name, because it is the id value of the <img> element

        scrawl.makePattern({
    
            name: name('brick-pattern'),
            asset: 'brick',
        });
    
        scrawl.makeBlock({
    
            name: name('patterned-block'),
            dimensions: ['100%', '100%'],
            fillStyle: name('brick-pattern'),
            globalAlpha: 0.5,
        });
  • §

    We did not give the other asset a name

    • But we can discover the name the SC system gave it because importImageBitmap returns an array of the names given to each imported asset
        scrawl.makePicture({
    
            name: name('iris-picture'),
            start: ['center', 'center'],
            handle: ['center', 'center'],
            dimensions: ['50%', '50%'],
            copyDimensions: ['100%', '100%'],
            asset: results[0],
        });
    })
    .catch(error => console.log(error.message));
  • §

    Create SC assets from image files dropped onto the canvas

    Drag and drop event listeners

    scrawl.addNativeListener(['dragenter', 'dragover', 'dragleave'], (e) => {
    
        e.preventDefault();
        e.stopPropagation();
    
    }, canvas.domElement);
    
    scrawl.addNativeListener('drop', (e) => {
    
        e.preventDefault();
        e.stopPropagation();
    
        const dt = e.dataTransfer;
    
        if (dt) {
    
            console.log(`Attempting to upload ${dt.files.length} files`);
    
            [...dt.files].forEach(addImageAsset);
        }
    
    }, canvas.domElement);
  • §

    User interaction - picture drag-and-drop within canvas

    const myDragGroup = scrawl.makeGroup({
        name: name('draggable'),
        host: canvas.base,
    });
  • §

    Create the drag-and-drop zone

    scrawl.makeDragZone({
    
        zone: canvas,
        collisionGroup: myDragGroup,
        endOn: ['up', 'leave'],
        preventTouchDefaultWhenDragging: true,
    });
  • §

    Function to run when an image file is dropped onto the canvas

    let counter = 0;
    
    const addImageAsset = (file) => {
    
        if (file.type.indexOf('image/') === 0) {
    
            const assetName = `user-uploaded-asset-${counter}`;
            counter++;
    
            console.log(`Received an image file - asset name: ${assetName}`);
  • §

    We need to get the image dimensions

    • The simplest hack is to load the file into a temporary <img> element
            const img = new Image();
            const url = URL.createObjectURL(file);
    
            img.onload = () => {
    
                const { naturalWidth: w, naturalHeight: h } = img;
    
                URL.revokeObjectURL(url);
  • §

    Calculate aspect-ratio-preserving resize

                let targetW, targetH;
    
                if (w >= h) {
                    targetW = 150;
                    targetH = Math.round((h / w) * 150);
                }
                else {
                    targetH = 150;
                    targetW = Math.round((w / h) * 150);
                }
  • §

    Every image uploaded has a cost!

    • a 4k x 3k (3MB) image file will generate a 48MB ImageBitmap object
    • Which impacts page performance if more than a few such images are uploaded
    • For this demo, we only need 150px square images
    • createImageBitmap allows us to resize an image as we create the bitmap from it
                createImageBitmap(file, {
                    resizeWidth: targetW,
                    resizeHeight: targetH,
                    resizeQuality: 'high',
                })
                .then(bitmap => {
    
    
    /** @ts-expect-error */
                    const [importedName] = scrawl.importImageBitmap({
                        name: assetName,
                        src: bitmap,
                    });
    
                    scrawl.makePicture({
    
                        name: name(`picture-for-${assetName}`),
                        asset: importedName,
                        group: myDragGroup,
                        start: [
                            Math.random() * canvas.get('width'),
                            Math.random() * canvas.get('height'),
                        ],
                        handle: ['center', 'center'],
                        dimensions: [targetW, targetH],
                        copyDimensions: ['100%', '100%'],
                        strokeStyle: 'yellow',
                        lineWidth: 2,
                        method: 'fillThenDraw',
                    });
                })
                .catch(err => console.log(err.message));
            }
  • §

    Start the import process

            img.src = url;
        }
    };
  • §

    Scene animation

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

    const report = reportSpeed('#reportmessage');
  • §

    Create the Display cycle animation

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

    Development and testing

    console.log(scrawl.library);