패키지, 저장소 및 앱 카테고리 검색

patterns_canvas 표지
패키지 상세v0.6.0

patterns_canvas

캔버스 요소 또는 위젯에 줄무늬나 점 패턴을 그립니다.

AndroidiOSWebmacOSWindowsLinux
30일 다운로드
2.3만
좋아요
116
Pub 점수
160

패키지 설치

flutter pub add patterns_canvas

패키지 개요

공개 정보를 바탕으로 생성한 선택 가이드입니다.

캔버스 요소나 위젯에 스트라이프, 도트, 격자와 같은 사용자 정의 가능한 패턴을 생성할 수 있는 플러터 패키지입니다. 디자인과 미학에 중점을 둔 앱에서 장식용 배경, 텍스처 또는 시각적 효과를 추가하는 데 이상적입니다. 안드로이드, iOS, 웹, macOS, 윈도우, 리눅스 등 여러 플랫폼을 지원하여 크로스플랫폼 개발에 유연하게 활용할 수 있습니다. 간단한 API를 통해 개발자는 UI 컴포넌트에 패턴 렌더링을 쉽게 통합할 수 있습니다.

사용 사례

  • 질감 있는 배경 만들기
  • 사용자 정의 UI 요소 설계
  • 장식적 오버레이 추가
  • 반복 패턴 생성
  • 셰이더를 사용한 앱 시각 효과 향상
  • 예술적 인터페이스 구축

주요 기능

  • 스트라이프, 점, 그리드 패턴을 지원합니다
  • 크로스 플랫폼 호환성
  • Canvas 및 Widgets와의 간편한 통합
  • 사용자 지정 가능한 패턴 크기 및 색상
  • 고성능 렌더링
  • 확장 가능한 패턴 정의

적합한 대상

  • 시각적 다양성을 찾는 UI 디자이너
  • 예술적 또는 창의적인 앱을 개발하는 개발자
  • 동적 배경 효과가 필요한 앱
  • 그림 그리기 및 페인팅에 중점을 둔 프로젝트
  • 다중 플랫폼 디자인에 종사하는 팀

고려 사항

  • 복잡한 패턴과 함께 성능에 영향을 미칠 수 있습니다
  • Canvas 렌더링에 대한 이해가 필요합니다
  • 패턴 기반 그래픽에 한정
  • 고정밀 벡터 그래픽에 적합하지 않음
  • 최적의 렌더링 전략과 함께 사용하는 것이 가장 좋습니다

원본 README

연결된 소스 저장소의 README 원문 스냅샷입니다. 최신 내용은 저장소에서 확인하세요.

Patterns

Flutter library to draw patterns like stripes or dots on Canvas elements or widgets.

patterns_canvas Pub Version

A utility library that lets you paint Canvas shapes or widgets with patterns like dots, stripes, squares, etc.:

       

Simple Example

Inside your CustomPainter class's paint method, create a Pattern class with background (bgColor) and foreground (fgColor) colors and use one of its paintOn methods:

class MyPainter extends CustomPainter {
  @override
  void paint(Canvas canvas, Size size) {
  
    // Prepare a rectangle shape to draw the pattern on.
    final rect = Rect.fromLTWH(80, 50, 200, 100);
    
    // Create a Pattern object of diagonal stripes with the colors we want.
    final Pattern pattern = DiagonalStripesThick(bgColor: Colors.lightGreenAccent, fgColor: Colors.black);
    
    // Paint the pattern on the rectangle. 
    pattern.paintOnRect(canvas, size, rect);
    
  }
}

Results in this pattern drawn:

Pattern constructors and types:

You can construct a Pattern with three different ways:

  1. Directly with a Pattern type constructor:
final Pattern p1 = DiagonalStripesLight(bgColor: Colors.yellowAccent, fgColor: Colors.black);
  1. With the Pattern.fromValues factory constructor:
final Pattern p2 = Pattern.fromValues(patternType: PatternType.diagonalLight, bgColor: Colors.yellowAccent, fgColor: Colors.black);
  1. From a String representation in the form of patternType_backgroundHex_foregroundHex:
final Pattern p3 = Pattern.fromString("diagonalLight_ffff00_000000");

Usage

Painting patterns on a Canvas shape:
  • Create your Canvas element inside the paint function of your CustomPaint.
  • Create a Pattern object with the desired type and colors.
  • Use the corresponding paint method to draw the pattern on the object.
// In the build method of your screen:
...
body: Center(
    child: CustomPaint(
      size: const Size(double.infinity, double.infinity),
      painter: MyPainter(),
    ),
  ),
...

// In your CustomPainter:
class MyPainter extends CustomPainter {
  @override
  void paint(Canvas canvas, Size size) {
  
    final rect = Rect.fromLTWH(80, 50, 200, 100);
    DiagonalStripesLight(bgColor: Colors.lightGreenAccent, fgColor: Colors.black).paintOnRect(canvas, size, rect);
    
    final path = Path();
    path.moveTo(120, 200);
    path.lineTo(300, 280);
    path.quadraticBezierTo(20, 400, 40, 300);
    path.close();
    Crosshatch(bgColor: Colors.yellow, fgColor: Colors.black).paintOnPath(canvas, size, path);
    
  }
}

You can use the below methods to draw on Canvas shapes:

pattern.paintOnPath(canvas, size, path);
pattern.paintOnRect(canvas, size, rect);
pattern.paintOnRRect(canvas, size, rRect);
pattern.paintOnCircle(canvas, size, center, radius);

Check the Scale behavior setting section for more info on how the Pattern can be drawn.

Painting patterns on the whole Canvas:

As above, but you can use the paintOnCanvas method to draw the pattern on the whole Canvas:

TexturePattern(bgColor: Colors.white, fgColor: Colors.blueGrey).paintOnCanvas(canvas, size);

The result of the above paints:

Painting patterns on a Widget:

To draw patterns on a Widget, you need to:

  • Wrap the Widget with a CustomPaint:
CustomPaint(
  painter: ContainerPatternPainter(),
  child: Container(
    width: 600,
    height: 200,
    child: Center(
      child: Text("Painting on a Container"),
    ),
  ),
),
  • Inside your CustomPainter, create a Pattern and use its paintOnWidget method to paint with it:
class ContainerPatternPainter extends CustomPainter {
  @override
  void paint(Canvas canvas, Size size) {
    VerticalStripesThick(bgColor: Color(0xff0509050), fgColor: Color(0xfffdbf6f)).paintOnWidget(canvas, size);
  }

  @override
  bool shouldRepaint(CustomPainter oldDelegate) => true;
}

Rectangular widgets, like Containers, Rows, Columns, IconButtons, etc. can be painted directly with the above method. For widgets that have a custom shape, like a BottomAppbar, you need to provide a different clipBehavior property, e.g. Clip.antiAlias, to make sure the pattern is clipped to the special shape. Check the second screen in the example app for more.

Patterns and settings

Available patterns

All Patterns require a background and foreground color on instantiation. The currently available patterns are:

Description Class PatternType enum
Horizontal Stripes Light HorizontalStripesLight(Color bgColor, Color fgColor) PatternType.horizontalLight
Horizontal Stripes Thick HorizontalStripesThick(Color bgColor, Color fgColor) PatternType.horizontalThick
Vertical Stripes Light VerticalStripesLight(Color bgColor, Color fgColor) PatternType.verticalLight
Vertical Stripes Thick VerticalStripesThick(Color bgColor, Color fgColor) PatternType.verticalThick
Diagonal Stripes Light DiagonalStripesLight(Color bgColor, Color fgColor) PatternType.diagonalLight
Diagonal Stripes Thick DiagonalStripesThick(Color bgColor, Color fgColor) PatternType.diagonalThick
Checkers Checkers(Color bgColor, Color fgColor) PatternType.checkers
Crosshatch Crosshatch(Color bgColor, Color fgColor) PatternType.crosshatch
Dots Dots(Color bgColor, Color fgColor) PatternType.dots
Raindrops Raindrops(Color bgColor, Color fgColor) PatternType.raindrops
Subtle Patch SubtlePatch(Color bgColor, Color fgColor) PatternType.subtlepatch
Texture TexturePattern(Color bgColor, Color fgColor) PatternType.texture
Setting the number of pattern features to draw

You can pass a featuresCount argument when creating a Pattern, to set how many features, e.g. how many stripes, you want to be drawn.

DiagonalStripesThick(bgColor: bgColor, fgColor: fgColor, featuresCount: 40).paintOnRect(canvas, size, rect1);
Dots(bgColor: bgColor, fgColor: fgColor, featuresCount: 5).paintOnRect(canvas, size, rect2);
Scale behavior setting

All patterns are by default scaled to their container (patternScaleBehavior = PatternScaleBehavior.container). This means that, regardless of its size, a Rectangle will contain 15 diagonal stripes or 10 dots.

DiagonalStripesThick(bgColor: bgColor, fgColor: fgColor).paintOnRect(canvas, size, rect1);
Dots(bgColor: bgColor, fgColor: fgColor).paintOnRect(canvas, size, rect2);

You can change this behavior by providing a different argument to the paintOn method:

Pass patternScaleBehavior: PatternScaleBehavior.canvas to scale the pattern to the whole Canvas area. Now the Canvas will contain 15 diagonal stripes or 10 dots, so, a Rectangle will contain as many dots or stripes as it can fit:

DiagonalStripesThick(bgColor: bgColor, fgColor: fgColor).paintOnRect(canvas, size, rect1, patternScaleBehavior: PatternScaleBehavior.canvas);
Dots(bgColor: bgColor, fgColor: fgColor).paintOnRect(canvas, size, rect2, patternScaleBehavior: PatternScaleBehavior.canvas);

Pass patternScaleBehavior: PatternScaleBehavior.customRect and a customRect (e.g. a Rectangle with half the Canvas height) to further customize the Pattern size:

final Rect halfCanvas = Rect.fromLTWH(0, size.height / 2, size.width, size.height / 2); // a Rectangle with half the Canvas height.
DiagonalStripesThick(bgColor: bgColor, fgColor: fgColor).paintOnRect(canvas, size, rect1, patternScaleBehavior: PatternScaleBehavior.customRect, customRect: halfCanvas );
Dots(bgColor: bgColor, fgColor: fgColor).paintOnRect(canvas, size, rect2, patternScaleBehavior: PatternScaleBehavior.customRect, customRect: halfCanvas );

카테고리

소스 저장소

이 패키지를 사용하는 프로젝트

순위