Skip to content

Create professional demos and 3D mockups in seconds, directly in your browser

feat: refine Preview3DConfig and ZoomFragment interfaces for improved clarity and structure

CristianOlivera1b2d5aedf0c79
diff --git a/types/photo.types.ts b/types/photo.types.ts
index a04b22b..64f0744 100644
--- a/types/photo.types.ts
+++ b/types/photo.types.ts
@@ -11,27 +11,16 @@ export interface Preview3DConfig {
perspective?: number;
}
-// Configuraciones 3D estáticas e inmutables para los previews
-// Estas configuraciones NUNCA deben cambiar, independientemente del estado del canvas
export const PREVIEW_CONFIGS: readonly Preview3DConfig[] = Object.freeze([
Object.freeze({ id: "front", label: "Front", rotateX: 0, rotateY: 0, rotateZ: 0, translateY: 0, scale: 0.9, perspective: 600 }),
- Object.freeze({ id: "tilt-up", label: "Tilt Up", rotateX: 15, rotateY: 0, rotateZ: 0, translateY: -2, scale: 0.88, perspective: 500 }),
Object.freeze({ id: "top-left-angle", label: "Top Left Angle", rotateX: 18, rotateY: 25, rotateZ: -15, translateY: -10, scale: 0.95, perspective: 500 }),
Object.freeze({ id: "top-right-angle", label: "Top Right Angle", rotateX: 18, rotateY: -22, rotateZ: 15, translateY: 5, scale: 0.95, perspective: 500 }),
+ Object.freeze({ id: "bottom-left-angle", label: "Bottom Left Angle", rotateX: -18, rotateY: 25, rotateZ: 15, translateY: -5, scale: 0.95, perspective: 500 }),
+ Object.freeze({ id: "bottom-right-angle", label: "Bottom Right Angle", rotateX: -18, rotateY: -22, rotateZ: -15, translateY: -5, scale: 0.95, perspective: 500 }),
+ Object.freeze({ id: "isometric", label: "Isometric", rotateX: 35, rotateY: -45, rotateZ: 10, translateY: 0, scale: 0.85, perspective: 1000 }), Object.freeze({ id: "tilt-up", label: "Tilt Up", rotateX: 15, rotateY: 0, rotateZ: 0, translateY: -2, scale: 0.88, perspective: 500 }),
+ Object.freeze({ id: "tilt-down", label: "Tilt Down", rotateX: -15, rotateY: 0, rotateZ: 0, translateY: 2, scale: 0.88, perspective: 500 }),
]);
-// Configuración estática para previews de mask (siempre en posición frontal)
-export const PREVIEW_FRONT_CONFIG: Readonly<Preview3DConfig> = Object.freeze({
- id: "front",
- label: "Front",
- rotateX: 0,
- rotateY: 0,
- rotateZ: 0,
- translateY: 0,
- scale: 0.9,
- perspective: 600,
-});
-
export interface ImageMaskConfig {
enabled: boolean;
top?: { from: number; to?: number };
@@ -50,7 +39,6 @@ export const DEFAULT_MASK_CONFIG: ImageMaskConfig = {
export interface PhotoEditorPlaceholderProps {
className?: string;
canvasImageUrl?: string | null;
- /** Raw uploaded image URL (no canvas effects). Used as static reference in preview cards. */
staticImageUrl?: string | null;
onSelectPreview?: (config: Preview3DConfig) => void;
selectedPreviewId?: string;
diff --git a/types/zoom.types.ts b/types/zoom.types.ts
index 725d65a..6b323ca 100644
--- a/types/zoom.types.ts
+++ b/types/zoom.types.ts
@@ -2,27 +2,21 @@ import { VideoThumbnail } from "./editor.types";
export interface ZoomFragment {
id: string;
- startTime: number; // Tiempo de inicio del fragmento (segundos)
- endTime: number; // Tiempo de fin del fragmento (segundos)
- zoomLevel: number; // Nivel de zoom (1-10, donde 5 = 2x)
- speed: number; // Velocidad de animación entrada/salida (1-10)
- focusX: number; // Punto de enfoque inicial X (0-100%)
- focusY: number; // Punto de enfoque inicial Y (0-100%)
-
- // 3-Phase System: Entry → Hold with Pan Movement → Exit
- // When movementEnabled is false, it's simple zoom in/out (CSS handles transitions)
- movementEnabled?: boolean; // Enable dynamic hold phase with panning
- movementEndX?: number; // Destination X after panning (0-100%)
- movementEndY?: number; // Destination Y after panning (0-100%)
- // Movement timing within hold period (0 = hold start, holdDuration = hold end)
- movementStartOffset?: number; // When movement starts (seconds from hold start)
- movementEndOffset?: number; // When movement ends (seconds from hold start)
-
- // 3D perspective effect during zoom
- enable3D?: boolean; // Enable 3D perspective effect
- perspective3DIntensity?: number; // 0-100: intensity of 3D effect (default 50)
- perspective3DAngleX?: number; // -45 to 45: tilt angle X direction (default: auto from focus)
- perspective3DAngleY?: number; // -45 to 45: tilt angle Y direction (default: auto from focus)
+ startTime: number;
+ endTime: number;
+ zoomLevel: number;
+ speed: number;
+ focusX: number;
+ focusY: number;
+ movementEnabled?: boolean;
+ movementEndX?: number;
+ movementEndY?: number;
+ movementStartOffset?: number;
+ movementEndOffset?: number;
+ enable3D?: boolean;
+ perspective3DIntensity?: number;
+ perspective3DAngleX?: number;
+ perspective3DAngleY?: number;
}
export interface ZoomState {
@@ -57,19 +51,12 @@ export interface ZoomPhaseState {
scale: number;
focusX: number;
focusY: number;
- progress: number; // 0-1 progress within current phase
- // 3D effect values
- rotateX: number; // degrees
- rotateY: number; // degrees
- perspective: number; // px (0 = no perspective)
+ progress: number;
+ rotateX: number;
+ rotateY: number;
+ perspective: number;
}
-/**
- * Calculate zoom phase state for both preview and export
- * @param fragment - The zoom fragment configuration
- * @param currentTime - Current playback time in seconds
- * @param forExport - If true, calculates animated scale (for canvas export). If false, returns target scale (CSS handles animation)
- */
export function calculateZoomPhaseState(
fragment: ZoomFragment,
currentTime: number,
@@ -82,23 +69,20 @@ export function calculateZoomPhaseState(
const targetScale = zoomLevelToFactor(fragment.zoomLevel);
const enable3D = fragment.enable3D ?? false;
- // Calculate transition timing
const transitionSeconds = speedToTransitionMs(fragment.speed) / 1000;
const entryEndTime = fragment.startTime + transitionSeconds;
const exitStartTime = fragment.endTime - transitionSeconds;
const holdDuration = Math.max(0, exitStartTime - entryEndTime);
- // Initialize state
let rotateX = 0;
let rotateY = 0;
let perspective = 0;
- let scale = forExport ? 1 : targetScale; // For preview, CSS handles animation
+ let scale = forExport ? 1 : targetScale;
let focusX = fragment.focusX;
let focusY = fragment.focusY;
let phase: 'entry' | 'hold' | 'exit' = 'hold';
let progress = normalizedTime;
- // Movement end points
const movementEndX = fragment.movementEndX ?? fragment.focusX;
const movementEndY = fragment.movementEndY ?? fragment.focusY;
@@ -125,21 +109,18 @@ export function calculateZoomPhaseState(
scale = targetScale - (targetScale - 1) * easedProgress;
}
- // Focus should be at movement end if movement was enabled
if (fragment.movementEnabled) {
focusX = movementEndX;
focusY = movementEndY;
}
} else {
- // HOLD PHASE: Maintain zoom, handle movement
phase = 'hold';
if (forExport) {
scale = targetScale;
}
- // Handle camera movement during hold
if (fragment.movementEnabled && holdDuration > 0) {
const movementStartOffset = fragment.movementStartOffset ?? 0;
const movementEndOffset = fragment.movementEndOffset ?? holdDuration;
@@ -163,24 +144,19 @@ export function calculateZoomPhaseState(
}
// 3D EFFECT: Completely separate from zoom animation
- // Professional approach: subtle static perspective that fades in/out smoothly
if (enable3D) {
- const intensity = (fragment.perspective3DIntensity ?? 50) / 100; // 0-1 range
+ const intensity = (fragment.perspective3DIntensity ?? 50) / 100;
- // Get user-configured angles (default to 0 for neutral, user picks direction)
const baseAngleX = fragment.perspective3DAngleX ?? 0;
const baseAngleY = fragment.perspective3DAngleY ?? 0;
- // Calculate 3D opacity based on phase for smooth transitions
let effect3DOpacity = 0;
if (phase === 'entry') {
const entryProgress = (currentTime - fragment.startTime) / transitionSeconds;
- // El 3D arranca desde el inicio de la entry, sin umbral
- effect3DOpacity = Math.min(1, entryProgress * 1.2); // llega a 1 antes del final de entry
+ effect3DOpacity = Math.min(1, entryProgress * 1.2);
} else if (phase === 'exit') {
const exitProgress = (currentTime - exitStartTime) / transitionSeconds;
- // El 3D se va durante toda la exit
effect3DOpacity = Math.max(0, 1 - exitProgress * 1.8);
} else {
effect3DOpacity = 1;
@@ -188,9 +164,8 @@ export function calculateZoomPhaseState(
// Apply 3D with smooth easing
const smoothOpacity = easeInOutQuart(effect3DOpacity);
- perspective = 500; // Distancia de perspectiva fija para un efecto sutil y profesional
+ perspective = 500;
- // Intensidad de rotacion
const maxRotation = 32 * intensity;
rotateX = (baseAngleX / 45) * maxRotation * smoothOpacity;
rotateY = (baseAngleY / 45) * maxRotation * smoothOpacity;
@@ -209,7 +184,6 @@ export function calculateZoomPhaseState(
}
// Calculate available hold time for camera movement
-// Hold time = fragment duration - entry transition - exit transition
export function calculateHoldDuration(fragment: ZoomFragment): number {
const totalDuration = fragment.endTime - fragment.startTime;
const transitionSeconds = speedToTransitionMs(fragment.speed) / 1000;
@@ -228,11 +202,10 @@ export interface ZoomState {
focusY: number;
}
-const DEFAULT_ZOOM_LEVEL = 1.5; // 2x zoom
-const DEFAULT_ZOOM_SPEED = 4; // Medium speed
+const DEFAULT_ZOOM_LEVEL = 1.5;
+const DEFAULT_ZOOM_SPEED = 5;
// Helper para crear un nuevo fragmento con valores por defecto
-// By default, creates a simple zoom in/out fragment without camera movement
export function createZoomFragment(
startTime: number,
endTime: number
@@ -245,7 +218,6 @@ export function createZoomFragment(
speed: DEFAULT_ZOOM_SPEED,
focusX: 50,
focusY: 50,
- // 3-phase movement disabled by default (simple zoom in/out)
movementEnabled: false,
};
}
@@ -261,14 +233,12 @@ export function generateDefaultZoomFragments(
const fragments: ZoomFragment[] = [];
- // Primer fragmento en el primer tercio
const start1 = Math.max(0, spacing * 0.5);
fragments.push(createZoomFragment(
start1,
Math.min(start1 + fragmentDuration, videoDuration)
));
- // Segundo fragmento en el segundo tercio
const start2 = Math.max(0, spacing * 2);
fragments.push(createZoomFragment(
start2,
@@ -282,22 +252,20 @@ export function generateDefaultZoomFragments(
export function zoomLevelToFactor(level: number): number {
const minZoom = 1.2;
const maxZoom = 4.0;
- const normalized = (level - 1) / 9; // 0 to 1
+ const normalized = (level - 1) / 9;
return minZoom + (maxZoom - minZoom) * normalized;
}
// Convertir speed (1-10) a duración de transición en milisegundos
export function speedToTransitionMs(speed: number): number {
- const minMs = 150; // Speed 10
- const maxMs = 2000; // Speed 1
- const normalized = (speed - 1) / 9; // 0 to 1
+ const minMs = 150;
+ const maxMs = 2000;
+ const normalized = (speed - 1) / 9;
return Math.round(maxMs - (maxMs - minMs) * normalized);
}
-// Easing suave para animaciones de zoom (cubic-bezier)
export const ZOOM_EASING = 'cubic-bezier(0.4, 0, 0.2, 1)';
-// Formatear tiempo para mostrar en UI (MM:SS)
export function formatZoomTime(seconds: number): string {
const mins = Math.floor(seconds / 60);
const secs = Math.floor(seconds % 60);