avaloniaui-radialgradientbrush-fix

AvaloniaUI에서 RadialGradientBrush를 사용하는 경우 실행. AvaloniaUI Issue

⭐5stars🔀1forks📁View on GitHub🕐Updated Jan 11, 2026⬇️1downloads

When & Why to Use This Skill

This Claude skill automates the detection and resolution of RadialGradientBrush compatibility issues in AvaloniaUI, specifically addressing Issue #19888. It ensures seamless UI rendering by synchronizing GradientOrigin and Center properties, making it an essential tool for developers migrating WPF applications to AvaloniaUI or fixing gradient-related visual bugs.

Use Cases

  • WPF to AvaloniaUI Migration: Automatically detect and convert WPF RadialGradientBrush elements to be compatible with AvaloniaUI's specific property requirements.
  • UI Rendering Fixes: Resolve visual glitches where radial gradients fail to display correctly due to mismatches between GradientOrigin and Center values.
  • XAML Code Optimization: Standardize gradient brush definitions across a project to ensure consistent cross-platform UI behavior and adherence to AvaloniaUI best practices.
  • Automated Troubleshooting: Quickly identify problematic XAML snippets related to AvaloniaUI Issue #19888 and apply user-approved fixes without manual calculation.
nameavaloniaui-radialgradientbrush-fix
descriptionAvaloniaUI에서 RadialGradientBrush를 사용하는 경우 실행. AvaloniaUI Issue #19888로 인해 GradientOrigin과 Center 값이 반드시 동일해야 함. WPF RadialGradientBrush 변환, AvaloniaUI RadialGradientBrush 호환성, GradientOrigin Center 불일치 문제 해결 시 사용.

AvaloniaUI RadialGradientBrush 호환성 수정

문제 배경

AvaloniaUI에서 RadialGradientBrush는 WPF와 달리 GradientOrigin과 Center 값이 다르면 정상 동작하지 않음.

관련 이슈: AvaloniaUI/Avalonia#19888

  • RadialGradientBrush doesn't work when the GradientOrigin is different than the Center and the first Stop is Transparent

변환 절차

1. RadialGradientBrush 감지

WPF XAML에서 <RadialGradientBrush> 요소를 찾고 GradientOrigin과 Center 속성값을 비교.

2. 불일치 시 사용자에게 선택 요청

GradientOrigin ≠ Center인 경우 반드시 사용자에게 다음 선택지를 제시:

RadialGradientBrush의 GradientOrigin과 Center 값이 다릅니다.
- GradientOrigin: {현재값}
- Center: {현재값}

AvaloniaUI에서는 두 값이 동일해야 정상 동작합니다.
어느 쪽 값으로 통일하시겠습니까?

1. GradientOrigin 값으로 통일 → 결과: GradientOrigin="{GO값}" Center="{GO값}"
2. Center 값으로 통일 → 결과: GradientOrigin="{C값}" Center="{C값}"

3. 변환 예시

WPF 원본:

<RadialGradientBrush GradientOrigin="20%,20%" Center="28%,28%" RadiusX="75%" RadiusY="75%">
    <GradientStop Color="White" Offset="0"/>
    <GradientStop Color="Black" Offset="1"/>
</RadialGradientBrush>

AvaloniaUI 변환 (GradientOrigin 선택 시):

<RadialGradientBrush GradientOrigin="20%,20%" Center="20%,20%" RadiusX="75%" RadiusY="75%">
    <GradientStop Color="White" Offset="0"/>
    <GradientStop Color="Black" Offset="1"/>
</RadialGradientBrush>

AvaloniaUI 변환 (Center 선택 시):

<RadialGradientBrush GradientOrigin="28%,28%" Center="28%,28%" RadiusX="75%" RadiusY="75%">
    <GradientStop Color="White" Offset="0"/>
    <GradientStop Color="Black" Offset="1"/>
</RadialGradientBrush>

주의사항

  • 사용자가 선택하기 전까지 임의로 값을 변경하지 말 것
  • GradientOrigin 또는 Center 중 하나만 명시된 경우, 명시되지 않은 속성은 명시된 값으로 자동 설정
  • GradientOrigin과 Center가 이미 동일한 경우 수정 불필요