Sharp Stock

English

简体中文

English

简体中文

Thumbnails & Caching ​

Thumbnails are the technical cornerstone of Sharp Stock's ultra-fast browsing experience. The system deeply integrates the main process image processing engine with the real-time preview capabilities of the rendering viewport to generate high-definition thumbnail caches for images, videos, audio, Spine animations, and 3D models.

Thumbnail Effect

1. Generation Logic Overview ​

  • Incremental Auto-Generation: When you import new assets into the library (or paste images from the clipboard), the system automatically generates metadata and thumbnails for these new or modified resources.
  • Startup & Manual Scanning: The system provides "Startup Auto-Scan" and "Full Scan in Settings". The startup auto-scan quickly backfills missing metadata fields and missing thumbnails; you can also manually trigger a deep full scan in "Settings" to completely rebuild metadata and fully backfill all thumbnails.

2. Category-Specific Generation Strategies ​

The system employs optimized processing flows for assets with different characteristics:

Common Bitmaps (PNG, JPG, WebP, etc.) ​

  • Scaled directly by the main process using high-performance image libraries, ensuring core visual features are retained even at low resolutions.

Video Assets (MP4, MOV, WebM, etc.) ​

  • Precise Frame Capture: The system automatically locates approximately 10% into the video duration (or within the first second) to capture a keyframe and save it as a cache.
  • Generation Timing: Video frame captures are also pre-generated during the asset import or startup/manual scanning phases, avoiding lags caused by dynamic frame capturing during scrolling.
  • Decoding Limit Prompt: Some special encodings (e.g., older AVI, WMV) may be unable to capture frames due to system decoder limitations. Refer to Video Management for details.

Spine 2D Skeletal Animation ​

  • Uses the built-in professional Spine runtime environment to load skeleton data and atlases, automatically parsing them and selecting feature frames to generate high-fidelity previews via a background rendering queue during import or scan.

3D Models (FBX, GLB, GLTF) ​

  • Calls the 3D rendering engine to load models in real-time, rendering a snapshot from a default perspective and saving it as a cache image via a background rendering queue during import or scan.

Audio Assets (WAV, MP3, OGG, M4A, FLAC, AAC, etc.) ​

  • Waveform Visualization: The system decodes audio, extracts waveform features, renders them as waveform thumbnails, and saves them as PNG cache files.
  • Generation Timing: Like videos and 3D models, waveforms are pre-generated during asset import or startup/manual scanning via the post-processing queue, avoiding lag from dynamic decoding while scrolling.
  • See Audio Management for details.

3. Manual Maintenance & Troubleshooting ​

If thumbnail display errors occur (e.g., black images, outdated images) due to external file replacement or system anomalies, you can fix them using the following methods.

Cache Cleanup & Rebuild ​

Go to [Settings] → [Maintenance & Optimization] → [Rebuild Thumbnails]:

  • Orphan File Cleanup: The system will automatically scan and delete redundant cache files that no longer have corresponding assets.
  • Automatic Completion: The system will attempt to regenerate thumbnails for image and video assets missing previews; audio waveforms, Spine, and 3D model metadata and thumbnails will also be automatically generated and completed via the post-processing queue.

4. Performance & Browsing Suggestions ​

  • Pre-Generation Mechanism: Because thumbnails and metadata are pre-generated, the system requires a certain processing cycle during large-scale resource imports or first scans. You can monitor the progress via the interface progress indicators, and it's recommended to wait for it to complete to obtain a full visual preview.
  • Placeholder Description: If a card temporarily displays a format icon, it means the thumbnail for that asset has not been generated yet (e.g., queued during import, or manually placed externally without a scan). You can perform a "Startup Scan" or click the scan button in Settings to backfill thumbnails.

TIP

Thumbnail generation puts some load on the CPU and disk I/O. When processing ultra-large resource libraries, the background generation process may slightly affect system responsiveness.