移动父容器间的Layout后TShadowEffect渲染异常问题咨询

1. 这是否是已知的FMX渲染bug？ #

是FMX渲染管线的已知问题。TShadowEffect这类视觉效果的渲染依赖组件所在父容器的坐标系、渲染缓存等上下文信息。当组件被移动到新父容器时，原有阴影效果的缓存位图、变换矩阵没有被自动清除或重新计算，导致阴影绘制时使用了旧的上下文数据，出现错位、模糊或破损的情况。

2. 可靠的解决方法及底层解释 #

以下是几种从渲染底层出发的可靠修复方案：

方法一：移动前清除阴影效果的缓存位图 #

在执行Layout2.AddObject(Layout1);之前，手动强制阴影效果丢弃当前缓存的渲染位图，让它在新父容器中重新生成：

// 假设按钮名为Button1，阴影效果为ShadowEffect
Layout1.Button1.ShadowEffect.DisposeOfBitmap;
Layout2.AddObject(Layout1);

底层解释：TShadowEffect内部会缓存已渲染的阴影位图以提升性能，DisposeOfBitmap会直接释放这个缓存，下次渲染时会基于新父容器的坐标系重新计算并绘制阴影。

方法二：移动后强制触发重绘与效果刷新 #

移动完成后，主动标记阴影效果和相关容器为需要重新渲染：

Layout2.AddObject(Layout1);
// 标记阴影效果需要重新计算
Layout1.Button1.ShadowEffect.InvalidateEffect;
// 刷新组件和新父容器的渲染区域
Layout1.Invalidate;
Layout2.Invalidate;

底层解释：InvalidateEffect会让TShadowEffect内部的渲染状态标记为"脏"，Invalidate会触发容器和组件的Paint事件，强制FMX渲染管线使用新的父容器上下文重新绘制所有内容，包括阴影。

方法三：重置组件画布的变换上下文 #

如果前两种方法无效，可以手动重置组件的画布变换状态，确保阴影使用新的坐标系：

Layout2.AddObject(Layout1);
if Assigned(Layout1.Button1.Canvas) then
begin
  // 重置画布状态，触发变换矩阵更新
  Layout1.Button1.Canvas.BeginScene;
  Layout1.Button1.Canvas.EndScene;
end;
// 再配合效果刷新
Layout1.Button1.ShadowEffect.InvalidateEffect;

底层解释：FMX组件的画布会保留父容器的变换矩阵，BeginScene和EndScene会重置画布的变换状态，让后续的阴影绘制使用新父容器的坐标系计算偏移量。

额外注意事项 #

• 不要在组件的OnPaint事件中执行容器移动操作，会打乱FMX的渲染时序，加重异常；
• 批量移动组件时，先调用Layout2.SuspendLayout暂停布局更新，移动完成后调用Layout2.ResumeLayout恢复，再统一触发重绘，既能提升性能，也能避免多次渲染导致的异常。

内容的提问来源于stack exchange，提问作者Daniel Vieira Daniel