@holoscript/core 2.0.1 → 2.1.0

package/src/services/PlatformPerformanceOptimizer.ts

@@ -1,503 +0,0 @@
-/**
- * Platform Performance Optimization System
- *
- * Provides adaptive quality and performance tuning for:
- * - Mobile devices (battery/bandwidth constrained)
- * - VR/AR platforms (latency-critical, 90 FPS required)
- * - Desktop (quality-focused, high resolution)
- *
- * Features:
- * - Automatic quality adjustment based on device
- * - Performance profiling and analysis
- * - Bottleneck detection and mitigation
- * - Cross-platform benchmark testing
- */
-
-// ============================================================================
-// Device Capabilities
-// ============================================================================
-
-export interface DeviceInfo {
-  platform: 'mobile' | 'vr' | 'desktop';
-  gpuVendor: string;
-  gpuModel: string;
-  gpuMemory: number; // MB
-  cpuCores: number;
-  ramTotal: number; // MB
-  screenResolution: { width: number; height: number };
-  refreshRate: number;
-  isLowPowerMode?: boolean;
-}
-
-export interface DeviceCapabilities {
-  maxTextureResolution: number;
-  supportsCompression: boolean;
-  compressionFormats: string[];
-  maxSimultaneousLights: number;
-  shadowsSupported: boolean;
-  computeShaderSupported: boolean;
-  rayTracingSupported: boolean;
-  estimatedMemory: number;
-}
-
-// ============================================================================
-// Performance Profile
-// ============================================================================
-
-export interface PerformanceProfile {
-  device: DeviceInfo;
-  capabilities: DeviceCapabilities;
-  targetFPS: number;
-  qualityLevel: 'low' | 'medium' | 'high' | 'ultra';
-  adaptiveQuality: boolean;
-  fpsTarget: number;
-  fpsMin: number;
-  cpuBudget: number; // ms per frame
-  gpuBudget: number; // ms per frame
-}
-
-// ============================================================================
-// Performance Benchmark
-// ============================================================================
-
-export interface BenchmarkResult {
-  testName: string;
-  platform: string;
-  fps: number;
-  gpuFrameTime: number; // ms
-  cpuFrameTime: number; // ms
-  gpuMemoryUsed: number; // MB
-  trianglesPerSecond: number;
-  drawCallsPerSecond: number;
-  qualityLevel: string;
-  passed: boolean;
-}
-
-// ============================================================================
-// Adaptive Quality System
-// ============================================================================
-
-export interface AdaptiveQualitySettings {
-  enabled: boolean;
-  checkInterval: number; // ms
-  fpsDeltaThreshold: number; // FPS change to trigger adjustment
-  memoryThreshold: number; // % of max allowed
-  temperatureThreshold?: number; // celsius (mobile)
-}
-
-// ============================================================================
-// Compression & Recommendations
-// ============================================================================
-
-export type CompressionFormat =
-  | 'none'
-  | 'lz4'
-  | 'zstd'
-  | 'bc1'
-  | 'bc7'
-  | 'astc'
-  | 'etc2'
-  | 'pvrtc';
-
-export interface PerformanceRecommendation {
-  category: 'texture' | 'geometry' | 'shader' | 'memory' | 'rendering';
-  priority: 'low' | 'medium' | 'high' | 'critical';
-  recommendation: string;
-  expectedImprovement: number; // percentage
-  estimatedCost: string; // complexity of implementation
-}
-
-// ============================================================================
-// Platform Performance Optimizer
-// ============================================================================
-
-export class PlatformPerformanceOptimizer {
-  private deviceInfo: DeviceInfo;
-  private capabilities: DeviceCapabilities;
-  private profile: PerformanceProfile;
-  private adaptiveSettings: AdaptiveQualitySettings;
-
-  private currentFPS: number = 60;
-  private frameHistory: number[] = [];
-  private lastAdaptTime: number = 0;
-
-  constructor(device: DeviceInfo) {
-    this.deviceInfo = device;
-    this.capabilities = this.detectCapabilities(device);
-    this.profile = this.createProfile(device);
-    this.adaptiveSettings = this.getAdaptiveSettings(device.platform);
-  }
-
-  /**
-   * Detect device capabilities
-   */
-  private detectCapabilities(device: DeviceInfo): DeviceCapabilities {
-    let maxTexture = 2048;
-    let supportsCompression = true;
-    let compressionFormats: string[] = ['dxt', 'basis'];
-    let maxLights = 4;
-    let shadowsSupported = true;
-    let computeSupported = false;
-    let rayTracingSupported = false;
-
-    // Mobile capabilities
-    if (device.platform === 'mobile') {
-      maxTexture = 512;
-      maxLights = 2;
-      shadowsSupported = false;
-      compressionFormats = ['astc', 'pvrtc'];
-
-      // Check for low memory
-      if (device.gpuMemory < 1024) {
-        maxTexture = 256;
-        maxLights = 1;
-        supportsCompression = true;
-      }
-    }
-
-    // VR capabilities
-    if (device.platform === 'vr') {
-      maxTexture = 2048;
-      maxLights = 4;
-      shadowsSupported = true;
-      compressionFormats = ['basis', 'dxt'];
-      computeSupported = true;
-    }
-
-    // Desktop capabilities
-    if (device.platform === 'desktop') {
-      maxTexture = 4096;
-      maxLights = 8;
-      shadowsSupported = true;
-      compressionFormats = ['none', 'dxt', 'basis'];
-      computeSupported = true;
-      rayTracingSupported = true;
-    }
-
-    return {
-      maxTextureResolution: maxTexture,
-      supportsCompression,
-      compressionFormats,
-      maxSimultaneousLights: maxLights,
-      shadowsSupported,
-      computeShaderSupported: computeSupported,
-      rayTracingSupported,
-      estimatedMemory: Math.min(device.gpuMemory, 2048),
-    };
-  }
-
-  /**
-   * Create performance profile for device
-   */
-  private createProfile(device: DeviceInfo): PerformanceProfile {
-    let qualityLevel: 'low' | 'medium' | 'high' | 'ultra' = 'high';
-    let fpsTarget = 60;
-    let fpsMin = 30;
-    let cpuBudget = 16.67; // ms for 60 FPS
-    let gpuBudget = 16.67; // ms for 60 FPS
-
-    // Mobile
-    if (device.platform === 'mobile') {
-      qualityLevel = 'low';
-      fpsTarget = 30;
-      fpsMin = 24;
-      cpuBudget = 33.33; // ms for 30 FPS
-      gpuBudget = 33.33; // ms for 30 FPS
-    }
-
-    // VR (more demanding)
-    if (device.platform === 'vr') {
-      qualityLevel = 'high';
-      fpsTarget = 90;
-      fpsMin = 75;
-      cpuBudget = 11.11; // ms for 90 FPS
-      gpuBudget = 11.11; // ms for 90 FPS
-    }
-
-    // Desktop (quality-focused)
-    if (device.platform === 'desktop') {
-      qualityLevel = 'ultra';
-      fpsTarget = device.refreshRate || 120;
-      fpsMin = 60;
-      cpuBudget = 1000 / fpsTarget;
-      gpuBudget = 1000 / fpsTarget;
-    }
-
-    return {
-      device,
-      capabilities: this.capabilities,
-      targetFPS: fpsTarget,
-      qualityLevel,
-      adaptiveQuality: device.platform === 'mobile' || device.platform === 'vr',
-      fpsTarget,
-      fpsMin,
-      cpuBudget,
-      gpuBudget,
-    };
-  }
-
-  /**
-   * Get adaptive quality settings for platform
-   */
-  private getAdaptiveSettings(platform: string): AdaptiveQualitySettings {
-    if (platform === 'mobile') {
-      return {
-        enabled: true,
-        checkInterval: 500, // Check every 500ms
-        fpsDeltaThreshold: 5, // Adjust if FPS changes by 5+
-        memoryThreshold: 80, // Adjust if above 80% memory
-        temperatureThreshold: 45, // Adjust if above 45C
-      };
-    }
-
-    if (platform === 'vr') {
-      return {
-        enabled: true,
-        checkInterval: 300, // Check every 300ms
-        fpsDeltaThreshold: 3, // Adjust if FPS changes by 3+
-        memoryThreshold: 85, // Adjust if above 85% memory
-      };
-    }
-
-    // Desktop
-    return {
-      enabled: false, // No adaptive quality needed
-      checkInterval: 1000,
-      fpsDeltaThreshold: 0,
-      memoryThreshold: 90,
-    };
-  }
-
-  /**
-   * Optimize for device - returns recommended rendering settings
-   */
-  optimizeForDevice(): any {
-    const { platform, gpuMemory, isLowPowerMode } = this.deviceInfo;
-    const quality = this.profile.qualityLevel;
-
-    const settings = {
-      quality,
-      platform,
-      textureResolution: this.capabilities.maxTextureResolution,
-      compression: this.selectCompression(platform),
-      maxLights: this.capabilities.maxSimultaneousLights,
-      shadowsEnabled: this.capabilities.shadowsSupported,
-      lodEnabled: true,
-      cullingEnabled: true,
-      instancingEnabled: true,
-      gpuMemoryBudget: gpuMemory > 2048 ? 1024 : gpuMemory / 2,
-    };
-
-    // Mobile low power adjustments
-    if (isLowPowerMode && platform === 'mobile') {
-      settings.quality = 'low';
-      settings.textureResolution = 256;
-      settings.compression = 'astc';
-      settings.maxLights = 1;
-      settings.shadowsEnabled = false;
-      settings.lodEnabled = true;
-      settings.cullingEnabled = true;
-    }
-
-    return settings;
-  }
-
-  /**
-   * Select best compression format for platform
-   */
-  private selectCompression(platform: string): string {
-    const formats = this.capabilities.compressionFormats;
-
-    if (platform === 'mobile') {
-      return formats.includes('astc') ? 'astc' : formats[0];
-    }
-
-    if (platform === 'vr') {
-      return formats.includes('basis') ? 'basis' : formats[0];
-    }
-
-    // Desktop
-    return formats.includes('none') ? 'none' : formats[0];
-  }
-
-  /**
-   * Update frame metrics for adaptive quality
-   */
-  updateFrameMetrics(fps: number, gpuMemoryUsed: number, gpuFrameTime: number): void {
-    this.currentFPS = fps;
-    this.frameHistory.push(fps);
-
-    // Keep only last 30 frames
-    if (this.frameHistory.length > 30) {
-      this.frameHistory.shift();
-    }
-
-    // Check if adaptation is needed
-    if (this.adaptiveSettings.enabled) {
-      const now = Date.now();
-      if (now - this.lastAdaptTime > this.adaptiveSettings.checkInterval) {
-        this.checkAndAdapt(fps, gpuMemoryUsed);
-        this.lastAdaptTime = now;
-      }
-    }
-  }
-
-  /**
-   * Check and adapt quality settings
-   */
-  private checkAndAdapt(fps: number, gpuMemoryUsed: number): void {
-    const avgFps = this.getAverageFPS();
-    const memoryPercent = (gpuMemoryUsed / this.profile.capabilities.estimatedMemory) * 100;
-
-    let shouldDegrade = false;
-    let shouldImprove = false;
-
-    // Check FPS
-    if (avgFps < this.profile.fpsMin) {
-      shouldDegrade = true;
-    } else if (avgFps > this.profile.fpsTarget + this.adaptiveSettings.fpsDeltaThreshold) {
-      shouldImprove = true;
-    }
-
-    // Check memory
-    if (memoryPercent > this.adaptiveSettings.memoryThreshold) {
-      shouldDegrade = true;
-    }
-
-    if (shouldDegrade) {
-      this.degradeQuality();
-    } else if (shouldImprove) {
-      this.improveQuality();
-    }
-  }
-
-  /**
-   * Degrade quality for better performance
-   */
-  private degradeQuality(): void {
-    switch (this.profile.qualityLevel) {
-      case 'ultra':
-        this.profile.qualityLevel = 'high';
-        break;
-      case 'high':
-        this.profile.qualityLevel = 'medium';
-        break;
-      case 'medium':
-        this.profile.qualityLevel = 'low';
-        break;
-      case 'low':
-        // Already at minimum
-        break;
-    }
-  }
-
-  /**
-   * Improve quality for better visuals
-   */
-  private improveQuality(): void {
-    switch (this.profile.qualityLevel) {
-      case 'low':
-        this.profile.qualityLevel = 'medium';
-        break;
-      case 'medium':
-        this.profile.qualityLevel = 'high';
-        break;
-      case 'high':
-        if (this.profile.device.platform === 'desktop') {
-          this.profile.qualityLevel = 'ultra';
-        }
-        break;
-      case 'ultra':
-        // Already at maximum
-        break;
-    }
-  }
-
-  /**
-   * Get average FPS from history
-   */
-  private getAverageFPS(): number {
-    if (this.frameHistory.length === 0) {
-      return this.currentFPS;
-    }
-
-    const sum = this.frameHistory.reduce((a, b) => a + b, 0);
-    return sum / this.frameHistory.length;
-  }
-
-  /**
-   * Run performance benchmark
-   */
-  async runBenchmark(
-    name: string,
-    renderFunc: (iterations: number) => Promise<{ fps: number; gpuTime: number; cpuTime: number; triangles: number; drawCalls: number }>
-  ): Promise<BenchmarkResult> {
-    const iterations = this.getBenchmarkIterations();
-
-    console.log(`Running benchmark: ${name} (${iterations} iterations)...`);
-
-    const result = await renderFunc(iterations);
-
-    const fps = result.fps;
-    const passed = fps >= this.profile.fpsMin;
-
-    return {
-      testName: name,
-      platform: this.deviceInfo.platform,
-      fps,
-      gpuFrameTime: result.gpuTime,
-      cpuFrameTime: result.cpuTime,
-      gpuMemoryUsed: 0, // Would be populated from actual measurement
-      trianglesPerSecond: result.triangles * fps,
-      drawCallsPerSecond: result.drawCalls * fps,
-      qualityLevel: this.profile.qualityLevel,
-      passed,
-    };
-  }
-
-  /**
-   * Get benchmark iterations based on platform
-   */
-  private getBenchmarkIterations(): number {
-    switch (this.deviceInfo.platform) {
-      case 'mobile':
-        return 100;
-      case 'vr':
-        return 200;
-      case 'desktop':
-        return 300;
-    }
-  }
-
-  /**
-   * Get current performance profile
-   */
-  getProfile(): PerformanceProfile {
-    return { ...this.profile };
-  }
-
-  /**
-   * Get optimization recommendations
-   */
-  getRecommendations(): string[] {
-    const recommendations: string[] = [];
-    const avgFps = this.getAverageFPS();
-
-    if (avgFps < this.profile.fpsMin) {
-      recommendations.push(`FPS below target (${Math.round(avgFps)} < ${this.profile.fpsMin})`);
-      recommendations.push('Consider reducing quality preset');
-      recommendations.push('Enable texture compression');
-      recommendations.push('Reduce shadow quality');
-    }
-
-    if (this.profile.device.isLowPowerMode) {
-      recommendations.push('Device in low power mode');
-      recommendations.push('Consider reducing quality');
-      recommendations.push('Disable shadows and lights');
-    }
-
-    return recommendations;
-  }
-}
-
-export default PlatformPerformanceOptimizer;