import * as GA from "../ga"; import * as GAPoint from "../gapoints"; import * as GADirection from "../gadirections"; import * as GALine from "../galines"; import * as GATransform from "../gatransforms"; import { ExcalidrawBindableElement, ExcalidrawElement, ExcalidrawRectangleElement, ExcalidrawDiamondElement, ExcalidrawTextElement, ExcalidrawEllipseElement, ExcalidrawFreeDrawElement, ExcalidrawImageElement, ExcalidrawFrameLikeElement, ExcalidrawIframeLikeElement, NonDeleted, ExcalidrawLinearElement, PointBinding, NonDeletedExcalidrawElement, ElementsMap, NonDeletedSceneElementsMap, } from "./types"; import { getElementAbsoluteCoords } from "./bounds"; import { AppClassProperties, AppState, Point } from "../types"; import { isPointOnShape } from "../../utils/collision"; import { getElementAtPosition } from "../scene"; import { isBindableElement, isBindingElement, isLinearElement, } from "./typeChecks"; import { mutateElement } from "./mutateElement"; import Scene from "../scene/Scene"; import { LinearElementEditor } from "./linearElementEditor"; import { arrayToMap, tupleToCoors } from "../utils"; import { KEYS } from "../keys"; import { getBoundTextElement, handleBindTextResize } from "./textElement"; export type SuggestedBinding = | NonDeleted | SuggestedPointBinding; export type SuggestedPointBinding = [ NonDeleted, "start" | "end" | "both", NonDeleted, ]; export const shouldEnableBindingForPointerEvent = ( event: React.PointerEvent, ) => { return !event[KEYS.CTRL_OR_CMD]; }; export const isBindingEnabled = (appState: AppState): boolean => { return appState.isBindingEnabled; }; const getNonDeletedElements = ( scene: Scene, ids: readonly ExcalidrawElement["id"][], ): NonDeleted[] => { const result: NonDeleted[] = []; ids.forEach((id) => { const element = scene.getNonDeletedElement(id); if (element != null) { result.push(element); } }); return result; }; export const bindOrUnbindLinearElement = ( linearElement: NonDeleted, startBindingElement: ExcalidrawBindableElement | null | "keep", endBindingElement: ExcalidrawBindableElement | null | "keep", elementsMap: NonDeletedSceneElementsMap, ): void => { const boundToElementIds: Set = new Set(); const unboundFromElementIds: Set = new Set(); bindOrUnbindLinearElementEdge( linearElement, startBindingElement, endBindingElement, "start", boundToElementIds, unboundFromElementIds, elementsMap, ); bindOrUnbindLinearElementEdge( linearElement, endBindingElement, startBindingElement, "end", boundToElementIds, unboundFromElementIds, elementsMap, ); const onlyUnbound = Array.from(unboundFromElementIds).filter( (id) => !boundToElementIds.has(id), ); getNonDeletedElements(Scene.getScene(linearElement)!, onlyUnbound).forEach( (element) => { mutateElement(element, { boundElements: element.boundElements?.filter( (element) => element.type !== "arrow" || element.id !== linearElement.id, ), }); }, ); }; const bindOrUnbindLinearElementEdge = ( linearElement: NonDeleted, bindableElement: ExcalidrawBindableElement | null | "keep", otherEdgeBindableElement: ExcalidrawBindableElement | null | "keep", startOrEnd: "start" | "end", // Is mutated boundToElementIds: Set, // Is mutated unboundFromElementIds: Set, elementsMap: NonDeletedSceneElementsMap, ): void => { if (bindableElement !== "keep") { if (bindableElement != null) { // Don't bind if we're trying to bind or are already bound to the same // element on the other edge already ("start" edge takes precedence). if ( otherEdgeBindableElement == null || (otherEdgeBindableElement === "keep" ? !isLinearElementSimpleAndAlreadyBoundOnOppositeEdge( linearElement, bindableElement, startOrEnd, ) : startOrEnd === "start" || otherEdgeBindableElement.id !== bindableElement.id) ) { bindLinearElement( linearElement, bindableElement, startOrEnd, elementsMap, ); boundToElementIds.add(bindableElement.id); } } else { const unbound = unbindLinearElement(linearElement, startOrEnd); if (unbound != null) { unboundFromElementIds.add(unbound); } } } }; export const bindOrUnbindSelectedElements = ( selectedElements: NonDeleted[], app: AppClassProperties, ): void => { selectedElements.forEach((selectedElement) => { if (isBindingElement(selectedElement)) { bindOrUnbindLinearElement( selectedElement, getElligibleElementForBindingElement(selectedElement, "start", app), getElligibleElementForBindingElement(selectedElement, "end", app), app.scene.getNonDeletedElementsMap(), ); } else if (isBindableElement(selectedElement)) { maybeBindBindableElement( selectedElement, app.scene.getNonDeletedElementsMap(), app, ); } }); }; const maybeBindBindableElement = ( bindableElement: NonDeleted, elementsMap: NonDeletedSceneElementsMap, app: AppClassProperties, ): void => { getElligibleElementsForBindableElementAndWhere(bindableElement, app).forEach( ([linearElement, where]) => bindOrUnbindLinearElement( linearElement, where === "end" ? "keep" : bindableElement, where === "start" ? "keep" : bindableElement, elementsMap, ), ); }; export const maybeBindLinearElement = ( linearElement: NonDeleted, appState: AppState, pointerCoords: { x: number; y: number }, app: AppClassProperties, ): void => { if (appState.startBoundElement != null) { bindLinearElement( linearElement, appState.startBoundElement, "start", app.scene.getNonDeletedElementsMap(), ); } const hoveredElement = getHoveredElementForBinding(pointerCoords, app); if ( hoveredElement != null && !isLinearElementSimpleAndAlreadyBoundOnOppositeEdge( linearElement, hoveredElement, "end", ) ) { bindLinearElement( linearElement, hoveredElement, "end", app.scene.getNonDeletedElementsMap(), ); } }; export const bindLinearElement = ( linearElement: NonDeleted, hoveredElement: ExcalidrawBindableElement, startOrEnd: "start" | "end", elementsMap: NonDeletedSceneElementsMap, ): void => { mutateElement(linearElement, { [startOrEnd === "start" ? "startBinding" : "endBinding"]: { elementId: hoveredElement.id, ...calculateFocusAndGap( linearElement, hoveredElement, startOrEnd, elementsMap, ), } as PointBinding, }); const boundElementsMap = arrayToMap(hoveredElement.boundElements || []); if (!boundElementsMap.has(linearElement.id)) { mutateElement(hoveredElement, { boundElements: (hoveredElement.boundElements || []).concat({ id: linearElement.id, type: "arrow", }), }); } }; // Don't bind both ends of a simple segment const isLinearElementSimpleAndAlreadyBoundOnOppositeEdge = ( linearElement: NonDeleted, bindableElement: ExcalidrawBindableElement, startOrEnd: "start" | "end", ): boolean => { const otherBinding = linearElement[startOrEnd === "start" ? "endBinding" : "startBinding"]; return isLinearElementSimpleAndAlreadyBound( linearElement, otherBinding?.elementId, bindableElement, ); }; export const isLinearElementSimpleAndAlreadyBound = ( linearElement: NonDeleted, alreadyBoundToId: ExcalidrawBindableElement["id"] | undefined, bindableElement: ExcalidrawBindableElement, ): boolean => { return ( alreadyBoundToId === bindableElement.id && linearElement.points.length < 3 ); }; export const unbindLinearElements = ( elements: readonly NonDeleted[], elementsMap: NonDeletedSceneElementsMap, ): void => { elements.forEach((element) => { if (isBindingElement(element)) { bindOrUnbindLinearElement(element, null, null, elementsMap); } }); }; const unbindLinearElement = ( linearElement: NonDeleted, startOrEnd: "start" | "end", ): ExcalidrawBindableElement["id"] | null => { const field = startOrEnd === "start" ? "startBinding" : "endBinding"; const binding = linearElement[field]; if (binding == null) { return null; } mutateElement(linearElement, { [field]: null }); return binding.elementId; }; export const getHoveredElementForBinding = ( pointerCoords: { x: number; y: number; }, app: AppClassProperties, ): NonDeleted | null => { const hoveredElement = getElementAtPosition( app.scene.getNonDeletedElements(), (element) => isBindableElement(element, false) && bindingBorderTest(element, pointerCoords, app), ); return hoveredElement as NonDeleted | null; }; const calculateFocusAndGap = ( linearElement: NonDeleted, hoveredElement: ExcalidrawBindableElement, startOrEnd: "start" | "end", elementsMap: NonDeletedSceneElementsMap, ): { focus: number; gap: number } => { const direction = startOrEnd === "start" ? -1 : 1; const edgePointIndex = direction === -1 ? 0 : linearElement.points.length - 1; const adjacentPointIndex = edgePointIndex - direction; const edgePoint = LinearElementEditor.getPointAtIndexGlobalCoordinates( linearElement, edgePointIndex, elementsMap, ); const adjacentPoint = LinearElementEditor.getPointAtIndexGlobalCoordinates( linearElement, adjacentPointIndex, elementsMap, ); return { focus: determineFocusDistance( hoveredElement, adjacentPoint, edgePoint, elementsMap, ), gap: Math.max( 1, distanceToBindableElement(hoveredElement, edgePoint, elementsMap), ), }; }; // Supports translating, rotating and scaling `changedElement` with bound // linear elements. // Because scaling involves moving the focus points as well, it is // done before the `changedElement` is updated, and the `newSize` is passed // in explicitly. export const updateBoundElements = ( changedElement: NonDeletedExcalidrawElement, elementsMap: ElementsMap, options?: { simultaneouslyUpdated?: readonly ExcalidrawElement[]; newSize?: { width: number; height: number }; }, ) => { const boundLinearElements = (changedElement.boundElements ?? []).filter( (el) => el.type === "arrow", ); if (boundLinearElements.length === 0) { return; } const { newSize, simultaneouslyUpdated } = options ?? {}; const simultaneouslyUpdatedElementIds = getSimultaneouslyUpdatedElementIds( simultaneouslyUpdated, ); const scene = Scene.getScene(changedElement)!; getNonDeletedElements( scene, boundLinearElements.map((el) => el.id), ).forEach((element) => { if (!isLinearElement(element)) { return; } const bindableElement = changedElement as ExcalidrawBindableElement; // In case the boundElements are stale if (!doesNeedUpdate(element, bindableElement)) { return; } const startBinding = maybeCalculateNewGapWhenScaling( bindableElement, element.startBinding, newSize, ); const endBinding = maybeCalculateNewGapWhenScaling( bindableElement, element.endBinding, newSize, ); // `linearElement` is being moved/scaled already, just update the binding if (simultaneouslyUpdatedElementIds.has(element.id)) { mutateElement(element, { startBinding, endBinding }); return; } updateBoundPoint( element, "start", startBinding, changedElement as ExcalidrawBindableElement, elementsMap, ); updateBoundPoint( element, "end", endBinding, changedElement as ExcalidrawBindableElement, elementsMap, ); const boundText = getBoundTextElement( element, scene.getNonDeletedElementsMap(), ); if (boundText) { handleBindTextResize(element, scene.getNonDeletedElementsMap(), false); } }); }; const doesNeedUpdate = ( boundElement: NonDeleted, changedElement: ExcalidrawBindableElement, ) => { return ( boundElement.startBinding?.elementId === changedElement.id || boundElement.endBinding?.elementId === changedElement.id ); }; const getSimultaneouslyUpdatedElementIds = ( simultaneouslyUpdated: readonly ExcalidrawElement[] | undefined, ): Set => { return new Set((simultaneouslyUpdated || []).map((element) => element.id)); }; const updateBoundPoint = ( linearElement: NonDeleted, startOrEnd: "start" | "end", binding: PointBinding | null | undefined, changedElement: ExcalidrawBindableElement, elementsMap: ElementsMap, ): void => { if ( binding == null || // We only need to update the other end if this is a 2 point line element (binding.elementId !== changedElement.id && linearElement.points.length > 2) ) { return; } const bindingElement = Scene.getScene(linearElement)!.getElement( binding.elementId, ) as ExcalidrawBindableElement | null; if (bindingElement == null) { // We're not cleaning up after deleted elements atm., so handle this case return; } const direction = startOrEnd === "start" ? -1 : 1; const edgePointIndex = direction === -1 ? 0 : linearElement.points.length - 1; const adjacentPointIndex = edgePointIndex - direction; const adjacentPoint = LinearElementEditor.getPointAtIndexGlobalCoordinates( linearElement, adjacentPointIndex, elementsMap, ); const focusPointAbsolute = determineFocusPoint( bindingElement, binding.focus, adjacentPoint, elementsMap, ); let newEdgePoint; // The linear element was not originally pointing inside the bound shape, // we can point directly at the focus point if (binding.gap === 0) { newEdgePoint = focusPointAbsolute; } else { const intersections = intersectElementWithLine( bindingElement, adjacentPoint, focusPointAbsolute, binding.gap, elementsMap, ); if (intersections.length === 0) { // This should never happen, since focusPoint should always be // inside the element, but just in case, bail out newEdgePoint = focusPointAbsolute; } else { // Guaranteed to intersect because focusPoint is always inside the shape newEdgePoint = intersections[0]; } } LinearElementEditor.movePoints( linearElement, [ { index: edgePointIndex, point: LinearElementEditor.pointFromAbsoluteCoords( linearElement, newEdgePoint, elementsMap, ), }, ], { [startOrEnd === "start" ? "startBinding" : "endBinding"]: binding }, ); }; const maybeCalculateNewGapWhenScaling = ( changedElement: ExcalidrawBindableElement, currentBinding: PointBinding | null | undefined, newSize: { width: number; height: number } | undefined, ): PointBinding | null | undefined => { if (currentBinding == null || newSize == null) { return currentBinding; } const { gap, focus, elementId } = currentBinding; const { width: newWidth, height: newHeight } = newSize; const { width, height } = changedElement; const newGap = Math.max( 1, Math.min( maxBindingGap(changedElement, newWidth, newHeight), gap * (newWidth < newHeight ? newWidth / width : newHeight / height), ), ); return { elementId, gap: newGap, focus }; }; // TODO: this is a bottleneck, optimise export const getEligibleElementsForBinding = ( selectedElements: NonDeleted[], app: AppClassProperties, ): SuggestedBinding[] => { const includedElementIds = new Set(selectedElements.map(({ id }) => id)); return selectedElements.flatMap((selectedElement) => isBindingElement(selectedElement, false) ? (getElligibleElementsForBindingElement( selectedElement as NonDeleted, app, ).filter( (element) => !includedElementIds.has(element.id), ) as SuggestedBinding[]) : isBindableElement(selectedElement, false) ? getElligibleElementsForBindableElementAndWhere( selectedElement, app, ).filter((binding) => !includedElementIds.has(binding[0].id)) : [], ); }; const getElligibleElementsForBindingElement = ( linearElement: NonDeleted, app: AppClassProperties, ): NonDeleted[] => { return [ getElligibleElementForBindingElement(linearElement, "start", app), getElligibleElementForBindingElement(linearElement, "end", app), ].filter( (element): element is NonDeleted => element != null, ); }; const getElligibleElementForBindingElement = ( linearElement: NonDeleted, startOrEnd: "start" | "end", app: AppClassProperties, ): NonDeleted | null => { return getHoveredElementForBinding( getLinearElementEdgeCoors( linearElement, startOrEnd, app.scene.getNonDeletedElementsMap(), ), app, ); }; const getLinearElementEdgeCoors = ( linearElement: NonDeleted, startOrEnd: "start" | "end", elementsMap: NonDeletedSceneElementsMap, ): { x: number; y: number } => { const index = startOrEnd === "start" ? 0 : -1; return tupleToCoors( LinearElementEditor.getPointAtIndexGlobalCoordinates( linearElement, index, elementsMap, ), ); }; const getElligibleElementsForBindableElementAndWhere = ( bindableElement: NonDeleted, app: AppClassProperties, ): SuggestedPointBinding[] => { const scene = Scene.getScene(bindableElement)!; return scene .getNonDeletedElements() .map((element) => { if (!isBindingElement(element, false)) { return null; } const canBindStart = isLinearElementEligibleForNewBindingByBindable( element, "start", bindableElement, scene.getNonDeletedElementsMap(), app, ); const canBindEnd = isLinearElementEligibleForNewBindingByBindable( element, "end", bindableElement, scene.getNonDeletedElementsMap(), app, ); if (!canBindStart && !canBindEnd) { return null; } return [ element, canBindStart && canBindEnd ? "both" : canBindStart ? "start" : "end", bindableElement, ]; }) .filter((maybeElement) => maybeElement != null) as SuggestedPointBinding[]; }; const isLinearElementEligibleForNewBindingByBindable = ( linearElement: NonDeleted, startOrEnd: "start" | "end", bindableElement: NonDeleted, elementsMap: NonDeletedSceneElementsMap, app: AppClassProperties, ): boolean => { const existingBinding = linearElement[startOrEnd === "start" ? "startBinding" : "endBinding"]; return ( existingBinding == null && !isLinearElementSimpleAndAlreadyBoundOnOppositeEdge( linearElement, bindableElement, startOrEnd, ) && bindingBorderTest( bindableElement, getLinearElementEdgeCoors(linearElement, startOrEnd, elementsMap), app, ) ); }; // We need to: // 1: Update elements not selected to point to duplicated elements // 2: Update duplicated elements to point to other duplicated elements export const fixBindingsAfterDuplication = ( sceneElements: readonly ExcalidrawElement[], oldElements: readonly ExcalidrawElement[], oldIdToDuplicatedId: Map, // There are three copying mechanisms: Copy-paste, duplication and alt-drag. // Only when alt-dragging the new "duplicates" act as the "old", while // the "old" elements act as the "new copy" - essentially working reverse // to the other two. duplicatesServeAsOld?: "duplicatesServeAsOld" | undefined, ): void => { // First collect all the binding/bindable elements, so we only update // each once, regardless of whether they were duplicated or not. const allBoundElementIds: Set = new Set(); const allBindableElementIds: Set = new Set(); const shouldReverseRoles = duplicatesServeAsOld === "duplicatesServeAsOld"; oldElements.forEach((oldElement) => { const { boundElements } = oldElement; if (boundElements != null && boundElements.length > 0) { boundElements.forEach((boundElement) => { if (shouldReverseRoles && !oldIdToDuplicatedId.has(boundElement.id)) { allBoundElementIds.add(boundElement.id); } }); allBindableElementIds.add(oldIdToDuplicatedId.get(oldElement.id)!); } if (isBindingElement(oldElement)) { if (oldElement.startBinding != null) { const { elementId } = oldElement.startBinding; if (shouldReverseRoles && !oldIdToDuplicatedId.has(elementId)) { allBindableElementIds.add(elementId); } } if (oldElement.endBinding != null) { const { elementId } = oldElement.endBinding; if (shouldReverseRoles && !oldIdToDuplicatedId.has(elementId)) { allBindableElementIds.add(elementId); } } if (oldElement.startBinding != null || oldElement.endBinding != null) { allBoundElementIds.add(oldIdToDuplicatedId.get(oldElement.id)!); } } }); // Update the linear elements ( sceneElements.filter(({ id }) => allBoundElementIds.has(id), ) as ExcalidrawLinearElement[] ).forEach((element) => { const { startBinding, endBinding } = element; mutateElement(element, { startBinding: newBindingAfterDuplication( startBinding, oldIdToDuplicatedId, ), endBinding: newBindingAfterDuplication(endBinding, oldIdToDuplicatedId), }); }); // Update the bindable shapes sceneElements .filter(({ id }) => allBindableElementIds.has(id)) .forEach((bindableElement) => { const { boundElements } = bindableElement; if (boundElements != null && boundElements.length > 0) { mutateElement(bindableElement, { boundElements: boundElements.map((boundElement) => oldIdToDuplicatedId.has(boundElement.id) ? { id: oldIdToDuplicatedId.get(boundElement.id)!, type: boundElement.type, } : boundElement, ), }); } }); }; const newBindingAfterDuplication = ( binding: PointBinding | null, oldIdToDuplicatedId: Map, ): PointBinding | null => { if (binding == null) { return null; } const { elementId, focus, gap } = binding; return { focus, gap, elementId: oldIdToDuplicatedId.get(elementId) ?? elementId, }; }; export const fixBindingsAfterDeletion = ( sceneElements: readonly ExcalidrawElement[], deletedElements: readonly ExcalidrawElement[], ): void => { const deletedElementIds = new Set( deletedElements.map((element) => element.id), ); // non-deleted which bindings need to be updated const affectedElements: Set = new Set(); deletedElements.forEach((deletedElement) => { if (isBindableElement(deletedElement)) { deletedElement.boundElements?.forEach((element) => { if (!deletedElementIds.has(element.id)) { affectedElements.add(element.id); } }); } else if (isBindingElement(deletedElement)) { if (deletedElement.startBinding) { affectedElements.add(deletedElement.startBinding.elementId); } if (deletedElement.endBinding) { affectedElements.add(deletedElement.endBinding.elementId); } } }); sceneElements .filter(({ id }) => affectedElements.has(id)) .forEach((element) => { if (isBindableElement(element)) { mutateElement(element, { boundElements: newBoundElementsAfterDeletion( element.boundElements, deletedElementIds, ), }); } else if (isBindingElement(element)) { mutateElement(element, { startBinding: newBindingAfterDeletion( element.startBinding, deletedElementIds, ), endBinding: newBindingAfterDeletion( element.endBinding, deletedElementIds, ), }); } }); }; const newBindingAfterDeletion = ( binding: PointBinding | null, deletedElementIds: Set, ): PointBinding | null => { if (binding == null || deletedElementIds.has(binding.elementId)) { return null; } return binding; }; const newBoundElementsAfterDeletion = ( boundElements: ExcalidrawElement["boundElements"], deletedElementIds: Set, ) => { if (!boundElements) { return null; } return boundElements.filter((ele) => !deletedElementIds.has(ele.id)); }; export const bindingBorderTest = ( element: NonDeleted, { x, y }: { x: number; y: number }, app: AppClassProperties, ): boolean => { const threshold = maxBindingGap(element, element.width, element.height); const shape = app.getElementShape(element); return isPointOnShape([x, y], shape, threshold); }; export const maxBindingGap = ( element: ExcalidrawElement, elementWidth: number, elementHeight: number, ): number => { // Aligns diamonds with rectangles const shapeRatio = element.type === "diamond" ? 1 / Math.sqrt(2) : 1; const smallerDimension = shapeRatio * Math.min(elementWidth, elementHeight); // We make the bindable boundary bigger for bigger elements return Math.max(16, Math.min(0.25 * smallerDimension, 32)); }; export const distanceToBindableElement = ( element: ExcalidrawBindableElement, point: Point, elementsMap: ElementsMap, ): number => { switch (element.type) { case "rectangle": case "image": case "text": case "iframe": case "embeddable": case "frame": case "magicframe": return distanceToRectangle(element, point, elementsMap); case "diamond": return distanceToDiamond(element, point, elementsMap); case "ellipse": return distanceToEllipse(element, point, elementsMap); } }; const distanceToRectangle = ( element: | ExcalidrawRectangleElement | ExcalidrawTextElement | ExcalidrawFreeDrawElement | ExcalidrawImageElement | ExcalidrawIframeLikeElement | ExcalidrawFrameLikeElement, point: Point, elementsMap: ElementsMap, ): number => { const [, pointRel, hwidth, hheight] = pointRelativeToElement( element, point, elementsMap, ); return Math.max( GAPoint.distanceToLine(pointRel, GALine.equation(0, 1, -hheight)), GAPoint.distanceToLine(pointRel, GALine.equation(1, 0, -hwidth)), ); }; const distanceToDiamond = ( element: ExcalidrawDiamondElement, point: Point, elementsMap: ElementsMap, ): number => { const [, pointRel, hwidth, hheight] = pointRelativeToElement( element, point, elementsMap, ); const side = GALine.equation(hheight, hwidth, -hheight * hwidth); return GAPoint.distanceToLine(pointRel, side); }; export const distanceToEllipse = ( element: ExcalidrawEllipseElement, point: Point, elementsMap: ElementsMap, ): number => { const [pointRel, tangent] = ellipseParamsForTest(element, point, elementsMap); return -GALine.sign(tangent) * GAPoint.distanceToLine(pointRel, tangent); }; const ellipseParamsForTest = ( element: ExcalidrawEllipseElement, point: Point, elementsMap: ElementsMap, ): [GA.Point, GA.Line] => { const [, pointRel, hwidth, hheight] = pointRelativeToElement( element, point, elementsMap, ); const [px, py] = GAPoint.toTuple(pointRel); // We're working in positive quadrant, so start with `t = 45deg`, `tx=cos(t)` let tx = 0.707; let ty = 0.707; const a = hwidth; const b = hheight; // This is a numerical method to find the params tx, ty at which // the ellipse has the closest point to the given point [0, 1, 2, 3].forEach((_) => { const xx = a * tx; const yy = b * ty; const ex = ((a * a - b * b) * tx ** 3) / a; const ey = ((b * b - a * a) * ty ** 3) / b; const rx = xx - ex; const ry = yy - ey; const qx = px - ex; const qy = py - ey; const r = Math.hypot(ry, rx); const q = Math.hypot(qy, qx); tx = Math.min(1, Math.max(0, ((qx * r) / q + ex) / a)); ty = Math.min(1, Math.max(0, ((qy * r) / q + ey) / b)); const t = Math.hypot(ty, tx); tx /= t; ty /= t; }); const closestPoint = GA.point(a * tx, b * ty); const tangent = GALine.orthogonalThrough(pointRel, closestPoint); return [pointRel, tangent]; }; // Returns: // 1. the point relative to the elements (x, y) position // 2. the point relative to the element's center with positive (x, y) // 3. half element width // 4. half element height // // Note that for linear elements the (x, y) position is not at the // top right corner of their boundary. // // Rectangles, diamonds and ellipses are symmetrical over axes, // and other elements have a rectangular boundary, // so we only need to perform hit tests for the positive quadrant. const pointRelativeToElement = ( element: ExcalidrawElement, pointTuple: Point, elementsMap: ElementsMap, ): [GA.Point, GA.Point, number, number] => { const point = GAPoint.from(pointTuple); const [x1, y1, x2, y2] = getElementAbsoluteCoords(element, elementsMap); const center = coordsCenter(x1, y1, x2, y2); // GA has angle orientation opposite to `rotate` const rotate = GATransform.rotation(center, element.angle); const pointRotated = GATransform.apply(rotate, point); const pointRelToCenter = GA.sub(pointRotated, GADirection.from(center)); const pointRelToCenterAbs = GAPoint.abs(pointRelToCenter); const elementPos = GA.offset(element.x, element.y); const pointRelToPos = GA.sub(pointRotated, elementPos); const halfWidth = (x2 - x1) / 2; const halfHeight = (y2 - y1) / 2; return [pointRelToPos, pointRelToCenterAbs, halfWidth, halfHeight]; }; const relativizationToElementCenter = ( element: ExcalidrawElement, elementsMap: ElementsMap, ): GA.Transform => { const [x1, y1, x2, y2] = getElementAbsoluteCoords(element, elementsMap); const center = coordsCenter(x1, y1, x2, y2); // GA has angle orientation opposite to `rotate` const rotate = GATransform.rotation(center, element.angle); const translate = GA.reverse( GATransform.translation(GADirection.from(center)), ); return GATransform.compose(rotate, translate); }; const coordsCenter = ( x1: number, y1: number, x2: number, y2: number, ): GA.Point => { return GA.point((x1 + x2) / 2, (y1 + y2) / 2); }; // The focus distance is the oriented ratio between the size of // the `element` and the "focus image" of the element on which // all focus points lie, so it's a number between -1 and 1. // The line going through `a` and `b` is a tangent to the "focus image" // of the element. export const determineFocusDistance = ( element: ExcalidrawBindableElement, // Point on the line, in absolute coordinates a: Point, // Another point on the line, in absolute coordinates (closer to element) b: Point, elementsMap: ElementsMap, ): number => { const relateToCenter = relativizationToElementCenter(element, elementsMap); const aRel = GATransform.apply(relateToCenter, GAPoint.from(a)); const bRel = GATransform.apply(relateToCenter, GAPoint.from(b)); const line = GALine.through(aRel, bRel); const q = element.height / element.width; const hwidth = element.width / 2; const hheight = element.height / 2; const n = line[2]; const m = line[3]; const c = line[1]; const mabs = Math.abs(m); const nabs = Math.abs(n); let ret; switch (element.type) { case "rectangle": case "image": case "text": case "iframe": case "embeddable": case "frame": case "magicframe": ret = c / (hwidth * (nabs + q * mabs)); break; case "diamond": ret = mabs < nabs ? c / (nabs * hwidth) : c / (mabs * hheight); break; case "ellipse": ret = c / (hwidth * Math.sqrt(n ** 2 + q ** 2 * m ** 2)); break; } return ret || 0; }; export const determineFocusPoint = ( element: ExcalidrawBindableElement, // The oriented, relative distance from the center of `element` of the // returned focusPoint focus: number, adjecentPoint: Point, elementsMap: ElementsMap, ): Point => { if (focus === 0) { const [x1, y1, x2, y2] = getElementAbsoluteCoords(element, elementsMap); const center = coordsCenter(x1, y1, x2, y2); return GAPoint.toTuple(center); } const relateToCenter = relativizationToElementCenter(element, elementsMap); const adjecentPointRel = GATransform.apply( relateToCenter, GAPoint.from(adjecentPoint), ); const reverseRelateToCenter = GA.reverse(relateToCenter); let point; switch (element.type) { case "rectangle": case "image": case "text": case "diamond": case "iframe": case "embeddable": case "frame": case "magicframe": point = findFocusPointForRectangulars(element, focus, adjecentPointRel); break; case "ellipse": point = findFocusPointForEllipse(element, focus, adjecentPointRel); break; } return GAPoint.toTuple(GATransform.apply(reverseRelateToCenter, point)); }; // Returns 2 or 0 intersection points between line going through `a` and `b` // and the `element`, in ascending order of distance from `a`. export const intersectElementWithLine = ( element: ExcalidrawBindableElement, // Point on the line, in absolute coordinates a: Point, // Another point on the line, in absolute coordinates b: Point, // If given, the element is inflated by this value gap: number = 0, elementsMap: ElementsMap, ): Point[] => { const relateToCenter = relativizationToElementCenter(element, elementsMap); const aRel = GATransform.apply(relateToCenter, GAPoint.from(a)); const bRel = GATransform.apply(relateToCenter, GAPoint.from(b)); const line = GALine.through(aRel, bRel); const reverseRelateToCenter = GA.reverse(relateToCenter); const intersections = getSortedElementLineIntersections( element, line, aRel, gap, ); return intersections.map((point) => GAPoint.toTuple(GATransform.apply(reverseRelateToCenter, point)), ); }; const getSortedElementLineIntersections = ( element: ExcalidrawBindableElement, // Relative to element center line: GA.Line, // Relative to element center nearPoint: GA.Point, gap: number = 0, ): GA.Point[] => { let intersections: GA.Point[]; switch (element.type) { case "rectangle": case "image": case "text": case "diamond": case "iframe": case "embeddable": case "frame": case "magicframe": const corners = getCorners(element); intersections = corners .flatMap((point, i) => { const edge: [GA.Point, GA.Point] = [point, corners[(i + 1) % 4]]; return intersectSegment(line, offsetSegment(edge, gap)); }) .concat( corners.flatMap((point) => getCircleIntersections(point, gap, line)), ); break; case "ellipse": intersections = getEllipseIntersections(element, gap, line); break; } if (intersections.length < 2) { // Ignore the "edge" case of only intersecting with a single corner return []; } const sortedIntersections = intersections.sort( (i1, i2) => GAPoint.distance(i1, nearPoint) - GAPoint.distance(i2, nearPoint), ); return [ sortedIntersections[0], sortedIntersections[sortedIntersections.length - 1], ]; }; const getCorners = ( element: | ExcalidrawRectangleElement | ExcalidrawImageElement | ExcalidrawDiamondElement | ExcalidrawTextElement | ExcalidrawIframeLikeElement | ExcalidrawFrameLikeElement, scale: number = 1, ): GA.Point[] => { const hx = (scale * element.width) / 2; const hy = (scale * element.height) / 2; switch (element.type) { case "rectangle": case "image": case "text": case "iframe": case "embeddable": case "frame": case "magicframe": return [ GA.point(hx, hy), GA.point(hx, -hy), GA.point(-hx, -hy), GA.point(-hx, hy), ]; case "diamond": return [ GA.point(0, hy), GA.point(hx, 0), GA.point(0, -hy), GA.point(-hx, 0), ]; } }; // Returns intersection of `line` with `segment`, with `segment` moved by // `gap` in its polar direction. // If intersection coincides with second segment point returns empty array. const intersectSegment = ( line: GA.Line, segment: [GA.Point, GA.Point], ): GA.Point[] => { const [a, b] = segment; const aDist = GAPoint.distanceToLine(a, line); const bDist = GAPoint.distanceToLine(b, line); if (aDist * bDist >= 0) { // The intersection is outside segment `(a, b)` return []; } return [GAPoint.intersect(line, GALine.through(a, b))]; }; const offsetSegment = ( segment: [GA.Point, GA.Point], distance: number, ): [GA.Point, GA.Point] => { const [a, b] = segment; const offset = GATransform.translationOrthogonal( GADirection.fromTo(a, b), distance, ); return [GATransform.apply(offset, a), GATransform.apply(offset, b)]; }; const getEllipseIntersections = ( element: ExcalidrawEllipseElement, gap: number, line: GA.Line, ): GA.Point[] => { const a = element.width / 2 + gap; const b = element.height / 2 + gap; const m = line[2]; const n = line[3]; const c = line[1]; const squares = a * a * m * m + b * b * n * n; const discr = squares - c * c; if (squares === 0 || discr <= 0) { return []; } const discrRoot = Math.sqrt(discr); const xn = -a * a * m * c; const yn = -b * b * n * c; return [ GA.point( (xn + a * b * n * discrRoot) / squares, (yn - a * b * m * discrRoot) / squares, ), GA.point( (xn - a * b * n * discrRoot) / squares, (yn + a * b * m * discrRoot) / squares, ), ]; }; export const getCircleIntersections = ( center: GA.Point, radius: number, line: GA.Line, ): GA.Point[] => { if (radius === 0) { return GAPoint.distanceToLine(line, center) === 0 ? [center] : []; } const m = line[2]; const n = line[3]; const c = line[1]; const [a, b] = GAPoint.toTuple(center); const r = radius; const squares = m * m + n * n; const discr = r * r * squares - (m * a + n * b + c) ** 2; if (squares === 0 || discr <= 0) { return []; } const discrRoot = Math.sqrt(discr); const xn = a * n * n - b * m * n - m * c; const yn = b * m * m - a * m * n - n * c; return [ GA.point((xn + n * discrRoot) / squares, (yn - m * discrRoot) / squares), GA.point((xn - n * discrRoot) / squares, (yn + m * discrRoot) / squares), ]; }; // The focus point is the tangent point of the "focus image" of the // `element`, where the tangent goes through `point`. export const findFocusPointForEllipse = ( ellipse: ExcalidrawEllipseElement, // Between -1 and 1 (not 0) the relative size of the "focus image" of // the element on which the focus point lies relativeDistance: number, // The point for which we're trying to find the focus point, relative // to the ellipse center. point: GA.Point, ): GA.Point => { const relativeDistanceAbs = Math.abs(relativeDistance); const a = (ellipse.width * relativeDistanceAbs) / 2; const b = (ellipse.height * relativeDistanceAbs) / 2; const orientation = Math.sign(relativeDistance); const [px, pyo] = GAPoint.toTuple(point); // The calculation below can't handle py = 0 const py = pyo === 0 ? 0.0001 : pyo; const squares = px ** 2 * b ** 2 + py ** 2 * a ** 2; // Tangent mx + ny + 1 = 0 const m = (-px * b ** 2 + orientation * py * Math.sqrt(Math.max(0, squares - a ** 2 * b ** 2))) / squares; let n = (-m * px - 1) / py; if (n === 0) { // if zero {-0, 0}, fall back to a same-sign value in the similar range n = (Object.is(n, -0) ? -1 : 1) * 0.01; } const x = -(a ** 2 * m) / (n ** 2 * b ** 2 + m ** 2 * a ** 2); return GA.point(x, (-m * x - 1) / n); }; export const findFocusPointForRectangulars = ( element: | ExcalidrawRectangleElement | ExcalidrawImageElement | ExcalidrawDiamondElement | ExcalidrawTextElement | ExcalidrawIframeLikeElement | ExcalidrawFrameLikeElement, // Between -1 and 1 for how far away should the focus point be relative // to the size of the element. Sign determines orientation. relativeDistance: number, // The point for which we're trying to find the focus point, relative // to the element center. point: GA.Point, ): GA.Point => { const relativeDistanceAbs = Math.abs(relativeDistance); const orientation = Math.sign(relativeDistance); const corners = getCorners(element, relativeDistanceAbs); let maxDistance = 0; let tangentPoint: null | GA.Point = null; corners.forEach((corner) => { const distance = orientation * GALine.through(point, corner)[1]; if (distance > maxDistance) { maxDistance = distance; tangentPoint = corner; } }); return tangentPoint!; };