CALayer的shadowPath渲染为NSImage时显示异常问题咨询

我正在开发一款在NSWindow中使用CALayer展示图片等内容的App，为优化外观给CALayer设置了带shadowPath的底部阴影。但将父NSView转换为NSImage导出时，生成的NSImage中阴影变为四边都有，与CALayer实际显示的阴影完全不同。想咨询这是AppKit的正常现象还是我的实现有误？

阴影设置代码 #

layer?.masksToBounds = false
let size: CGFloat = 100
let distance: CGFloat = 200
let rect = CGRect(
    x: -size,
    y: layer.frame.height - (size * 0.4) + distance,
    width: layer.frame.width + size * 2,
    height: size
)

layer.shadowColor = .black
layer.shadowRadius = 100
layer.shadowOpacity = 1
layer.shadowPath = NSBezierPath(ovalIn: rect).cgPath

NSImage转换代码 #

let imageRep = view.bitmapImageRepForCachingDisplay(in: view.bounds)

view.cacheDisplay(in: view.bounds, to: imageRep!)
let image = NSImage(size: view.bounds.size)
image.addRepresentation(imageRep!)
let imageData = image.tiffRepresentation

return NSImage(data: imageData!)!

这不是AppKit的正常现象，问题出在两个核心点：

1. shadowPath的坐标系错误
   你计算shadowPath的rect时使用了layer.frame.height，但CALayer的shadowPath是基于自身bounds坐标系（原点在layer左上角），而非父层坐标系的frame。虽然多数情况下frame和bounds高度一致，但y轴的计算逻辑会因为坐标系基准错误，导致阴影位置偏离预期，最终在导出渲染时出现异常。

修改方式：将layer.frame.height替换为layer.bounds.height，确保坐标系匹配：

let rect = CGRect(
    x: -size,
    y: layer.bounds.height - (size * 0.4) + distance,
    width: layer.bounds.width + size * 2,
    height: size
)

2. 缓存渲染范围未覆盖阴影区域
   bitmapImageRepForCachingDisplay默认只缓存view bounds内的内容，但你的shadowPath明显超出了view的bounds范围（x从-size开始，y轴超出view底部）。当缓存范围不足时，AppKit会自动补充默认的四边阴影来填充缺失部分，这就是导出图片出现四边阴影的直接原因。

解决方法：

• 扩展缓存范围，将阴影区域完全包含进去：

// 计算需要扩展的边距，取阴影半径和偏移距离的最大值
let extraMargin = max(layer.shadowRadius, distance)
let extendedBounds = view.bounds.insetBy(dx: -extraMargin, dy: -extraMargin)
let imageRep = view.bitmapImageRepForCachingDisplay(in: extendedBounds)

view.cacheDisplay(in: extendedBounds, to: imageRep!)
let image = NSImage(size: extendedBounds.size)
image.addRepresentation(imageRep!)

• 若需要导出图片与原view尺寸一致，可先渲染到扩展范围，再裁剪回原bounds：

let extraMargin = max(layer.shadowRadius, distance)
let extendedBounds = view.bounds.insetBy(dx: -extraMargin, dy: -extraMargin)
let imageRep = view.bitmapImageRepForCachingDisplay(in: extendedBounds)
view.cacheDisplay(in: extendedBounds, to: imageRep!)

// 裁剪回原view大小
let croppedRep = NSBitmapImageRep(bitmapDataPlanes: nil, pixelsWide: Int(view.bounds.width), pixelsHigh: Int(view.bounds.height), bitsPerSample: imageRep.bitsPerSample, samplesPerPixel: imageRep.samplesPerPixel, hasAlpha: imageRep.hasAlpha, isPlanar: imageRep.isPlanar, colorSpaceName: imageRep.colorSpaceName, bytesPerRow: imageRep.bytesPerRow, bitsPerPixel: imageRep.bitsPerPixel)!

croppedRep.draw(in: view.bounds, from: extendedBounds, operation: .copy, fraction: 1.0)

let image = NSImage(size: view.bounds.size)
image.addRepresentation(croppedRep!)

另外，务必确保你的NSView已经开启layer支持（设置wantsLayer = true），否则CALayer的阴影配置无法被正确渲染。

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