Package Exports

webgl-tech-particles
webgl-tech-particles/dist/webgl-tech-particles.js

This package does not declare an exports field, so the exports above have been automatically detected and optimized by JSPM instead. If any package subpath is missing, it is recommended to post an issue to the original package (webgl-tech-particles) to support the "exports" field. If that is not possible, create a JSPM override to customize the exports field for this package.

Readme

WebGL Tech Particles

Interactive 3D particle system with technology icons using WebGL and Three.js.

This project is an interactive 3D visualization of technology icons (e.g., JavaScript, Python, React, Docker, etc.) implemented with WebGL and Three.js. Particles representing different technologies move dynamically in a 3D space, connecting with each other based on customizable parameters.

Live demo

Install

Using npm:

npm i webgl-tech-particles

Usage

import {initWebGLTechParticles} from 'webgl-tech-particles';

initWebGLTechParticles('tech-particles');

To apply your custom settings, you need to specify the path to settings.json as the second parameter in initWebGLTechParticles:

import {initWebGLTechParticles} from 'webgl-tech-particles';

initWebGLTechParticles('tech-particles', 'settings.json');

If you want to use a custom icon set, you need to specify the path to the icon folder in your settings.json:

"iconFolderPath": "icons"

Also in the icon folder you need to create a file iconList.json and specify which icons to load.

Example of iconList.json:

[
    "vue.webp",
    "react.webp",
    "dart.webp",
    "rust.webp",
    "aws.webp"
]

For correct operation, it is better to upload small icons in png and webp formats.

CDN Usage

You can also use this package directly in the browser via CDN without installing it via npm. To do this, include the following script tag in your HTML file:

<script type="module">
  import { initWebGLTechParticles } from 'https://cdn.jsdelivr.net/npm/webgl-tech-particles@:version/dist/webgl-tech-particles.js';
  initWebGLTechParticles('tech-particles', 'settings.json');
</script>

Replace :version with the version you need

Settings

Example with basic settings.

You can also export settings from the demo version.

Below is a description of the settings.

Particle Settings:

Name	Default	Description
`enableRotation`	`false`	Enable/disable sphere rotation
`rotationSpeed`	`0.1`	Rotation speed
`showLines`	`true`	Show/hide meshes between particles (icons)
`minDistance`	`150`	Minimum distance to create meshes connecting particles
`maxConnections`	`20`	Maximum number of connections
`particleVelocity`	`0.1`	Velocity of particles
`colorEnabled []`	`[true, true, true]`	The sphere can have 3 colors for the meshes connecting the particles, this setting allows you to turn on/off certain colors
`availableColors []`	`['#b02727', '#454545','#15154c']`	Available colors for meshes
`enableCameraControls`	`true`	Enable/disable the ability to rotate and resize the sphere

Camera Settings:

Name	Default	Description
`positionZ`	`1750`	Initial position of the sphere by Z coordinates
`farPlane`	`4000`	The farthest distance that can be obtained by resizing a sphere
`nearPlane`	`1`	Minimum distance from the camera at which objects begin to be displayed
`fieldOfView`	`45`	Maximum distance from the camera at which objects will still be displayed

Orbit Controls Settings:

Name	Default	Description
`minDistance`	`1000`	Minimum distance the camera can get to the target (focus point)
`maxDistance`	`3000`	Maximum distance the camera can get to the target (focus point)

Scene Settings:

Name	Default	Description
`halfRadius`	`400`	Radius value for constructing a sphere
`iconSize`	`20`	Icons size
`particlesCount`	`500`	Number of particles
`maxParticlesCount`	`1000`	Maximum number of particles

Credits

It is mainly developed using the JavaScript 3D library three.js.

License

MIT