Input-error code 'capture-displayed-fixed' ​

Contract 2.0.0 · package sha256 a857eca95b35921109faf997094bb4192f12527d9d0fcd4be7e97f06425bad6e · generated from configurator-runtime.d.ts, tables/problems.json and services/onsite-scripter/scripts/contract-docs-what-to-do.json by services/onsite-scripter/scripts/build-contract-docs.mjs; edit the source, not this file.

A member of InputErrorCode · stable · since 2.0.0

source: 'displayed' with a view, size, pixelRatio or a background other than 'scene'.

What to do ​

CaptureSpec.source 'displayed' copies the frame as shown, so session.capture() takes no view, size, pixelRatio or non-'scene' background with it: drop them, or use source: 'render' (the default) for those.

const shot = await session.capture({ source: 'render', size: { width: 1200, height: 900 }, background: 'transparent' });
upload(shot.image);

Where the declaration names it ​

• CaptureSpec.background: Another value is 'render' only: a 'displayed' capture copies the frame as presented, so 'transparent' or a colour with it rejects HoloInputError ('capture-displayed-fixed').
• CaptureSpec.view: 'render' only; with 'displayed' the capture rejects HoloInputError ('capture-displayed-fixed').
• Session.capture: Rejects HoloInputError ('capture-displayed-fixed') for source: 'displayed' with a view, size, pixelRatio or non-'scene' background, also during a hold.

The set is open: handle a code you don't know ('other').