Self-hosted personal gallery application with online photo management and albums, supporting Live/Motion Photos, EXIF parsing, geolocation recognition, and an explore map.
TypeScript albumsexif-extractiongeocodinglive-photomotion-photophoto-galleryphoto-sharingwebgl-viewer
import type { Point } from '../types'
/**
* 限制数值在指定范围内
*/
export function clamp(value: number, min: number, max: number): number {
return Math.min(Math.max(value, min), max)
}
/**
* 检测是否为移动设备
*/
export function isMobile(): boolean {
return /Android|webOS|iPhone|iPad|iPod|BlackBerry|IEMobile|Opera Mini/i.test(
navigator.userAgent,
)
}
/**
* 检测是否为触摸设备
*/
export function isTouchDevice(): boolean {
return 'ontouchstart' in window || navigator.maxTouchPoints > 0
}
/**
* 获取设备像素比
*/
export function getDevicePixelRatio(): number {
return window.devicePixelRatio || 1
}
/**
* 计算两点间距离
*/
export function getDistance(
p1: { x: number; y: number },
p2: { x: number; y: number },
): number {
const dx = p2.x - p1.x
const dy = p2.y - p1.y
return Math.sqrt(dx * dx + dy * dy)
}
/**
* 计算多个点的中心点
*/
export function getCenter(points: { x: number; y: number }[]): {
x: number
y: number
} {
const sum = points.reduce(
(acc, point) => ({
x: acc.x + point.x,
y: acc.y + point.y,
}),
{ x: 0, y: 0 },
)
return {
x: sum.x / points.length,
y: sum.y / points.length,
}
}
/**
* 从触摸事件获取触摸点坐标
*/
export function getTouchPoints(touches: TouchList): Point[] {
return Array.from(touches).map((touch) => ({
x: touch.clientX,
y: touch.clientY,
}))
}
/**
* 防抖函数
*/
export function debounce<T extends (...args: any[]) => any>(
func: T,
delay: number,
): (...args: Parameters<T>) => void {
let timeoutId: number
return (...args: Parameters<T>) => {
clearTimeout(timeoutId)
timeoutId = setTimeout(() => func(...args), delay) as unknown as number
}
}
/**
* 节流函数
*/
export function throttle<T extends (...args: any[]) => any>(
func: T,
delay: number,
): (...args: Parameters<T>) => void {
let lastCall = 0
return (...args: Parameters<T>) => {
const now = Date.now()
if (now - lastCall >= delay) {
lastCall = now
func(...args)
}
}
}
/**
* 创建 2D 变换矩阵
*/
export function createTransformMatrix(
scale: number,
translateX: number,
translateY: number,
): Float32Array {
return new Float32Array([scale, 0, 0, 0, scale, 0, translateX, translateY, 1])
}
/**
* 检查 WebGL 支持
*/
export function checkWebGLSupport(): boolean {
try {
const canvas = document.createElement('canvas')
const gl =
canvas.getContext('webgl') || canvas.getContext('experimental-webgl')
return !!gl
} catch {
return false
}
}
/**
* 获取 WebGL 最大纹理尺寸
*/
export function getMaxTextureSize(gl: WebGLRenderingContext): number {
try {
return gl.getParameter(gl.MAX_TEXTURE_SIZE)
} catch {
return 4096 // 回退值
}
}
/**
* 加载图片
*/
export function loadImage(src: string): Promise<HTMLImageElement> {
return new Promise((resolve, reject) => {
const img = new Image()
img.crossOrigin = 'anonymous'
img.onload = () => resolve(img)
img.onerror = () => reject(new Error(`Failed to load image: ${src}`))
img.src = src
})
}