@esengine/ecs-framework-math 1.0.3 → 2.8.0

package/bin/Color.d.ts

@@ -0,0 +1,277 @@
+/**
+ * Color utility class for game engine
+ * 游戏引擎颜色工具类
+ *
+ * Provides color conversion, manipulation, and packing utilities.
+ * 提供颜色转换、操作和打包工具。
+ */
+/**
+ * RGBA color components
+ * RGBA 颜色分量
+ */
+export interface RGBA {
+    r: number;
+    g: number;
+    b: number;
+    a: number;
+}
+/**
+ * HSL color components
+ * HSL 颜色分量
+ */
+export interface HSL {
+    h: number;
+    s: number;
+    l: number;
+}
+/**
+ * Color class for color manipulation and conversion
+ * 颜色类，用于颜色操作和转换
+ */
+export declare class Color {
+    /** Red component (0-255) | 红色分量 (0-255) */
+    r: number;
+    /** Green component (0-255) | 绿色分量 (0-255) */
+    g: number;
+    /** Blue component (0-255) | 蓝色分量 (0-255) */
+    b: number;
+    /** Alpha component (0-1) | 透明度分量 (0-1) */
+    a: number;
+    /** White (0xFFFFFF) | 白色 */
+    static readonly WHITE: Color;
+    /** Black (0x000000) | 黑色 */
+    static readonly BLACK: Color;
+    /** Red (0xFF0000) | 红色 */
+    static readonly RED: Color;
+    /** Green (0x00FF00) | 绿色 */
+    static readonly GREEN: Color;
+    /** Blue (0x0000FF) | 蓝色 */
+    static readonly BLUE: Color;
+    /** Yellow (0xFFFF00) | 黄色 */
+    static readonly YELLOW: Color;
+    /** Cyan (0x00FFFF) | 青色 */
+    static readonly CYAN: Color;
+    /** Magenta (0xFF00FF) | 品红色 */
+    static readonly MAGENTA: Color;
+    /** Transparent (0x00000000) | 透明 */
+    static readonly TRANSPARENT: Color;
+    /** Gray (0x808080) | 灰色 */
+    static readonly GRAY: Color;
+    /**
+     * Create a new Color instance
+     * 创建新的 Color 实例
+     */
+    constructor(r?: number, g?: number, b?: number, a?: number);
+    /**
+     * Create color from hex string
+     * 从十六进制字符串创建颜色
+     * @param hex Hex string (e.g., "#FF0000", "#F00", "FF0000") | 十六进制字符串
+     * @param alpha Optional alpha value (0-1) | 可选的透明度值
+     */
+    static fromHex(hex: string, alpha?: number): Color;
+    /**
+     * Create color from packed uint32 (0xRRGGBB or 0xAARRGGBB)
+     * 从打包的 uint32 创建颜色
+     * @param value Packed color value | 打包的颜色值
+     * @param hasAlpha Whether value includes alpha | 是否包含透明度
+     */
+    static fromUint32(value: number, hasAlpha?: boolean): Color;
+    /**
+     * Create color from HSL values
+     * 从 HSL 值创建颜色
+     * @param h Hue (0-360) | 色相
+     * @param s Saturation (0-1) | 饱和度
+     * @param l Lightness (0-1) | 亮度
+     * @param a Alpha (0-1) | 透明度
+     */
+    static fromHSL(h: number, s: number, l: number, a?: number): Color;
+    /**
+     * Create color from normalized float values (0-1)
+     * 从归一化浮点值创建颜色 (0-1)
+     */
+    static fromFloat(r: number, g: number, b: number, a?: number): Color;
+    /**
+     * Convert hex string to RGB
+     * 将十六进制字符串转换为 RGB
+     */
+    static hexToRgb(hex: string): {
+        r: number;
+        g: number;
+        b: number;
+    };
+    /**
+     * Convert RGB to hex string
+     * 将 RGB 转换为十六进制字符串
+     */
+    static rgbToHex(r: number, g: number, b: number): string;
+    /**
+     * Convert HSL to RGB
+     * 将 HSL 转换为 RGB
+     */
+    static hslToRgb(h: number, s: number, l: number): {
+        r: number;
+        g: number;
+        b: number;
+    };
+    /**
+     * Convert RGB to HSL
+     * 将 RGB 转换为 HSL
+     */
+    static rgbToHsl(r: number, g: number, b: number): HSL;
+    /**
+     * Pack color to uint32 (0xRRGGBB)
+     * 打包颜色为 uint32 (0xRRGGBB)
+     */
+    static packRGB(r: number, g: number, b: number): number;
+    /**
+     * Pack color to uint32 (0xAARRGGBB)
+     * 打包颜色为 uint32 (0xAARRGGBB)
+     */
+    static packARGB(r: number, g: number, b: number, a: number): number;
+    /**
+     * Pack color to uint32 for WebGL (0xAABBGGRR)
+     * 打包颜色为 WebGL 格式的 uint32 (0xAABBGGRR)
+     */
+    static packABGR(r: number, g: number, b: number, a: number): number;
+    /**
+     * Pack hex string and alpha to WebGL uint32 (0xAABBGGRR)
+     * 将十六进制字符串和透明度打包为 WebGL 格式 uint32
+     */
+    static packHexAlpha(hex: string, alpha: number): number;
+    /**
+     * Unpack uint32 to RGBA (assumes 0xAARRGGBB)
+     * 解包 uint32 为 RGBA (假设格式为 0xAARRGGBB)
+     */
+    static unpackARGB(value: number): RGBA;
+    /**
+     * Unpack uint32 to RGBA (assumes 0xAABBGGRR - WebGL format)
+     * 解包 uint32 为 RGBA (假设格式为 0xAABBGGRR - WebGL 格式)
+     */
+    static unpackABGR(value: number): RGBA;
+    /**
+     * Interpolate between two colors
+     * 在两个颜色之间插值
+     */
+    static lerp(from: Color, to: Color, t: number): Color;
+    /**
+     * Interpolate between two packed uint32 colors (0xRRGGBB)
+     * 在两个打包的 uint32 颜色之间插值
+     */
+    static lerpUint32(from: number, to: number, t: number): number;
+    /**
+     * Mix two colors
+     * 混合两个颜色
+     */
+    static mix(color1: Color, color2: Color, ratio?: number): Color;
+    /**
+     * Lighten a color
+     * 使颜色变亮
+     */
+    static lighten(color: Color, amount: number): Color;
+    /**
+     * Darken a color
+     * 使颜色变暗
+     */
+    static darken(color: Color, amount: number): Color;
+    /**
+     * Saturate a color
+     * 增加颜色饱和度
+     */
+    static saturate(color: Color, amount: number): Color;
+    /**
+     * Desaturate a color
+     * 降低颜色饱和度
+     */
+    static desaturate(color: Color, amount: number): Color;
+    /**
+     * Invert a color
+     * 反转颜色
+     */
+    static invert(color: Color): Color;
+    /**
+     * Convert color to grayscale
+     * 将颜色转换为灰度
+     */
+    static grayscale(color: Color): Color;
+    /**
+     * Get color luminance (perceived brightness)
+     * 获取颜色亮度（感知亮度）
+     */
+    static luminance(color: Color): number;
+    /**
+     * Get contrast ratio between two colors
+     * 获取两个颜色之间的对比度
+     */
+    static contrastRatio(color1: Color, color2: Color): number;
+    /**
+     * Convert to hex string
+     * 转换为十六进制字符串
+     */
+    toHex(): string;
+    /**
+     * Convert to hex string with alpha
+     * 转换为带透明度的十六进制字符串
+     */
+    toHexAlpha(): string;
+    /**
+     * Convert to CSS rgba string
+     * 转换为 CSS rgba 字符串
+     */
+    toRgba(): string;
+    /**
+     * Convert to CSS rgb string
+     * 转换为 CSS rgb 字符串
+     */
+    toRgb(): string;
+    /**
+     * Convert to HSL
+     * 转换为 HSL
+     */
+    toHSL(): HSL;
+    /**
+     * Pack to uint32 (0xRRGGBB)
+     * 打包为 uint32 (0xRRGGBB)
+     */
+    toUint32(): number;
+    /**
+     * Pack to uint32 with alpha (0xAARRGGBB)
+     * 打包为带透明度的 uint32 (0xAARRGGBB)
+     */
+    toUint32Alpha(): number;
+    /**
+     * Pack to WebGL uint32 (0xAABBGGRR)
+     * 打包为 WebGL 格式 uint32 (0xAABBGGRR)
+     */
+    toWebGL(): number;
+    /**
+     * Get normalized float array [r, g, b, a] (0-1)
+     * 获取归一化浮点数组 [r, g, b, a] (0-1)
+     */
+    toFloatArray(): [number, number, number, number];
+    /**
+     * Clone this color
+     * 克隆此颜色
+     */
+    clone(): Color;
+    /**
+     * Set color values
+     * 设置颜色值
+     */
+    set(r: number, g: number, b: number, a?: number): this;
+    /**
+     * Copy from another color
+     * 从另一个颜色复制
+     */
+    copy(other: Color): this;
+    /**
+     * Check equality with another color
+     * 检查与另一个颜色是否相等
+     */
+    equals(other: Color): boolean;
+    /**
+     * String representation
+     * 字符串表示
+     */
+    toString(): string;
+}
+//# sourceMappingURL=Color.d.ts.map

package/bin/Color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Color.d.ts","sourceRoot":"","sources":["../src/Color.ts"],"names":[],"mappings":"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"}