@ume-group/contracts 0.2.1

package/dist/layer2/webcam-utils.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Shared webcam utility functions for Layer 2 rendering
+ *
+ * These utilities are used by both editor and player for consistent
+ * webcam plane positioning and geometry calculations.
+ *
+ * ArchiMate: Application Component (Shared Webcam Utilities)
+ */
+/**
+ * Base height for webcam plane in meters
+ * At scale 1.0, the plane is 1 meter tall
+ */
+export declare const WEBCAM_BASE_HEIGHT_METERS = 1;
+/**
+ * Silhouette occupies 85% of plane height
+ * This leaves margin at top and bottom for natural framing
+ */
+export declare const SILHOUETTE_HEIGHT_RATIO = 0.85;
+/**
+ * Calculate webcam plane base dimensions in meters
+ *
+ * @param aspectRatio - Webcam aspect ratio (width/height)
+ * @returns Object with width and height in meters
+ */
+export declare function getWebcamBaseDimensions(aspectRatio: number): {
+    width: number;
+    height: number;
+};
+/**
+ * Calculate Y offset for webcam mesh positioning
+ * This ensures the webcam plane's bottom aligns with the Y position
+ *
+ * @param baseDimensionsHeight - Base height in meters (usually 1.0)
+ * @param scale - Scale factor from participation template
+ * @returns Y offset in meters
+ */
+export declare function getWebcamMeshYOffset(baseDimensionsHeight: number, scale: number): number;
+/**
+ * Convert rotation from degrees to radians for Three.js Euler
+ *
+ * @param rotation - Rotation in degrees [x, y, z]
+ * @returns Object with x, y, z in radians
+ */
+export declare function getObjectEuler(rotation: [number, number, number]): {
+    x: number;
+    y: number;
+    z: number;
+};
+/**
+ * Convert Gausst camera rotation to Three.js Euler angles
+ * Uses YXZ rotation order for proper camera orientation
+ *
+ * @param rotation - Camera rotation in degrees [tilt, pan, roll]
+ * @returns Object with x, y, z in radians and rotation order
+ */
+export declare function getCameraEuler(rotation: [number, number, number]): {
+    x: number;
+    y: number;
+    z: number;
+    order: string;
+};
+/**
+ * GAM pixels to meters conversion factor
+ * 384 pixels = 1 meter (based on standard ad dimensions)
+ */
+export declare const GAM_PIXELS_TO_METERS: number;
+/**
+ * Standard 3D ad template dimensions
+ */
+export declare const AD_TEMPLATE_DIMENSIONS: Record<string, {
+    w: number;
+    h: number;
+}>;
+/**
+ * Get 3D ad dimensions in meters
+ *
+ * @param templateId - Ad template identifier
+ * @returns Object with width and height in meters
+ */
+export declare function getAdDimensions(templateId: string): {
+    width: number;
+    height: number;
+};
+/**
+ * Chroma key color presets
+ */
+export declare const CHROMA_KEY_COLORS: {
+    readonly green: 65280;
+    readonly blue: 255;
+};
+/**
+ * Get chroma key color as hex number
+ *
+ * @param colorPreset - Color preset ('green' | 'blue' | 'custom')
+ * @param customHex - Custom hex string when preset is 'custom'
+ * @returns Hex color number
+ */
+export declare function getChromaKeyColorHex(colorPreset: 'green' | 'blue' | 'custom', customHex: string): number;
+/**
+ * Convert feather value from UI range (0-10) to UV units (0-0.15)
+ *
+ * @param featherValue - Feather value in UI range (0-10)
+ * @returns Feather value in UV units
+ */
+export declare function featherToUV(featherValue: number): number;
+/**
+ * Convert per-edge feather values from UI range to UV units
+ *
+ * @param featherEdges - Per-edge feather values [top, right, bottom, left]
+ * @returns Per-edge values in UV units
+ */
+export declare function featherEdgesToUV(featherEdges: [number, number, number, number]): [number, number, number, number];
+//# sourceMappingURL=webcam-utils.d.ts.map

package/dist/layer2/webcam-utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webcam-utils.d.ts","sourceRoot":"","sources":["../../src/layer2/webcam-utils.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAIH;;;GAGG;AACH,eAAO,MAAM,yBAAyB,IAAM,CAAC;AAE7C;;;GAGG;AACH,eAAO,MAAM,uBAAuB,OAAO,CAAC;AAE5C;;;;;GAKG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAI9F;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,oBAAoB,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAExF;AAED;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG;IACnE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACV,CAMA;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG;IACnE,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;CACd,CAQA;AAED;;;GAGG;AACH,eAAO,MAAM,oBAAoB,QAAU,CAAC;AAE5C;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAK3E,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,UAAU,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAMrF;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB;;;CAGpB,CAAC;AAEX;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CACnC,WAAW,EAAE,OAAO,GAAG,MAAM,GAAG,QAAQ,EACxC,SAAS,EAAE,MAAM,GACf,MAAM,CAYR;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,YAAY,EAAE,MAAM,GAAG,MAAM,CAExD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC/B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC5C,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAOlC"}

package/dist/layer2/webcam-utils.js

@@ -0,0 +1,147 @@
+/**
+ * Shared webcam utility functions for Layer 2 rendering
+ *
+ * These utilities are used by both editor and player for consistent
+ * webcam plane positioning and geometry calculations.
+ *
+ * ArchiMate: Application Component (Shared Webcam Utilities)
+ */
+import { GAUSST } from '../index';
+/**
+ * Base height for webcam plane in meters
+ * At scale 1.0, the plane is 1 meter tall
+ */
+export const WEBCAM_BASE_HEIGHT_METERS = 1.0;
+/**
+ * Silhouette occupies 85% of plane height
+ * This leaves margin at top and bottom for natural framing
+ */
+export const SILHOUETTE_HEIGHT_RATIO = 0.85;
+/**
+ * Calculate webcam plane base dimensions in meters
+ *
+ * @param aspectRatio - Webcam aspect ratio (width/height)
+ * @returns Object with width and height in meters
+ */
+export function getWebcamBaseDimensions(aspectRatio) {
+    const height = WEBCAM_BASE_HEIGHT_METERS;
+    const width = height * aspectRatio;
+    return { width, height };
+}
+/**
+ * Calculate Y offset for webcam mesh positioning
+ * This ensures the webcam plane's bottom aligns with the Y position
+ *
+ * @param baseDimensionsHeight - Base height in meters (usually 1.0)
+ * @param scale - Scale factor from participation template
+ * @returns Y offset in meters
+ */
+export function getWebcamMeshYOffset(baseDimensionsHeight, scale) {
+    return (baseDimensionsHeight / 2) * scale;
+}
+/**
+ * Convert rotation from degrees to radians for Three.js Euler
+ *
+ * @param rotation - Rotation in degrees [x, y, z]
+ * @returns Object with x, y, z in radians
+ */
+export function getObjectEuler(rotation) {
+    return {
+        x: rotation[0] * GAUSST.DEG_TO_RAD,
+        y: rotation[1] * GAUSST.DEG_TO_RAD,
+        z: rotation[2] * GAUSST.DEG_TO_RAD
+    };
+}
+/**
+ * Convert Gausst camera rotation to Three.js Euler angles
+ * Uses YXZ rotation order for proper camera orientation
+ *
+ * @param rotation - Camera rotation in degrees [tilt, pan, roll]
+ * @returns Object with x, y, z in radians and rotation order
+ */
+export function getCameraEuler(rotation) {
+    const [tilt, pan, roll] = rotation;
+    return {
+        x: tilt * GAUSST.DEG_TO_RAD,
+        y: -pan * GAUSST.DEG_TO_RAD,
+        z: -roll * GAUSST.DEG_TO_RAD,
+        order: 'YXZ'
+    };
+}
+/**
+ * GAM pixels to meters conversion factor
+ * 384 pixels = 1 meter (based on standard ad dimensions)
+ */
+export const GAM_PIXELS_TO_METERS = 1 / 384;
+/**
+ * Standard 3D ad template dimensions
+ */
+export const AD_TEMPLATE_DIMENSIONS = {
+    'overlay-medium-rectangle': { w: 300, h: 250 },
+    'overlay-leaderboard': { w: 728, h: 90 },
+    'overlay-skyscraper': { w: 160, h: 600 },
+    'overlay-banner': { w: 468, h: 60 }
+};
+/**
+ * Get 3D ad dimensions in meters
+ *
+ * @param templateId - Ad template identifier
+ * @returns Object with width and height in meters
+ */
+export function getAdDimensions(templateId) {
+    const dims = AD_TEMPLATE_DIMENSIONS[templateId] ?? { w: 300, h: 250 };
+    return {
+        width: dims.w * GAM_PIXELS_TO_METERS,
+        height: dims.h * GAM_PIXELS_TO_METERS
+    };
+}
+/**
+ * Chroma key color presets
+ */
+export const CHROMA_KEY_COLORS = {
+    green: 0x00ff00,
+    blue: 0x0000ff
+};
+/**
+ * Get chroma key color as hex number
+ *
+ * @param colorPreset - Color preset ('green' | 'blue' | 'custom')
+ * @param customHex - Custom hex string when preset is 'custom'
+ * @returns Hex color number
+ */
+export function getChromaKeyColorHex(colorPreset, customHex) {
+    switch (colorPreset) {
+        case 'green':
+            return CHROMA_KEY_COLORS.green;
+        case 'blue':
+            return CHROMA_KEY_COLORS.blue;
+        case 'custom':
+            // Parse hex string (e.g., '#00B140' -> 0x00B140)
+            return parseInt(customHex.replace('#', ''), 16);
+        default:
+            return CHROMA_KEY_COLORS.green;
+    }
+}
+/**
+ * Convert feather value from UI range (0-10) to UV units (0-0.15)
+ *
+ * @param featherValue - Feather value in UI range (0-10)
+ * @returns Feather value in UV units
+ */
+export function featherToUV(featherValue) {
+    return featherValue * 0.015;
+}
+/**
+ * Convert per-edge feather values from UI range to UV units
+ *
+ * @param featherEdges - Per-edge feather values [top, right, bottom, left]
+ * @returns Per-edge values in UV units
+ */
+export function featherEdgesToUV(featherEdges) {
+    return [
+        featherEdges[0] * 0.015,
+        featherEdges[1] * 0.015,
+        featherEdges[2] * 0.015,
+        featherEdges[3] * 0.015
+    ];
+}

package/dist/layer2/webcam-utils.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=webcam-utils.test.d.ts.map

package/dist/layer2/webcam-utils.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"webcam-utils.test.d.ts","sourceRoot":"","sources":["../../src/layer2/webcam-utils.test.ts"],"names":[],"mappings":""}

package/dist/layer2/webcam-utils.test.js

@@ -0,0 +1,18 @@
+import { describe, it, expect } from 'vitest';
+import { featherToUV, getChromaKeyColorHex } from './webcam-utils';
+describe('featherToUV', () => {
+    it('converts 10 to 0.15', () => {
+        expect(featherToUV(10)).toBe(0.15);
+    });
+    it('converts 0 to 0', () => {
+        expect(featherToUV(0)).toBe(0);
+    });
+});
+describe('getChromaKeyColorHex', () => {
+    it('returns green preset', () => {
+        expect(getChromaKeyColorHex('green', '')).toBe(0x00ff00);
+    });
+    it('parses custom hex color', () => {
+        expect(getChromaKeyColorHex('custom', '#00B140')).toBe(0x00b140);
+    });
+});