Tempusxr Français
  1. Docs
  2. Experience Library
  3. Picture frame

Picture frame Image tracking

A 3D frame and a nameplate around a painting. Change the frame style.

Open in A-FrameOpen in Three.jsBack to the Experience Library

Code

The code of this experience, split in the files you would keep: HTML, CSS and JavaScript. The live page keeps them in one file; copy each part into its own file and the page works the same.

<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
    <title>Tempusxr picture frame</title>
    <!-- Plain HTML, no JavaScript framework: A-Frame, Tempusxr, the image tracker. Needs pnpm build. -->
    <script src="/node_modules/aframe/dist/aframe-v1.8.0.min.js"></script>
    <script src="/packages/sdk-aframe/dist/index.umd.cjs"></script>
    <script src="/packages/sdk-tracker-image/dist/index.umd.cjs"></script>
    <link rel="stylesheet" href="page.css" />
  </head>
  <body>
    <!--
      Open art.png on a screen (or print it) and point the camera at it: the picture gets a 3D frame
      and a nameplate. "Change frame" cycles wood, gold, black and white.
    -->
    <div id="ui" class="tx-overlay">
      <div data-tx-slot="top-left" class="pill" data-tx-show="found">Sunset hills</div>
      <div data-tx-slot="center" data-tx-show="scanning" class="pill">
        Point the camera at the painting
      </div>
      <div data-tx-slot="bottom" data-tx-show="found">
        <div class="plate">
          <strong>Sunset hills</strong><br />
          A. Martin, 2026
        </div>
        <button class="tx-cta" type="button" data-tx-action="style" style="margin-top: 10px">
          Change frame
        </button>
      </div>
    </div>

    <a-scene
      tempusxr="tracker: image; targets: art.txr; overlay: #ui"
      renderer="alpha: true"
      vr-mode-ui="enabled: false"
    >
      <a-camera
        position="0 0 0"
        look-controls="enabled: false"
        wasd-controls="enabled: false"
      ></a-camera>
      <a-light type="ambient" intensity="1.1"></a-light>
      <a-light type="directional" position="0.4 1 1" intensity="0.9"></a-light>

      <a-entity tempusxr-image-target="index: 0">
        <!-- The four sides of the frame are built from the real size of the image, see the script -->
        <a-entity id="frame"></a-entity>
        <!-- A faint glass shine over the painting -->
        <a-plane
          tempusxr-image-plane
          width="1"
          height="1.25"
          color="#ffffff"
          opacity="0.07"
          position="0 0 0.01"
        ></a-plane>
      </a-entity>
    </a-scene>

    <script src="page.js"></script>
  </body>
</html>
body {
  margin: 0;
}
.pill {
  padding: 6px 16px;
  border-radius: 999px;
  background: rgba(0, 0, 0, 0.55);
  color: #fff;
  font-weight: 700;
}
.plate {
  padding: 10px 22px;
  border-radius: 10px;
  background: rgba(20, 20, 20, 0.7);
  border: 1px solid rgba(212, 175, 55, 0.7);
  color: #f6e7b4;
  text-align: center;
}
const styles = [
  { name: 'Wood', color: '#8b5a2b' },
  { name: 'Gold', color: '#d4af37' },
  { name: 'Black', color: '#1a1a1a' },
  { name: 'White', color: '#f2f2f2' },
];
const THICKNESS = 0.06; // frame width, in image widths
const DEPTH = 0.05;
let current = 0;
let overlay = null;

const paint = () => {
  for (const side of document.querySelectorAll('#frame a-box'))
    side.setAttribute('color', styles[current].color);
};

// Once the image is known, the frame fits it exactly, whatever its proportions.
document.querySelector('a-scene').addEventListener('tempusxr-ready', (event) => {
  overlay = event.detail.overlay;
  const { width: w, height: h } = event.detail.tracker.anchors[0].size;
  const t = THICKNESS;
  const sides = [
    { x: 0, y: h / 2 + t / 2, w: w + 2 * t, h: t },
    { x: 0, y: -h / 2 - t / 2, w: w + 2 * t, h: t },
    { x: -w / 2 - t / 2, y: 0, w: t, h: h },
    { x: w / 2 + t / 2, y: 0, w: t, h: h },
  ];
  const frame = document.getElementById('frame');
  for (const side of sides) {
    const box = document.createElement('a-box');
    box.setAttribute('position', `${side.x} ${side.y} ${DEPTH / 2}`);
    box.setAttribute('width', side.w);
    box.setAttribute('height', side.h);
    box.setAttribute('depth', DEPTH);
    frame.appendChild(box);
  }
  paint();
});

document.getElementById('ui').addEventListener('click', (event) => {
  if (!event.target.closest('[data-tx-action="style"]')) return;
  current = (current + 1) % styles.length;
  paint();
  overlay?.toast(styles[current].name, { color: styles[current].color });
});
<!doctype html>
<html lang="en">
  <head>
    <meta charset="utf-8" />
    <meta name="viewport" content="width=device-width, initial-scale=1, viewport-fit=cover" />
    <title>Tempusxr picture frame (Three.js)</title>
    <!-- Three.js with the SDK, as a page without a bundler loads it. Needs pnpm build. -->
    <script type="importmap">
      {
        "imports": {
          "three": "/node_modules/three/build/three.module.js",
          "@tempusxr/sdk-core": "/packages/sdk-core/dist/index.js",
          "@tempusxr/sdk-three": "/packages/sdk-three/dist/index.js",
          "@tempusxr/sdk-tracker-image": "/packages/sdk-tracker-image/dist/index.js"
        }
      }
    </script>
    <link rel="stylesheet" href="page.css" />
  </head>
  <body>
    <!--
      Open art.png on a screen (or print it) and point the camera at it: the picture gets a 3D frame
      and a nameplate. "Change frame" cycles wood, gold, black and white.
    -->
    <div id="ui" class="tx-overlay">
      <div data-tx-slot="top-left" class="pill" data-tx-show="found">Sunset hills</div>
      <div data-tx-slot="center" data-tx-show="scanning" class="pill">
        Point the camera at the painting
      </div>
      <div data-tx-slot="bottom" data-tx-show="found">
        <div class="plate">
          <strong>Sunset hills</strong><br />
          A. Martin, 2026
        </div>
        <button class="tx-cta" type="button" data-tx-action="style" style="margin-top: 10px">
          Change frame
        </button>
      </div>
    </div>
    <div id="ar"></div>
    <script type="module" src="page.js"></script>
  </body>
</html>
html,
body {
  margin: 0;
  height: 100%;
  background: #111;
}
.pill {
  padding: 6px 16px;
  border-radius: 999px;
  background: rgba(0, 0, 0, 0.55);
  color: #fff;
  font-weight: 700;
}
.plate {
  padding: 10px 22px;
  border-radius: 10px;
  background: rgba(20, 20, 20, 0.7);
  border: 1px solid rgba(212, 175, 55, 0.7);
  color: #f6e7b4;
  text-align: center;
}
import * as THREE from 'three';
import { create } from '@tempusxr/sdk-three';
import '@tempusxr/sdk-tracker-image';
const ar = create({
  container: '#ar',
  overlay: document.getElementById('ui'),
  cameraOptions: { idealWidth: 640, idealHeight: 480 },
});
window.__ar = ar;
const tracker = await ar.use('image', { targets: ['/examples/art-frame/art.txr'] });
const { width: w, height: h } = tracker.anchors[0]?.size ?? { width: 1, height: 1.25 };

const styles = [
  { name: 'Wood', color: '#8b5a2b' },
  { name: 'Gold', color: '#d4af37' },
  { name: 'Black', color: '#1a1a1a' },
  { name: 'White', color: '#f2f2f2' },
];
const THICKNESS = 0.06; // frame width, in image widths
const DEPTH = 0.05;
const material = new THREE.MeshStandardMaterial({ color: styles[0].color, roughness: 0.6 });

// The four sides of the frame are built from the real size of the image, whatever its proportions.
const t = THICKNESS;
const content = new THREE.Group();
for (const side of [
  { x: 0, y: h / 2 + t / 2, w: w + 2 * t, h: t },
  { x: 0, y: -h / 2 - t / 2, w: w + 2 * t, h: t },
  { x: -w / 2 - t / 2, y: 0, w: t, h },
  { x: w / 2 + t / 2, y: 0, w: t, h },
]) {
  const box = new THREE.Mesh(new THREE.BoxGeometry(side.w, side.h, DEPTH), material);
  box.position.set(side.x, side.y, DEPTH / 2);
  content.add(box);
}
// A faint glass shine over the painting.
const glass = new THREE.Mesh(
  new THREE.PlaneGeometry(w, h),
  new THREE.MeshBasicMaterial({ color: '#ffffff', transparent: true, opacity: 0.07 }),
);
glass.position.z = 0.01;
content.add(glass);
content.add(new THREE.AmbientLight(0xffffff, 1.3));
const sun = new THREE.DirectionalLight(0xffffff, 1.2);
sun.position.set(0.4, 1, 1);
content.add(sun);
ar.attach(tracker.anchors[0], content);

let current = 0;
document.getElementById('ui').addEventListener('click', (event) => {
  if (!event.target.closest('[data-tx-action="style"]')) return;
  current = (current + 1) % styles.length;
  material.color.set(styles[current].color);
  ar.ui?.toast(styles[current].name, { color: styles[current].color });
});
await ar.start();

Open on your phone

Scan this code with the phone camera.

Open on this device