@cos-design/weather-background 3.5.3 → 3.5.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -0,0 +1,68 @@
1
+ export declare const REFERENCE_WIND_KMH = 16;
2
+ export declare const DEFAULT_WIND_LEVEL = 3;
3
+ export declare const clampWindLevel: (level: number) => number;
4
+ /** 展示风级 → 视觉风级(整体降两档:3 级≈原 1 级,5 级≈原 3 级) */
5
+ export declare const visualWindLevel: (level: number) => number;
6
+ export interface WindMotion {
7
+ /** 等效风速 km/h */
8
+ speedKmh: number;
9
+ /** 蒲福风级 0~12(展示/实况) */
10
+ level: number;
11
+ /** 用于渲染的视觉风级(比 level 低两档) */
12
+ visualLevel: number;
13
+ /** 相对三级风的强度比 */
14
+ scale: number;
15
+ /** 云层漂移倍率 */
16
+ cloud: number;
17
+ /** 雨/毛毛雨水平风分量倍率(作用于 cfg.rain.wind) */
18
+ rain: number;
19
+ /** 雪花水平飘移 px/帧(负值=向左,与雨丝一致) */
20
+ snowDrift: number;
21
+ /** 冰雹侧向 gust 倍率 */
22
+ hail: number;
23
+ /** 雾团漂移倍率 */
24
+ fog: number;
25
+ /** 风条速度倍率 */
26
+ streak: number;
27
+ /** 风条可见度 0~1(风级越高越明显) */
28
+ streakVisibility: number;
29
+ /** 阵风起伏幅度 0~1(风级越高越剧烈) */
30
+ gustiness: number;
31
+ /** 风向扰动幅度(弧度) */
32
+ wander: number;
33
+ }
34
+ /** 瞬时风场:阵风强度 + 方向扰动 */
35
+ export interface WindFieldSample {
36
+ /** 相对基准的瞬时强度,约 0.15~2.2 */
37
+ intensity: number;
38
+ /** 相对水平的偏角(弧度),正=偏下 */
39
+ angle: number;
40
+ /** 单位方向 x(主风向约定为向右 +1 附近) */
41
+ ux: number;
42
+ /** 单位方向 y */
43
+ uy: number;
44
+ }
45
+ /**
46
+ * 采样自然风场:多层正弦叠加阵风/静歇,并带空间相位差。
47
+ * `t` 为场景帧计数;`x/y` 用于让画面不同位置不同步。
48
+ */
49
+ export declare const sampleWindField: (t: number, motion: Pick<WindMotion, "gustiness" | "wander">, x?: number, y?: number) => WindFieldSample;
50
+ /** 按风级生成风条数量与透明度(全天气场景通用) */
51
+ export declare const windStreakSpec: (level: number) => {
52
+ count: number;
53
+ alphaMul: number;
54
+ };
55
+ /** 风级 → 典型 km/h */
56
+ export declare const windLevelToKmh: (level: number) => number;
57
+ /** km/h → 蒲福风级 */
58
+ export declare const kmhToWindLevel: (kmh: number) => number;
59
+ /**
60
+ * 根据风速构建运动参数。
61
+ * 展示风级比视觉风级高两档;三级风视觉上接近原先一级风感。
62
+ */
63
+ export declare const buildWindMotion: (speedKmh: number) => WindMotion;
64
+ export declare const resolveWindKmh: (options: {
65
+ live: boolean;
66
+ windLevel: number;
67
+ liveWindKmh?: number | null;
68
+ }) => number;
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@cos-design/weather-background",
3
- "version": "3.5.3",
3
+ "version": "3.5.5",
4
4
  "description": "WeatherBackground component from cos-design",
5
5
  "type": "module",
6
6
  "main": "./dist/index.cjs",
@@ -52,6 +52,6 @@
52
52
  "registry": "https://registry.npmjs.org"
53
53
  },
54
54
  "dependencies": {
55
- "@cos-design/shared": "3.5.3"
55
+ "@cos-design/shared": "3.5.6"
56
56
  }
57
57
  }