usePrimitiveScope

将 PrimitiveCollection 的增删操作限定在组件生命周期内：组件卸载时，自动移除所有通过 add 添加的图元。图元直接参与场景渲染，残留会造成重复绘制与 GPU 资源泄漏，因此移除时图元默认被销毁（PrimitiveCollection 默认 destroyPrimitives: true）；collection 支持传 'ground' 改用 viewer.scene.groundPrimitives，常见图元加载请优先使用 usePrimitive。

WARNING

这是一个底层辅助函数，用于自定义集合管理（@vesium/plot 内部即如此使用）。除非你需要自定义集合管理逻辑，否则优先使用高层 API（如 usePrimitive）。

Usage

import { Primitive } from 'cesium';
import { usePrimitiveScope } from 'vesium';

// collection: 'ground' 改用 viewer.scene.groundPrimitives
const { add } = usePrimitiveScope({ collection: 'ground' });
const primitive = add(new Primitive({ geometryInstances: [] }));
// 组件卸载时自动移除并销毁

返回值

• add(instance, ...args) - 添加图元，多余参数透传给 PrimitiveCollection.add(instance, index)；支持 Promise；集合不可用时抛出 collection is not defined
• remove(instance) - 移除图元；Cesium 的 remove 默认销毁实例，destroyOnRemove 只控制 hook 是否额外调用 destroy()
• scope - 已添加图元的只读响应式 Set

注意事项

• 目标集合默认 useViewer().value.scene.primitives；collection: 'ground' 切换到 viewer.scene.groundPrimitives（用于 GroundPrimitive）。
• PrimitiveCollection.remove 默认销毁图元（destroyPrimitives: true），destroyOnRemove 无法阻止；移除后实例不可复用，需要再次显示请创建新实例。

Type Definitions

import type { GroundPrimitive, Primitive, PrimitiveCollection } from 'cesium';
import type { MaybeRefOrGetter } from 'vue';
export interface UsePrimitiveScopeOptions {
    /**
     * The collection of Primitive to be added,
     * 'ground' alias `useViewer().value.scene.groundPrimitives`
     * @default useViewer().value.scene.primitives
     */
    collection?: MaybeRefOrGetter<PrimitiveCollection | 'ground' | undefined>;
    /**
     * Whether to destroy the primitive when removed from the collection.
     * When true, the primitive's GPU resources will be released.
     * @default true
     */
    destroyOnRemove?: boolean;
}
/**
 * Make `add` and `remove` operations of `PrimitiveCollection` scoped,
 * automatically remove `Primitive` instance when component is unmounted.
 */
export declare function usePrimitiveScope(options?: UsePrimitiveScopeOptions): {
    scope: Readonly<import("vue").ShallowReactive<Set<Primitive | GroundPrimitive>>>;
    add: <R extends Primitive | GroundPrimitive | Promise<Primitive | GroundPrimitive>>(instance: R, ...args: any[]) => R extends Promise<infer U> ? Promise<U> : Primitive | GroundPrimitive;
    remove: (instance: Primitive | GroundPrimitive) => any;
    removeWhere: (predicate: import("..").EffcetRemovePredicate<Primitive | GroundPrimitive>) => void;
    removeScope: () => void;
};