Objective-C中高效绘制渐变：解决NSColorWell卡顿与PDF导出黑色问题

核心问题原因 #

NSGradient的drawInRect:angle:方法在PDF导出的矢量上下文环境中，可能会以位图方式渲染渐变，导致导出的PDF显示为黑色。而你当前生成NSImage再绘制的方式，每次调整颜色都需要重新渲染位图，必然引发性能卡顿。

高效兼容的两种实现方式 #

方式1：使用NSGradient的矢量绘制方法

手动计算渐变的起始/结束点，替代drawInRect:angle:，绘制的渐变会以矢量形式被PDF上下文记录，同时保持高效重绘：

- (void)drawRect:(NSRect)dirtyRect {
    [super drawRect:dirtyRect];
    
    NSGradient *g = // 你的渐变对象
    NSRect bounds = [self bounds];
    
    // 对应90度角的渐变：从矩形顶部中点到底部中点（与原angle:90效果一致）
    NSPoint startPoint = NSMakePoint(NSMidX(bounds), NSMaxY(bounds));
    NSPoint endPoint = NSMakePoint(NSMidX(bounds), NSMinY(bounds));
    
    // 绘制渐变，包含超出起止点的区域填充
    [g drawFromPoint:startPoint 
             toPoint:endPoint 
             options:NSGradientDrawsBeforeStartingLocation | NSGradientDrawsAfterEndingLocation];
    
    // 绘制上方的其他对象
    // ...
}

方式2：使用Core Graphics的CGGradient（更底层，兼容性更强）

如果需要更稳定的PDF导出支持，直接使用Core Graphics API绘制渐变：

- (void)drawRect:(NSRect)dirtyRect {
    [super drawRect:dirtyRect];
    
    NSGradient *g = // 你的渐变对象
    NSRect bounds = [self bounds];
    CGContextRef context = [[NSGraphicsContext currentContext] CGContext];
    
    // 将NSGradient转换为CGGradient
    NSArray *colors = [g colors];
    NSArray *locations = [g locations];
    CGColorSpaceRef colorSpace = CGColorSpaceCreateWithName(kCGColorSpaceGenericRGB);
    size_t colorCount = [colors count];
    
    CGFloat *colorComponents = malloc(colorCount * 4 * sizeof(CGFloat));
    CGFloat *gradientLocations = malloc(colorCount * sizeof(CGFloat));
    
    for (NSUInteger i = 0; i < colorCount; i++) {
        NSColor *color = colors[i];
        CGFloat comps[4];
        [color getRed:&comps[0] green:&comps[1] blue:&comps[2] alpha:&comps[3]];
        memcpy(colorComponents + i*4, comps, 4*sizeof(CGFloat));
        gradientLocations[i] = [locations[i] floatValue];
    }
    
    CGGradientRef gradient = CGGradientCreateWithColorComponents(colorSpace, colorComponents, gradientLocations, colorCount);
    
    // 绘制垂直渐变（对应90度角）
    CGPoint start = CGPointMake(CGRectGetMidX(bounds), CGRectGetMaxY(bounds));
    CGPoint end = CGPointMake(CGRectGetMidX(bounds), CGRectGetMinY(bounds));
    CGContextDrawLinearGradient(context, gradient, start, end, kCGGradientDrawsBeforeStartLocation | kCGGradientDrawsAfterEndLocation);
    
    // 释放资源
    CGGradientRelease(gradient);
    free(colorComponents);
    free(gradientLocations);
    CGColorSpaceRelease(colorSpace);
    
    // 绘制上方的其他对象
    // ...
}

为什么这两种方式能解决问题 #

1. PDF导出兼容性：两种方式均以矢量形式绘制渐变，PDF上下文会直接记录渐变的矢量数据，不会出现变黑的问题。
2. 性能优化：无需预先生成NSImage，每次调整颜色后仅需重绘矢量渐变，CPU开销远低于位图渲染，能避免NSColorWell滑块卡顿。

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