@zephyr3d/scene 0.6.1 → 0.7.0

package/dist/render/lightpass.js.map

@@ -1 +1 @@
-{"version":3,"file":"lightpass.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"lightpass.js","sources":["../../src/render/lightpass.ts"],"sourcesContent":["import { RenderPass } from './renderpass';\r\nimport { MaterialVaryingFlags, QUEUE_OPAQUE, QUEUE_TRANSPARENT, RENDER_PASS_TYPE_LIGHT } from '../values';\r\nimport { Vector4 } from '@zephyr3d/base';\r\nimport type { RenderItemListBundle, RenderQueue } from './render_queue';\r\nimport type { PunctualLight } from '../scene/light';\r\nimport type { DrawContext } from './drawable';\r\nimport { ShaderHelper } from '../material/shader/helper';\r\nimport { PostEffectLayer } from '../posteffect/posteffect';\r\n\r\n/**\r\n * Forward render pass\r\n * @internal\r\n */\r\nexport class LightPass extends RenderPass {\r\n  /** @internal */\r\n  protected _shadowMapHash: string;\r\n  /** @internal */\r\n  protected _transmission: boolean;\r\n  /**\r\n   * Creates an instance of ForwardRenderPass\r\n   */\r\n  constructor() {\r\n    super(RENDER_PASS_TYPE_LIGHT);\r\n    this._shadowMapHash = null;\r\n    this._clearColor = Vector4.zero();\r\n  }\r\n  /** @internal */\r\n  get transmission(): boolean {\r\n    return this._transmission;\r\n  }\r\n  set transmission(val: boolean) {\r\n    this._transmission = val;\r\n  }\r\n  /** @internal */\r\n  protected _getGlobalBindGroupHash(ctx: DrawContext) {\r\n    return `${this._shadowMapHash}:${ctx.oit?.calculateHash() ?? ''}:${ctx.env.getHash(ctx)}:${\r\n      ctx.materialFlags\r\n    }:${ctx.linearDepthTexture?.uid ?? 0}:${ctx.sceneColorTexture?.uid ?? 0}:${ctx.HiZTexture?.uid ?? 0}`;\r\n  }\r\n  /** @internal */\r\n  protected renderLightPass(\r\n    ctx: DrawContext,\r\n    itemList: RenderItemListBundle,\r\n    lights: PunctualLight[],\r\n    flags: any\r\n  ) {\r\n    const baseLightPass = !ctx.lightBlending;\r\n    ctx.drawEnvLight =\r\n      baseLightPass &&\r\n      ctx.env.light.type !== 'none' &&\r\n      (ctx.env.light.envLight.hasRadiance() || ctx.env.light.envLight.hasIrradiance());\r\n    ctx.renderPassHash = this.getGlobalBindGroupHash(ctx);\r\n    const bindGroup = ctx.globalBindGroupAllocator.getGlobalBindGroup(ctx);\r\n    if (!flags.cameraSet[ctx.renderPassHash]) {\r\n      ShaderHelper.setCameraUniforms(bindGroup, ctx, !!ctx.device.getFramebuffer());\r\n      flags.cameraSet[ctx.renderPassHash] = 1;\r\n    }\r\n    if (ctx.currentShadowLight) {\r\n      ShaderHelper.setLightUniformsShadow(bindGroup, ctx, lights[0]);\r\n    } else {\r\n      if (!flags.lightSet[ctx.renderPassHash]) {\r\n        ShaderHelper.setLightUniforms(\r\n          bindGroup,\r\n          ctx,\r\n          ctx.clusteredLight.clusterParam,\r\n          ctx.clusteredLight.countParam,\r\n          ctx.clusteredLight.lightBuffer,\r\n          ctx.clusteredLight.lightIndexTexture\r\n        );\r\n        flags.lightSet[ctx.renderPassHash] = 1;\r\n      }\r\n    }\r\n    if (ctx.materialFlags & MaterialVaryingFlags.APPLY_FOG && !flags.fogSet[ctx.renderPassHash]) {\r\n      ShaderHelper.setFogUniforms(\r\n        bindGroup,\r\n        ctx.env.sky.skyType === 'scatter' ? 1 : 0,\r\n        ctx.env.sky.mappedFogType,\r\n        baseLightPass ? 0 : 1,\r\n        ctx.env.sky.atmosphereParams,\r\n        ctx.env.sky.heightFogParams,\r\n        ctx.env.sky.getAerialPerspectiveLUT(ctx),\r\n        ctx.env.sky.getSkyDistantLightLUT(ctx)\r\n      );\r\n      flags.fogSet[ctx.renderPassHash] = 1;\r\n    }\r\n    ctx.device.setBindGroup(0, bindGroup);\r\n    const reverseWinding = ctx.camera.worldMatrixDet < 0;\r\n    for (const lit of itemList.lit) {\r\n      this.drawItemList(lit, ctx, reverseWinding);\r\n    }\r\n    if (!ctx.lightBlending) {\r\n      for (const unlit of itemList.unlit) {\r\n        this.drawItemList(unlit, ctx, reverseWinding);\r\n      }\r\n    }\r\n  }\r\n  /** @internal */\r\n  protected renderItems(ctx: DrawContext, renderQueue: RenderQueue) {\r\n    ctx.fogFlags = 0;\r\n    ctx.renderPassHash = null;\r\n    ctx.env = ctx.scene.env;\r\n    ctx.drawEnvLight = false;\r\n    ctx.flip = this.isAutoFlip(ctx);\r\n    const ssr = !!(ctx.materialFlags & MaterialVaryingFlags.SSR_STORE_ROUGHNESS);\r\n    const tmpFramebuffer = ssr\r\n      ? ctx.device.pool.fetchTemporalFramebuffer(\r\n          false,\r\n          ctx.device.getDrawingBufferWidth(),\r\n          ctx.device.getDrawingBufferHeight(),\r\n          ctx.device.getFramebuffer().getColorAttachments()[0],\r\n          ctx.device.getFramebuffer().getDepthAttachment()\r\n        )\r\n      : null;\r\n    const oit =\r\n      renderQueue.drawTransparent &&\r\n      ctx.primaryCamera.oit &&\r\n      ctx.primaryCamera.oit.supportDevice(ctx.device.type)\r\n        ? ctx.primaryCamera.oit\r\n        : null;\r\n    if (!oit && renderQueue.drawTransparent) {\r\n      renderQueue.sortTransparentItems(ctx.primaryCamera.getWorldPosition());\r\n    }\r\n    const flags: any = {\r\n      lightSet: {},\r\n      cameraSet: {},\r\n      fogSet: {}\r\n    };\r\n    const items = renderQueue.itemList;\r\n    const lists = this._transmission\r\n      ? [items?.transmission, items?.transmission_trans, items?.transparent]\r\n      : [items?.opaque, items?.transparent];\r\n    const transparentPass = lists.length - 1;\r\n    for (let i = 0; i < lists.length; i++) {\r\n      if (lists[i]) {\r\n        ctx.queue = i === 0 ? QUEUE_OPAQUE : QUEUE_TRANSPARENT;\r\n        ctx.oit = i === 0 || !items ? null : oit;\r\n        if ((ctx.queue === QUEUE_TRANSPARENT || this._transmission) && ctx.scene.env.sky.fogPresents) {\r\n          ctx.materialFlags |= MaterialVaryingFlags.APPLY_FOG;\r\n        }\r\n        const numOitPasses = ctx.oit ? ctx.oit.begin(ctx) : 1;\r\n        for (let p = 0; p < numOitPasses; p++) {\r\n          if (ctx.oit) {\r\n            if (!ctx.oit.beginPass(ctx, p)) {\r\n              continue;\r\n            }\r\n          }\r\n          let lightIndex = 0;\r\n          if (ctx.shadowMapInfo) {\r\n            for (const k of ctx.shadowMapInfo.keys()) {\r\n              ctx.currentShadowLight = k;\r\n              ctx.lightBlending = lightIndex > 0;\r\n              this._shadowMapHash = ctx.shadowMapInfo.get(k).shaderHash;\r\n              this.renderLightPass(ctx, lists[i], [k], flags);\r\n              lightIndex++;\r\n            }\r\n          }\r\n          if (lightIndex === 0 || renderQueue.unshadowedLights.length > 0) {\r\n            ctx.currentShadowLight = null;\r\n            ctx.lightBlending = lightIndex > 0;\r\n            this._shadowMapHash = '';\r\n            if (ctx.lightBlending && tmpFramebuffer) {\r\n              ctx.materialFlags &= ~MaterialVaryingFlags.SSR_STORE_ROUGHNESS;\r\n              ctx.device.pushDeviceStates();\r\n              ctx.device.setFramebuffer(tmpFramebuffer);\r\n            }\r\n            this.renderLightPass(ctx, lists[i], renderQueue.unshadowedLights, flags);\r\n            if (ctx.lightBlending && tmpFramebuffer) {\r\n              ctx.materialFlags |= MaterialVaryingFlags.SSR_STORE_ROUGHNESS;\r\n              ctx.device.popDeviceStates();\r\n            }\r\n          }\r\n          if (ctx.oit) {\r\n            ctx.oit.endPass(ctx, p);\r\n          }\r\n        }\r\n        if (ctx.oit) {\r\n          ctx.oit.end(ctx);\r\n        }\r\n        ctx.materialFlags &= ~MaterialVaryingFlags.APPLY_FOG;\r\n      }\r\n      if (i === 0 && !ctx.sceneColorTexture) {\r\n        if (tmpFramebuffer) {\r\n          ctx.device.pushDeviceStates();\r\n          ctx.device.setFramebuffer(tmpFramebuffer);\r\n        }\r\n        ctx.env.sky.skyWorldMatrix = ctx.scene.rootNode.worldMatrix;\r\n        ctx.env.sky.renderSky(ctx);\r\n        if (ctx.env.sky.fogPresents) {\r\n          ctx.env.sky.renderFog(ctx.camera);\r\n        }\r\n        if (tmpFramebuffer) {\r\n          ctx.device.popDeviceStates();\r\n        }\r\n      }\r\n      if (!renderQueue.needSceneColor() || ctx.sceneColorTexture) {\r\n        if (i === 0 || i === transparentPass) {\r\n          ctx.compositor?.drawPostEffects(\r\n            ctx,\r\n            i === 0 ? PostEffectLayer.opaque : PostEffectLayer.transparent,\r\n            ctx.linearDepthTexture\r\n          );\r\n        }\r\n      }\r\n    }\r\n    if (tmpFramebuffer) {\r\n      ctx.device.pool.releaseFrameBuffer(tmpFramebuffer);\r\n    }\r\n  }\r\n}\r\n"],"names":["LightPass","RenderPass","RENDER_PASS_TYPE_LIGHT","_shadowMapHash","_clearColor","Vector4","zero","transmission","_transmission","val","_getGlobalBindGroupHash","ctx","oit","calculateHash","env","getHash","materialFlags","linearDepthTexture","uid","sceneColorTexture","HiZTexture","renderLightPass","itemList","lights","flags","baseLightPass","lightBlending","drawEnvLight","light","type","envLight","hasRadiance","hasIrradiance","renderPassHash","getGlobalBindGroupHash","bindGroup","globalBindGroupAllocator","getGlobalBindGroup","cameraSet","ShaderHelper","setCameraUniforms","device","getFramebuffer","currentShadowLight","setLightUniformsShadow","lightSet","setLightUniforms","clusteredLight","clusterParam","countParam","lightBuffer","lightIndexTexture","MaterialVaryingFlags","APPLY_FOG","fogSet","setFogUniforms","sky","skyType","mappedFogType","atmosphereParams","heightFogParams","getAerialPerspectiveLUT","getSkyDistantLightLUT","setBindGroup","reverseWinding","camera","worldMatrixDet","lit","drawItemList","unlit","renderItems","renderQueue","fogFlags","scene","flip","isAutoFlip","ssr","SSR_STORE_ROUGHNESS","tmpFramebuffer","pool","fetchTemporalFramebuffer","getDrawingBufferWidth","getDrawingBufferHeight","getColorAttachments","getDepthAttachment","drawTransparent","primaryCamera","supportDevice","sortTransparentItems","getWorldPosition","items","lists","transmission_trans","transparent","opaque","transparentPass","length","i","queue","QUEUE_OPAQUE","QUEUE_TRANSPARENT","fogPresents","numOitPasses","begin","p","beginPass","lightIndex","shadowMapInfo","k","keys","get","shaderHash","unshadowedLights","pushDeviceStates","setFramebuffer","popDeviceStates","endPass","end","skyWorldMatrix","rootNode","worldMatrix","renderSky","renderFog","needSceneColor","compositor","drawPostEffects","PostEffectLayer","releaseFrameBuffer"],"mappings":";;;;;;AASA;;;IAIO,MAAMA,SAAkBC,SAAAA,UAAAA,CAAAA;qBAE7B,cAAiC;qBAEjC,aAAiC;AACjC;;AAEC,MACD,WAAc,EAAA;AACZ,QAAA,KAAK,CAACC,sBAAAA,CAAAA;QACN,IAAI,CAACC,cAAc,GAAG,IAAA;AACtB,QAAA,IAAI,CAACC,WAAW,GAAGC,OAAAA,CAAQC,IAAI,EAAA;AACjC;qBAEA,IAAIC,YAAwB,GAAA;QAC1B,OAAO,IAAI,CAACC,aAAa;AAC3B;IACA,IAAID,YAAAA,CAAaE,GAAY,EAAE;QAC7B,IAAI,CAACD,aAAa,GAAGC,GAAAA;AACvB;AACA,qBACUC,uBAAwBC,CAAAA,GAAgB,EAAE;QAClD,OAAO,CAAA,EAAG,IAAI,CAACR,cAAc,CAAC,CAAC,EAAEQ,IAAIC,GAAG,EAAEC,mBAAmB,EAAG,CAAA,CAAC,EAAEF,GAAIG,CAAAA,GAAG,CAACC,OAAO,CAACJ,KAAK,CAAC,EACvFA,IAAIK,aAAa,CAClB,CAAC,EAAEL,GAAAA,CAAIM,kBAAkB,EAAEC,GAAAA,IAAO,EAAE,CAAC,EAAEP,IAAIQ,iBAAiB,EAAED,OAAO,CAAE,CAAA,CAAC,EAAEP,GAAIS,CAAAA,UAAU,EAAEF,GAAAA,IAAO,CAAG,CAAA,CAAA;AACvG;qBAEA,eAAUG,CACRV,GAAgB,EAChBW,QAA8B,EAC9BC,MAAuB,EACvBC,KAAU,EACV;QACA,MAAMC,aAAAA,GAAgB,CAACd,GAAAA,CAAIe,aAAa;AACxCf,QAAAA,GAAAA,CAAIgB,YAAY,GACdF,aACAd,IAAAA,GAAAA,CAAIG,GAAG,CAACc,KAAK,CAACC,IAAI,KAAK,MACtBlB,KAAAA,GAAIG,CAAAA,GAAG,CAACc,KAAK,CAACE,QAAQ,CAACC,WAAW,EAAMpB,IAAAA,GAAAA,CAAIG,GAAG,CAACc,KAAK,CAACE,QAAQ,CAACE,aAAa,EAAC,CAAA;AAChFrB,QAAAA,GAAAA,CAAIsB,cAAc,GAAG,IAAI,CAACC,sBAAsB,CAACvB,GAAAA,CAAAA;AACjD,QAAA,MAAMwB,SAAYxB,GAAAA,GAAAA,CAAIyB,wBAAwB,CAACC,kBAAkB,CAAC1B,GAAAA,CAAAA;AAClE,QAAA,IAAI,CAACa,KAAMc,CAAAA,SAAS,CAAC3B,GAAIsB,CAAAA,cAAc,CAAC,EAAE;YACxCM,YAAaC,CAAAA,iBAAiB,CAACL,SAAWxB,EAAAA,GAAAA,EAAK,CAAC,CAACA,GAAAA,CAAI8B,MAAM,CAACC,cAAc,EAAA,CAAA;AAC1ElB,YAAAA,KAAAA,CAAMc,SAAS,CAAC3B,GAAIsB,CAAAA,cAAc,CAAC,GAAG,CAAA;AACxC;QACA,IAAItB,GAAAA,CAAIgC,kBAAkB,EAAE;AAC1BJ,YAAAA,YAAAA,CAAaK,sBAAsB,CAACT,SAAAA,EAAWxB,GAAKY,EAAAA,MAAM,CAAC,CAAE,CAAA,CAAA;SACxD,MAAA;AACL,YAAA,IAAI,CAACC,KAAMqB,CAAAA,QAAQ,CAAClC,GAAIsB,CAAAA,cAAc,CAAC,EAAE;gBACvCM,YAAaO,CAAAA,gBAAgB,CAC3BX,SACAxB,EAAAA,GAAAA,EACAA,IAAIoC,cAAc,CAACC,YAAY,EAC/BrC,GAAIoC,CAAAA,cAAc,CAACE,UAAU,EAC7BtC,IAAIoC,cAAc,CAACG,WAAW,EAC9BvC,GAAAA,CAAIoC,cAAc,CAACI,iBAAiB,CAAA;AAEtC3B,gBAAAA,KAAAA,CAAMqB,QAAQ,CAAClC,GAAIsB,CAAAA,cAAc,CAAC,GAAG,CAAA;AACvC;AACF;AACA,QAAA,IAAItB,GAAIK,CAAAA,aAAa,GAAGoC,oBAAAA,CAAqBC,SAAS,IAAI,CAAC7B,KAAAA,CAAM8B,MAAM,CAAC3C,GAAIsB,CAAAA,cAAc,CAAC,EAAE;YAC3FM,YAAagB,CAAAA,cAAc,CACzBpB,SACAxB,EAAAA,GAAAA,CAAIG,GAAG,CAAC0C,GAAG,CAACC,OAAO,KAAK,SAAA,GAAY,IAAI,CACxC9C,EAAAA,GAAAA,CAAIG,GAAG,CAAC0C,GAAG,CAACE,aAAa,EACzBjC,aAAAA,GAAgB,CAAI,GAAA,CAAA,EACpBd,GAAIG,CAAAA,GAAG,CAAC0C,GAAG,CAACG,gBAAgB,EAC5BhD,GAAIG,CAAAA,GAAG,CAAC0C,GAAG,CAACI,eAAe,EAC3BjD,GAAIG,CAAAA,GAAG,CAAC0C,GAAG,CAACK,uBAAuB,CAAClD,GACpCA,CAAAA,EAAAA,GAAAA,CAAIG,GAAG,CAAC0C,GAAG,CAACM,qBAAqB,CAACnD,GAAAA,CAAAA,CAAAA;AAEpCa,YAAAA,KAAAA,CAAM8B,MAAM,CAAC3C,GAAIsB,CAAAA,cAAc,CAAC,GAAG,CAAA;AACrC;AACAtB,QAAAA,GAAAA,CAAI8B,MAAM,CAACsB,YAAY,CAAC,CAAG5B,EAAAA,SAAAA,CAAAA;AAC3B,QAAA,MAAM6B,cAAiBrD,GAAAA,GAAAA,CAAIsD,MAAM,CAACC,cAAc,GAAG,CAAA;AACnD,QAAA,KAAK,MAAMC,GAAAA,IAAO7C,QAAS6C,CAAAA,GAAG,CAAE;AAC9B,YAAA,IAAI,CAACC,YAAY,CAACD,GAAAA,EAAKxD,GAAKqD,EAAAA,cAAAA,CAAAA;AAC9B;QACA,IAAI,CAACrD,GAAIe,CAAAA,aAAa,EAAE;AACtB,YAAA,KAAK,MAAM2C,KAAAA,IAAS/C,QAAS+C,CAAAA,KAAK,CAAE;AAClC,gBAAA,IAAI,CAACD,YAAY,CAACC,KAAAA,EAAO1D,GAAKqD,EAAAA,cAAAA,CAAAA;AAChC;AACF;AACF;AACA,qBACA,WAAUM,CAAY3D,GAAgB,EAAE4D,WAAwB,EAAE;AAChE5D,QAAAA,GAAAA,CAAI6D,QAAQ,GAAG,CAAA;AACf7D,QAAAA,GAAAA,CAAIsB,cAAc,GAAG,IAAA;AACrBtB,QAAAA,GAAAA,CAAIG,GAAG,GAAGH,GAAI8D,CAAAA,KAAK,CAAC3D,GAAG;AACvBH,QAAAA,GAAAA,CAAIgB,YAAY,GAAG,KAAA;AACnBhB,QAAAA,GAAAA,CAAI+D,IAAI,GAAG,IAAI,CAACC,UAAU,CAAChE,GAAAA,CAAAA;QAC3B,MAAMiE,GAAAA,GAAM,CAAC,EAAEjE,IAAIK,aAAa,GAAGoC,oBAAqByB,CAAAA,mBAAmB,CAAD;AAC1E,QAAA,MAAMC,iBAAiBF,GACnBjE,GAAAA,GAAAA,CAAI8B,MAAM,CAACsC,IAAI,CAACC,wBAAwB,CACtC,KAAA,EACArE,IAAI8B,MAAM,CAACwC,qBAAqB,EAAA,EAChCtE,IAAI8B,MAAM,CAACyC,sBAAsB,EAAA,EACjCvE,IAAI8B,MAAM,CAACC,cAAc,EAAA,CAAGyC,mBAAmB,EAAE,CAAC,CAAE,CAAA,EACpDxE,IAAI8B,MAAM,CAACC,cAAc,EAAA,CAAG0C,kBAAkB,EAEhD,CAAA,GAAA,IAAA;QACJ,MAAMxE,GAAAA,GACJ2D,WAAYc,CAAAA,eAAe,IAC3B1E,GAAAA,CAAI2E,aAAa,CAAC1E,GAAG,IACrBD,GAAAA,CAAI2E,aAAa,CAAC1E,GAAG,CAAC2E,aAAa,CAAC5E,GAAAA,CAAI8B,MAAM,CAACZ,IAAI,CAAA,GAC/ClB,GAAI2E,CAAAA,aAAa,CAAC1E,GAAG,GACrB,IAAA;AACN,QAAA,IAAI,CAACA,GAAAA,IAAO2D,WAAYc,CAAAA,eAAe,EAAE;AACvCd,YAAAA,WAAAA,CAAYiB,oBAAoB,CAAC7E,GAAI2E,CAAAA,aAAa,CAACG,gBAAgB,EAAA,CAAA;AACrE;AACA,QAAA,MAAMjE,KAAa,GAAA;AACjBqB,YAAAA,QAAAA,EAAU,EAAC;AACXP,YAAAA,SAAAA,EAAW,EAAC;AACZgB,YAAAA,MAAAA,EAAQ;AACV,SAAA;QACA,MAAMoC,KAAAA,GAAQnB,YAAYjD,QAAQ;AAClC,QAAA,MAAMqE,KAAQ,GAAA,IAAI,CAACnF,aAAa,GAC5B;YAACkF,KAAOnF,EAAAA,YAAAA;YAAcmF,KAAOE,EAAAA,kBAAAA;YAAoBF,KAAOG,EAAAA;SAAY,GACpE;YAACH,KAAOI,EAAAA,MAAAA;YAAQJ,KAAOG,EAAAA;AAAY,SAAA;QACvC,MAAME,eAAAA,GAAkBJ,KAAMK,CAAAA,MAAM,GAAG,CAAA;AACvC,QAAA,IAAK,IAAIC,CAAI,GAAA,CAAA,EAAGA,IAAIN,KAAMK,CAAAA,MAAM,EAAEC,CAAK,EAAA,CAAA;YACrC,IAAIN,KAAK,CAACM,CAAAA,CAAE,EAAE;AACZtF,gBAAAA,GAAAA,CAAIuF,KAAK,GAAGD,CAAM,KAAA,CAAA,GAAIE,YAAeC,GAAAA,iBAAAA;AACrCzF,gBAAAA,GAAAA,CAAIC,GAAG,GAAGqF,CAAAA,KAAM,CAAK,IAAA,CAACP,QAAQ,IAAO9E,GAAAA,GAAAA;AACrC,gBAAA,IAAI,CAACD,GAAAA,CAAIuF,KAAK,KAAKE,iBAAAA,IAAqB,IAAI,CAAC5F,aAAa,KAAKG,GAAAA,CAAI8D,KAAK,CAAC3D,GAAG,CAAC0C,GAAG,CAAC6C,WAAW,EAAE;oBAC5F1F,GAAIK,CAAAA,aAAa,IAAIoC,oBAAAA,CAAqBC,SAAS;AACrD;gBACA,MAAMiD,YAAAA,GAAe3F,IAAIC,GAAG,GAAGD,IAAIC,GAAG,CAAC2F,KAAK,CAAC5F,GAAO,CAAA,GAAA,CAAA;AACpD,gBAAA,IAAK,IAAI6F,CAAAA,GAAI,CAAGA,EAAAA,CAAAA,GAAIF,cAAcE,CAAK,EAAA,CAAA;oBACrC,IAAI7F,GAAAA,CAAIC,GAAG,EAAE;AACX,wBAAA,IAAI,CAACD,GAAIC,CAAAA,GAAG,CAAC6F,SAAS,CAAC9F,KAAK6F,CAAI,CAAA,EAAA;AAC9B,4BAAA;AACF;AACF;AACA,oBAAA,IAAIE,UAAa,GAAA,CAAA;oBACjB,IAAI/F,GAAAA,CAAIgG,aAAa,EAAE;AACrB,wBAAA,KAAK,MAAMC,CAAKjG,IAAAA,GAAAA,CAAIgG,aAAa,CAACE,IAAI,EAAI,CAAA;AACxClG,4BAAAA,GAAAA,CAAIgC,kBAAkB,GAAGiE,CAAAA;4BACzBjG,GAAIe,CAAAA,aAAa,GAAGgF,UAAa,GAAA,CAAA;4BACjC,IAAI,CAACvG,cAAc,GAAGQ,GAAAA,CAAIgG,aAAa,CAACG,GAAG,CAACF,CAAAA,CAAAA,CAAGG,UAAU;AACzD,4BAAA,IAAI,CAAC1F,eAAe,CAACV,KAAKgF,KAAK,CAACM,EAAE,EAAE;AAACW,gCAAAA;6BAAE,EAAEpF,KAAAA,CAAAA;AACzCkF,4BAAAA,UAAAA,EAAAA;AACF;AACF;AACA,oBAAA,IAAIA,eAAe,CAAKnC,IAAAA,WAAAA,CAAYyC,gBAAgB,CAAChB,MAAM,GAAG,CAAG,EAAA;AAC/DrF,wBAAAA,GAAAA,CAAIgC,kBAAkB,GAAG,IAAA;wBACzBhC,GAAIe,CAAAA,aAAa,GAAGgF,UAAa,GAAA,CAAA;wBACjC,IAAI,CAACvG,cAAc,GAAG,EAAA;wBACtB,IAAIQ,GAAAA,CAAIe,aAAa,IAAIoD,cAAgB,EAAA;AACvCnE,4BAAAA,GAAAA,CAAIK,aAAa,IAAI,CAACoC,oBAAAA,CAAqByB,mBAAmB;4BAC9DlE,GAAI8B,CAAAA,MAAM,CAACwE,gBAAgB,EAAA;4BAC3BtG,GAAI8B,CAAAA,MAAM,CAACyE,cAAc,CAACpC,cAAAA,CAAAA;AAC5B;wBACA,IAAI,CAACzD,eAAe,CAACV,GAAKgF,EAAAA,KAAK,CAACM,CAAE,CAAA,EAAE1B,WAAYyC,CAAAA,gBAAgB,EAAExF,KAAAA,CAAAA;wBAClE,IAAIb,GAAAA,CAAIe,aAAa,IAAIoD,cAAgB,EAAA;4BACvCnE,GAAIK,CAAAA,aAAa,IAAIoC,oBAAAA,CAAqByB,mBAAmB;4BAC7DlE,GAAI8B,CAAAA,MAAM,CAAC0E,eAAe,EAAA;AAC5B;AACF;oBACA,IAAIxG,GAAAA,CAAIC,GAAG,EAAE;AACXD,wBAAAA,GAAAA,CAAIC,GAAG,CAACwG,OAAO,CAACzG,GAAK6F,EAAAA,CAAAA,CAAAA;AACvB;AACF;gBACA,IAAI7F,GAAAA,CAAIC,GAAG,EAAE;oBACXD,GAAIC,CAAAA,GAAG,CAACyG,GAAG,CAAC1G,GAAAA,CAAAA;AACd;AACAA,gBAAAA,GAAAA,CAAIK,aAAa,IAAI,CAACoC,oBAAAA,CAAqBC,SAAS;AACtD;AACA,YAAA,IAAI4C,CAAM,KAAA,CAAA,IAAK,CAACtF,GAAAA,CAAIQ,iBAAiB,EAAE;AACrC,gBAAA,IAAI2D,cAAgB,EAAA;oBAClBnE,GAAI8B,CAAAA,MAAM,CAACwE,gBAAgB,EAAA;oBAC3BtG,GAAI8B,CAAAA,MAAM,CAACyE,cAAc,CAACpC,cAAAA,CAAAA;AAC5B;gBACAnE,GAAIG,CAAAA,GAAG,CAAC0C,GAAG,CAAC8D,cAAc,GAAG3G,GAAAA,CAAI8D,KAAK,CAAC8C,QAAQ,CAACC,WAAW;AAC3D7G,gBAAAA,GAAAA,CAAIG,GAAG,CAAC0C,GAAG,CAACiE,SAAS,CAAC9G,GAAAA,CAAAA;AACtB,gBAAA,IAAIA,IAAIG,GAAG,CAAC0C,GAAG,CAAC6C,WAAW,EAAE;AAC3B1F,oBAAAA,GAAAA,CAAIG,GAAG,CAAC0C,GAAG,CAACkE,SAAS,CAAC/G,IAAIsD,MAAM,CAAA;AAClC;AACA,gBAAA,IAAIa,cAAgB,EAAA;oBAClBnE,GAAI8B,CAAAA,MAAM,CAAC0E,eAAe,EAAA;AAC5B;AACF;AACA,YAAA,IAAI,CAAC5C,WAAYoD,CAAAA,cAAc,EAAMhH,IAAAA,GAAAA,CAAIQ,iBAAiB,EAAE;gBAC1D,IAAI8E,CAAAA,KAAM,CAAKA,IAAAA,CAAAA,KAAMF,eAAiB,EAAA;AACpCpF,oBAAAA,GAAAA,CAAIiH,UAAU,EAAEC,eACdlH,CAAAA,GAAAA,EACAsF,CAAM,KAAA,CAAA,GAAI6B,eAAgBhC,CAAAA,MAAM,GAAGgC,eAAAA,CAAgBjC,WAAW,EAC9DlF,IAAIM,kBAAkB,CAAA;AAE1B;AACF;AACF;AACA,QAAA,IAAI6D,cAAgB,EAAA;AAClBnE,YAAAA,GAAAA,CAAI8B,MAAM,CAACsC,IAAI,CAACgD,kBAAkB,CAACjD,cAAAA,CAAAA;AACrC;AACF;AACF;;;;"}

package/dist/render/objectcolorpass.js

@@ -11,13 +11,13 @@ import { ShaderHelper } from '../material/shader/helper.js';
    */ constructor(){
         super(RENDER_PASS_TYPE_OBJECT_COLOR);
     }
-    /** @internal */ _getGlobalBindGroupHash(ctx) {
-        return 'ocp';
+    /** @internal */ _getGlobalBindGroupHash(_ctx) {
+        return '';
     }
     /** @internal */ renderItems(ctx, renderQueue) {
         const items = renderQueue.itemList;
         if (items) {
-            ctx.applyFog = null;
+            ctx.fogFlags = 0;
             ctx.drawEnvLight = false;
             ctx.env = null;
             ctx.picking = true;
@@ -25,7 +25,7 @@ import { ShaderHelper } from '../material/shader/helper.js';
             ctx.renderPassHash = this.getGlobalBindGroupHash(ctx);
             const bindGroup = ctx.globalBindGroupAllocator.getGlobalBindGroup(ctx);
             ctx.device.setBindGroup(0, bindGroup);
-            ShaderHelper.setCameraUniforms(bindGroup, ctx.camera, ctx.flip, true);
+            ShaderHelper.setCameraUniforms(bindGroup, ctx, true);
             const reverseWinding = ctx.camera.worldMatrixDet < 0;
             for (const list of [
                 items.opaque,

package/dist/render/objectcolorpass.js.map

@@ -1 +1 @@
-{"version":3,"file":"objectcolorpass.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"objectcolorpass.js","sources":["../../src/render/objectcolorpass.ts"],"sourcesContent":["import { RenderPass } from './renderpass';\r\nimport { RENDER_PASS_TYPE_OBJECT_COLOR } from '../values';\r\nimport type { RenderQueue } from './render_queue';\r\nimport type { DrawContext } from './drawable';\r\nimport { ShaderHelper } from '../material/shader/helper';\r\n\r\n/**\r\n * Object color render pass\r\n * @internal\r\n */\r\nexport class ObjectColorPass extends RenderPass {\r\n  /**\r\n   * Creates an instance of ForwardRenderPass\r\n   */\r\n  constructor() {\r\n    super(RENDER_PASS_TYPE_OBJECT_COLOR);\r\n  }\r\n  /** @internal */\r\n  protected _getGlobalBindGroupHash(_ctx: DrawContext) {\r\n    return '';\r\n  }\r\n  /** @internal */\r\n  protected renderItems(ctx: DrawContext, renderQueue: RenderQueue) {\r\n    const items = renderQueue.itemList;\r\n    if (items) {\r\n      ctx.fogFlags = 0;\r\n      ctx.drawEnvLight = false;\r\n      ctx.env = null;\r\n      ctx.picking = true;\r\n      ctx.flip = this.isAutoFlip(ctx);\r\n      ctx.renderPassHash = this.getGlobalBindGroupHash(ctx);\r\n      const bindGroup = ctx.globalBindGroupAllocator.getGlobalBindGroup(ctx);\r\n      ctx.device.setBindGroup(0, bindGroup);\r\n      ShaderHelper.setCameraUniforms(bindGroup, ctx, true);\r\n      const reverseWinding = ctx.camera.worldMatrixDet < 0;\r\n      for (const list of [items.opaque, items.transmission, items.transparent, items.transmission_trans]) {\r\n        if (list) {\r\n          for (const lit of list.lit) {\r\n            this.drawItemList(lit, ctx, reverseWinding);\r\n          }\r\n          for (const unlit of list.unlit) {\r\n            this.drawItemList(unlit, ctx, reverseWinding);\r\n          }\r\n        }\r\n      }\r\n      ctx.picking = false;\r\n    }\r\n  }\r\n}\r\n"],"names":["ObjectColorPass","RenderPass","RENDER_PASS_TYPE_OBJECT_COLOR","_getGlobalBindGroupHash","_ctx","renderItems","ctx","renderQueue","items","itemList","fogFlags","drawEnvLight","env","picking","flip","isAutoFlip","renderPassHash","getGlobalBindGroupHash","bindGroup","globalBindGroupAllocator","getGlobalBindGroup","device","setBindGroup","ShaderHelper","setCameraUniforms","reverseWinding","camera","worldMatrixDet","list","opaque","transmission","transparent","transmission_trans","lit","drawItemList","unlit"],"mappings":";;;;AAMA;;;IAIO,MAAMA,eAAwBC,SAAAA,UAAAA,CAAAA;AACnC;;AAEC,MACD,WAAc,EAAA;AACZ,QAAA,KAAK,CAACC,6BAAAA,CAAAA;AACR;AACA,qBACUC,uBAAwBC,CAAAA,IAAiB,EAAE;QACnD,OAAO,EAAA;AACT;AACA,qBACA,WAAUC,CAAYC,GAAgB,EAAEC,WAAwB,EAAE;QAChE,MAAMC,KAAAA,GAAQD,YAAYE,QAAQ;AAClC,QAAA,IAAID,KAAO,EAAA;AACTF,YAAAA,GAAAA,CAAII,QAAQ,GAAG,CAAA;AACfJ,YAAAA,GAAAA,CAAIK,YAAY,GAAG,KAAA;AACnBL,YAAAA,GAAAA,CAAIM,GAAG,GAAG,IAAA;AACVN,YAAAA,GAAAA,CAAIO,OAAO,GAAG,IAAA;AACdP,YAAAA,GAAAA,CAAIQ,IAAI,GAAG,IAAI,CAACC,UAAU,CAACT,GAAAA,CAAAA;AAC3BA,YAAAA,GAAAA,CAAIU,cAAc,GAAG,IAAI,CAACC,sBAAsB,CAACX,GAAAA,CAAAA;AACjD,YAAA,MAAMY,SAAYZ,GAAAA,GAAAA,CAAIa,wBAAwB,CAACC,kBAAkB,CAACd,GAAAA,CAAAA;AAClEA,YAAAA,GAAAA,CAAIe,MAAM,CAACC,YAAY,CAAC,CAAGJ,EAAAA,SAAAA,CAAAA;YAC3BK,YAAaC,CAAAA,iBAAiB,CAACN,SAAAA,EAAWZ,GAAK,EAAA,IAAA,CAAA;AAC/C,YAAA,MAAMmB,cAAiBnB,GAAAA,GAAAA,CAAIoB,MAAM,CAACC,cAAc,GAAG,CAAA;AACnD,YAAA,KAAK,MAAMC,IAAQ,IAAA;AAACpB,gBAAAA,KAAAA,CAAMqB,MAAM;AAAErB,gBAAAA,KAAAA,CAAMsB,YAAY;AAAEtB,gBAAAA,KAAAA,CAAMuB,WAAW;AAAEvB,gBAAAA,KAAAA,CAAMwB;aAAmB,CAAE;AAClG,gBAAA,IAAIJ,IAAM,EAAA;AACR,oBAAA,KAAK,MAAMK,GAAAA,IAAOL,IAAKK,CAAAA,GAAG,CAAE;AAC1B,wBAAA,IAAI,CAACC,YAAY,CAACD,GAAAA,EAAK3B,GAAKmB,EAAAA,cAAAA,CAAAA;AAC9B;AACA,oBAAA,KAAK,MAAMU,KAAAA,IAASP,IAAKO,CAAAA,KAAK,CAAE;AAC9B,wBAAA,IAAI,CAACD,YAAY,CAACC,KAAAA,EAAO7B,GAAKmB,EAAAA,cAAAA,CAAAA;AAChC;AACF;AACF;AACAnB,YAAAA,GAAAA,CAAIO,OAAO,GAAG,KAAA;AAChB;AACF;AACF;;;;"}

package/dist/render/primitive.js

@@ -1,24 +1,46 @@
-import { PBPrimitiveType } from '@zephyr3d/device';
-import { Application } from '../app.js';
+import { makeObservable, Disposable, releaseObject, retainObject } from '@zephyr3d/base';
+import { PBPrimitiveType, matchVertexBuffer } from '@zephyr3d/device';
+import { RenderBundleWrapper } from './renderbundle_wrapper.js';
+import { getDevice } from '../app/api.js';
 
 /**
- * Primitive contains only the vertex and index data of a mesh
+ * Holds vertex/index data and draw parameters for a mesh geometry.
+ *
+ * Responsibilities:
+ * - Owns one or more vertex buffers and an optional index buffer.
+ * - Defines primitive topology, draw range (start/count), and vertex layout.
+ * - Provides utilities to create/set/remove buffers and query vertex/face counts.
+ * - Tracks changes via a change tag and notifies render-bundle caching.
+ * - Optionally stores a bounding volume and supports ray intersection tests.
+ *
+ * Ownership and lifecycle:
+ * - When adding buffers (`setVertexBuffer`, `setIndexBuffer`), the primitive retains them.
+ * - When removing/overwriting buffers, the primitive releases the previous buffers.
+ * - Disposing the primitive also disposes the internal `VertexLayout` and releases retained buffers.
+ *
  * @public
- */ class Primitive {
-    /** @internal */ _vertexLayout;
-    /** @internal */ _vertexLayoutOptions;
-    /** @internal */ _primitiveType;
-    /** @internal */ _indexStart;
-    /** @internal */ _indexCount;
-    /** @internal */ _defaultIndexCount;
-    /** @internal */ _vertexLayoutDirty;
-    /** @internal */ static _nextId = 0;
-    /** @internal */ _id;
-    /** @internal */ _bbox;
-    /** @internal */ _bboxChangeCallback;
+ */ class Primitive extends makeObservable(Disposable)() {
+    /** @internal Current vertex layout object (created lazily from options). */ _vertexLayout;
+    /** @internal Mutable options used to build the vertex layout. */ _vertexLayoutOptions;
+    /** @internal Primitive topology (e.g., 'triangle-list', 'line-strip'). */ _primitiveType;
+    /** @internal First index/vertex to draw. */ _indexStart;
+    /** @internal Number of indices/vertices to draw (computed lazily if null). */ _indexCount;
+    /** @internal Cached default index count (derived when needed). */ _defaultIndexCount;
+    /** @internal Marks layout dirty when buffers/topology change. */ _vertexLayoutDirty;
+    /** @internal Monotonic runtime id. */ static _nextId = 0;
+    /** @internal Unique runtime id for the instance. */ _id;
+    /** @internal Optional bounding volume for culling/raycast. */ _bbox;
+    /** @internal Change tag increments when draw-affecting state changes. */ _changeTag;
     /**
-   * Creates an instance of a primitive
+   * Create an empty primitive.
+   *
+   * Defaults:
+   * - Primitive type: 'triangle-list'
+   * - `indexStart = 0`, `indexCount = null` (auto-computed)
+   * - No vertex/index buffers attached
+   * - No bounding volume
    */ constructor(){
+        super();
         this._vertexLayout = null;
         this._vertexLayoutOptions = {
             vertexBuffers: []
@@ -29,61 +51,106 @@ import { Application } from '../app.js';
         this._defaultIndexCount = 0;
         this._vertexLayoutDirty = false;
         this._id = ++Primitive._nextId;
+        this._changeTag = 0;
         this._bbox = null;
-        this._bboxChangeCallback = [];
     }
     /**
-   * Unique identifier of the primitive
+   * Unique runtime identifier of this primitive.
+   *
+   * @returns The numeric instance id.
    * @internal
    */ get id() {
         return this._id;
     }
     /**
-   * Adds a callback function that will be called whenever the bounding box of the primitive changes.
-   * @param cb - The callback function
+   * Change tag that increments whenever draw-affecting state changes.
+   * Useful for invalidating cached render bundles.
    *
-   * @internal
-   */ addBoundingboxChangeCallback(cb) {
-        cb && this._bboxChangeCallback.push(cb);
+   * @returns The current change tag value.
+   */ get changeTag() {
+        return this._changeTag;
+    }
+    /**
+   * Create a shallow clone: copies topology, draw range, and buffers.
+   *
+   * Note: Buffers are re-retained on the new primitive.
+   *
+   * @returns A cloned Primitive instance.
+   */ clone() {
+        const other = new Primitive();
+        other.copyFrom(this);
+        return other;
     }
     /**
-   * Removes a callback function for bounding box changing
-   * @param cb - The callback function to be removed
-   */ removeBoundingboxChangeCallback(cb) {
-        const index = this._bboxChangeCallback.indexOf(cb);
-        if (index >= 0) {
-            this._bboxChangeCallback.splice(index, 1);
+   * Copy from another primitive.
+   *
+   * Copies:
+   * - All vertex buffers and the index buffer
+   * - Primitive type, index start, index count
+   *
+   * @param other - The source primitive to copy from.
+   * @returns void
+   */ copyFrom(other) {
+        for (const info of other._vertexLayoutOptions.vertexBuffers){
+            this.setVertexBuffer(info.buffer, info.stepMode);
         }
+        this.setIndexBuffer(other._vertexLayoutOptions.indexBuffer);
+        this.primitiveType = other.primitiveType;
+        this.indexStart = other.indexStart;
+        this.indexCount = other.indexCount;
     }
-    /** Primitive type */ get primitiveType() {
+    /**
+   * Primitive topology.
+   */ get primitiveType() {
         return this._primitiveType;
     }
     set primitiveType(type) {
-        this._primitiveType = type;
+        if (type !== this._primitiveType) {
+            this._primitiveType = type;
+            this._changeTag++;
+            RenderBundleWrapper.primitiveChanged(this);
+        }
     }
-    /** Start index for drawing */ get indexStart() {
+    /**
+   * Starting index/vertex for drawing.
+   */ get indexStart() {
         return this._indexStart;
     }
     set indexStart(val) {
-        this._indexStart = val;
+        if (val !== this._indexStart) {
+            this._indexStart = val;
+            this._changeTag++;
+            RenderBundleWrapper.primitiveChanged(this);
+        }
     }
-    /** The number of the indices or vertices to be drawn */ get indexCount() {
+    /**
+   * Number of indices/vertices to draw.
+   */ get indexCount() {
         this._indexCount = this._indexCount ?? this.calcDefaultIndexCount();
         return this._indexCount;
     }
     set indexCount(val) {
-        this._indexCount = val;
+        if (val !== this._indexCount) {
+            this._indexCount = val;
+            this._changeTag++;
+            RenderBundleWrapper.primitiveChanged(this);
+        }
     }
     /**
-   * Query total vertex count
-   * @returns Total vertex count, 0 if no position vertex buffer set
+   * Query total vertex count from the position buffer, if present.
+   *
+   * @returns Total vertex count; 0 if no position buffer is set.
    */ getNumVertices() {
         const posInfo = this.getVertexBufferInfo('position');
         return posInfo?.buffer ? posInfo.buffer.byteLength / posInfo.stride >> 0 : 0;
     }
     /**
-   * Query total face count
-   * @returns Total face count
+   * Query total face/segment count based on topology and buffer size.
+   *
+   * - For indexed geometry: derived from index buffer.
+   * - For non-indexed: derived from position vertex count.
+   *
+   * @returns Total primitive count for the current topology.
    */ getNumFaces() {
         const ib = this.getIndexBuffer();
         const count = ib ? ib.byteLength >> (ib.indexType.primitiveType === PBPrimitiveType.U16 ? 1 : 2) : this.getNumVertices();
@@ -105,63 +172,91 @@ import { Application } from '../app.js';
         }
     }
     /**
-   * Removes a vertex buffer from the primitive
-   * @param buffer - The vertex buffer to be removed
-   */ removeVertexBuffer(buffer) {
-        for(let loc = 0; loc < this._vertexLayoutOptions.vertexBuffers.length; loc++){
-            const info = this._vertexLayoutOptions.vertexBuffers[loc];
-            if (info?.buffer === buffer) {
-                info[loc] = null;
+   * Remove all vertex buffers that match a given semantic.
+   *
+   * This releases retained buffers, marks the layout dirty, and invalidates bundles.
+   *
+   * @param semantic - The vertex semantic to remove (e.g., 'position', 'normal').
+   * @returns void
+   */ removeVertexBuffer(semantic) {
+        for(let i = this._vertexLayoutOptions.vertexBuffers.length - 1; i >= 0; i--){
+            const info = this._vertexLayoutOptions.vertexBuffers[i];
+            if (matchVertexBuffer(info.buffer, semantic)) {
+                releaseObject(info.buffer);
+                this._vertexLayoutOptions.vertexBuffers.splice(i, 1);
                 this._vertexLayoutDirty = true;
             }
         }
+        if (this._vertexLayoutDirty) {
+            this._changeTag++;
+            RenderBundleWrapper.primitiveChanged(this);
+        }
     }
     /**
-   * Gets the vertex buffer by a given semantic
-   * @param semantic - The semantic of the vertex buffer
-   * @returns The vertex buffer which semantic matches the given value
+   * Get the vertex buffer that matches a given semantic.
+   *
+   * @param semantic - The vertex semantic to look up.
+   * @returns The matching vertex buffer, or `null` if not found.
    */ getVertexBuffer(semantic) {
-        this.checkVertexLayout();
-        return this._vertexLayout.getVertexBuffer(semantic);
+        for (const info of this._vertexLayoutOptions.vertexBuffers){
+            if (info.buffer && matchVertexBuffer(info.buffer, semantic)) {
+                return info.buffer;
+            }
+        }
+        return null;
     }
     /**
-   * Gets the vertex buffer information by a given semantic
-   * @param semantic - The semantic of the vertex buffer
-   * @returns The vertex buffer information of the given semantic
+   * Get vertex buffer information for a given semantic.
+   *
+   * @param semantic - The vertex semantic to look up.
+   * @returns The `VertexBufferInfo`, or `null` if not found.
    */ getVertexBufferInfo(semantic) {
         this.checkVertexLayout();
-        return this._vertexLayout.getVertexBufferInfo(semantic);
+        return this._vertexLayout?.getVertexBufferInfo(semantic) ?? null;
     }
     /**
-   * Creates a vertex buffer from the given options and then adds it to the primitive
-   * @param format - Vertex format for the vertex buffer
-   * @param data - Contents of the vertex buffer
-   * @param stepMode - Step mode of the vertex buffer
-   * @returns The created vertex buffer
+   * Create a vertex buffer from data and add it to the primitive.
+   *
+   * - For interleaved layouts, pass an array of `VertexAttribFormat`.
+   * - For a single attribute, pass a single `VertexAttribFormat`.
+   *
+   * @param format - Vertex attribute format(s).
+   * @param data - Typed array with vertex data.
+   * @param stepMode - Optional step mode (e.g., 'vertex', 'instance').
+   * @returns The created `StructuredBuffer`.
    */ createAndSetVertexBuffer(format, data, stepMode) {
-        const buffer = Application.instance.device.createVertexBuffer(format, data);
+        const device = getDevice();
+        const buffer = Array.isArray(format) ? device.createInterleavedVertexBuffer(format, data) : device.createVertexBuffer(format, data);
         return this.setVertexBuffer(buffer, stepMode);
     }
     /**
-   * Adds a vertex buffer to the primitive
-   * @param buffer - The vertex buffer to be added
-   * @param stepMode - Step mode of the vertex buffer
-   * @returns The added vertex buffer
+   * Add an existing vertex buffer to the primitive.
+   *
+   * Ownership note: The primitive retains the buffer; it will be released or disposed when replaced or on dispose.
+   *
+   * @param buffer - The vertex buffer to add.
+   * @param stepMode - Optional step mode for the buffer.
+   * @returns The same buffer.
    */ setVertexBuffer(buffer, stepMode) {
+        retainObject(buffer);
         this._vertexLayoutOptions.vertexBuffers.push({
             buffer,
             stepMode
         });
         this._vertexLayoutDirty = true;
+        this._changeTag++;
+        RenderBundleWrapper.primitiveChanged(this);
         return buffer;
     }
     /**
-   * Creates an index buffer from the given options and then adds it to the prmitive
-   * @param data - Contents of the index buffer
-   * @param dynamic - true if the index buffer is dynamic
-   * @returns The created index buffer
+   * Create an index buffer from data and set it on the primitive.
+   *
+   * @param data - Index data as Uint16Array or Uint32Array.
+   * @param dynamic - Whether the index buffer is dynamic (unmanaged).
+   * @returns The created `IndexBuffer`.
    */ createAndSetIndexBuffer(data, dynamic) {
-        const buffer = Application.instance.device.createIndexBuffer(data, {
+        const device = getDevice();
+        const buffer = device.createIndexBuffer(data, {
             dynamic: !!dynamic,
             managed: !dynamic
         });
@@ -169,22 +264,34 @@ import { Application } from '../app.js';
         return buffer;
     }
     /**
-   * Adds an index buffer to the primitive
-   * @param buffer - The index buffer to be added
+   * Set or replace the index buffer.
+   *
+   * Ownership note: The primitive retains the buffer; previous buffer is released.
+   * Marks the vertex layout dirty and invalidates bundles.
+   *
+   * @param buffer - The index buffer to set (non-null).
+   * @returns void
    */ setIndexBuffer(buffer) {
         if (this._vertexLayoutOptions.indexBuffer !== buffer) {
+            retainObject(buffer);
+            releaseObject(this._vertexLayoutOptions.indexBuffer);
             this._vertexLayoutOptions.indexBuffer = buffer;
             this._vertexLayoutDirty = true;
+            this._changeTag++;
+            RenderBundleWrapper.primitiveChanged(this);
         }
     }
     /**
-   * Gets the index buffer of the primitive
-   * @returns The index buffer of the primitive
+   * Get the current index buffer.
+   *
+   * @returns The index buffer, or `undefined`/`null` if none set.
    */ getIndexBuffer() {
         return this._vertexLayoutOptions.indexBuffer;
     }
     /**
-   * Draw the prmitive
+   * Issue a non-instanced draw for the current topology and range.
+   *
+   * Preconditions: A valid vertex layout and `indexCount > 0`.
    */ draw() {
         this.checkVertexLayout();
         if (this.indexCount > 0) {
@@ -192,8 +299,11 @@ import { Application } from '../app.js';
         }
     }
     /**
-   * Draw multiple instances of the primitive
-   * @param numInstances - How many instances of the primitive should be drawn
+   * Issue an instanced draw for the current topology and range.
+   *
+   * Preconditions: A valid vertex layout and `indexCount > 0`.
+   *
+   * @param numInstances - Number of instances to draw.
    */ drawInstanced(numInstances) {
         this.checkVertexLayout();
         if (this.indexCount > 0) {
@@ -201,24 +311,18 @@ import { Application } from '../app.js';
         }
     }
     /**
-   * Disposes the primitive
-   *
-   * @remarks
-   * The vertex buffers and index buffer will also be disposed.
-   * To prevent specific vertex buffer or index buffer to be disposed,
-   * call removeVertexBuffer() or setIndexBuffer(null) first.
-   */ dispose() {
-        if (this._vertexLayout) {
-            const vertexBuffers = this._vertexLayout.vertexBuffers;
-            for(const k in vertexBuffers){
-                vertexBuffers[k]?.buffer?.dispose();
+   * Dispose this primitive and release associated GPU resources.
+   */ onDispose() {
+        super.onDispose();
+        this._vertexLayout?.dispose();
+        this._vertexLayout = null;
+        if (this._vertexLayoutOptions) {
+            releaseObject(this._vertexLayoutOptions.indexBuffer);
+            for (const info of this._vertexLayoutOptions.vertexBuffers){
+                releaseObject(info.buffer);
             }
-            this._vertexLayout.indexBuffer?.dispose();
-            this._vertexLayout.dispose();
-            this._vertexLayout = null;
+            this._vertexLayoutOptions = null;
         }
-        this._indexCount = null;
-        this._indexStart = 0;
     }
     /*
   createAABBTree(): AABBTree {
@@ -229,26 +333,30 @@ import { Application } from '../app.js';
     return aabbtree;
   }
   */ /**
-   * Gets the bounding volume of the primitive
-   * @returns The bounding volume of the primitive, or null if no bounding volume set
+   * Get the bounding volume associated with this primitive.
+   *
+   * @returns The current bounding volume, or `null` if not set.
    */ getBoundingVolume() {
         return this._bbox;
     }
     /**
-   * Sets the bounding volume of the primitive
-   * @param bv - The bounding volume to be set
+   * Set or replace the bounding volume of this primitive.
+   *
+   * Triggers registered bounding-volume change callbacks.
+   *
+   * @param bv - The bounding volume to set.
+   * @returns void
    */ setBoundingVolume(bv) {
         if (bv !== this._bbox) {
             this._bbox = bv;
-            for (const cb of this._bboxChangeCallback){
-                cb();
-            }
+            this.dispatchEvent('bv_changed');
         }
     }
     /**
-   * Ray intersection test
-   * @param ray - Ray object used to do intersection test with this object
-   * @returns The distance from ray origin to the intersection point if ray intersects with this object, otherwise null
+   * Test intersection against the current axis-aligned bounding box (AABB).
+   *
+   * @param ray - Ray to test against the primitive's AABB (derived from its bounding volume).
+   * @returns The distance from ray origin to the intersection, or `null` if no hit or no AABB.
    */ raycast(ray) {
         const aabb = this.getBoundingVolume()?.toAABB();
         return aabb ? ray.bboxIntersectionTestEx(aabb) : null;
@@ -256,7 +364,8 @@ import { Application } from '../app.js';
     /** @internal */ checkVertexLayout() {
         if (this._vertexLayoutDirty) {
             this._vertexLayout?.dispose();
-            this._vertexLayout = Application.instance.device.createVertexLayout(this._vertexLayoutOptions);
+            const device = getDevice();
+            this._vertexLayout = device.createVertexLayout(this._vertexLayoutOptions);
             this._vertexLayoutDirty = false;
         }
     }

package/dist/render/primitive.js.map

@@ -1 +1 @@
-{"version":3,"file":"primitive.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;"}
+{"version":3,"file":"primitive.js","sources":["../../src/render/primitive.ts"],"sourcesContent":["import {\r\n  Disposable,\r\n  makeObservable,\r\n  releaseObject,\r\n  retainObject,\r\n  type Clonable,\r\n  type Ray,\r\n  type TypedArray\r\n} from '@zephyr3d/base';\r\nimport {\r\n  type VertexStepMode,\r\n  type VertexLayout,\r\n  type VertexLayoutOptions,\r\n  type PrimitiveType,\r\n  type StructuredBuffer,\r\n  type IndexBuffer,\r\n  type VertexSemantic,\r\n  type VertexAttribFormat,\r\n  type VertexBufferInfo,\r\n  PBPrimitiveType,\r\n  matchVertexBuffer\r\n} from '@zephyr3d/device';\r\nimport type { BoundingVolume } from '../utility/bounding_volume';\r\nimport { RenderBundleWrapper } from './renderbundle_wrapper';\r\nimport { getDevice } from '../app/api';\r\n\r\n/**\r\n * Holds vertex/index data and draw parameters for a mesh geometry.\r\n *\r\n * Responsibilities:\r\n * - Owns one or more vertex buffers and an optional index buffer.\r\n * - Defines primitive topology, draw range (start/count), and vertex layout.\r\n * - Provides utilities to create/set/remove buffers and query vertex/face counts.\r\n * - Tracks changes via a change tag and notifies render-bundle caching.\r\n * - Optionally stores a bounding volume and supports ray intersection tests.\r\n *\r\n * Ownership and lifecycle:\r\n * - When adding buffers (`setVertexBuffer`, `setIndexBuffer`), the primitive retains them.\r\n * - When removing/overwriting buffers, the primitive releases the previous buffers.\r\n * - Disposing the primitive also disposes the internal `VertexLayout` and releases retained buffers.\r\n *\r\n * @public\r\n */\r\nexport class Primitive\r\n  extends makeObservable(Disposable)<{\r\n    bv_changed: [];\r\n  }>()\r\n  implements Clonable<Primitive>\r\n{\r\n  /** @internal Current vertex layout object (created lazily from options). */\r\n  protected _vertexLayout: VertexLayout;\r\n  /** @internal Mutable options used to build the vertex layout. */\r\n  protected _vertexLayoutOptions: VertexLayoutOptions;\r\n  /** @internal Primitive topology (e.g., 'triangle-list', 'line-strip'). */\r\n  protected _primitiveType: PrimitiveType;\r\n  /** @internal First index/vertex to draw. */\r\n  protected _indexStart: number;\r\n  /** @internal Number of indices/vertices to draw (computed lazily if null). */\r\n  protected _indexCount: number;\r\n  /** @internal Cached default index count (derived when needed). */\r\n  protected _defaultIndexCount: number;\r\n  /** @internal Marks layout dirty when buffers/topology change. */\r\n  protected _vertexLayoutDirty: boolean;\r\n  /** @internal Monotonic runtime id. */\r\n  private static _nextId = 0;\r\n  /** @internal Unique runtime id for the instance. */\r\n  protected _id: number;\r\n  /** @internal Optional bounding volume for culling/raycast. */\r\n  protected _bbox: BoundingVolume;\r\n  /** @internal Change tag increments when draw-affecting state changes. */\r\n  private _changeTag: number;\r\n  /**\r\n   * Create an empty primitive.\r\n   *\r\n   * Defaults:\r\n   * - Primitive type: 'triangle-list'\r\n   * - `indexStart = 0`, `indexCount = null` (auto-computed)\r\n   * - No vertex/index buffers attached\r\n   * - No bounding volume\r\n   */\r\n  constructor() {\r\n    super();\r\n    this._vertexLayout = null;\r\n    this._vertexLayoutOptions = { vertexBuffers: [] };\r\n    this._primitiveType = 'triangle-list';\r\n    this._indexStart = 0;\r\n    this._indexCount = null;\r\n    this._defaultIndexCount = 0;\r\n    this._vertexLayoutDirty = false;\r\n    this._id = ++Primitive._nextId;\r\n    this._changeTag = 0;\r\n    this._bbox = null;\r\n  }\r\n  /**\r\n   * Unique runtime identifier of this primitive.\r\n   *\r\n   * @returns The numeric instance id.\r\n   * @internal\r\n   */\r\n  get id(): number {\r\n    return this._id;\r\n  }\r\n  /**\r\n   * Change tag that increments whenever draw-affecting state changes.\r\n   * Useful for invalidating cached render bundles.\r\n   *\r\n   * @returns The current change tag value.\r\n   */\r\n  get changeTag() {\r\n    return this._changeTag;\r\n  }\r\n  /**\r\n   * Create a shallow clone: copies topology, draw range, and buffers.\r\n   *\r\n   * Note: Buffers are re-retained on the new primitive.\r\n   *\r\n   * @returns A cloned Primitive instance.\r\n   */\r\n  clone(): Primitive {\r\n    const other = new Primitive();\r\n    other.copyFrom(this);\r\n    return other;\r\n  }\r\n  /**\r\n   * Copy from another primitive.\r\n   *\r\n   * Copies:\r\n   * - All vertex buffers and the index buffer\r\n   * - Primitive type, index start, index count\r\n   *\r\n   * @param other - The source primitive to copy from.\r\n   * @returns void\r\n   */\r\n  copyFrom(other: this) {\r\n    for (const info of other._vertexLayoutOptions.vertexBuffers) {\r\n      this.setVertexBuffer(info.buffer, info.stepMode);\r\n    }\r\n    this.setIndexBuffer(other._vertexLayoutOptions.indexBuffer);\r\n    this.primitiveType = other.primitiveType;\r\n    this.indexStart = other.indexStart;\r\n    this.indexCount = other.indexCount;\r\n  }\r\n  /**\r\n   * Primitive topology.\r\n   */\r\n  get primitiveType() {\r\n    return this._primitiveType;\r\n  }\r\n  set primitiveType(type) {\r\n    if (type !== this._primitiveType) {\r\n      this._primitiveType = type;\r\n      this._changeTag++;\r\n      RenderBundleWrapper.primitiveChanged(this);\r\n    }\r\n  }\r\n  /**\r\n   * Starting index/vertex for drawing.\r\n   */\r\n  get indexStart() {\r\n    return this._indexStart;\r\n  }\r\n  set indexStart(val) {\r\n    if (val !== this._indexStart) {\r\n      this._indexStart = val;\r\n      this._changeTag++;\r\n      RenderBundleWrapper.primitiveChanged(this);\r\n    }\r\n  }\r\n  /**\r\n   * Number of indices/vertices to draw.\r\n   */\r\n  get indexCount() {\r\n    this._indexCount = this._indexCount ?? this.calcDefaultIndexCount();\r\n    return this._indexCount;\r\n  }\r\n  set indexCount(val) {\r\n    if (val !== this._indexCount) {\r\n      this._indexCount = val;\r\n      this._changeTag++;\r\n      RenderBundleWrapper.primitiveChanged(this);\r\n    }\r\n  }\r\n  /**\r\n   * Query total vertex count from the position buffer, if present.\r\n   *\r\n   * @returns Total vertex count; 0 if no position buffer is set.\r\n   */\r\n  getNumVertices(): number {\r\n    const posInfo = this.getVertexBufferInfo('position');\r\n    return posInfo?.buffer ? (posInfo.buffer.byteLength / posInfo.stride) >> 0 : 0;\r\n  }\r\n  /**\r\n   * Query total face/segment count based on topology and buffer size.\r\n   *\r\n   * - For indexed geometry: derived from index buffer.\r\n   * - For non-indexed: derived from position vertex count.\r\n   *\r\n   * @returns Total primitive count for the current topology.\r\n   */\r\n  getNumFaces(): number {\r\n    const ib = this.getIndexBuffer();\r\n    const count = ib\r\n      ? ib.byteLength >> (ib.indexType.primitiveType === PBPrimitiveType.U16 ? 1 : 2)\r\n      : this.getNumVertices();\r\n    switch (this.primitiveType) {\r\n      case 'line-list':\r\n        return count >> 1;\r\n      case 'point-list':\r\n        return count;\r\n      case 'line-strip':\r\n        return count - 1;\r\n      case 'triangle-fan':\r\n        return count - 2;\r\n      case 'triangle-strip':\r\n        return count - 2;\r\n      case 'triangle-list':\r\n        return (count / 3) >> 0;\r\n      default:\r\n        return 0;\r\n    }\r\n  }\r\n  /**\r\n   * Remove all vertex buffers that match a given semantic.\r\n   *\r\n   * This releases retained buffers, marks the layout dirty, and invalidates bundles.\r\n   *\r\n   * @param semantic - The vertex semantic to remove (e.g., 'position', 'normal').\r\n   * @returns void\r\n   */\r\n  removeVertexBuffer(semantic: VertexSemantic): void {\r\n    for (let i = this._vertexLayoutOptions.vertexBuffers.length - 1; i >= 0; i--) {\r\n      const info = this._vertexLayoutOptions.vertexBuffers[i];\r\n      if (matchVertexBuffer(info.buffer, semantic)) {\r\n        releaseObject(info.buffer);\r\n        this._vertexLayoutOptions.vertexBuffers.splice(i, 1);\r\n        this._vertexLayoutDirty = true;\r\n      }\r\n    }\r\n    if (this._vertexLayoutDirty) {\r\n      this._changeTag++;\r\n      RenderBundleWrapper.primitiveChanged(this);\r\n    }\r\n  }\r\n  /**\r\n   * Get the vertex buffer that matches a given semantic.\r\n   *\r\n   * @param semantic - The vertex semantic to look up.\r\n   * @returns The matching vertex buffer, or `null` if not found.\r\n   */\r\n  getVertexBuffer(semantic: VertexSemantic): StructuredBuffer {\r\n    for (const info of this._vertexLayoutOptions.vertexBuffers) {\r\n      if (info.buffer && matchVertexBuffer(info.buffer, semantic)) {\r\n        return info.buffer;\r\n      }\r\n    }\r\n    return null;\r\n  }\r\n  /**\r\n   * Get vertex buffer information for a given semantic.\r\n   *\r\n   * @param semantic - The vertex semantic to look up.\r\n   * @returns The `VertexBufferInfo`, or `null` if not found.\r\n   */\r\n  getVertexBufferInfo(semantic: VertexSemantic): VertexBufferInfo {\r\n    this.checkVertexLayout();\r\n    return this._vertexLayout?.getVertexBufferInfo(semantic) ?? null;\r\n  }\r\n  /**\r\n   * Create a vertex buffer from data and add it to the primitive.\r\n   *\r\n   * - For interleaved layouts, pass an array of `VertexAttribFormat`.\r\n   * - For a single attribute, pass a single `VertexAttribFormat`.\r\n   *\r\n   * @param format - Vertex attribute format(s).\r\n   * @param data - Typed array with vertex data.\r\n   * @param stepMode - Optional step mode (e.g., 'vertex', 'instance').\r\n   * @returns The created `StructuredBuffer`.\r\n   */\r\n  createAndSetVertexBuffer(\r\n    format: VertexAttribFormat[] | VertexAttribFormat,\r\n    data: TypedArray,\r\n    stepMode?: VertexStepMode\r\n  ): StructuredBuffer {\r\n    const device = getDevice();\r\n    const buffer = Array.isArray(format)\r\n      ? device.createInterleavedVertexBuffer(format, data)\r\n      : device.createVertexBuffer(format, data);\r\n    return this.setVertexBuffer(buffer, stepMode);\r\n  }\r\n  /**\r\n   * Add an existing vertex buffer to the primitive.\r\n   *\r\n   * Ownership note: The primitive retains the buffer; it will be released or disposed when replaced or on dispose.\r\n   *\r\n   * @param buffer - The vertex buffer to add.\r\n   * @param stepMode - Optional step mode for the buffer.\r\n   * @returns The same buffer.\r\n   */\r\n  setVertexBuffer(buffer: StructuredBuffer, stepMode?: VertexStepMode) {\r\n    retainObject(buffer);\r\n    this._vertexLayoutOptions.vertexBuffers.push({\r\n      buffer,\r\n      stepMode\r\n    });\r\n    this._vertexLayoutDirty = true;\r\n    this._changeTag++;\r\n    RenderBundleWrapper.primitiveChanged(this);\r\n    return buffer;\r\n  }\r\n  /**\r\n   * Create an index buffer from data and set it on the primitive.\r\n   *\r\n   * @param data - Index data as Uint16Array or Uint32Array.\r\n   * @param dynamic - Whether the index buffer is dynamic (unmanaged).\r\n   * @returns The created `IndexBuffer`.\r\n   */\r\n  createAndSetIndexBuffer(\r\n    data: Uint16Array<ArrayBuffer> | Uint32Array<ArrayBuffer>,\r\n    dynamic?: boolean\r\n  ): IndexBuffer {\r\n    const device = getDevice();\r\n    const buffer = device.createIndexBuffer(data, {\r\n      dynamic: !!dynamic,\r\n      managed: !dynamic\r\n    });\r\n    this.setIndexBuffer(buffer);\r\n    return buffer;\r\n  }\r\n  /**\r\n   * Set or replace the index buffer.\r\n   *\r\n   * Ownership note: The primitive retains the buffer; previous buffer is released.\r\n   * Marks the vertex layout dirty and invalidates bundles.\r\n   *\r\n   * @param buffer - The index buffer to set (non-null).\r\n   * @returns void\r\n   */\r\n  setIndexBuffer(buffer: IndexBuffer): void {\r\n    if (this._vertexLayoutOptions.indexBuffer !== buffer) {\r\n      retainObject(buffer);\r\n      releaseObject(this._vertexLayoutOptions.indexBuffer);\r\n      this._vertexLayoutOptions.indexBuffer = buffer;\r\n      this._vertexLayoutDirty = true;\r\n      this._changeTag++;\r\n      RenderBundleWrapper.primitiveChanged(this);\r\n    }\r\n  }\r\n  /**\r\n   * Get the current index buffer.\r\n   *\r\n   * @returns The index buffer, or `undefined`/`null` if none set.\r\n   */\r\n  getIndexBuffer(): IndexBuffer {\r\n    return this._vertexLayoutOptions.indexBuffer;\r\n  }\r\n  /**\r\n   * Issue a non-instanced draw for the current topology and range.\r\n   *\r\n   * Preconditions: A valid vertex layout and `indexCount > 0`.\r\n   */\r\n  draw() {\r\n    this.checkVertexLayout();\r\n    if (this.indexCount > 0) {\r\n      this._vertexLayout?.draw(this._primitiveType, this._indexStart, this.indexCount);\r\n    }\r\n  }\r\n  /**\r\n   * Issue an instanced draw for the current topology and range.\r\n   *\r\n   * Preconditions: A valid vertex layout and `indexCount > 0`.\r\n   *\r\n   * @param numInstances - Number of instances to draw.\r\n   */\r\n  drawInstanced(numInstances: number): void {\r\n    this.checkVertexLayout();\r\n    if (this.indexCount > 0) {\r\n      this._vertexLayout?.drawInstanced(this._primitiveType, this._indexStart, this.indexCount, numInstances);\r\n    }\r\n  }\r\n  /**\r\n   * Dispose this primitive and release associated GPU resources.\r\n   */\r\n  protected onDispose() {\r\n    super.onDispose();\r\n    this._vertexLayout?.dispose();\r\n    this._vertexLayout = null;\r\n    if (this._vertexLayoutOptions) {\r\n      releaseObject(this._vertexLayoutOptions.indexBuffer);\r\n      for (const info of this._vertexLayoutOptions.vertexBuffers) {\r\n        releaseObject(info.buffer);\r\n      }\r\n      this._vertexLayoutOptions = null;\r\n    }\r\n  }\r\n  /*\r\n  createAABBTree(): AABBTree {\r\n    const indices = this.getIndexBuffer() ? this.getIndexBuffer().getData() : null;\r\n    const vertices = (this.getVertexBuffer(VERTEX_ATTRIB_POSITION)?.getData() as Float32Array) || null;\r\n    const aabbtree = new AABBTree();\r\n    aabbtree.buildFromPrimitives(vertices, indices, this._primitiveType);\r\n    return aabbtree;\r\n  }\r\n  */\r\n  /**\r\n   * Get the bounding volume associated with this primitive.\r\n   *\r\n   * @returns The current bounding volume, or `null` if not set.\r\n   */\r\n  getBoundingVolume(): BoundingVolume {\r\n    return this._bbox;\r\n  }\r\n  /**\r\n   * Set or replace the bounding volume of this primitive.\r\n   *\r\n   * Triggers registered bounding-volume change callbacks.\r\n   *\r\n   * @param bv - The bounding volume to set.\r\n   * @returns void\r\n   */\r\n  setBoundingVolume(bv: BoundingVolume): void {\r\n    if (bv !== this._bbox) {\r\n      this._bbox = bv;\r\n      this.dispatchEvent('bv_changed');\r\n    }\r\n  }\r\n  /**\r\n   * Test intersection against the current axis-aligned bounding box (AABB).\r\n   *\r\n   * @param ray - Ray to test against the primitive's AABB (derived from its bounding volume).\r\n   * @returns The distance from ray origin to the intersection, or `null` if no hit or no AABB.\r\n   */\r\n  raycast(ray: Ray): number {\r\n    const aabb = this.getBoundingVolume()?.toAABB();\r\n    return aabb ? ray.bboxIntersectionTestEx(aabb) : null;\r\n  }\r\n  /** @internal */\r\n  private checkVertexLayout() {\r\n    if (this._vertexLayoutDirty) {\r\n      this._vertexLayout?.dispose();\r\n      const device = getDevice();\r\n      this._vertexLayout = device.createVertexLayout(this._vertexLayoutOptions);\r\n      this._vertexLayoutDirty = false;\r\n    }\r\n  }\r\n  /** @internal */\r\n  private calcDefaultIndexCount(): number {\r\n    const indexBuffer = this.getIndexBuffer();\r\n    if (indexBuffer) {\r\n      return Math.max(0, indexBuffer.length - this._indexStart);\r\n    }\r\n    const info = this.getVertexBufferInfo('position');\r\n    if (info) {\r\n      return Math.max(\r\n        0,\r\n        Math.floor((info.buffer.byteLength - info.drawOffset) / info.stride) - this._indexStart\r\n      );\r\n    }\r\n    return 0;\r\n  }\r\n}\r\n"],"names":["Primitive","makeObservable","Disposable","_nextId","_vertexLayout","_vertexLayoutOptions","vertexBuffers","_primitiveType","_indexStart","_indexCount","_defaultIndexCount","_vertexLayoutDirty","_id","_changeTag","_bbox","id","changeTag","clone","other","copyFrom","info","setVertexBuffer","buffer","stepMode","setIndexBuffer","indexBuffer","primitiveType","indexStart","indexCount","type","RenderBundleWrapper","primitiveChanged","val","calcDefaultIndexCount","getNumVertices","posInfo","getVertexBufferInfo","byteLength","stride","getNumFaces","ib","getIndexBuffer","count","indexType","PBPrimitiveType","U16","removeVertexBuffer","semantic","i","length","matchVertexBuffer","releaseObject","splice","getVertexBuffer","checkVertexLayout","createAndSetVertexBuffer","format","data","device","getDevice","Array","isArray","createInterleavedVertexBuffer","createVertexBuffer","retainObject","push","createAndSetIndexBuffer","dynamic","createIndexBuffer","managed","draw","drawInstanced","numInstances","onDispose","dispose","getBoundingVolume","setBoundingVolume","bv","dispatchEvent","raycast","ray","aabb","toAABB","bboxIntersectionTestEx","createVertexLayout","Math","max","floor","drawOffset"],"mappings":"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"}