Files
refboard-ayon/frontend/src/canvas/operations.ts
T
Hiren Kangad e9509ef7b0 feat(refboard): canvas polish — transform box sync, dot grid, snap tuning, perf fixes
- Fix transform box not updating after alignment/arrangement/normalize/flip operations
  (shortcuts, context menu, and selection toolbar all fixed with DRY _opUpdate helper)
- Replace 100ms polling loop with event-driven viewport updates (moved + wheel-scroll)
- Add adaptive dot grid background that responds to zoom/pan
- Reduce snap guide threshold from 8px to 4px for subtler snapping
- Remove PresenceOverlay (remote selection highlighting) — too heavy for minimal benefit
- Offset multiple dropped images so they don't overlap
- Add new canvas modules: SnapGuides, clipboard, grouping, FrameSprite, DrawingSprite,
  LaserPointer, context-menu-items, SelectionToolbar, Minimap
- Extract Editor hooks into dedicated files (useBoardLoader, useCanvasSetup,
  useShortcutHandler, useLayerPanel, useSaveManager, useFollowMode)
- Sync improvements: real-time transform broadcast, board rooms, viewport sync
2026-03-10 03:58:53 +05:30

464 lines
14 KiB
TypeScript

/**
* Canvas operations — pure functions for alignment, arrangement, normalize, flip, etc.
* Each mutates item.data in place and syncs the displayObject. Caller should trigger
* any needed re-render or persistence.
*/
import type { SceneItem } from './SceneManager';
import type { ImageObject } from './scene-format';
import { ColorMatrixFilter } from 'pixi.js';
// ─── Helpers ───
function scaledW(item: SceneItem): number {
return item.data.w * item.data.sx;
}
function scaledH(item: SceneItem): number {
return item.data.h * item.data.sy;
}
/** Sync displayObject position from item.data. */
function syncPosition(item: SceneItem): void {
item.displayObject.position.set(item.data.x, item.data.y);
}
/** Sync displayObject scale from item.data. */
function syncScale(item: SceneItem): void {
item.displayObject.scale.set(item.data.sx, item.data.sy);
}
/** Sync both position and scale. */
function syncTransform(item: SceneItem): void {
syncPosition(item);
syncScale(item);
item.displayObject.angle = item.data.angle;
}
// ─── Alignment ───
export function alignLeft(objects: SceneItem[]) {
if (objects.length < 2) return;
const minLeft = Math.min(...objects.map((item) => item.data.x));
objects.forEach((item) => {
item.data.x = minLeft;
syncPosition(item);
});
}
export function alignRight(objects: SceneItem[]) {
if (objects.length < 2) return;
const maxRight = Math.max(...objects.map((item) => item.data.x + scaledW(item)));
objects.forEach((item) => {
item.data.x = maxRight - scaledW(item);
syncPosition(item);
});
}
export function alignTop(objects: SceneItem[]) {
if (objects.length < 2) return;
const minTop = Math.min(...objects.map((item) => item.data.y));
objects.forEach((item) => {
item.data.y = minTop;
syncPosition(item);
});
}
export function alignBottom(objects: SceneItem[]) {
if (objects.length < 2) return;
const maxBottom = Math.max(...objects.map((item) => item.data.y + scaledH(item)));
objects.forEach((item) => {
item.data.y = maxBottom - scaledH(item);
syncPosition(item);
});
}
// ─── Distribution ───
export function distributeHorizontal(objects: SceneItem[]) {
if (objects.length < 3) return;
const sorted = [...objects].sort((a, b) => a.data.x - b.data.x);
const first = sorted[0];
const last = sorted[sorted.length - 1];
const totalSpan = last.data.x + scaledW(last) - first.data.x;
const totalWidth = sorted.reduce((s, item) => s + scaledW(item), 0);
const gap = (totalSpan - totalWidth) / (sorted.length - 1);
let x = first.data.x + scaledW(first) + gap;
for (let i = 1; i < sorted.length - 1; i++) {
sorted[i].data.x = x;
syncPosition(sorted[i]);
x += scaledW(sorted[i]) + gap;
}
}
export function distributeVertical(objects: SceneItem[]) {
if (objects.length < 3) return;
const sorted = [...objects].sort((a, b) => a.data.y - b.data.y);
const first = sorted[0];
const last = sorted[sorted.length - 1];
const totalSpan = last.data.y + scaledH(last) - first.data.y;
const totalHeight = sorted.reduce((s, item) => s + scaledH(item), 0);
const gap = (totalSpan - totalHeight) / (sorted.length - 1);
let y = first.data.y + scaledH(first) + gap;
for (let i = 1; i < sorted.length - 1; i++) {
sorted[i].data.y = y;
syncPosition(sorted[i]);
y += scaledH(sorted[i]) + gap;
}
}
// ─── Normalize ───
export function normalizeSize(objects: SceneItem[]) {
if (objects.length < 2) return;
const areas = objects.map((item) => scaledW(item) * scaledH(item));
const avgArea = areas.reduce((a, b) => a + b, 0) / areas.length;
objects.forEach((item) => {
const currentArea = scaledW(item) * scaledH(item);
if (currentArea <= 0) return;
const ratio = Math.sqrt(avgArea / currentArea);
item.data.sx *= ratio;
item.data.sy *= ratio;
syncScale(item);
});
}
export function normalizeScale(objects: SceneItem[]) {
if (objects.length < 2) return;
const avgSX = objects.reduce((s, item) => s + item.data.sx, 0) / objects.length;
const avgSY = objects.reduce((s, item) => s + item.data.sy, 0) / objects.length;
objects.forEach((item) => {
item.data.sx = avgSX;
item.data.sy = avgSY;
syncScale(item);
});
}
export function normalizeHeight(objects: SceneItem[]) {
if (objects.length < 2) return;
const avgH = objects.reduce((s, item) => s + scaledH(item), 0) / objects.length;
objects.forEach((item) => {
const h = scaledH(item);
if (h <= 0) return;
const ratio = avgH / h;
item.data.sx *= ratio;
item.data.sy *= ratio;
syncScale(item);
});
}
export function normalizeWidth(objects: SceneItem[]) {
if (objects.length < 2) return;
const avgW = objects.reduce((s, item) => s + scaledW(item), 0) / objects.length;
objects.forEach((item) => {
const w = scaledW(item);
if (w <= 0) return;
const ratio = avgW / w;
item.data.sx *= ratio;
item.data.sy *= ratio;
syncScale(item);
});
}
// ─── Arrangement ───
export function arrangeOptimal(objects: SceneItem[]) {
if (objects.length < 2) return;
// Shelf-based bin packing, sorted by height descending
const sorted = [...objects].sort((a, b) => scaledH(b) - scaledH(a));
const gap = 10;
const totalArea = sorted.reduce((s, item) => s + scaledW(item) * scaledH(item), 0);
const shelfWidth = Math.sqrt(totalArea) * 1.3;
const startX = sorted[0].data.x;
const startY = sorted[0].data.y;
let x = 0, y = 0, shelfHeight = 0;
sorted.forEach((item) => {
const w = scaledW(item);
const h = scaledH(item);
if (x + w > shelfWidth && x > 0) {
x = 0;
y += shelfHeight + gap;
shelfHeight = 0;
}
item.data.x = startX + x;
item.data.y = startY + y;
syncPosition(item);
shelfHeight = Math.max(shelfHeight, h);
x += w + gap;
});
}
export function arrangeGrid(objects: SceneItem[]) {
if (objects.length < 2) return;
const gap = 20;
const cols = Math.ceil(Math.sqrt(objects.length));
const startX = objects[0].data.x;
const startY = objects[0].data.y;
const maxW = Math.max(...objects.map(scaledW));
const maxH = Math.max(...objects.map(scaledH));
objects.forEach((item, i) => {
const col = i % cols;
const row = Math.floor(i / cols);
item.data.x = startX + col * (maxW + gap);
item.data.y = startY + row * (maxH + gap);
syncPosition(item);
});
}
export function arrangeRow(objects: SceneItem[]) {
if (objects.length < 2) return;
const gap = 20;
const sorted = [...objects].sort((a, b) => a.data.x - b.data.x);
const startY = sorted[0].data.y;
let x = sorted[0].data.x;
sorted.forEach((item) => {
item.data.x = x;
item.data.y = startY;
syncPosition(item);
x += scaledW(item) + gap;
});
}
export function arrangeColumn(objects: SceneItem[]) {
if (objects.length < 2) return;
const gap = 20;
const sorted = [...objects].sort((a, b) => a.data.y - b.data.y);
const startX = sorted[0].data.x;
let y = sorted[0].data.y;
sorted.forEach((item) => {
item.data.x = startX;
item.data.y = y;
syncPosition(item);
y += scaledH(item) + gap;
});
}
export function stackObjects(objects: SceneItem[]) {
if (objects.length < 2) return;
const cx = objects.reduce((s, item) => s + item.data.x + scaledW(item) / 2, 0) / objects.length;
const cy = objects.reduce((s, item) => s + item.data.y + scaledH(item) / 2, 0) / objects.length;
objects.forEach((item) => {
item.data.x = cx - scaledW(item) / 2;
item.data.y = cy - scaledH(item) / 2;
syncPosition(item);
});
}
export function arrangeByName(objects: SceneItem[]) {
const sorted = [...objects].sort((a, b) =>
(a.data.name || '').localeCompare(b.data.name || '')
);
layoutAsGrid(sorted);
}
export function arrangeByZOrder(objects: SceneItem[]) {
// Sort by z-order stored in item.data.z
const sorted = [...objects].sort((a, b) => a.data.z - b.data.z);
layoutAsGrid(sorted);
}
export function arrangeRandomly(objects: SceneItem[]) {
if (objects.length < 2) return;
const minX = Math.min(...objects.map((item) => item.data.x));
const minY = Math.min(...objects.map((item) => item.data.y));
const maxX = Math.max(...objects.map((item) => item.data.x + scaledW(item)));
const maxY = Math.max(...objects.map((item) => item.data.y + scaledH(item)));
objects.forEach((item) => {
item.data.x = minX + Math.random() * (maxX - minX - scaledW(item));
item.data.y = minY + Math.random() * (maxY - minY - scaledH(item));
syncPosition(item);
});
}
function layoutAsGrid(sorted: SceneItem[]) {
if (sorted.length < 2) return;
const gap = 20;
const cols = Math.ceil(Math.sqrt(sorted.length));
const startX = sorted[0].data.x;
const startY = sorted[0].data.y;
const maxW = Math.max(...sorted.map(scaledW));
const maxH = Math.max(...sorted.map(scaledH));
sorted.forEach((item, i) => {
const col = i % cols;
const row = Math.floor(i / cols);
item.data.x = startX + col * (maxW + gap);
item.data.y = startY + row * (maxH + gap);
syncPosition(item);
});
}
// ─── Flip ───
export function flipHorizontal(objects: SceneItem[]) {
objects.forEach((item) => {
item.data.flipX = !item.data.flipX;
item.displayObject.scale.x = item.data.sx * (item.data.flipX ? -1 : 1);
});
}
export function flipVertical(objects: SceneItem[]) {
objects.forEach((item) => {
item.data.flipY = !item.data.flipY;
item.displayObject.scale.y = item.data.sy * (item.data.flipY ? -1 : 1);
});
}
// ─── Transform ───
export function resetTransform(objects: SceneItem[]) {
objects.forEach((item) => {
item.data.sx = 1;
item.data.sy = 1;
item.data.angle = 0;
item.data.flipX = false;
item.data.flipY = false;
syncTransform(item);
});
}
// ─── Grayscale ───
export function toggleGrayscale(objects: SceneItem[]) {
objects.forEach((item) => {
if (item.type !== 'image') return;
const imgData = item.data as ImageObject;
const obj = item.displayObject;
// Check if a desaturate filter is already applied
const hasGrayscale = imgData.filters.includes('Grayscale');
if (hasGrayscale) {
// Remove grayscale: clear the ColorMatrixFilter and remove from data
imgData.filters = imgData.filters.filter((f) => f !== 'Grayscale');
obj.filters = (obj.filters || []).filter((f) => !(f instanceof ColorMatrixFilter));
} else {
// Add grayscale
imgData.filters.push('Grayscale');
const filter = new ColorMatrixFilter();
filter.desaturate();
obj.filters = [...(obj.filters || []), filter];
}
});
}
// ─── Lock ───
export function toggleLocked(objects: SceneItem[]) {
objects.forEach((item) => {
item.data.locked = !item.data.locked;
item.displayObject.eventMode = item.data.locked ? 'none' : 'static';
});
}
// ─── Nudge ───
export function nudge(objects: SceneItem[], dx: number, dy: number) {
objects.forEach((item) => {
item.data.x += dx;
item.data.y += dy;
syncPosition(item);
});
}
// ─── Scale (relative) ───
export function scaleBy(objects: SceneItem[], factor: number) {
objects.forEach((item) => {
const cx = item.data.x + scaledW(item) / 2;
const cy = item.data.y + scaledH(item) / 2;
item.data.sx *= factor;
item.data.sy *= factor;
// Keep center in place
item.data.x = cx - scaledW(item) / 2;
item.data.y = cy - scaledH(item) / 2;
syncTransform(item);
});
}
// ─── Rotate (quick 90° snap) ───
export function rotate90(objects: SceneItem[], clockwise: boolean) {
objects.forEach((item) => {
item.data.angle = ((item.data.angle + (clockwise ? 90 : -90)) % 360 + 360) % 360;
item.displayObject.angle = item.data.angle;
});
}
// ─── Set Opacity ───
export function setOpacity(objects: SceneItem[], opacity: number) {
const clamped = Math.max(0, Math.min(1, opacity));
objects.forEach((item) => {
item.data.opacity = clamped;
item.displayObject.alpha = clamped;
});
}
// ─── Align Center ───
export function alignCenterH(objects: SceneItem[]) {
if (objects.length < 2) return;
const avgCX = objects.reduce((s, item) => s + item.data.x + scaledW(item) / 2, 0) / objects.length;
objects.forEach((item) => {
item.data.x = avgCX - scaledW(item) / 2;
syncPosition(item);
});
}
export function alignCenterV(objects: SceneItem[]) {
if (objects.length < 2) return;
const avgCY = objects.reduce((s, item) => s + item.data.y + scaledH(item) / 2, 0) / objects.length;
objects.forEach((item) => {
item.data.y = avgCY - scaledH(item) / 2;
syncPosition(item);
});
}
// ─── Equal Spacing ───
export function equalSpacingH(objects: SceneItem[], gap = 20) {
if (objects.length < 2) return;
const sorted = [...objects].sort((a, b) => a.data.x - b.data.x);
let x = sorted[0].data.x + scaledW(sorted[0]) + gap;
for (let i = 1; i < sorted.length; i++) {
sorted[i].data.x = x;
syncPosition(sorted[i]);
x += scaledW(sorted[i]) + gap;
}
}
export function equalSpacingV(objects: SceneItem[], gap = 20) {
if (objects.length < 2) return;
const sorted = [...objects].sort((a, b) => a.data.y - b.data.y);
let y = sorted[0].data.y + scaledH(sorted[0]) + gap;
for (let i = 1; i < sorted.length; i++) {
sorted[i].data.y = y;
syncPosition(sorted[i]);
y += scaledH(sorted[i]) + gap;
}
}
// ─── Overlay / Compare ───
export function overlayCompare(objects: SceneItem[]) {
if (objects.length < 2) return;
// If all are at 0.5 opacity, restore to 1; otherwise set to 0.5 and center-stack
const allHalf = objects.every((item) => Math.abs(item.data.opacity - 0.5) < 0.05);
if (allHalf) {
objects.forEach((item) => {
item.data.opacity = 1;
item.displayObject.alpha = 1;
});
} else {
const cx = objects.reduce((s, item) => s + item.data.x + scaledW(item) / 2, 0) / objects.length;
const cy = objects.reduce((s, item) => s + item.data.y + scaledH(item) / 2, 0) / objects.length;
objects.forEach((item) => {
item.data.opacity = 0.5;
item.data.x = cx - scaledW(item) / 2;
item.data.y = cy - scaledH(item) / 2;
item.displayObject.alpha = 0.5;
syncPosition(item);
});
}
}