Рисование простого круга в SkiaSharpDrawing a Simple Circle in SkiaSharp

• 03/10/2017
• Чтение занимает 4 мин

Скачать пример Download the sample

Изучите основы рисования SkiaSharp, включая холсты и объекты PaintLearn the basics of SkiaSharp drawing, including canvases and paint objects

В этой статье рассматриваются основные понятия рисования графики в Xamarin.Forms с помощью SkiaSharp, включая создание SKCanvasView объекта для размещения графики, обработку PaintSurface события и использование SKPaint объекта для указания цвета и других атрибутов рисования.This article introduces the concepts of drawing graphics in Xamarin.Forms using SkiaSharp, including creating an SKCanvasView object to host the graphics, handling the PaintSurface event, and using a SKPaint object to specify color and other drawing attributes.

Программа скиашарпформсдемос содержит весь пример кода для этой серии статей SkiaSharp.The SkiaSharpFormsDemos program contains all the sample code for this series of SkiaSharp articles. Первая страница имеет право на простой круг и вызывает класс страницы SimpleCirclePage .The first page is entitled Simple Circle and invokes the page class SimpleCirclePage. В этом коде показано, как нарисовать окружность в центре страницы с радиусом 100 пикселей.This code shows how to draw a circle in the center of the page with a radius of 100 pixels. Контур окружности красного цвета, а внутренняя часть окружности — синим.The outline of the circle is red, and the interior of the circle is blue.

SimpleCircleКласс Page является производным от ContentPage и содержит две using директивы для пространств имен SkiaSharp:The SimpleCircle page class derives from ContentPage and contains two using directives for the SkiaSharp namespaces:

using SkiaSharp;using SkiaSharp.Views.Forms;

Следующий конструктор класса создает SKCanvasView объект, присоединяет обработчик для PaintSurface события и задает SKCanvasView объект в качестве содержимого страницы:The following constructor of the class creates an SKCanvasView object, attaches a handler for the PaintSurface event, and sets the SKCanvasView object as the content of the page:

public SimpleCirclePage(){    Title = "Simple Circle";    SKCanvasView canvasView = new SKCanvasView();    canvasView.PaintSurface += OnCanvasViewPaintSurface;    Content = canvasView;}

Объект SKCanvasView занимает всю область содержимого страницы.The SKCanvasView occupies the entire content area of the page. Можно также объединить SKCanvasView с другими Xamarin.Forms View производными, как показано в других примерах.You can alternatively combine an SKCanvasView with other Xamarin.Forms View derivatives, as you'll see in other examples.

PaintSurfaceОбработчик событий выполняет все действия по рисованию.The PaintSurface event handler is where you do all your drawing. Этот метод можно вызывать несколько раз во время выполнения программы, поэтому он должен поддерживать всю информацию, необходимую для воссоздания графики.This method can be called multiple times while your program is running, so it should maintain all the information necessary to recreate the graphics display:

void OnCanvasViewPaintSurface(object sender, SKPaintSurfaceEventArgs args){    ...}

SKPaintSurfaceEventArgsОбъект, сопровождающий событие, имеет два свойства:The SKPaintSurfaceEventArgs object that accompanies the event has two properties:

SKImageInfoСтруктура содержит сведения о поверхности рисования, что самое важное, ширину и высоту в пикселях.The SKImageInfo structure contains information about the drawing surface, most importantly, its width and height in pixels. SKSurfaceОбъект представляет саму поверхность рисования.The SKSurface object represents the drawing surface itself. В этой программе поверхность рисования является видеоизображением, но в других программах SKSurface объект может также представлять точечный рисунок, который используется SkiaSharp для рисования.In this program, the drawing surface is a video display, but in other programs an SKSurface object can also represent a bitmap that you use SkiaSharp to draw on.

Наиболее важным свойством для SKSurface является Canvas тип SKCanvas .The most important property of SKSurface is Canvas of type SKCanvas. Этот класс является контекстом графического рисования, который используется для выполнения фактического рисования.This class is a graphics drawing context that you use to perform the actual drawing. SKCanvasОбъект инкапсулирует состояние графики, которое включает преобразования графики и обрезание.The SKCanvas object encapsulates a graphics state, which includes graphics transforms and clipping.

Ниже приведен типичный запуск PaintSurface обработчика событий.Here's a typical start of a PaintSurface event handler:

void OnCanvasViewPaintSurface(object sender, SKPaintSurfaceEventArgs args){    SKImageInfo info = args.Info;    SKSurface surface = args.Surface;    SKCanvas canvas = surface.Canvas;    canvas.Clear();    ...}

ClearМетод очищает холст с прозрачным цветом.The Clear method clears the canvas with a transparent color. Перегрузка позволяет указать цвет фона для холста.An overload lets you specify a background color for the canvas.

Цель этой задачи — нарисовать красный круг, заполненный синим.The goal here is to draw a red circle filled with blue. Так как это конкретное графическое изображение содержит два разных цвета, задание должно выполняться в два этапа.Because this particular graphic image contains two different colors, the job needs to be done in two steps. Первым шагом является рисование контура окружности.The first step is to draw the outline of the circle. Чтобы указать цвет и другие характеристики линии, создайте и инициализируйте SKPaint объект:To specify the color and other characteristic of the line, you create and initialize an SKPaint object:

void OnCanvasViewPaintSurface(object sender, SKPaintSurfaceEventArgs args){    ...    SKPaint paint = new SKPaint    {        Style = SKPaintStyle.Stroke,        Color = Color.Red.ToSKColor(),        StrokeWidth = 25    };    ...}

StyleСвойство указывает, что требуется Обводка линии (в данном случае контура окружности), а не заливки внутренней.The Style property indicates that you want to stroke a line (in this case the outline of the circle) rather than fill the interior. SKPaintStyleНиже приведены три члена перечисления.The three members of the SKPaintStyle enumeration are as follows:

Значение по умолчанию — Fill.The default is Fill. Используйте третий параметр для обводки линии и заполнения внутренней области тем же цветом.Use the third option to stroke the line and fill the interior with the same color.

Присвойте Color свойству значение типа SKColor .Set the Color property to a value of type SKColor. Одним из способов получения SKColor значения является преобразование Xamarin.Forms Color значения в SKColor значение с помощью метода расширения ToSKColor .One way to get an SKColor value is by converting a Xamarin.Forms Color value to an SKColor value using the extension method ToSKColor. ExtensionsКласс в SkiaSharp.Views.Forms пространстве имен включает другие методы, которые преобразуют Xamarin.Forms значения и SkiaSharp значения.The Extensions class in the SkiaSharp.Views.Forms namespace includes other methods that convert between Xamarin.Forms values and SkiaSharp values.

StrokeWidthСвойство указывает толщину линии.The StrokeWidth property indicates the thickness of the line. Здесь устанавливается значение 25 пикселей.Here it's set to 25 pixels.

Этот объект используется SKPaint для рисования окружности:You use that SKPaint object to draw the circle:

void OnCanvasViewPaintSurface(object sender, SKPaintSurfaceEventArgs args){    ...    canvas.DrawCircle(info.Width / 2, info.Height / 2, 100, paint);    ...}

Координаты задаются относительно левого верхнего угла отображаемой поверхности.Coordinates are specified relative to the upper-left corner of the display surface. Координаты X увеличиваются вправо, а координаты Y увеличиваются.X coordinates increase to the right and Y coordinates increase going down. В обсуждении о графике часто используется математическая нотация (x, y) для обозначения точки.In discussion about graphics, often the mathematical notation (x, y) is used to denote a point. Точка (0, 0) является верхним левым углом отображаемой поверхности и часто называется источником.The point (0, 0) is the upper-left corner of the display surface and is often called the origin.

Первые два аргумента DrawCircle указывают координаты X и Y центра окружности.The first two arguments of DrawCircle indicate the X and Y coordinates of the center of the circle. Они назначаются в половину ширины и высоты поверхности отображения, чтобы разместить центр окружности в центре поверхности отображения.These are assigned to half the width and height of the display surface to put the center of the circle in the center of the display surface. Третий аргумент задает радиус окружности, а последний аргумент — SKPaint объект.The third argument specifies the circle's radius, and the last argument is the SKPaint object.

Чтобы заполнить внутреннюю часть круга, можно изменить два свойства SKPaint объекта и вызвать метод DrawCircle еще раз.To fill the interior of the circle, you can alter two properties of the SKPaint object and call DrawCircle again. Этот код также показывает альтернативный способ получения SKColor значения из одного из многих полей SKColors структуры:This code also shows an alternative way to get an SKColor value from one of the many fields of the SKColors structure:

void OnCanvasViewPaintSurface(object sender, SKPaintSurfaceEventArgs args){    ...    paint.Style = SKPaintStyle.Fill;    paint.Color = SKColors.Blue;    canvas.DrawCircle(args.Info.Width / 2, args.Info.Height / 2, 100, paint);}

На этот раз DrawCircle вызов заполняет круг с помощью новых свойств SKPaint объекта.This time, the DrawCircle call fills the circle using the new properties of the SKPaint object.

Вот программа, выполняемая в iOS и Android:Here's the program running on iOS and Android:

При самостоятельном запуске программы можно превратить телефон или симулятор в сторону, чтобы увидеть, как изображение перерисовывается.When running the program yourself, you can turn the phone or simulator sideways to see how the graphic is redrawn. Каждый раз, когда необходимо перерисовать график, PaintSurface обработчик событий вызывается снова.Each time the graphic needs to be redrawn, the PaintSurface event handler is called again.

Также можно окрасить графические объекты с помощью градиентов или растровых элементов.It's also possible to color graphical objects with gradients or bitmap tiles. Эти параметры обсуждаются в разделе SkiaSharp шейдеры.These options are discussed in the section on SkiaSharp shaders.

SKPaintОбъект немного больше, чем коллекция свойств графического рисунка.An SKPaint object is little more than a collection of graphics drawing properties. Эти объекты являются легковесными.These objects are lightweight. Можно повторно использовать SKPaint объекты, как это делает программа, или можно создать несколько SKPaint объектов для различных сочетаний свойств рисования.You can reuse SKPaint objects as this program does, or you can create multiple SKPaint objects for various combinations of drawing properties. Вы можете создавать и инициализировать эти объекты за пределами PaintSurface обработчика событий, а также сохранять их в качестве полей в классе страницы.You can create and initialize these objects outside of the PaintSurface event handler, and you can save them as fields in your page class.

Примечание

SKPaintКласс определяет, IsAntialias чтобы включить сглаживание в отрисовке графики.The SKPaint class defines an IsAntialias to enable anti-aliasing in the rendering of your graphics. Сглаживание обычно приводит к визуально более гладким краям, поэтому вам, вероятно, потребуется задать это свойство true в большинстве SKPaint объектов.Anti-aliasing generally results in visually smoother edges, so you'll probably want to set this property to true in most of your SKPaint objects. В целях простоты это свойство не задано в большинстве примеров страниц.For purposes of simplicity, this property is not set in most of the sample pages.

Несмотря на то, что ширина контура окружности равна 25 пикселям — или одному кварталу радиуса круга — , она выглядит более тонкой, и есть веская причина: половина ширины линии скрыта синим кружком.Although the width of the circle's outline is specified as 25 pixels — or one-quarter of the radius of the circle — it appears to be thinner, and there's a good reason for that: Half the width of the line is obscured by the blue circle. Аргументы DrawCircle метода определяют абстрактные геометрические координаты окружности.The arguments to the DrawCircle method define the abstract geometric coordinates of a circle. Размер синей внутренней части изменяется до ближайшего пикселя, но 25-пиксельный контур охватывает геометрический круг — половины внутри и половины снаружи.The blue interior is sized to that dimension to the nearest pixel, but the 25-pixel-wide outline straddles the geometric circle — half on the inside and half on the outside.

Следующий пример в разделе Интеграция с Xamarin.Forms этой статьей демонстрирует визуальную визуализацию.The next sample in the Integrating with Xamarin.Forms article demonstrates this visually.