Particles.js

/* ===============================================================================================================================================
   Particles.js

   Description
   This collection of scripts reproduces the p5.js examples with Adobe Illustrator's ExtendScript.
   However, since it is not interesting just to reproduce them, some of them are modified.

   p5.js
   https://p5js.org/examples/simulate-particles.html

   Usage
   run this script from File > Scripts > Other Script...

   Notes
   In rare cases, you may not be able to create it.
   In that case, restart Illustrator and run this script again.

   Requirements
   Illustrator CS6 or higher

   Version
   1.0.0

   Homepage
   github.com/sky-chaser-high/generative-art-with-illustrator

   License
   Released under the MIT license.
   https://opensource.org/licenses/mit-license.php
   =============================================================================================================================================== */

(function () {
    main();
})();


/**
 * main function
 */
function main() {
    var artboard = {
        width: 1920,
        height: 1080,
        center: { x: 0, y: 0 }
    };

    var title = 'Particles';
    var aw = 'Artwork';
    var bg = 'Background';

    var mode = DocumentColorSpace.RGB;


    // setup ----------------------------------------------------------------------
    if (app.documents.length == 0) {
        createDocument(title, artboard.width, artboard.height, mode);
    }
    else {
        artboard.width = app.activeDocument.width;
        artboard.height = app.activeDocument.height;
    }

    artboard.center.x = artboard.width / 2;
    artboard.center.y = artboard.height / 2;

    if (!existsLayer(bg)) {
        createLayer(bg);
        createBackground(bg, artboard.width, artboard.height, setRGBColor(26, 32, 38));
    }

    if (!existsLayer(aw)) {
        createLayer(aw);
    }


    // draw ++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++++
    var particles = [];
    var radius = {
        min: 4,
        max: 14
    };

    for (var i = 0; i < artboard.width / 8; i++) {
        particles.push({
            x: Math.random() * artboard.width,
            y: Math.random() * artboard.height,
            r: map(Math.random(), 0, 1, radius.min, radius.max),
            speed: {
                x: map(Math.random(), 0, 1, -2, 2),
                y: map(Math.random(), 0, 1, -1, 1)
            },
            filled: Math.random() > 0.5
        });
    }

    for (var i = 0; i < particles.length; i++) {
        createParticle(aw, particles[i].x, particles[i].y, particles[i].r, particles[i].r, particles[i].filled);
        var pos = moveParticle(artboard, particles[i].speed, particles[i].x, particles[i].y);
        particles[i].x = pos.x;
        particles[i].y = pos.y;
        joinParticles(aw, particles[i], particles.slice(i));
    }


    app.executeMenuCommand('fitin');
}


/**
 * Creation of a particle.
 * @param {string} layer
 * @param {number} x
 * @param {number} y
 * @param {number} width
 * @param {number} height
 * @param {boolean} filled
 */
function createParticle(layer, x, y, width, height, filled) {
    var color = setRGBColor(
        Math.random() * 255,
        Math.random() * 255,
        Math.random() * 255
    );
    if (filled) {
        createEllipse(layer, x, y * -1, width, height, color);
    }
    else {
        var circle = createEllipse(layer, x, y * -1, width, height, setRGBColor(26, 32, 38));
        circle.stroked = true;
        circle.strokeColor = color;
    }
}


/**
 * Setting the particle in motion.
 * @param {{width: number, height: number}} stage
 * @param {{x: number, y: number}} speed
 * @param {number} x
 * @param {number} y
 * @returns {{x: number, y: number}}
 */
function moveParticle(stage, speed, x, y) {
    if (x < 0 || x > stage.width) {
        speed.x *= -1;
    }
    if (y < 0 || y > stage.height) {
        speed.y *= -1;
    }
    return {
        x: x + speed.x,
        y: y + speed.y
    };
}


/**
 * Creates the connections(lines) between particles which are less than a certain distance apart.
 * @param {string} layer
 * @param {{x: number, y: number}} particle
 * @param {{x: number, y: number}[]} particles
 */
function joinParticles(layer, particle, particles) {
    var distance = 100;
    for (var i = 0; i < particles.length; i++) {
        var d = dist(particle.x, particle.y, particles[i].x, particles[i].y);
        if (d < distance) {
            var color = setRGBColor(60);
            var line = createLine(layer, [[particle.x, particle.y * -1], [particles[i].x, particles[i].y * -1]], color);
            line.zOrder(ZOrderMethod.SENDTOBACK);
        }
    }
}


/**
 * Creates a new pathItem.
 * @param {string} layerName The name of the layer.
 * @param {number[]} points The array of [x, y] coordinate pairs
 * @param {Color} color The color of the PathItem.
 * @returns {PathItem}
 */
function createLine(layerName, points, color) {
    var layer = app.activeDocument.layers.getByName(layerName);
    var line = layer.pathItems.add();
    line.setEntirePath(points);
    line.filled = false;
    line.stroked = true;
    line.strokeColor = color;
    return line;
}


/**
 * Creates a new pathItem in the shape of an ellipse.
 * @param {string} layerName The name of the layer.
 * @param {number} x The x-coordinate of the center of the ellipse.
 * @param {number} y The y-coordinate of the center of the ellipse.
 * @param {number} width The width of the PathItem.
 * @param {number} height The height of the PathItem.
 * @param {Color} color The color of the PathItem.
 * @returns {PathItem}
 */
function createEllipse(layerName, x, y, width, height, color) {
    var layer = app.activeDocument.layers.getByName(layerName);
    var ellipse = layer.pathItems.ellipse(y + height / 2, x - width / 2, width, height);
    ellipse.stroked = false;
    ellipse.filled = true;
    ellipse.fillColor = color;
    return ellipse;
}


/**
 * Creates a background object in the document.
 * @param {string} layerName The name of the layer.
 * @param {number} width The width of the PathItem.
 * @param {number} height The height of the PathItem.
 * @param {Color} color The color of the PathItem.
 * @returns {PathItem}
 */
function createBackground(layerName, width, height, color) {
    var layer = app.activeDocument.layers.getByName(layerName);
    var bg = layer.pathItems.rectangle(0, 0, width, height);
    bg.stroked = false;
    bg.filled = true;
    bg.fillColor = color;
    return bg;
}


/**
 * Creates a new document.
 * @param {string} title The document title.
 * @param {number} width The width of this document.
 * @param {number} height The height of the document.
 * @param {DocumentColorSpace} mode The color space for the new document.
 * @returns {Document}
 */
function createDocument(title, width, height, mode) {
    var preset = new DocumentPreset();
    preset.title = title;
    preset.width = width;
    preset.height = height;
    preset.colorMode = mode;
    preset.units = RulerUnits.Points;
    var document = app.documents.addDocument(title, preset);
    var artboards = document.artboards;
    artboards[0].artboardRect = [0, 0, width, -height];
    return document;
}


/**
 * Creates a new layer in the document.
 * @param {string} name The name of the layer.
 * @returns {Layer}
 */
function createLayer(name) {
    var layer = app.activeDocument.layers.add();
    layer.name = name;
    layer.zOrder(ZOrderMethod.BRINGTOFRONT);
    return layer;
}


/**
 * Check if the layer exists.
 * @param {string} name The name of the layer.
 * @returns {boolean}
 */
function existsLayer(name) {
    try {
        app.activeDocument.layers.getByName(name);
        return true;
    }
    catch (e) {
        return false;
    }
}


/**
 * Setting a RGB color.
 * @param {number} r The red color value.
 * @param {number} [g] The green color value. Optional.
 * @param {number} [b] The blue color value. Optional.
 * @returns {RGBColor} RGBColor
 */
function setRGBColor(r, g, b) {
    if (g == undefined) g = r;
    if (b == undefined) b = r;
    var color = new RGBColor();
    color.red = r;
    color.green = g;
    color.blue = b;
    return color;
}


/**
 * Re-maps a number from one range to another.
 * @param {number} value The incoming value to be converted.
 * @param {number} start1 Lower bound of the value's current range.
 * @param {number} stop1 Upper bound of the value's current range.
 * @param {number} start2 Lower bound of the value's target range.
 * @param {number} stop2 Upper bound of the value's target range.
 * @returns {number} Remapped number.
 */
function map(value, start1, stop1, start2, stop2) {
    var distance1 = stop1 - start1;
    var value1 = value - start1;
    var ratio = value1 / distance1;
    var distance2 = stop2 - start2;
    var value2 = distance2 * ratio;
    return start2 + value2;
}


/**
 * Calculates the distance between two points, in either two dimensions.
 * @param {number} x1 The x-coordinate of the first point.
 * @param {number} y1 The y-coordinate of the first point.
 * @param {number} x2 The x-coordinate of the second point.
 * @param {number} y2 The y-coordinate of the second point.
 * @returns {number} Distance between the two points.
 */
function dist(x1, y1, x2, y2) {
    var x = x2 - x1;
    var y = y2 - y1;
    return Math.sqrt(x * x + y * y);
}