Skip to content

README.md

Latest commit

 

History

History
61 lines (45 loc) · 3.98 KB

README.md

File metadata and controls

61 lines (45 loc) · 3.98 KB
Raw

Draw Shapes With ImageSharp

This sample generates four composed scenes using the DrawingCanvas API. Each scene renders to an Image<Rgba32> and writes a PNG file under the sample's artifacts output directory.

Samples

01-poster-composition.png

Poster-style landscape that exercises the building blocks:

  • LinearGradientBrush and RadialGradientBrush for the sky, lake, and sun.
  • PathBuilder + CloseFigure for the mountain ridges, lake, and shoreline.
  • canvas.Save() plus canvas.Clip(IPath) for the lake highlight clip.
  • canvas.Save + canvas.SaveLayer to apply a Z rotation and then composite the title panel and text together with GraphicsOptions.BlendPercentage.
  • TextMeasurer.MeasureRenderableBounds to size the title panel to the laid-out text.

02-transit-map.png

Transit-map style scene focusing on stroke styling and labels:

  • A reference grid drawn with Pens.Solid plus a translucent colour.
  • Three route lines using SolidPen with StrokeOptions { LineCap = Round, LineJoin = Round } so corners and ends stay smooth across multi-segment polylines.
  • Pens.Dash for a walking-transfer line.
  • Station markers as filled-then-stroked EllipsePolygon instances.
  • One-off labels with RichTextOptions { Origin = ... }.

03-typography.png

Typography sheet covering the rich-text surface:

  • A header that mixes a headlineFont and a bodyFont in one paragraph by way of RichTextRun.
  • A "Rich runs" panel where each run targets a grapheme range computed dynamically with string.GetGraphemeCount() so the runs survive copy edits without re-numbering.
  • A "Wrapping and measurement" panel that wraps text with WrappingLength and uses TextMeasurer.MeasureRenderableBounds (advance ∪ ink) to size a callout that never clips.
  • A "Bidi and fallback" panel mixing Latin, Arabic, and Hebrew with FallbackFontFamilies = [ArabicFontFamily].
  • A "Vertical mixed layout" panel using LayoutMode.VerticalMixedRightLeft for traditional Korean vertical typography with sideways Latin and digit runs.
  • Curve text drawn with the explicit canvas.DrawText(options, text, bezier, brush, pen) path overload and WrappingLength = bezier.ComputeLength().

04-image-processing-mask.png

Image-compositing scene demonstrating four ways a photograph (tests/Images/Input/Jpg/baseline/Lake.jpg, linked into this project via Content Include) interacts with an IPath:

  • Before / after wipe — canvas.Apply(rightHalfRect, ctx => ctx.OilPaint(15, 5)) scopes an OilPaint processor to the right half of the photograph.
  • Privacy redaction — canvas.Apply(ellipse, ctx => ctx.Pixelate(10)) pixelates an elliptical face-shaped region and leaves the rest untouched.
  • Image as a brush — new ImageBrush<Rgba32>(source, source.Bounds, brushOffset) wraps the photograph as a Brush so a StarPolygon path can be filled with it as a texture; the brush offset aligns the mountain in the photograph with the star's centre.
  • Photo in text — TextBuilder.GeneratePaths("MASK", ...) produces one IPath per glyph; canvas.Clip(glyphPaths) uses them as a compound clip so DrawImage only renders inside the letterforms.

Running

dotnet run --project samples/DrawShapesWithImageSharp -c Release

Output PNGs are written to artifacts/bin/samples/DrawShapesWithImageSharp/<configuration>/<target-framework>/Output/.

Fonts and image assets

The csproj links four fonts and one JPEG from the test fixtures:

Asset Source Used by
OpenSans-Regular.ttf tests/ImageSharp.Drawing.Tests/TestFonts/ text bodies, transit labels
WendyOne-Regular.ttf tests/ImageSharp.Drawing.Tests/TestFonts/ display headings, glyph mask
me_quran_volt_newmet.ttf tests/ImageSharp.Drawing.Tests/TestFonts/ Arabic fallback in the bidi panel
NotoSansKR-Regular.otf tests/ImageSharp.Drawing.Tests/TestFonts/ Korean vertical-layout panel
Lake.jpg tests/Images/Input/Jpg/baseline/ masking sample source photograph