Montagem
Nós espalhados que se juntam numa forma de núcleo com satélites; o cursor desmonta e eles voltam.
usa o PAR-05
O código
particulas-motor.js + montagem.js + markup.html
/* ===== particulas-motor.js ========================================================= */
/* OCTA · motor de cenas de partículas — a base compartilhada pelos componentes PAR-*.
Cena de three.js atrás de uma dobra, com física leve e o cursor mandando de verdade.
Nasceu no site da primeira proposta da OCTA ao Pedro (27/08/2026), onde as seis cenas viviam
num arquivo só. Aqui o motor está separado da cena: você inclui ESTE arquivo uma vez e, depois
dele, só o arquivo da cena que for usar.
Três regras de desempenho que não são opcionais:
- **pausa fora da tela** (IntersectionObserver): cena invisível não queima bateria;
- **DPR no teto de 2**: acima disso o ganho é invisível e o custo não;
- **`prefers-reduced-motion` desenha UM quadro e para** — a cena existe, não se mexe.
Configuração, no próprio <canvas>:
data-cena="plexus" qual cena (obrigatório)
data-cor="#212121" a cor dos nós e das linhas
data-cor-destaque="#e8ad32" o acento (algumas cenas usam)
Exige three.js (r12x+) carregado antes. Sem ele, o canvas some em silêncio — a página não quebra.
*/
window.OctaParticulas = (function () {
'use strict';
var REDUZIR = window.matchMedia && window.matchMedia('(prefers-reduced-motion: reduce)').matches;
var CELULAR = window.innerWidth < 700;
var cenas = {};
function textura(desenhar) {
var cv = document.createElement('canvas');
cv.width = cv.height = 64;
desenhar(cv.getContext('2d'));
return new THREE.CanvasTexture(cv);
}
var PONTO = null, ANEL = null;
function texturas() {
if (PONTO) { return; }
PONTO = textura(function (g) { g.fillStyle = '#fff'; g.beginPath(); g.arc(32, 32, 30, 0, Math.PI * 2); g.fill(); });
ANEL = textura(function (g) { g.strokeStyle = '#fff'; g.lineWidth = 7; g.beginPath(); g.arc(32, 32, 24, 0, Math.PI * 2); g.stroke(); });
}
function Cena(canvas) {
texturas();
this.canvas = canvas;
this.tipo = canvas.getAttribute('data-cena');
this.dobra = canvas.parentElement;
this.COR = new THREE.Color(canvas.getAttribute('data-cor') || '#212121');
this.DESTAQUE = new THREE.Color(canvas.getAttribute('data-cor-destaque') || '#e8ad32');
this.PONTO = PONTO;
this.ANEL = ANEL;
this.CELULAR = CELULAR;
this.renderer = new THREE.WebGLRenderer({ canvas: canvas, alpha: true, antialias: true });
this.renderer.setPixelRatio(Math.min(window.devicePixelRatio || 1, 2));
this.scene = new THREE.Scene();
/* câmera ortográfica em PIXEL: x e y da cena são as coordenadas da tela, e a conta de
física fica legível — sem conversão de espaço no meio do passo */
this.camera = new THREE.OrthographicCamera(0, 1, 1, 0, -500, 500);
this.mouse = { x: -9999, y: -9999 };
this.t = 0;
this.rodando = false;
var eu = this;
this.dobra.addEventListener('pointermove', function (e) {
var r = eu.canvas.getBoundingClientRect();
eu.mouse.x = e.clientX - r.left;
eu.mouse.y = e.clientY - r.top;
});
this.dobra.addEventListener('pointerleave', function () { eu.mouse.x = -9999; eu.mouse.y = -9999; });
window.addEventListener('resize', function () { eu.redimensionar(); });
this.redimensionar();
var montar = cenas[this.tipo];
if (!montar) { throw new Error('cena desconhecida: ' + this.tipo); }
montar.call(this);
this.montada = true;
if (REDUZIR) { this.passo(0.016); this.desenhar(); return; }
if ('IntersectionObserver' in window) {
new IntersectionObserver(function (en) {
eu.rodando = en[0].isIntersecting;
if (eu.rodando) { eu.laco(); }
}, { rootMargin: '80px' }).observe(canvas);
} else {
this.rodando = true;
this.laco();
}
}
Cena.prototype.redimensionar = function () {
var w = this.dobra.clientWidth, h = this.dobra.clientHeight;
this.w = w; this.h = h;
this.renderer.setSize(w, h, false);
this.camera.right = w; this.camera.top = 0; this.camera.bottom = h; this.camera.left = 0;
this.camera.updateProjectionMatrix();
if (this.montada && this.aoRedimensionar) { this.aoRedimensionar(); }
};
Cena.prototype.laco = function () {
if (!this.rodando || document.hidden) { return; }
var eu = this;
this.passo(0.016);
this.desenhar();
requestAnimationFrame(function () { eu.laco(); });
};
Cena.prototype.desenhar = function () { this.renderer.render(this.scene, this.camera); };
Cena.prototype.passo = function (dt) { if (this.passoFn) { this.passoFn(dt); } };
function iniciar() {
if (!window.THREE) { return; }
Array.prototype.forEach.call(document.querySelectorAll('canvas[data-cena]'), function (cv) {
try { new Cena(cv); }
catch (e) { cv.style.display = 'none'; } // cena que falha some; a página segue
});
}
if (document.readyState === 'loading') { document.addEventListener('DOMContentLoaded', iniciar); }
else { setTimeout(iniciar, 0); } // dá um tique para os arquivos de cena se registrarem
return {
registrar: function (nome, montar) { cenas[nome] = montar; },
Cena: Cena,
celular: CELULAR,
reduzir: REDUZIR
};
})();
/* ===== montagem.js ================================================================= */
/* PAR-05 · Montagem — nós espalhados que se juntam numa forma de núcleo com satélites, e voltam
a se juntar depois que o cursor os espalha. As linhas ganham opacidade conforme a forma assenta.
Exige particulas-motor.js antes. data-cena="montagem"
Quantos satélites: data-satelites (padrão 8).
⚠️ No site de origem este número é 8 e todos os satélites são iguais — e isso contraria a
leitura do símbolo da OCTA (sete pontos mais um braço de solução) que a marca fixou. É
divergência aberta, registrada em _BRAND/CLAUDE.md. Em peça da marca, decida o número antes. */
(function () {
'use strict';
function alvos() {
var R = Math.min(this.w * .46, this.h * .44);
var cx = this.w * .5, cy = this.h * .5;
for (var i = 0; i < this.nos.length; i++) {
var a = (i - 1) * Math.PI * 2 / this.satelites;
this.nos[i].tx = i === 0 ? cx : cx + Math.cos(a) * R;
this.nos[i].ty = i === 0 ? cy : cy + Math.sin(a) * R;
}
}
function montar() {
this.satelites = parseInt(this.canvas.getAttribute('data-satelites') || '8', 10);
var N = this.satelites + 1; // o núcleo mais os satélites
this.nos = [];
for (var i = 0; i < N; i++) {
this.nos.push({ x: Math.random() * this.w, y: Math.random() * this.h,
vx: 0, vy: 0, tx: 0, ty: 0, nucleo: i === 0 });
}
alvos.call(this);
var pg = new THREE.BufferGeometry();
pg.setAttribute('position', new THREE.BufferAttribute(new Float32Array(N * 3), 3));
pg.setAttribute('color', new THREE.BufferAttribute(new Float32Array(N * 3), 3));
this.pts = new THREE.Points(pg, new THREE.PointsMaterial({ size: 19, vertexColors: true, map: this.PONTO, transparent: true, alphaTest: .5 }));
this.scene.add(this.pts);
var lg = new THREE.BufferGeometry();
lg.setAttribute('position', new THREE.BufferAttribute(new Float32Array(this.satelites * 6), 3));
this.linhas = new THREE.LineSegments(lg, new THREE.LineBasicMaterial({ color: this.COR, transparent: true, opacity: 0 }));
this.scene.add(this.linhas);
var eu = this;
this.passoFn = function (dt) { passo.call(eu, dt); };
this.aoRedimensionar = function () { alvos.call(this); };
}
function passo(dt) {
this.t += dt;
var assentados = 0, i;
for (i = 0; i < this.nos.length; i++) {
var p = this.nos[i];
p.vx += (p.tx - p.x) * .02; p.vy += (p.ty - p.y) * .02;
var dx = p.x - this.mouse.x, dy = p.y - this.mouse.y, d = Math.hypot(dx, dy);
if (d < 150 && d > 1) { var f = (1 - d / 150) * 2.6; p.vx += (dx / d) * f; p.vy += (dy / d) * f; }
p.vx *= .88; p.vy *= .88;
p.x += p.vx; p.y += p.vy;
if (Math.abs(p.tx - p.x) < 4 && Math.abs(p.ty - p.y) < 4) { assentados++; }
}
var pp = this.pts.geometry.attributes.position.array;
var pc = this.pts.geometry.attributes.color.array;
for (i = 0; i < this.nos.length; i++) {
pp[i * 3] = this.nos[i].x; pp[i * 3 + 1] = this.nos[i].y; pp[i * 3 + 2] = 0;
var c = this.nos[i].nucleo ? this.DESTAQUE : this.COR;
pc[i * 3] = c.r; pc[i * 3 + 1] = c.g; pc[i * 3 + 2] = c.b;
}
this.pts.geometry.attributes.position.needsUpdate = true;
this.pts.geometry.attributes.color.needsUpdate = true;
var lp = this.linhas.geometry.attributes.position.array;
var nucleo = this.nos[0];
for (i = 1; i < this.nos.length; i++) {
lp[(i - 1) * 6] = nucleo.x; lp[(i - 1) * 6 + 1] = nucleo.y; lp[(i - 1) * 6 + 2] = 0;
lp[(i - 1) * 6 + 3] = this.nos[i].x; lp[(i - 1) * 6 + 4] = this.nos[i].y; lp[(i - 1) * 6 + 5] = 0;
}
this.linhas.geometry.attributes.position.needsUpdate = true;
/* as linhas só aparecem conforme a forma assenta — e some de novo quando o cursor a desmonta */
var alvo = assentados >= this.satelites - 1 ? .42 : 0;
this.linhas.material.opacity += (alvo - this.linhas.material.opacity) * .04;
}
OctaParticulas.registrar('montagem', montar);
})();
/* ===== markup.html ================================================================= */
<!-- PAR-05 · Montagem. O <canvas> precisa de um PAI POSICIONADO com altura própria: a cena
mede o pai, não o canvas. three.js vem antes; o motor antes da cena.
data-cor e data-cor-destaque são opcionais (padrão: os do IDV da OCTA). -->
<div class="dobra" style="position:relative;min-height:60vh;overflow:hidden">
<canvas data-cena="montagem" data-cor="#ebebeb" aria-hidden="true"
style="position:absolute;inset:0;width:100%;height:100%"></canvas>
<!-- o conteúdo da dobra vai aqui, com position:relative para ficar por cima -->
</div>
<script src="three.min.js"></script>
<script src="particulas-motor.js"></script>
<script src="montagem.js"></script>
Já rodou em
- site da proposta ao Pedro (27/08/2026) — o fecho, montando o símbolo da OCTA
Exige
- three.js (r12x+), carregado antes do motor
Como se configura
data-cena — qual cena montar (obrigatorio)data-cor — a cor dos nos e das linhas (padrao #212121)data-cor-destaque — o acento (padrao #e8ad32)data-satelites — quantos satelites (padrao 8)
A ficha
O que o componente entrega
Exige: three.js (r12x+) carregado antes, e particulas-motor.js carregado antes da cena. O <canvas> precisa de um pai posicionado com altura própria — a cena mede o pai, não o canvas.
Variantes. Número de satélites pelo data-satelites (padrão 8). O núcleo sai na cor de destaque, os satélites na cor principal.
Três regras de desempenho que vêm do motor, e não são opcionais:
- pausa fora da tela (
IntersectionObservercom 80 px de folga): cena invisível não queima bateria; - DPR no teto de 2: acima disso o ganho é invisível e o custo não;
prefers-reduced-motiondesenha um quadro e para — a cena existe, não se mexe.
A câmera é ortográfica em pixel: x e y da cena são as coordenadas da tela, o que deixa a conta de física legível, sem conversão de espaço no meio do passo.
Detalhes que importam:
- As linhas do núcleo aos satélites só aparecem conforme a forma assenta, e somem de novo quando o cursor a desmonta — é a leitura de “se organizando” sem texto nenhum.
- Na versão de origem a opacidade só subia e nunca voltava; aqui ela persegue o alvo nos dois sentidos.
O que a adaptação da OCTA mudou
- O motor saiu do arquivo da cena. No site de origem as seis cenas viviam num
motion.jsde 444 linhas; aqui você inclui o motor uma vez e, depois dele, só a cena que for usar. - A cor deixou de ser constante no código e virou
data-cor/data-cor-destaqueno<canvas>. - A cena que falha some em silêncio e a página segue — o erro não derruba a dobra.
Lacunas
- ⚠️ Divergência de marca em aberto. No site de origem são 8 satélites iguais, o que contraria a leitura de sete pontos mais um braço de solução que
_BRAND/marca.mdfixou para o símbolo da OCTA. Está registrado como divergência aberta no_BRAND/CLAUDE.md. Em peça da marca, decida o número antes de usar. - A forma é sempre um círculo regular de satélites: não serve a desenho arbitrário (para isso, o PAR-06).