fix(rendering): isolate planar reflection camera in legacy flow for preview

Legacy ReflectionProbeFlow was calling renderPlanarReflection() for
PREVIEW cameras, which overwrites the main probe camera state and
can corrupt Scene View / Game View reflections. Switch to
renderPreviewPlanarReflection() and pass the isolated reflection
camera through the stage and queue chain.

Author: xubing0906

cocos/rendering/reflection-probe/reflection-probe-flow.ts

@@ -66,10 +66,11 @@ export class ReflectionProbeFlow extends RenderFlow {
         for (let i = 0; i < probes.length; i++) {
             if (probes[i].needRender) {
                 if (probes[i].probeType === ProbeType.PLANAR) {
+                    let reflectionCamera: Camera | undefined;
                     if (EDITOR && camera.cameraUsage === CameraUsage.PREVIEW) {
-                        probes[i].renderPlanarReflection(camera);
+                        reflectionCamera = probes[i].renderPreviewPlanarReflection(camera);
                     }
-                    this._renderStage(camera, probes[i]);
+                    this._renderStage(camera, probes[i], reflectionCamera);
                 } else if (EDITOR) {
                     this._renderStage(camera, probes[i]);
                 }
@@ -80,12 +81,12 @@ export class ReflectionProbeFlow extends RenderFlow {
     public destroy (): void {
         super.destroy();
     }
-    private _renderStage (camera: Camera, probe: ReflectionProbe): void {
+    private _renderStage (camera: Camera, probe: ReflectionProbe, reflectionCamera?: Camera): void {
         for (let i = 0; i < this._stages.length; i++) {
             const probeStage = this._stages[i] as ReflectionProbeStage;
             if (probe.probeType === ProbeType.PLANAR) {
                 cclegacy.internal.reflectionProbeManager.updatePlanarMap(probe, null);
-                probeStage.setUsageInfo(probe, probe.realtimePlanarTexture!.window!.framebuffer);
+                probeStage.setUsageInfo(probe, probe.realtimePlanarTexture!.window!.framebuffer, reflectionCamera);
                 probeStage.render(camera);
                 cclegacy.internal.reflectionProbeManager.updatePlanarMap(probe, probe.realtimePlanarTexture!.getGFXTexture());
             } else {

cocos/rendering/reflection-probe/reflection-probe-stage.ts

@@ -55,6 +55,7 @@ export class ReflectionProbeStage extends RenderStage {
     private _frameBuffer: Framebuffer | null = null;
     private _renderArea = new Rect();
     private _probe: ReflectionProbe | null = null;
+    private _reflectionCamera: Camera | null = null;
     private _probeRenderQueue!: RenderReflectionProbeQueue;
     private _rgbeColor = new Vec3();
 
@@ -68,9 +69,10 @@ export class ReflectionProbeStage extends RenderStage {
      * @param probe
      * @param frameBuffer
      */
-    public setUsageInfo (probe: ReflectionProbe, frameBuffer: Framebuffer): void {
+    public setUsageInfo (probe: ReflectionProbe, frameBuffer: Framebuffer, reflectionCamera?: Camera): void {
         this._probe = probe;
         this._frameBuffer = frameBuffer;
+        this._reflectionCamera = reflectionCamera ?? null;
     }
 
     public destroy (): void {
@@ -108,8 +110,9 @@ export class ReflectionProbeStage extends RenderStage {
     public render (camera: Camera): void {
         const pipeline = this._pipeline;
         const cmdBuff = pipeline.commandBuffers[0];
-        this._probeRenderQueue.gatherRenderObjects(this._probe!, camera, cmdBuff);
-        pipeline.pipelineUBO.updateCameraUBO(this._probe!.camera);
+        const probeCamera = this._reflectionCamera ?? this._probe!.camera;
+        this._probeRenderQueue.gatherRenderObjects(this._probe!, camera, cmdBuff, probeCamera);
+        pipeline.pipelineUBO.updateCameraUBO(probeCamera);
 
         this._renderArea.x = 0;
         this._renderArea.y = 0;
@@ -118,10 +121,10 @@ export class ReflectionProbeStage extends RenderStage {
 
         const renderPass = this._frameBuffer!.renderPass;
 
-        if (this._probe!.camera.clearFlag & ClearFlagBit.COLOR) {
-            this._rgbeColor.x = this._probe!.camera.clearColor.x;
-            this._rgbeColor.y = this._probe!.camera.clearColor.y;
-            this._rgbeColor.z = this._probe!.camera.clearColor.z;
+        if (probeCamera.clearFlag & ClearFlagBit.COLOR) {
+            this._rgbeColor.x = probeCamera.clearColor.x;
+            this._rgbeColor.y = probeCamera.clearColor.y;
+            this._rgbeColor.z = probeCamera.clearColor.z;
             const rgbe = packRGBE(this._rgbeColor);
             colors[0].x = rgbe.x;
             colors[0].y = rgbe.y;
@@ -134,8 +137,8 @@ export class ReflectionProbeStage extends RenderStage {
             this._frameBuffer!,
             this._renderArea,
             colors,
-            this._probe!.camera.clearDepth,
-            this._probe!.camera.clearStencil,
+            probeCamera.clearDepth,
+            probeCamera.clearStencil,
         );
         cmdBuff.bindDescriptorSet(SetIndex.GLOBAL, pipeline.descriptorSet);
 

cocos/rendering/render-reflection-probe-queue.ts

@@ -79,13 +79,14 @@ export class RenderReflectionProbeQueue {
     public constructor (pipeline: PipelineRuntime) {
         this._pipeline = pipeline;
     }
-    public gatherRenderObjects (probe: ReflectionProbe, camera: Camera, cmdBuff: CommandBuffer): void {
+    public gatherRenderObjects (probe: ReflectionProbe, camera: Camera, cmdBuff: CommandBuffer, reflectionCamera?: Camera): void {
         this.clear();
         const scene = camera.scene!;
         const sceneData = this._pipeline.pipelineSceneData;
         const skybox = sceneData.skybox;
+        const probeCamera = reflectionCamera ?? probe.camera;
 
-        if (skybox.enabled && skybox.model && (probe.camera.clearFlag & SkyBoxFlagValue.VALUE)) {
+        if (skybox.enabled && skybox.model && (probeCamera.clearFlag & SkyBoxFlagValue.VALUE)) {
             this.add(skybox.model);
         }
 
@@ -105,7 +106,7 @@ export class RenderReflectionProbeQueue {
                     if (geometry.intersect.aabbWithAABB(model.worldBounds, probe.boundingBox!)) {
                         this.add(model);
                     }
-                } else if (geometry.intersect.aabbFrustum(model.worldBounds, probe.camera.frustum)) {
+                } else if (geometry.intersect.aabbFrustum(model.worldBounds, probeCamera.frustum)) {
                     this.add(model);
                 }
             }