@bendyline/molen-ambient 0.0.11 → 0.0.13

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.
package/dist/client.d.mts CHANGED
@@ -1,9 +1,9 @@
1
- import { p as WildlifeSpecies, r as WildlifeAgent } from "./wildlife-B4EL0z-N.mjs";
1
+ import { p as WildlifeSpecies, r as WildlifeAgent } from "./wildlife-CvHzzI9m.mjs";
2
2
  import { World } from "@bendyline/molen-kernel/world";
3
3
  import { AircraftSpec, VehicleData } from "@bendyline/molen-schema";
4
4
  import * as THREE from "three";
5
5
  import { FigureData } from "@bendyline/molen-figures/client";
6
- import { RenderableKind } from "@bendyline/molen-client";
6
+ import { RenderableKind, SceneAdmission } from "@bendyline/molen-client";
7
7
 
8
8
  //#region src/client/aircraft.d.ts
9
9
  interface AmbientAircraftModels {
@@ -45,7 +45,7 @@ declare class ProxyBatches {
45
45
  private readonly position;
46
46
  private readonly quaternion;
47
47
  private readonly scale;
48
- constructor(prepare?: ((object: THREE.Object3D) => void) | undefined, initialCapacity?: number);
48
+ constructor(prepare?: ((object: THREE.Object3D) => Promise<void> | void) | undefined, initialCapacity?: number);
49
49
  /** Start a frame: keep the anchor within a few hundred metres of the camera. */
50
50
  begin(camera: readonly [number, number, number]): void;
51
51
  add(instance: ProxyInstance): void;
@@ -61,7 +61,7 @@ declare class ProxyBatches {
61
61
  /** Where full vehicle models come from (absent: every car stays a proxy). */
62
62
  interface AmbientVehicleModels {
63
63
  /** A fresh model instance for a type, or undefined when the type has no model. */
64
- load(type: string): Promise<THREE.Object3D | undefined>;
64
+ load(type: string, signal?: AbortSignal): Promise<THREE.Object3D | undefined>;
65
65
  /** The vehicle data (wheel nodes, paint material, spec) of a type, if it is a vehicle type. */
66
66
  vehicle(type: string): VehicleData | undefined;
67
67
  }
@@ -119,7 +119,9 @@ declare class AmbientFigures {
119
119
  private budget;
120
120
  private cursor;
121
121
  private frame;
122
- constructor(prepare?: ((object: THREE.Object3D) => void) | undefined);
122
+ /** New bodies whose shaders are still being built; they stay hidden until then. */
123
+ private readonly preparing;
124
+ constructor(prepare?: ((object: THREE.Object3D) => Promise<void> | void) | undefined);
123
125
  setBudget(budget: Partial<FigureBudget>): void;
124
126
  get count(): number;
125
127
  private tierFor;
@@ -146,6 +148,12 @@ interface AmbientRenderBudget {
146
148
  detailedCars: number;
147
149
  /** Full vessel models at most (default 4). */
148
150
  detailedBoats?: number;
151
+ /** Idle detailed instances per pool (default 4); active instances have separate caps. */
152
+ idleVehicleModels?: number;
153
+ /** Estimated geometry/texture bytes per detail pool, including active and idle (default 32 MiB). */
154
+ vehicleModelBytes?: number;
155
+ /** Concurrent detailed model loads per pool (default 2). */
156
+ vehicleLoads?: number;
149
157
  /** Animated (skinned) pedestrians at most. */
150
158
  skinnedFigures: number;
151
159
  /** Pedestrians beyond this distance (m) are not drawn. */
@@ -159,6 +167,8 @@ interface AmbientRendererOptions {
159
167
  parent: THREE.Object3D;
160
168
  /** Shader warm-up for new objects (e.g. `renderer.prepareObject`). */
161
169
  prepare?: (object: THREE.Object3D) => Promise<void> | void;
170
+ /** Main-thread admission (e.g. `renderer.admission`) for building aircraft models. */
171
+ admission?: SceneAdmission;
162
172
  /** Full vehicle models for nearby cars (absent: proxies only). */
163
173
  vehicles?: AmbientVehicleModels;
164
174
  /** Aircraft models (absent: proxies only). */