@ar-js-org/artoolkit5-ts 0.1.0 → 0.2.1

package/dist/artoolkit5-ts.js

@@ -17,86 +17,168 @@ async function a(e, r, i, a) {
 		core: s,
 		width: e,
 		height: r,
-		markers: {},
+		patternMarkers: {},
+		barcodeMarkers: {},
+		minConfidence: {
+			pattern: 0,
+			barcode: 0
+		},
 		disposed: !1
 	};
 }
 function o(e) {
-	e.disposed ||= (e.core.teardown(), e.core.delete(), e.markers = {}, !0);
+	e.disposed ||= (e.core.teardown(), e.core.delete(), e.patternMarkers = {}, e.barcodeMarkers = {}, !0);
+}
+//#endregion
+//#region node_modules/@ar-js-org/artoolkit5-constants/dist/generated/artoolkit_constants.js
+var s = 1028, c = 1029, l = 1285, u = {
+	color: 0,
+	mono: 1,
+	matrix: 2,
+	color_and_matrix: 3,
+	mono_and_matrix: 4
+}, d = {
+	"3x3": 3,
+	"3x3_PARITY65": 259,
+	"3x3_HAMMING63": 515,
+	"4x4": 4,
+	"4x4_BCH_13_9_3": 772,
+	"4x4_BCH_13_5_5": s,
+	"5x5": 5,
+	"5x5_BCH_22_7_7": l,
+	"5x5_BCH_22_12_5": c,
+	"6x6": 6
+}, f = {
+	manual: 0,
+	auto_median: 1,
+	auto_otsu: 2,
+	auto_bracketing: 4
+}, p = {
+	frame: 0,
+	field: 1
+}, m = {
+	white_region: 0,
+	black_region: 1
+};
+function h(e, t, n) {
+	let i = Object.prototype.hasOwnProperty.call(e, t) ? e[t] : void 0;
+	if (i === void 0) {
+		let i = Object.keys(e).join(", ");
+		throw new r(`Invalid value ${JSON.stringify(t)} for '${n}'. Valid values are: ${i}.`);
+	}
+	return i;
+}
+//#endregion
+//#region src/detector.ts
+function g(e, t) {
+	if (i(e, "configureDetector"), t.detectionMode !== void 0 && e.core.setPatternDetectionMode(h(u, t.detectionMode, "detectionMode")), t.matrixCodeType !== void 0 && e.core.setMatrixCodeType(h(d, t.matrixCodeType, "matrixCodeType")), t.threshold !== void 0 && e.core.setThreshold(_(t.threshold)), t.thresholdMode !== void 0 && e.core.setThresholdMode(h(f, t.thresholdMode, "thresholdMode")), t.labelingMode !== void 0 && e.core.setLabelingMode(h(m, t.labelingMode, "labelingMode")), t.imageProcMode !== void 0 && e.core.setImageProcMode(h(p, t.imageProcMode, "imageProcMode")), t.patternRatio !== void 0 && e.core.setPattRatio(v(t.patternRatio)), t.minConfidence !== void 0) {
+		let { pattern: n, barcode: r } = t.minConfidence;
+		n !== void 0 && (e.minConfidence.pattern = y(n, "minConfidence.pattern")), r !== void 0 && (e.minConfidence.barcode = y(r, "minConfidence.barcode"));
+	}
+	t.nearPlane !== void 0 && e.core.setProjectionNearPlane(t.nearPlane), t.farPlane !== void 0 && e.core.setProjectionFarPlane(t.farPlane), (t.nearPlane !== void 0 || t.farPlane !== void 0) && e.core.recalculateCameraLens();
+}
+function _(e) {
+	if (!Number.isInteger(e) || e < 0 || e > 255) throw new r(`Invalid value ${e} for 'threshold'. Must be an integer between 0 and 255 inclusive.`);
+	return e;
+}
+function v(e) {
+	if (!Number.isFinite(e) || e <= 0 || e >= 1) throw new r(`Invalid value ${e} for 'patternRatio'. Must be a finite number greater than 0 and less than 1.`);
+	return e;
+}
+function y(e, t) {
+	if (!Number.isFinite(e) || e < 0 || e > 1) throw new r(`Invalid value ${e} for '${t}'. Must be a finite number between 0 and 1 inclusive.`);
+	return e;
 }
 //#endregion
 //#region src/markers.ts
-async function s(t, n) {
+async function b(t, n) {
 	return i(t, "loadPatternMarker"), e(t.mod, t.core, n);
 }
 //#endregion
 //#region src/math.ts
-var c = 16;
-function l(e) {
+var x = 16;
+function S(e) {
 	return i(e, "getCameraProjectionMatrix"), e.core.getCameraLens();
 }
-function u(e, t = new Float32Array(c)) {
+function C(e, t = new Float32Array(x)) {
 	return t[0] = e[0], t[1] = e[4], t[2] = e[8], t[3] = 0, t[4] = e[1], t[5] = e[5], t[6] = e[9], t[7] = 0, t[8] = e[2], t[9] = e[6], t[10] = e[10], t[11] = 0, t[12] = e[3], t[13] = e[7], t[14] = e[11], t[15] = 1, t;
 }
-function d(e, t = new Float32Array(c), n) {
+function w(e, t = new Float32Array(x), n) {
 	return t[0] = e[0], t[4] = e[4], t[8] = e[8], t[12] = e[12], t[1] = -e[1], t[5] = -e[5], t[9] = -e[9], t[13] = -e[13], t[2] = -e[2], t[6] = -e[6], t[10] = -e[10], t[14] = -e[14], t[3] = 0, t[7] = 0, t[11] = 0, t[15] = 1, n !== void 0 && n !== 0 && (t[12] *= n, t[13] *= n, t[14] *= n), t;
 }
 //#endregion
 //#region src/tracking.ts
-var f = 12, p = 3, m = -1, h = [], g = !0, _ = /* @__PURE__ */ new Float32Array(16);
-function v(e, t, n = 1) {
-	i(e, "trackMarker"), e.markers[t] = {
-		id: t,
-		markerWidth: n,
+var T = 12, E = 3, D = -1, O = [], k = !0, A = /* @__PURE__ */ new Float32Array(16);
+function j(e, t, n = 1) {
+	i(e, "trackMarker"), e.patternMarkers[t] = N(t, n);
+}
+function M(e, t, n = 1) {
+	i(e, "trackBarcodeMarker"), e.barcodeMarkers[t] = N(t, n);
+}
+function N(e, t) {
+	return {
+		id: e,
+		markerWidth: t,
 		inPrevious: !1,
 		inCurrent: !1,
-		matrix: new Float64Array(f),
+		matrix: new Float64Array(T),
 		matrixGL: /* @__PURE__ */ new Float32Array(16)
 	};
 }
-function y(e, t) {
-	return i(e, "processFrame"), b(e, t), x(e), {
-		detected: S(e),
-		lost: C(e)
+function P(e, t) {
+	return i(e, "processFrame"), F(e, t), I(e), {
+		detected: L(e),
+		lost: z(e)
 	};
 }
-function b(e, t) {
-	e.core.passVideoData(t, h, g), e.core.detectMarker();
+function F(e, t) {
+	e.core.passVideoData(t, O, k), e.core.detectMarker();
 }
-function x(e) {
-	for (let t in e.markers) {
-		let n = e.markers[t];
+function I(e) {
+	for (let t of [e.patternMarkers, e.barcodeMarkers]) for (let e in t) {
+		let n = t[e];
 		n.inPrevious = n.inCurrent, n.inCurrent = !1;
 	}
 }
-function S(e) {
+function L(e) {
 	let t = [], n = e.core.getMarkerNum();
 	for (let r = 0; r < n; r++) {
-		let { id: n } = e.core.getMarkerInfo(r);
-		if (n === m) continue;
-		let i = e.markers[n];
-		i && (i.inCurrent = !0, w(e, r, i), t.push({
-			id: i.id,
-			matrix: i.matrix,
-			matrixGL: i.matrixGL
-		}));
+		let n = e.core.getMarkerInfo(r), i = R(e.patternMarkers, e, r, n.idPatt, n.cfPatt, "pattern", e.minConfidence.pattern, n.vertex);
+		i && t.push(i);
+		let a = R(e.barcodeMarkers, e, r, n.idMatrix, n.cfMatrix, "barcode", e.minConfidence.barcode, n.vertex);
+		a && t.push(a);
 	}
 	return t;
 }
-function C(e) {
-	let t = [];
-	for (let n in e.markers) {
-		let r = e.markers[n];
-		r.inPrevious && !r.inCurrent && t.push(r.id);
+function R(e, t, n, r, i, a, o, s) {
+	if (r === D) return;
+	let c = e[r];
+	if (c && !(i < o)) return c.inCurrent = !0, B(t, n, c), {
+		id: c.id,
+		type: a,
+		confidence: i,
+		matrix: c.matrix,
+		matrixGL: c.matrixGL,
+		vertex: s
+	};
+}
+function z(e) {
+	let t = [], n = [[e.patternMarkers, "pattern"], [e.barcodeMarkers, "barcode"]];
+	for (let [e, r] of n) for (let n in e) {
+		let i = e[n];
+		i.inPrevious && !i.inCurrent && t.push({
+			id: i.id,
+			type: r
+		});
 	}
 	return t;
 }
-function w(e, t, n) {
-	n.inPrevious ? e.core.getTransMatSquareCont(t, n.markerWidth) : e.core.getTransMatSquare(t, n.markerWidth), T(e, n.matrix), u(n.matrix, _), d(_, n.matrixGL);
+function B(e, t, n) {
+	n.inPrevious ? e.core.getTransMatSquareCont(t, n.markerWidth) : e.core.getTransMatSquare(t, n.markerWidth), V(e, n.matrix), C(n.matrix, A), w(A, n.matrixGL);
 }
-function T(e, t) {
-	let n = e.core.getTransform() >> p;
-	t.set(e.mod.HEAPF64.subarray(n, n + f));
+function V(e, t) {
+	let n = e.core.getTransform() >> E;
+	t.set(e.mod.HEAPF64.subarray(n, n + T));
 }
 //#endregion
-export { r as ARToolKitError, d as arglCameraViewRHf, a as createARToolKitState, o as disposeARToolKitState, l as getCameraProjectionMatrix, s as loadPatternMarker, y as processFrame, v as trackMarker, u as transMatToGLMat };
+export { r as ARToolKitError, w as arglCameraViewRHf, g as configureDetector, a as createARToolKitState, o as disposeARToolKitState, S as getCameraProjectionMatrix, b as loadPatternMarker, P as processFrame, M as trackBarcodeMarker, j as trackMarker, C as transMatToGLMat };

package/dist/artoolkit5-ts.umd.cjs

@@ -1 +1 @@
-(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("@ar-js-org/artoolkit5-wasm")):typeof define==`function`&&define.amd?define([`exports`,`@ar-js-org/artoolkit5-wasm`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.ARToolkit5TS={},e.ARToolkit5Wasm))})(this,function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var n=class e extends Error{constructor(t){super(t),this.name=`ARToolKitError`,Object.setPrototypeOf(this,e.prototype)}};function r(e,t){if(e.disposed)throw new n(`${t} was called on a disposed ARToolKitState. Create a new one with createARToolKitState().`)}async function i(e,n,r,i){let a=(await(0,t.createARToolKit)({locateFile:e=>i&&e.endsWith(`.wasm`)?i:e})).mod,o=new a.ARToolKitCore,s=await(0,t.loadCameraFromUrl)(a,o,r);return await o.setup(e,n,s),{mod:a,core:o,width:e,height:n,markers:{},disposed:!1}}function a(e){e.disposed||=(e.core.teardown(),e.core.delete(),e.markers={},!0)}async function o(e,n){return r(e,`loadPatternMarker`),(0,t.addMarkerFromUrl)(e.mod,e.core,n)}var s=16;function c(e){return r(e,`getCameraProjectionMatrix`),e.core.getCameraLens()}function l(e,t=new Float32Array(s)){return t[0]=e[0],t[1]=e[4],t[2]=e[8],t[3]=0,t[4]=e[1],t[5]=e[5],t[6]=e[9],t[7]=0,t[8]=e[2],t[9]=e[6],t[10]=e[10],t[11]=0,t[12]=e[3],t[13]=e[7],t[14]=e[11],t[15]=1,t}function u(e,t=new Float32Array(s),n){return t[0]=e[0],t[4]=e[4],t[8]=e[8],t[12]=e[12],t[1]=-e[1],t[5]=-e[5],t[9]=-e[9],t[13]=-e[13],t[2]=-e[2],t[6]=-e[6],t[10]=-e[10],t[14]=-e[14],t[3]=0,t[7]=0,t[11]=0,t[15]=1,n!==void 0&&n!==0&&(t[12]*=n,t[13]*=n,t[14]*=n),t}var d=12,f=3,p=-1,m=[],h=!0,g=new Float32Array(16);function _(e,t,n=1){r(e,`trackMarker`),e.markers[t]={id:t,markerWidth:n,inPrevious:!1,inCurrent:!1,matrix:new Float64Array(d),matrixGL:new Float32Array(16)}}function v(e,t){return r(e,`processFrame`),y(e,t),b(e),{detected:x(e),lost:S(e)}}function y(e,t){e.core.passVideoData(t,m,h),e.core.detectMarker()}function b(e){for(let t in e.markers){let n=e.markers[t];n.inPrevious=n.inCurrent,n.inCurrent=!1}}function x(e){let t=[],n=e.core.getMarkerNum();for(let r=0;r<n;r++){let{id:n}=e.core.getMarkerInfo(r);if(n===p)continue;let i=e.markers[n];i&&(i.inCurrent=!0,C(e,r,i),t.push({id:i.id,matrix:i.matrix,matrixGL:i.matrixGL}))}return t}function S(e){let t=[];for(let n in e.markers){let r=e.markers[n];r.inPrevious&&!r.inCurrent&&t.push(r.id)}return t}function C(e,t,n){n.inPrevious?e.core.getTransMatSquareCont(t,n.markerWidth):e.core.getTransMatSquare(t,n.markerWidth),w(e,n.matrix),l(n.matrix,g),u(g,n.matrixGL)}function w(e,t){let n=e.core.getTransform()>>f;t.set(e.mod.HEAPF64.subarray(n,n+d))}e.ARToolKitError=n,e.arglCameraViewRHf=u,e.createARToolKitState=i,e.disposeARToolKitState=a,e.getCameraProjectionMatrix=c,e.loadPatternMarker=o,e.processFrame=v,e.trackMarker=_,e.transMatToGLMat=l});
+(function(e,t){typeof exports==`object`&&typeof module<`u`?t(exports,require("@ar-js-org/artoolkit5-wasm")):typeof define==`function`&&define.amd?define([`exports`,`@ar-js-org/artoolkit5-wasm`],t):(e=typeof globalThis<`u`?globalThis:e||self,t(e.ARToolkit5TS={},e.ARToolkit5Wasm))})(this,function(e,t){Object.defineProperty(e,Symbol.toStringTag,{value:`Module`});var n=class e extends Error{constructor(t){super(t),this.name=`ARToolKitError`,Object.setPrototypeOf(this,e.prototype)}};function r(e,t){if(e.disposed)throw new n(`${t} was called on a disposed ARToolKitState. Create a new one with createARToolKitState().`)}async function i(e,n,r,i){let a=(await(0,t.createARToolKit)({locateFile:e=>i&&e.endsWith(`.wasm`)?i:e})).mod,o=new a.ARToolKitCore,s=await(0,t.loadCameraFromUrl)(a,o,r);return await o.setup(e,n,s),{mod:a,core:o,width:e,height:n,patternMarkers:{},barcodeMarkers:{},minConfidence:{pattern:0,barcode:0},disposed:!1}}function a(e){e.disposed||=(e.core.teardown(),e.core.delete(),e.patternMarkers={},e.barcodeMarkers={},!0)}var o=1028,s=1029,c=1285,l={color:0,mono:1,matrix:2,color_and_matrix:3,mono_and_matrix:4},u={"3x3":3,"3x3_PARITY65":259,"3x3_HAMMING63":515,"4x4":4,"4x4_BCH_13_9_3":772,"4x4_BCH_13_5_5":o,"5x5":5,"5x5_BCH_22_7_7":c,"5x5_BCH_22_12_5":s,"6x6":6},d={manual:0,auto_median:1,auto_otsu:2,auto_bracketing:4},f={frame:0,field:1},p={white_region:0,black_region:1};function m(e,t,r){let i=Object.prototype.hasOwnProperty.call(e,t)?e[t]:void 0;if(i===void 0){let i=Object.keys(e).join(`, `);throw new n(`Invalid value ${JSON.stringify(t)} for '${r}'. Valid values are: ${i}.`)}return i}function h(e,t){if(r(e,`configureDetector`),t.detectionMode!==void 0&&e.core.setPatternDetectionMode(m(l,t.detectionMode,`detectionMode`)),t.matrixCodeType!==void 0&&e.core.setMatrixCodeType(m(u,t.matrixCodeType,`matrixCodeType`)),t.threshold!==void 0&&e.core.setThreshold(g(t.threshold)),t.thresholdMode!==void 0&&e.core.setThresholdMode(m(d,t.thresholdMode,`thresholdMode`)),t.labelingMode!==void 0&&e.core.setLabelingMode(m(p,t.labelingMode,`labelingMode`)),t.imageProcMode!==void 0&&e.core.setImageProcMode(m(f,t.imageProcMode,`imageProcMode`)),t.patternRatio!==void 0&&e.core.setPattRatio(_(t.patternRatio)),t.minConfidence!==void 0){let{pattern:n,barcode:r}=t.minConfidence;n!==void 0&&(e.minConfidence.pattern=v(n,`minConfidence.pattern`)),r!==void 0&&(e.minConfidence.barcode=v(r,`minConfidence.barcode`))}t.nearPlane!==void 0&&e.core.setProjectionNearPlane(t.nearPlane),t.farPlane!==void 0&&e.core.setProjectionFarPlane(t.farPlane),(t.nearPlane!==void 0||t.farPlane!==void 0)&&e.core.recalculateCameraLens()}function g(e){if(!Number.isInteger(e)||e<0||e>255)throw new n(`Invalid value ${e} for 'threshold'. Must be an integer between 0 and 255 inclusive.`);return e}function _(e){if(!Number.isFinite(e)||e<=0||e>=1)throw new n(`Invalid value ${e} for 'patternRatio'. Must be a finite number greater than 0 and less than 1.`);return e}function v(e,t){if(!Number.isFinite(e)||e<0||e>1)throw new n(`Invalid value ${e} for '${t}'. Must be a finite number between 0 and 1 inclusive.`);return e}async function y(e,n){return r(e,`loadPatternMarker`),(0,t.addMarkerFromUrl)(e.mod,e.core,n)}var b=16;function x(e){return r(e,`getCameraProjectionMatrix`),e.core.getCameraLens()}function S(e,t=new Float32Array(b)){return t[0]=e[0],t[1]=e[4],t[2]=e[8],t[3]=0,t[4]=e[1],t[5]=e[5],t[6]=e[9],t[7]=0,t[8]=e[2],t[9]=e[6],t[10]=e[10],t[11]=0,t[12]=e[3],t[13]=e[7],t[14]=e[11],t[15]=1,t}function C(e,t=new Float32Array(b),n){return t[0]=e[0],t[4]=e[4],t[8]=e[8],t[12]=e[12],t[1]=-e[1],t[5]=-e[5],t[9]=-e[9],t[13]=-e[13],t[2]=-e[2],t[6]=-e[6],t[10]=-e[10],t[14]=-e[14],t[3]=0,t[7]=0,t[11]=0,t[15]=1,n!==void 0&&n!==0&&(t[12]*=n,t[13]*=n,t[14]*=n),t}var w=12,T=3,E=-1,D=[],O=!0,k=new Float32Array(16);function A(e,t,n=1){r(e,`trackMarker`),e.patternMarkers[t]=M(t,n)}function j(e,t,n=1){r(e,`trackBarcodeMarker`),e.barcodeMarkers[t]=M(t,n)}function M(e,t){return{id:e,markerWidth:t,inPrevious:!1,inCurrent:!1,matrix:new Float64Array(w),matrixGL:new Float32Array(16)}}function N(e,t){return r(e,`processFrame`),P(e,t),F(e),{detected:I(e),lost:R(e)}}function P(e,t){e.core.passVideoData(t,D,O),e.core.detectMarker()}function F(e){for(let t of[e.patternMarkers,e.barcodeMarkers])for(let e in t){let n=t[e];n.inPrevious=n.inCurrent,n.inCurrent=!1}}function I(e){let t=[],n=e.core.getMarkerNum();for(let r=0;r<n;r++){let n=e.core.getMarkerInfo(r),i=L(e.patternMarkers,e,r,n.idPatt,n.cfPatt,`pattern`,e.minConfidence.pattern,n.vertex);i&&t.push(i);let a=L(e.barcodeMarkers,e,r,n.idMatrix,n.cfMatrix,`barcode`,e.minConfidence.barcode,n.vertex);a&&t.push(a)}return t}function L(e,t,n,r,i,a,o,s){if(r===E)return;let c=e[r];if(c&&!(i<o))return c.inCurrent=!0,z(t,n,c),{id:c.id,type:a,confidence:i,matrix:c.matrix,matrixGL:c.matrixGL,vertex:s}}function R(e){let t=[],n=[[e.patternMarkers,`pattern`],[e.barcodeMarkers,`barcode`]];for(let[e,r]of n)for(let n in e){let i=e[n];i.inPrevious&&!i.inCurrent&&t.push({id:i.id,type:r})}return t}function z(e,t,n){n.inPrevious?e.core.getTransMatSquareCont(t,n.markerWidth):e.core.getTransMatSquare(t,n.markerWidth),B(e,n.matrix),S(n.matrix,k),C(k,n.matrixGL)}function B(e,t){let n=e.core.getTransform()>>T;t.set(e.mod.HEAPF64.subarray(n,n+w))}e.ARToolKitError=n,e.arglCameraViewRHf=C,e.configureDetector=h,e.createARToolKitState=i,e.disposeARToolKitState=a,e.getCameraProjectionMatrix=x,e.loadPatternMarker=y,e.processFrame=N,e.trackBarcodeMarker=j,e.trackMarker=A,e.transMatToGLMat=S});

package/dist/config.d.ts

@@ -0,0 +1,88 @@
+export type DetectionMode = 'color' | 'mono' | 'matrix' | 'color_and_matrix' | 'mono_and_matrix';
+/**
+ * `'global_id'` is deliberately absent. `AR_MATRIX_CODE_GLOBAL_ID` decodes a
+ * 64-bit value into `markerInfo->globalID`, and that field is not bound, so
+ * nothing here can read what the mode decoded (artoolkit5-wasm#29).
+ *
+ * Offering it anyway would not leave the mode inert — it would leave it
+ * aliasing. The engine still fills `idMatrix`, the field `processFrame` reads:
+ * a global ID below 32768 is reported as itself, and **every** larger one is
+ * reported as `0` (`arPattGetID.c:213-217`). A barcode registered as `0` would
+ * therefore match every large global-ID marker in view, and with none
+ * registered those markers would silently never match at all.
+ *
+ * Re-adding it once the value is bound is a non-breaking addition. Shipping it
+ * first would be the expensive order: #29 has still to settle how a 64-bit
+ * value crosses into JavaScript, and by then that would be released API.
+ */
+export type MatrixCodeType = '3x3' | '3x3_PARITY65' | '3x3_HAMMING63' | '4x4' | '4x4_BCH_13_9_3' | '4x4_BCH_13_5_5' | '5x5' | '5x5_BCH_22_7_7' | '5x5_BCH_22_12_5' | '6x6';
+/**
+ * `'auto_adaptive'` is deliberately absent. `AR_LABELING_THRESH_MODE_AUTO_ADAPTIVE`
+ * is exported by the constants package, but `AR_DISABLE_THRESH_MODE_AUTO_ADAPTIVE`
+ * is set in the WebARKitLib build this module compiles against, which compiles out
+ * its `case` in `arCreateHandle.c`. Passing it silently falls through to `manual`.
+ * Offering a mode that cannot work would be worse than not offering it; re-adding
+ * it if the upstream build flag changes is a non-breaking addition.
+ */
+export type ThresholdMode = 'manual' | 'auto_median' | 'auto_otsu' | 'auto_bracketing';
+export type ImageProcMode = 'frame' | 'field';
+/** `'black_region'` — black-bordered markers on a white background — is the engine default. */
+export type LabelingMode = 'white_region' | 'black_region';
+/**
+ * Minimum match confidence per marker family, 0.0 to 1.0.
+ *
+ * The two families are not comparable, so they take separate thresholds.
+ *
+ * Confidence is a continuous quality score for *both* families, not a verdict:
+ * it moves with viewing angle, distance and focus. Measured on real hardware,
+ * the genuine and spurious ranges overlap in both directions — a genuine
+ * barcode read 0.500 at an awkward angle while a misread of a pattern marker
+ * reached 0.867. So no threshold avoids both missed markers and admitted
+ * phantoms; see the README for the measurements and the trade-off.
+ *
+ * Omitted keys are left unchanged. Both default to 0, which filters nothing
+ * beyond the engine's own cutoff of 0.5.
+ */
+export interface MinConfidence {
+    /** Applies to pattern markers, compared against `cfPatt`. */
+    pattern?: number;
+    /** Applies to barcode markers, compared against `cfMatrix`. */
+    barcode?: number;
+}
+export interface DetectorOptions {
+    detectionMode?: DetectionMode;
+    matrixCodeType?: MatrixCodeType;
+    /** Luma threshold, 0-255. Only meaningful when `thresholdMode` is `'manual'`. */
+    threshold?: number;
+    thresholdMode?: ThresholdMode;
+    labelingMode?: LabelingMode;
+    imageProcMode?: ImageProcMode;
+    /** Proportion of the marker occupied by the pattern. Exclusive of 0 and 1. */
+    patternRatio?: number;
+    nearPlane?: number;
+    farPlane?: number;
+    /**
+     * Rejects weak matches, per family. Unlike every other option here this
+     * is applied by this library rather than passed to the engine — ARToolKit
+     * has no setter for it.
+     */
+    minConfidence?: MinConfidence;
+}
+export declare const DETECTION_MODES: Record<DetectionMode, number>;
+export declare const MATRIX_CODE_TYPES: Record<MatrixCodeType, number>;
+export declare const THRESHOLD_MODES: Record<ThresholdMode, number>;
+export declare const IMAGE_PROC_MODES: Record<ImageProcMode, number>;
+export declare const LABELING_MODES: Record<LabelingMode, number>;
+/**
+ * Looks up `value` in `table`, throwing a message that names the option and
+ * lists what it does accept — the failure mode a raw `table[value]` cannot
+ * give you, since an unknown key there is `undefined`, not an error.
+ *
+ * `Object.prototype.hasOwnProperty` guards against inherited keys: `table`
+ * is a plain object literal, so `value` arriving as e.g. `'toString'` from
+ * outside TypeScript's type safety (a plain-JS caller, JSON, a UI control)
+ * would otherwise resolve to `Object.prototype.toString` rather than
+ * `undefined`, silently passing a function into the setter instead of
+ * throwing.
+ */
+export declare function lookUp<T extends string>(table: Record<T, number>, value: T, optionName: string): number;

package/dist/detector.d.ts

@@ -0,0 +1,22 @@
+import { DetectorOptions } from './config';
+import { ARToolKitState } from './domain';
+/**
+ * Applies detector tuning.
+ *
+ * Only the keys present in `opts` are applied — a partial call mid-session
+ * changes just those settings and leaves everything else as it was.
+ *
+ * Every option but one is handed to the ARToolKit5 engine. `minConfidence`
+ * is the exception: the engine's confidence cutoff is a compile-time
+ * constant with no setter, so that threshold is recorded on `state` and
+ * applied by `processFrame` instead.
+ *
+ * Setting `nearPlane` or `farPlane` also recomputes the projection matrix
+ * `getCameraProjectionMatrix` returns, so a change is visible on the very
+ * next call rather than requiring a separate step to take effect.
+ *
+ * @throws {ARToolKitError} if the state has been disposed, if a string option
+ *   is not one of its documented values, or if `threshold` or `patternRatio` is
+ *   outside the range the engine accepts.
+ */
+export declare function configureDetector(state: ARToolKitState, opts: DetectorOptions): void;

package/dist/domain.d.ts

@@ -3,6 +3,16 @@
  *
  * This module contains types only — no logic, no side effects.
  */
+/**
+ * Which family a registered marker belongs to.
+ *
+ * The engine reports each family through its own field — `idPatt` for
+ * pattern markers, `idMatrix` for barcode markers — so a detection is
+ * matched against the registry by the field that produced it. This type
+ * records which field a given registration answers to. See `trackMarker`
+ * and `trackBarcodeMarker`.
+ */
+export type MarkerType = 'pattern' | 'barcode';
 /**
  * Detection result for a single marker in a single frame.
  *
@@ -16,6 +26,20 @@
  */
 export interface MarkerPose {
     id: number;
+    type: MarkerType;
+    /**
+     * How strongly the engine matched this marker, 0.0 to 1.0.
+     *
+     * Read from the field belonging to this marker's family — `cfPatt` for a
+     * pattern marker, `cfMatrix` for a barcode — so the two are directly
+     * comparable only within a family, not across them.
+     *
+     * A continuous quality score for both families, not a verdict: the same
+     * marker moves across a wide range with viewing angle, distance and focus.
+     * A high value is not proof of a genuine match, nor a low one proof of a
+     * false one — the ranges overlap. See `MinConfidence`.
+     */
+    confidence: number;
     /**
      * 3x4 row-major pose, exactly as ARToolKit produces it.
      *
@@ -33,6 +57,20 @@ export interface MarkerPose {
      * camera noise and calibration in the millimetre range.
      */
     matrixGL: Float32Array;
+    /**
+     * The four corners of the detected square, in camera image coordinates
+     * with the origin at top-left.
+     *
+     * Unlike `matrix` and `matrixGL`, this is **not** a view onto a reused
+     * buffer — the engine builds a fresh array each frame, so it is safe to
+     * retain without copying.
+     *
+     * Corner order depends on the marker's rotation: `vertex[(4 - dir) % 4]`
+     * is the top-left corner of the marker itself, with the rest proceeding
+     * clockwise from there. Anything that merely outlines the square can
+     * ignore that; anything orientation-sensitive cannot.
+     */
+    vertex: [number, number][];
 }
 /**
  * Outcome of a single call to `processFrame`.
@@ -45,13 +83,27 @@ export interface FrameResult {
     /** Markers visible in this frame, with their poses. */
     detected: MarkerPose[];
     /**
-     * IDs of markers visible in the previous frame but not this one.
+     * Markers visible in the previous frame but not this one.
      *
      * Reported exactly once, on the frame the marker disappears.
+     *
+     * Carries `type` as well as `id` because the two families have
+     * independent ID spaces: a pattern marker and a barcode marker may both
+     * be registered as `5`, and an ID alone could not say which was lost.
      */
-    lost: number[];
+    lost: LostMarker[];
+}
+/** A marker that was visible in the previous frame and is not in this one. */
+export interface LostMarker {
+    id: number;
+    type: MarkerType;
 }
-/** Per-marker tracking state, owned by {@link ARToolKitState}. */
+/**
+ * Per-marker tracking state, owned by {@link ARToolKitState}.
+ *
+ * Carries no `type`: which registry a marker lives in already determines its
+ * family, so storing it again would allow the two to disagree.
+ */
 export interface TrackedMarkerState {
     id: number;
     markerWidth: number;
@@ -77,10 +129,40 @@ export interface ARToolKitModule {
     loadCameraFromPath(path: string): number;
     addMarker(path: string): number;
 }
-/** Marker metadata returned by the detector for one candidate square. */
+/**
+ * Marker metadata returned by the detector for one candidate square.
+ *
+ * ARToolKit reports results in three families, and each is only valid in the
+ * detection modes that populate it — a field the active mode did not write
+ * would otherwise expose uninitialised engine memory. The binding reports
+ * `-1` for any family the mode does not populate, so every field here is
+ * always safe to read; `-1` uniformly means "no match".
+ *
+ * Requires `@ar-js-org/artoolkit5-wasm` >= 0.3.0, which is where the
+ * per-mode fields were first bound.
+ */
 export interface MarkerInfo {
-    /** Engine-assigned marker ID, or -1 when unrecognised. */
+    /**
+     * Marker ID, or -1. Only meaningful when `detectionMode` is pattern-only
+     * *or* matrix-only — never both. Reported as -1 in the combined modes,
+     * where a single unified ID would be ambiguous. Prefer `idPatt` and
+     * `idMatrix`, which are valid in every mode that can produce them.
+     */
     id: number;
+    /** Pattern-marker ID, or -1. Valid when the mode includes template matching. */
+    idPatt: number;
+    /** Barcode (matrix code) ID, or -1. Valid when the mode includes matrix detection. */
+    idMatrix: number;
+    /** Template-match confidence, 0.0-1.0, or -1.0 when there was no match. */
+    cfPatt: number;
+    /** Matrix-code confidence, 0.0-1.0, or -1.0 when there was no match. */
+    cfMatrix: number;
+    /**
+     * 2D positions of the square's four corners, in camera image coordinates
+     * with the origin at top-left. Populated in every detection mode, unlike
+     * the id and confidence fields above.
+     */
+    vertex: [number, number][];
 }
 /**
  * The C++ `ARToolKitCore` instance, narrowed to the methods this library calls.
@@ -99,6 +181,22 @@ export interface ARToolKitCore {
     /** Byte offset into `HEAPF64` holding the most recent 3x4 pose. */
     getTransform(): number;
     getCameraLens(): Float64Array;
+    /**
+     * Recomputes the cached projection matrix `getCameraLens` returns, from
+     * whatever `nearPlane`/`farPlane` currently hold. `setProjectionNearPlane`
+     * and `setProjectionFarPlane` only assign those fields — the matrix stays
+     * stale until this is called.
+     */
+    recalculateCameraLens(): void;
+    setPatternDetectionMode(mode: number): void;
+    setMatrixCodeType(type: number): void;
+    setThreshold(threshold: number): void;
+    setThresholdMode(mode: number): void;
+    setLabelingMode(mode: number): void;
+    setImageProcMode(mode: number): void;
+    setPattRatio(ratio: number): void;
+    setProjectionNearPlane(nearPlane: number): void;
+    setProjectionFarPlane(farPlane: number): void;
     /** Releases the ARToolKit handles held by the C++ instance. */
     teardown(): number;
     /** Frees the C++ instance itself. Generated by Embind, not declared in C++. */
@@ -115,8 +213,34 @@ export interface ARToolKitState {
     readonly core: ARToolKitCore;
     readonly width: number;
     readonly height: number;
-    /** Registered markers, keyed by engine-assigned ID. */
-    markers: Record<number, TrackedMarkerState>;
+    /**
+     * Pattern markers, keyed by the engine-assigned ID `loadPatternMarker`
+     * returned — matched against `getMarkerInfo`'s `idPatt`.
+     */
+    patternMarkers: Record<number, TrackedMarkerState>;
+    /**
+     * Barcode markers, keyed by the ID encoded in the marker's own geometry —
+     * matched against `getMarkerInfo`'s `idMatrix`.
+     *
+     * Separate from {@link ARToolKitState.patternMarkers} because the two
+     * families occupy independent ID spaces: pattern IDs are assigned by the
+     * engine starting at 0, barcode IDs are chosen by whoever printed the
+     * marker, and `5` in one is unrelated to `5` in the other.
+     */
+    barcodeMarkers: Record<number, TrackedMarkerState>;
+    /**
+     * Confidence below which a detection is discarded, per family.
+     *
+     * Enforced here rather than in the engine: ARToolKit's own cutoff
+     * (`AR_CONFIDENCE_CUTOFF_DEFAULT`, 0.5) is a compile-time constant with no
+     * setter, so this filters on top of it and can only ever be stricter.
+     * Both default to 0, meaning no filtering beyond the engine's own.
+     * Set through `configureDetector`.
+     */
+    minConfidence: {
+        pattern: number;
+        barcode: number;
+    };
     /**
      * Set by `disposeARToolKitState`. Once true the C++ instance is gone and
      * every operation on this state throws rather than reaching freed memory.

package/dist/index.d.ts

@@ -1,6 +1,8 @@
-export type { ARToolKitCore, ARToolKitModule, ARToolKitState, FrameResult, MarkerInfo, MarkerPose, TrackedMarkerState, } from './domain';
+export type { ARToolKitCore, ARToolKitModule, ARToolKitState, FrameResult, LostMarker, MarkerInfo, MarkerPose, MarkerType, TrackedMarkerState, } from './domain';
+export type { DetectionMode, DetectorOptions, MinConfidence, ImageProcMode, LabelingMode, MatrixCodeType, ThresholdMode, } from './config';
 export { ARToolKitError } from './errors';
 export { createARToolKitState, disposeARToolKitState } from './init';
+export { configureDetector } from './detector';
 export { loadPatternMarker } from './markers';
-export { processFrame, trackMarker } from './tracking';
+export { processFrame, trackBarcodeMarker, trackMarker } from './tracking';
 export { arglCameraViewRHf, getCameraProjectionMatrix, transMatToGLMat } from './math';

package/dist/tracking.d.ts

@@ -8,6 +8,30 @@ import { ARToolKitState, FrameResult } from './domain';
  * @throws {ARToolKitError} if the state has been disposed.
  */
 export declare function trackMarker(state: ARToolKitState, pattId: number, markerWidth?: number): void;
+/**
+ * Registers a barcode (matrix code) marker for tracking.
+ *
+ * Unlike a pattern marker, this involves no loading: the engine reads the ID
+ * directly off the marker's geometry, so there is no file to fetch and
+ * nothing to register with the C++ core first. Registering it here is all
+ * that is needed — which is why this is `trackBarcodeMarker`, not
+ * `loadBarcodeMarker`.
+ *
+ * Detecting a barcode marker also requires `configureDetector` to have put
+ * the engine into a matrix-capable `detectionMode` (`'matrix'`,
+ * `'color_and_matrix'`, or `'mono_and_matrix'`); this function only registers the ID.
+ *
+ * The two families have independent ID spaces, so a barcode may share an ID
+ * with an already-registered pattern marker: the engine reports each through
+ * its own field, and they are kept in separate registries.
+ *
+ * @param barcodeId The ID encoded in the marker itself — this is not
+ *   assigned by the engine, unlike a pattern marker's ID.
+ * @param markerWidth Physical marker width; the unit chosen here is the unit
+ *   all returned translations are expressed in.
+ * @throws {ARToolKitError} if the state has been disposed.
+ */
+export declare function trackBarcodeMarker(state: ARToolKitState, barcodeId: number, markerWidth?: number): void;
 /**
  * Detects registered markers in a single frame.
  *
@@ -15,9 +39,11 @@ export declare function trackMarker(state: ARToolKitState, pattId: number, marke
  * so a consumer emitting found/updated/lost events does not have to diff
  * successive results to recover information tracking already had.
  *
- * Called once per animation frame, so it allocates no typed arrays: every pose
- * is written into buffers owned by the marker's tracking state. Those buffers
- * are reused next frame — copy them if you need to retain values.
+ * Called once per animation frame, so it allocates no typed arrays: `matrix`
+ * and `matrixGL` are written into buffers owned by the marker's tracking
+ * state, and those buffers are reused next frame — copy them if you need to
+ * retain values. `vertex` is the exception; it is a fresh array every frame
+ * and can be retained as it is.
  *
  * @param videoFrame RGBA pixels matching the width and height the state was
  *   created with.