SKPaint クラス

定義

public class SKPaint : SkiaSharp.SKObject

継承

Object

SKNativeObject

SKObject

SKPaint

例

簡単な例

次の例は、それぞれ異なるスタイルで描画するように設定された 3 つの異なるペイントを示しています。 呼び出し元は、これらのペイントをそのまま使用するか、図面の進行に合わせて変更することで、これらのペイントを自由に混在させることができます。

var info = new SKImageInfo(256, 256);
using (var surface = SKSurface.Create(info)) {
    SKCanvas canvas = surface.Canvas;

    canvas.Clear(SKColors.White);

    using var font = new SKFont { Size = 64.0f };
    using var scaledFont = new SKFont { Size = 64.0f, ScaleX = 1.5f };

    using var paint1 = new SKPaint {
        IsAntialias = true,
        Color = new SKColor(255, 0, 0),
        Style = SKPaintStyle.Fill
    };

    using var paint2 = new SKPaint {
        IsAntialias = true,
        Color = new SKColor(0, 136, 0),
        Style = SKPaintStyle.Stroke,
        StrokeWidth = 3
    };

    using var paint3 = new SKPaint {
        IsAntialias = true,
        Color = new SKColor(136, 136, 136)
    };

    var text = "Skia!";
    canvas.DrawText(text, 20.0f, 64.0f, SKTextAlign.Left, font, paint1);
    canvas.DrawText(text, 20.0f, 144.0f, SKTextAlign.Left, font, paint2);
    canvas.DrawText(text, 20.0f, 224.0f, SKTextAlign.Left, scaledFont, paint3);
}

上記の例では、次の結果が生成されます。

効果の例

次の例では、単一の色ではなくグラデーションを使用して描画します。 これを行うには、 SKShader がペイントに割り当てられます。 そのペイントで描画されたものはすべて、 SKShader.CreateLinearGradientの呼び出しで指定されたグラデーションで描画されます。

var info = new SKImageInfo(256, 256);
using (var surface = SKSurface.Create(info)) {
    SKCanvas canvas = surface.Canvas;

    canvas.Clear(SKColors.White);

    // create a gradient
    var colors = new[] {
        SKColors.Blue,
        SKColors.Yellow
    };
    var shader = SKShader.CreateLinearGradient(
        new SKPoint(0.0f, 0.0f),
        new SKPoint(256.0f, 256.0f),
        colors,
        null,
        SKShaderTileMode.Clamp);

    // assign the gradient to the paint
    var paint = new SKPaint {
        Shader = shader
    };

    canvas.DrawPaint(paint);
}

上記の例では、次の結果が生成されます。

注釈

SkiaSharp で何かを描画し、その色、背景とのブレンド方法、描画するスタイルやフォントを指定する場合は、それらの属性をペイントで指定します。

SKCanvasとは異なり、ペイント オブジェクトは状態の内部スタックを維持しません。 つまり、ペイントに保存/復元はありません。 ただし、ペイント オブジェクトは比較的軽量であるため、クライアントは任意の数のペイント オブジェクトを作成して維持できます。各オブジェクトは特定の用途に合わせて設定されます。

これらの色とスタイルの属性をすべてキャンバス状態から (複数の) ペイント オブジェクトに分解すると、マトリックスとクリップの設定のスタックを維持する必要があるため、 SKCanvas の保存および復元操作をはるかに効率的にすることができます。

エフェクツ

色、ストローク、テキスト値などの単純な属性以外にも、ペイントは効果をサポートします。 これらは描画パイプラインのさまざまな側面のサブクラスであり、描画パイプラインの一部をオーバーライドするために描画パイプラインによって参照される場合に呼び出されます。

ペイント オブジェクトに割り当てることができる効果には、次の 5 種類があります。