컴퍼지션 브러시
UWP 애플리케이션에서 화면에 보이는 모든 것은 브러쉬로 그려졌기 때문에 볼 수 있습니다. 브러쉬를 사용하면 단순한 단색이나 이미지 또는 그림, 복잡한 효과 체인 등 다양한 콘텐츠로 사용자 인터페이스(UI) 개체를 그릴 수 있습니다. 이 항목에서는 CompositionBrush를 이용한 그리기 작업의 개념을 소개합니다.
XAML UWP 앱으로 작업할 때 XAML Brush 또는 CompositionBrush를 사용하여 UIElement를 그리도록 선택할 수 있습니다. 일반적으로 XAML Brush가 해당 시나리오를 지원하는 경우 XAML Brush를 선택하는 것이 쉽고 효과적입니다. 예를 들어, 단추 색상에 애니메이션을 적용하고 텍스트 채우기 또는 이미지 형태를 변경합니다. 반면에 애니메이션 효과의 마스크, 애니메이션 효과의 9개 모눈 확장 또는 효과 체인을 사용한 그리기 등, XAML Brush가 지원하지 않는 작업을 수행하려는 경우 CompositionBrush를 사용하면 XamlCompositionBrushBase 사용을 통해 UIElement를 그릴 수 있습니다.
시각적 계층 작업을 하는 경우 SpriteVisual 영역을 그리려면 CompositionBrush를 사용해야 합니다.
필수 조건
이 개요에서는 시각적 계층 개요에 설명된 기본 컴퍼지션 애플리케이션 구조에 익숙하다는 것을 전제로 합니다.
CompositionBrush로 그리기
CompositionBrush는 출력으로 영역을 "그립니다". 다른 브러시는 다른 유형의 출력 합니다. 어떤 브러시는 단색으로 영역을 그리고, 또 어떤 브러시는 그라데이션, 이미지, 사용자 지정 그림 또는 효과를 사용합니다. 다른 브러시의 동작을 수정하는 특수 브러시도 있습니다. 예를 들어 불투명 마스크를 사용하여 CompositionBrush가 어떤 영역을 그릴지 제어하거나, 9개 모눈을 사용하여 영역을 그릴 때 CompositionBrush에 적용되는 확장을 제어할 수 있습니다. CompositionBrush는 다음 유형 중 하나일 수 있습니다.
| 클래스 | 세부 정보 | 다음에서 도입 |
|---|---|---|
| CompositionColorBrush | 단색으로 영역을 그립니다. | Windows 10, 버전 1511(SDK 10586) |
| CompositionSurfaceBrush | ICompositionSurface의 콘텐츠로 영역 그리기 | Windows 10, 버전 1511(SDK 10586) |
| CompositionEffectBrush | 컴퍼지션 효과의 콘텐츠로 영역 그리기 | Windows 10, 버전 1511(SDK 10586) |
| CompositionMaskBrush | 불투명 마스크와 CompositionBrush로 시각 항목 그리기 | Windows 10, 버전 1607(SDK 14393) |
| CompositionNineGridBrush | 9개 모눈 확장을 이용해 CompositionBrush로 영역 그리기 | Windows 10, 버전 1607(SDK 14393) |
| CompositionLinearGradientBrush | 선형 그라데이션으로 영역을 그립니다. | Windows 10, 버전 1709(SDK 16299) |
| CompositionRadialGradientBrush | 방사형 그라데이션으로 영역을 그립니다. | Windows 10, 버전 1903(내부자 미리 보기 SDK) |
| CompositionBackdropBrush | 애플리케이션 또는 데스크톱의 애플리케이션 창 바로 뒤에 있는 픽셀에서 배경 픽셀을 샘플링하여 영역을 그립니다. CompositionEffectBrush처럼 다른 CompositionBrush에 대한 입력으로 사용됨 | Windows 10, 버전 1607(SDK 14393) |
단색으로 그리기
CompositionColorBrush가 단색으로 영역을 그립니다. SolidColorBrush의 색을 지정하는 다양한 방법이 있습니다. 예를 들어 알파, 빨간색, 녹색 및 파란색(ARGB) 채널을 지정하거나 색 클래스에서 제공하는 미리 정의된 색상 중 하나를 사용할 수 있습니다.
다음 그림과 코드는 검은색 브러시로 선을 긋고 색 값이 0x9ACD32인 단색 브러시로 칠하는 직사각형을 만드는 작은 시각적 트리를 보여줍니다.
Compositor _compositor;
ContainerVisual _container;
SpriteVisual _colorVisual1, _colorVisual2;
CompositionColorBrush _blackBrush, _greenBrush;
_compositor = Window.Current.Compositor;
_container = _compositor.CreateContainerVisual();
_blackBrush = _compositor.CreateColorBrush(Colors.Black);
_colorVisual1= _compositor.CreateSpriteVisual();
_colorVisual1.Brush = _blackBrush;
_colorVisual1.Size = new Vector2(156, 156);
_colorVisual1.Offset = new Vector3(0, 0, 0);
_container.Children.InsertAtBottom(_colorVisual1);
_ greenBrush = _compositor.CreateColorBrush(Color.FromArgb(0xff, 0x9A, 0xCD, 0x32));
_colorVisual2 = _compositor.CreateSpriteVisual();
_colorVisual2.Brush = _greenBrush;
_colorVisual2.Size = new Vector2(150, 150);
_colorVisual2.Offset = new Vector3(3, 3, 0);
_container.Children.InsertAtBottom(_colorVisual2);
선형 그라데이션으로 그리기
CompositionLinearGradientBrush는 선형 그라데이션으로 영역을 그립니다. 선형 그라데이션은 선, 그라데이션 축에 두 가지 이상의 색상을 혼합합니다. GradientStop 개체를 사용하여 그라데이션의 색상과 위치를 지정합니다.
다음 그림과 코드는 빨간색과 노란색을 사용하여 2개 스톱이 있는 LinearGradientBrush로 그린 SpriteVisual을 보여줍니다.
Compositor _compositor;
SpriteVisual _gradientVisual;
CompositionLinearGradientBrush _redyellowBrush;
_compositor = Window.Current.Compositor;
_redyellowBrush = _compositor.CreateLinearGradientBrush();
_redyellowBrush.ColorStops.Add(_compositor.CreateColorGradientStop(0, Colors.Red));
_redyellowBrush.ColorStops.Add(_compositor.CreateColorGradientStop(1, Colors.Yellow));
_gradientVisual = _compositor.CreateSpriteVisual();
_gradientVisual.Brush = _redyellowBrush;
_gradientVisual.Size = new Vector2(156, 156);
방사형 그라데이션으로 그리기
CompositionRadialGradientBrush는 방사형 그라데이션으로 영역을 그립니다. 방사형 그라데이션은 타원의 중심에서 시작하여 타원의 반경에서 끝나는 그라데이션으로 둘 이상의 색상을 혼합합니다. GradientStop 개체는 그라데이션에서 색상과 위치를 정의하는 데 사용됩니다.
다음 그림과 코드는 2개의 GradientStops가 있는 RadialGradientBrush로 그린 SpriteVisual을 보여 줍니다.
Compositor _compositor;
SpriteVisual _gradientVisual;
CompositionRadialGradientBrush RGBrush;
_compositor = Window.Current.Compositor;
RGBrush = _compositor.CreateRadialGradientBrush();
RGBrush.ColorStops.Add(_compositor.CreateColorGradientStop(0, Colors.Aquamarine));
RGBrush.ColorStops.Add(_compositor.CreateColorGradientStop(1, Colors.DeepPink));
_gradientVisual = _compositor.CreateSpriteVisual();
_gradientVisual.Brush = RGBrush;
_gradientVisual.Size = new Vector2(200, 200);
이미지로 그리기
CompositionSurfaceBrush는 ICompositionSurface에 렌더링된 픽셀로 영역을 그립니다. 예를 들어 CompositionSurfaceBrush를 사용하여 ICompositionSurface surface using LoadedImageSurface API에 렌더링된 이미지로 영역을 그릴 수 있습니다.
다음 그림과 코드는 LoadedImageSurface를 사용해 ICompositionSurface에 렌더링된 licorice의 비트맵으로 그린 SpriteVisual을 보여줍니다. CompositionSurfaceBrush의 속성을 사용하여 시각의 경계 내에서 비트맵을 확장하고 정렬할 수 있습니다.
Compositor _compositor;
SpriteVisual _imageVisual;
CompositionSurfaceBrush _imageBrush;
_compositor = Window.Current.Compositor;
_imageBrush = _compositor.CreateSurfaceBrush();
// The loadedSurface has a size of 0x0 till the image has been been downloaded, decoded and loaded to the surface. We can assign the surface to the CompositionSurfaceBrush and it will show up once the image is loaded to the surface.
LoadedImageSurface _loadedSurface = LoadedImageSurface.StartLoadFromUri(new Uri("ms-appx:///Assets/licorice.jpg"));
_imageBrush.Surface = _loadedSurface;
_imageVisual = _compositor.CreateSpriteVisual();
_imageVisual.Brush = _imageBrush;
_imageVisual.Size = new Vector2(156, 156);
사용자 지정 그림으로 그리기
CompositionSurfaceBrush를 사용하면 Win2D(또는 D2D)를 사용해 렌더링된 ICompositionSurface의 픽셀로 영역을 그릴 수도 있습니다.
다음 코드는 Win2D를 사용하여 ICompositionSurface에 렌더링된 텍스트 실행으로 그린 SpriteVisual을 보여줍니다. Win2D를 사용하려면 프로젝트에 Win2D NuGet 패키지를 포함시켜야 합니다.
Compositor _compositor;
CanvasDevice _device;
CompositionGraphicsDevice _compositionGraphicsDevice;
SpriteVisual _drawingVisual;
CompositionSurfaceBrush _drawingBrush;
_device = CanvasDevice.GetSharedDevice();
_compositionGraphicsDevice = CanvasComposition.CreateCompositionGraphicsDevice(_compositor, _device);
_drawingBrush = _compositor.CreateSurfaceBrush();
CompositionDrawingSurface _drawingSurface = _compositionGraphicsDevice.CreateDrawingSurface(new Size(256, 256), DirectXPixelFormat.B8G8R8A8UIntNormalized, DirectXAlphaMode.Premultiplied);
using (var ds = CanvasComposition.CreateDrawingSession(_drawingSurface))
{
ds.Clear(Colors.Transparent);
var rect = new Rect(new Point(2, 2), (_drawingSurface.Size.ToVector2() - new Vector2(4, 4)).ToSize());
ds.FillRoundedRectangle(rect, 15, 15, Colors.LightBlue);
ds.DrawRoundedRectangle(rect, 15, 15, Colors.Gray, 2);
ds.DrawText("This is a composition drawing surface", rect, Colors.Black, new CanvasTextFormat()
{
FontFamily = "Comic Sans MS",
FontSize = 32,
WordWrapping = CanvasWordWrapping.WholeWord,
VerticalAlignment = CanvasVerticalAlignment.Center,
HorizontalAlignment = CanvasHorizontalAlignment.Center
}
);
_drawingBrush.Surface = _drawingSurface;
_drawingVisual = _compositor.CreateSpriteVisual();
_drawingVisual.Brush = _drawingBrush;
_drawingVisual.Size = new Vector2(156, 156);
마찬가지로, CompositionSurfaceBrush를 사용하면 Win2D 상호 운용성을 사용하여 SwapChain으로 SpriteVisual을 그릴 수도 있습니다. 이 샘플은 Win2D를 사용하여 스왑 체인으로 SpriteVisual을 그리는 방법에 대한 예를 제공합니다.
비디오로 그리기
CompositionSurfaceBrush를 사용하면 MediaPlayer 클래스를 통해 로드한 비디오를 사용해 렌더링된 ICompositionSurface의 픽셀로 영역을 그릴 수도 있습니다.
다음 코드는 ICompositionSurface에 로드된 비디오로 그린 SpriteVisual을 보여줍니다.
Compositor _compositor;
SpriteVisual _videoVisual;
CompositionSurfaceBrush _videoBrush;
// MediaPlayer set up with a create from URI
_mediaPlayer = new MediaPlayer();
// Get a source from a URI. This could also be from a file via a picker or a stream
var source = MediaSource.CreateFromUri(new Uri("https://go.microsoft.com/fwlink/?LinkID=809007&clcid=0x409"));
var item = new MediaPlaybackItem(source);
_mediaPlayer.Source = item;
_mediaPlayer.IsLoopingEnabled = true;
// Get the surface from MediaPlayer and put it on a brush
_videoSurface = _mediaPlayer.GetSurface(_compositor);
_videoBrush = _compositor.CreateSurfaceBrush(_videoSurface.CompositionSurface);
_videoVisual = _compositor.CreateSpriteVisual();
_videoVisual.Brush = _videoBrush;
_videoVisual.Size = new Vector2(156, 156);
필터 효과로 그리기
CompositionEffectBrush는 CompositionEffect의 출력으로 영역을 그립니다. 시각적 계층의 효과는 색상, 그라데이션, 이미지, 비디오, 스왑 체인, UI 영역 또는 화면 효과의 트리 등, 소스 콘텐츠의 컬렉션에 적용되는 애니메이션 가능한 필터 효과라고 할 수 있습니다. 소스 콘텐츠는 일반적으로 다른 CompositionBrush를 사용하여 지정됩니다.
다음 그림과 코드는 채도 감소 필터 효과가 적용된 고양이 이미지로 그린 SpriteVisual을 보여줍니다.
Compositor _compositor;
SpriteVisual _effectVisual;
CompositionEffectBrush _effectBrush;
_compositor = Window.Current.Compositor;
var graphicsEffect = new SaturationEffect {
Saturation = 0.0f,
Source = new CompositionEffectSourceParameter("mySource")
};
var effectFactory = _compositor.CreateEffectFactory(graphicsEffect);
_effectBrush = effectFactory.CreateBrush();
CompositionSurfaceBrush surfaceBrush =_compositor.CreateSurfaceBrush();
LoadedImageSurface loadedSurface = LoadedImageSurface.StartLoadFromUri(new Uri("ms-appx:///Assets/cat.jpg"));
SurfaceBrush.surface = loadedSurface;
_effectBrush.SetSourceParameter("mySource", surfaceBrush);
_effectVisual = _compositor.CreateSpriteVisual();
_effectVisual.Brush = _effectBrush;
_effectVisual.Size = new Vector2(156, 156);
CompositionBrush를 이용한 효과 만들기에 대한 자세한 내용은 시각 계층의 효과를 참조하세요.
불투명 마스크가 적용된 CompositionBrush로 그리기
CompositionMaskBrush는 불투명 마스크가 적용된 CompositionBrush로 영역을 그립니다. 불투명 마스크의 소스는 CompositionColorBrush, CompositionLinearGradientBrush, CompositionSurfaceBrush, CompositionEffectBrush, 또는 CompositionNineGridBrush 유형의 모든 CompositionBrush일 수 있습니다. 불투명 마스크는 CompositionSurfaceBrush로 지정되어야 합니다.
다음 그림과 코드는 CompositionMaskBrush로 그린 SpriteVisual을 보여줍니다. 마스크의 소스는 원의 이미지를 마스크로 사용해 원과 비슷하게 보이도록 마스킹된 CompositionLinearGradientBrush입니다.
Compositor _compositor;
SpriteVisual _maskVisual;
CompositionMaskBrush _maskBrush;
_compositor = Window.Current.Compositor;
_maskBrush = _compositor.CreateMaskBrush();
CompositionLinearGradientBrush _sourceGradient = _compositor.CreateLinearGradientBrush();
_sourceGradient.ColorStops.Add(_compositor.CreateColorGradientStop(0,Colors.Red));
_sourceGradient.ColorStops.Add(_compositor.CreateColorGradientStop(1,Colors.Yellow));
_maskBrush.Source = _sourceGradient;
LoadedImageSurface loadedSurface = LoadedImageSurface.StartLoadFromUri(new Uri("ms-appx:///Assets/circle.png"), new Size(156.0, 156.0));
_maskBrush.Mask = _compositor.CreateSurfaceBrush(loadedSurface);
_maskVisual = _compositor.CreateSpriteVisual();
_maskVisual.Brush = _maskBrush;
_maskVisual.Size = new Vector2(156, 156);
개 모눈 확장을 이용해 CompositionBrush로 그리기
CompositionNineGridBrush는 9개 모눈 메타포를 이용해 확장되는 CompositionBrush로 영역을 그립니다. 9개 모눈 메타포를 사용하면 CompositionBrush의 가장자리 및 모서리를 중심과 다르게 늘릴 수 있습니다. 9개 모눈 확장의 소스는 CompositionColorBrush, CompositionSurfaceBrush 또는 CompositionEffectBrush 유형의 모든 CompositionBrush일 수 있습니다.
다음 코드는 CompositionNineGridBrush로 그린 SpriteVisual을 보여줍니다. 마스크의 소스는 9개 모눈을 사용하여 확장되는 CompositionSurfaceBrush입니다.
Compositor _compositor;
SpriteVisual _nineGridVisual;
CompositionNineGridBrush _nineGridBrush;
_compositor = Window.Current.Compositor;
_ninegridBrush = _compositor.CreateNineGridBrush();
// nineGridImage.png is 50x50 pixels; nine-grid insets, as measured relative to the actual size of the image, are: left = 1, top = 5, right = 10, bottom = 20 (in pixels)
LoadedImageSurface _imageSurface = LoadedImageSurface.StartLoadFromUri(new Uri("ms-appx:///Assets/nineGridImage.png"));
_nineGridBrush.Source = _compositor.CreateSurfaceBrush(_imageSurface);
// set Nine-Grid Insets
_ninegridBrush.SetInsets(1, 5, 10, 20);
// set appropriate Stretch on SurfaceBrush for Center of Nine-Grid
sourceBrush.Stretch = CompositionStretch.Fill;
_nineGridVisual = _compositor.CreateSpriteVisual();
_nineGridVisual.Brush = _ninegridBrush;
_nineGridVisual.Size = new Vector2(100, 75);
배경 픽셀을 사용해 그리기
CompositionBackdropBrush는 영역 뒤의 콘텐츠로 영역을 그립니다. CompositionBackdropBrush는 단독으로 사용되지 않고, EffectBrush 등의 다른 CompositionBrush에 대한 입력으로 사용됩니다. 예를 들어 흐림 효과에 대한 입력으로 CompositionBackdropBrush를 사용하면 불투명한 유리 효과를 얻을 수 있습니다.
다음 코드는 CompositionSurfaceBrush와 이미지 위에 불투명한 유리 오버레이를 사용하여 이미지를 만드는 작은 시각적 트리를 보여줍니다. 불투명한 유리 오버레이는 이미지 위에 EffectBrush가 채워진 SpriteVisual을 배치하여 만듭니다. EffectBrush는 CompositionBackdropBrush를 흐림 효과에 대한 입력으로 사용합니다.
Compositor _compositor;
SpriteVisual _containerVisual;
SpriteVisual _imageVisual;
SpriteVisual _backdropVisual;
_compositor = Window.Current.Compositor;
// Create container visual to host the visual tree
_containerVisual = _compositor.CreateContainerVisual();
// Create _imageVisual and add it to the bottom of the container visual.
// Paint the visual with an image.
CompositionSurfaceBrush _licoriceBrush = _compositor.CreateSurfaceBrush();
LoadedImageSurface loadedSurface =
LoadedImageSurface.StartLoadFromUri(new Uri("ms-appx:///Assets/licorice.jpg"));
_licoriceBrush.Surface = loadedSurface;
_imageVisual = _compositor.CreateSpriteVisual();
_imageVisual.Brush = _licoriceBrush;
_imageVisual.Size = new Vector2(156, 156);
_imageVisual.Offset = new Vector3(0, 0, 0);
_containerVisual.Children.InsertAtBottom(_imageVisual)
// Create a SpriteVisual and add it to the top of the containerVisual.
// Paint the visual with an EffectBrush that applies blur to the content
// underneath the Visual to create a frosted glass effect.
GaussianBlurEffect blurEffect = new GaussianBlurEffect(){
Name = "Blur",
BlurAmount = 1.0f,
BorderMode = EffectBorderMode.Hard,
Source = new CompositionEffectSourceParameter("source");
};
CompositionEffectFactory blurEffectFactory = _compositor.CreateEffectFactory(blurEffect);
CompositionEffectBrush _backdropBrush = blurEffectFactory.CreateBrush();
// Create a BackdropBrush and bind it to the EffectSourceParameter source
_backdropBrush.SetSourceParameter("source", _compositor.CreateBackdropBrush());
_backdropVisual = _compositor.CreateSpriteVisual();
_backdropVisual.Brush = _licoriceBrush;
_backdropVisual.Size = new Vector2(78, 78);
_backdropVisual.Offset = new Vector3(39, 39, 0);
_containerVisual.Children.InsertAtTop(_backdropVisual);
CompositionBrush 결합
다수의 CompositionBrush가 다른 CompositionBrush를 입력으로 사용합니다. 예를 들어 SetSourceParameter 메서드를 사용하면 다른 CompositionBrush를 CompositionEffectBrush에 대한 입력으로 설정할 수 있습니다. 아래 표에는 지원되는 CompositionBrush 조합이 나와 있습니다. 지원되지 않는 조합을 사용하면 예외가 발생합니다.
| Brush | EffectBrush.SetSourceParameter() | MaskBrush.Mask | MaskBrush.Source | NineGridBrush.Source |
|---|---|---|---|---|
| CompositionColorBrush | 예 | 예 | 예 | 예 |
| CompositionLinear GradientBrush |
예 | 예 | 예 | 아니요 |
| CompositionSurfaceBrush | 예 | 예 | 예 | 예 |
| CompositionEffectBrush | 아니요 | 아니요 | 예 | 아니요 |
| CompositionMaskBrush | 아니요 | 아니요 | 아니요 | 아니요 |
| CompositionNineGridBrush | 예 | 예 | 예 | 아니요 |
| CompositionBackdropBrush | 예 | 아니요 | 아니요 | 아니요 |
XAML Brush와 CompositionBrush 사용 비교
다음 표는 애플리케이션에서 UIElement 또는 SpriteVisual을 그릴 때 XAML 또는 컴퍼지션 브러시 사용이 규정되었는지 여부가 표시된 시나리오 목록입니다.
참고 항목
XAML UIElement에 대해 CompositionBrush가 제안된 경우 CompositionBrush가 XamlCompositionBrushBase를 사용하여 패키징된 것으로 간주됩니다.
관련 항목
BeginDraw 및 EndDraw를 사용하여 컴퍼지션 네이티브 DirectX 및 Direct2D 상호 운용
피드백
출시 예정: 2024년 내내 콘텐츠에 대한 피드백 메커니즘으로 GitHub 문제를 단계적으로 폐지하고 이를 새로운 피드백 시스템으로 바꿀 예정입니다. 자세한 내용은 다음을 참조하세요. https://aka.ms/ContentUserFeedback
다음에 대한 사용자 의견 제출 및 보기