---

name: fixing-avaloniaui-radialgradientbrush description: Fixes RadialGradientBrush compatibility issues in AvaloniaUI due to Issue #19888 where GradientOrigin and Center must be identical. Use when converting WPF RadialGradientBrush to AvaloniaUI, resolving gradient rendering issues, or GradientOrigin/Center value mismatch problems.

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인 경우 반드시 사용자에게 다음 선택지를 제시:

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

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

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

3. 변환 예시

WPF 원본:

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

AvaloniaUI 변환 (GradientOrigin 선택 시):

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

AvaloniaUI 변환 (Center 선택 시):

Copy<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가 이미 동일한 경우 수정 불필요

Copy