/Web APIs

InkPresenter: updateInkTrailStartPoint() method

Experimental: This is an experimental technology
Check the Browser compatibility table carefully before using this in production.

The updateInkTrailStartPoint() method of the InkPresenter interface indicates which PointerEvent was used as the last rendering point for the current frame, allowing the OS-level compositor to render a delegated ink trail ahead of the next pointer event being dispatched.



requestPresenter(event, style)


event Optional

A PointerEvent.


An object defining the trail style, which contains the following properties:


A String containing a valid CSS color code, indicating the color the presenter will use when rendering the ink trail.


A number representing the diameter the presenter will use when rendering the ink trail.

Return value



Error DOMException

An error is thrown and the operation is aborted if the:

  • color property does not contain a valid CSS color code.
  • diameter property is not a number or less than 1.
  • presentationArea element is removed from the document before or during rendering.


Drawing an ink trail

In this example, we draw a trail onto a 2D canvas. Near the start of the code, we call Ink.requestPresenter(), passing it the canvas as the presentation area for it to take care of and storing the promise it returns in the presenter variable.

Later on, in the pointermove event listener, the new position of the trailhead is drawn onto the canvas each time the event fires. In addition, the InkPresenter object returned when the presenter promise fulfills has its updateInkTrailStartPoint() method invoked; this is passed:

  • The last trusted pointer event representing the rendering point for the current frame.
  • A style object containing color and diameter settings.

The result is that a delegated ink trail is drawn ahead of the default browser rendering on the app's behalf, in the specified style, until the next time it receives a pointermove event.



<canvas id="canvas"></canvas>
<div id="div">Delegated ink trail should match the color of this div.</div>



div {
  background-color: rgba(0, 255, 0, 1);
  position: fixed;
  top: 1rem;
  left: 1rem;



const ctx = canvas.getContext("2d");
const presenter = navigator.ink.requestPresenter({ presentationArea: canvas });
let move_cnt = 0;
let style = { color: "rgba(0, 255, 0, 1)", diameter: 10 };

function getRandomInt(min, max) {
  min = Math.ceil(min);
  max = Math.floor(max);
  return Math.floor(Math.random() * (max - min + 1)) + min;

canvas.addEventListener("pointermove", async (evt) => {
  const pointSize = 10;
  ctx.fillStyle = style.color;
  ctx.fillRect(evt.pageX, evt.pageY, pointSize, pointSize);
  if (move_cnt == 20) {
    const r = getRandomInt(0, 255);
    const g = getRandomInt(0, 255);
    const b = getRandomInt(0, 255);

    style = { color: `rgba(${r}, ${g}, ${b}, 1)`, diameter: 10 };
    move_cnt = 0;
    ).style.backgroundColor = `rgba(${r}, ${g}, ${b}, 0.6)`;
  move_cnt += 1;
  await presenter.updateInkTrailStartPoint(evt, style);

window.addEventListener("pointerdown", () => {
  ctx.clearRect(0, 0, ctx.canvas.width, ctx.canvas.height);

canvas.width = window.innerWidth;
canvas.height = window.innerHeight;



Browser compatibility

Desktop Mobile
Chrome Edge Firefox Internet Explorer Opera Safari WebView Android Chrome Android Firefox for Android Opera Android Safari on IOS Samsung Internet
updateInkTrailStartPoint 94 93 No No 80 No 94 94 No 66 No 17.0

See also

© 2005–2023 MDN contributors.
Licensed under the Creative Commons Attribution-ShareAlike License v2.5 or later.