[FTD #4] support circle for multi lines text, updated images

example/lib/screens/examples/box_example_screen.dart

@@ -56,7 +56,7 @@ class BoxExampleScreen extends StatelessWidget {
               TextDecorator.boxed(
                 style: BoxStyle.curled,
                 text: const Text(
-                  'Curcled Box',
+                  'Curled Box',
                   style: TextStyle(fontSize: 16),
                 ),
                 strokeWidth: 2,

example/lib/screens/examples/circle_example_screen.dart

@@ -23,18 +23,34 @@ class CircleExampleScreen extends StatelessWidget {
                 ),
               ),
               const SizedBox(height: 32),
+              Padding(
+                padding: const EdgeInsets.symmetric(horizontal: 30.0),
+                child: TextDecorator.circled(
+                  style: CircleStyle.basic,
+                  text: const Text(
+                    'Franz jagt im komplett verwahrlosten Taxi quer durch Berlin',
+                    style: TextStyle(fontSize: 16),
+                    textAlign: TextAlign.center,
+                  ),
+                ),
+              ),
+              const SizedBox(height: 64),
               TextDecorator.circled(
                 text: const Text(
                   'Circled Text',
                   style: TextStyle(fontSize: 32),
                 ),
               ),
               const SizedBox(height: 32),
-              TextDecorator.circled(
-                style: CircleStyle.basic,
-                text: const Text(
-                  'Franz jagt im komplett verwahrlosten Taxi quer durch Berlin',
-                  style: TextStyle(fontSize: 16),
+              Padding(
+                padding: const EdgeInsets.symmetric(horizontal: 30.0),
+                child: TextDecorator.circled(
+                  style: CircleStyle.circled,
+                  text: const Text(
+                    'Franz jagt im komplett verwahrlosten Taxi quer durch Berlin',
+                    style: TextStyle(fontSize: 16),
+                    textAlign: TextAlign.center,
+                  ),
                 ),
               ),
             ],

lib/src/modules/circle/classes/circle_angle_option.dart

@@ -0,0 +1,47 @@
+// ignore_for_file: public_member_api_docs, sort_constructors_first
+import 'dart:math';
+
+import 'package:flutter_text_decorator/src/modules/circle/painter/open_circle_painter.dart';
+
+/// Defines a set of angles for rendering an "open circle" decoration.
+///
+/// This class encapsulates the start and sweep angles for two arcs
+/// (typically one for the bottom part of the circle and one for the top part)
+/// that together form an open or stylized circle.
+///
+/// It provides `const` factories for predefined angle configurations,
+/// such as `bottomLeft()` or `topLeft()`, which can be used with
+/// [OpenCirclePainter] to specify the orientation of the circle's opening.
+/// Instances of this class are immutable.
+class CircleAngleOption {
+  const CircleAngleOption({
+    required this.startAngleBottomCircle,
+    required this.sweepAngleBottomCircle,
+    required this.startAngleTopCircle,
+    required this.sweepAngleTopCircle,
+  });
+
+  const factory CircleAngleOption.bottomLeft() = _BottomLeftCircleAngleOption;
+
+  /// The starting angle for the bottom arc, in radians.
+  final double startAngleBottomCircle;
+
+  /// The sweep angle for the bottom arc, in radians.
+  final double sweepAngleBottomCircle;
+
+  /// The starting angle for the top arc, in radians.
+  final double startAngleTopCircle;
+
+  /// The sweep angle for the top arc, in radians.
+  final double sweepAngleTopCircle;
+}
+
+class _BottomLeftCircleAngleOption extends CircleAngleOption {
+  const _BottomLeftCircleAngleOption()
+      : super(
+          startAngleBottomCircle: -1.5 + pi,
+          sweepAngleBottomCircle: pi + 1.5,
+          startAngleTopCircle: (pi + 6.2) + pi,
+          sweepAngleTopCircle: pi - 1,
+        );
+}

lib/src/modules/circle/mixins/circle_mixin.dart

@@ -1,4 +1,5 @@
 import 'package:flutter/material.dart';
+import 'package:flutter/widgets.dart';
 import 'package:flutter_text_decorator/src/modules/circle/classes/circle_size.dart';
 
 /// A mixin that provides a utility method to calculate dimensions
@@ -19,12 +20,13 @@ mixin CircleConstraints {
   CircleSize getCircleSizes({
     required String text,
     required TextStyle textStyle,
+    required Size size,
   }) {
     final textSpan = TextSpan(text: text, style: textStyle);
     final textPainter = TextPainter(
       text: textSpan,
       textDirection: TextDirection.ltr,
-    )..layout();
+    )..layout(maxWidth: size.width);
 
     const textHeightOffset = 2;
     const textWidthScale = 1.8;

lib/src/modules/circle/painter/closed_circle_painter.dart

@@ -43,11 +43,10 @@ class ClosedCirclePainter extends TextDecoratorPainter with CircleConstraints {
       ..strokeWidth = decoration.strokeWidth
       ..style = PaintingStyle.stroke;
 
-    final circleSize = getCircleSizes(text: text, textStyle: textStyle);
+    final circleSize = getCircleSizes(text: text, textStyle: textStyle, size: size);
 
-    final scaledHorizontalRadius = circleSize.horizontalRadius * 2.1;
-    final scaledVerticalRadiusBottomCircle = circleSize.verticalRadius * 2.9;
-    const verticalOffset = 1.8;
+    final scaledVerticalRadiusBottomCircle = circleSize.verticalRadius * 3.5;
+    const verticalOffset = 2.5;
 
     final centerOffset = Offset(
       size.width / 2,
@@ -57,7 +56,7 @@ class ClosedCirclePainter extends TextDecoratorPainter with CircleConstraints {
     canvas.drawOval(
       Rect.fromCenter(
         center: centerOffset,
-        width: scaledHorizontalRadius,
+        width: size.width * 1.1,
         height: scaledVerticalRadiusBottomCircle,
       ),
       paint,

lib/src/modules/circle/painter/open_circle_painter.dart

@@ -1,7 +1,7 @@
-import 'dart:math';
 import 'package:flutter/material.dart';
 import 'package:flutter_text_decorator/src/modules/base/decoration_base.dart';
 import 'package:flutter_text_decorator/src/modules/base/text_decoration_painter.dart';
+import 'package:flutter_text_decorator/src/modules/circle/classes/circle_angle_option.dart';
 import 'package:flutter_text_decorator/src/modules/circle/mixins/circle_mixin.dart';
 
 /// A [CustomPainter] that draws an "open circle" decoration around text.
@@ -35,25 +35,27 @@ class OpenCirclePainter extends TextDecoratorPainter with CircleConstraints {
     required super.text,
     required super.textStyle,
     required super.decoration,
+    this.circleAngleOption = const CircleAngleOption.bottomLeft(),
   }) : assert(text != '' && decoration.strokeWidth > 0, 'text should not be empty and decoration.strokeWidth should be greater than 0');
 
+  /// Defines the start and sweep angles for the two arcs forming the open circle.
+  ///
+  /// Defaults to [CircleAngleOption.bottomLeft] if not specified.
+  final CircleAngleOption circleAngleOption;
+
   @override
   void paint(Canvas canvas, Size size) {
     final paint = Paint()
       ..color = decoration.color
       ..strokeWidth = decoration.strokeWidth
       ..style = PaintingStyle.stroke;
 
-    final circleSize = getCircleSizes(text: text, textStyle: textStyle);
+    final circleSize = getCircleSizes(text: text, textStyle: textStyle, size: size);
 
-    final scaledHorizontalRadius = circleSize.horizontalRadius * 2.1;
-    final scaledVerticalRadiusBottomCircle = circleSize.verticalRadius * 2.9;
+    final scaledHorizontalRadius = circleSize.horizontalRadius * 2;
+    final scaledVerticalRadiusBottomCircle = circleSize.verticalRadius * 3;
     final scaledVerticalRadiusTopCircle = circleSize.verticalRadius * 3.5;
     const verticalOffset = 1.8;
-    const startAngleBottomCircle = -1.5;
-    const sweepAngleBottomCircle = pi + 1.5;
-    const startAngleTopCircle = pi + 6.2;
-    const sweepAngleTopCircle = pi - 1;
 
     final centerOffset = Offset(
       size.width / 2,
@@ -67,8 +69,8 @@ class OpenCirclePainter extends TextDecoratorPainter with CircleConstraints {
           width: scaledHorizontalRadius,
           height: scaledVerticalRadiusBottomCircle,
         ),
-        startAngleBottomCircle,
-        sweepAngleBottomCircle,
+        circleAngleOption.startAngleBottomCircle,
+        circleAngleOption.sweepAngleBottomCircle,
         false,
         paint,
       )
@@ -78,15 +80,21 @@ class OpenCirclePainter extends TextDecoratorPainter with CircleConstraints {
           width: scaledHorizontalRadius,
           height: scaledVerticalRadiusTopCircle,
         ),
-        startAngleTopCircle,
-        sweepAngleTopCircle,
+        circleAngleOption.startAngleTopCircle,
+        circleAngleOption.sweepAngleTopCircle,
         false,
         paint,
       );
   }
 
   @override
   bool shouldRepaint(covariant CustomPainter oldDelegate) {
-    return false;
+    if (oldDelegate is OpenCirclePainter) {
+      return oldDelegate.circleAngleOption.startAngleBottomCircle != circleAngleOption.startAngleBottomCircle ||
+          oldDelegate.circleAngleOption.sweepAngleBottomCircle != circleAngleOption.sweepAngleBottomCircle ||
+          oldDelegate.circleAngleOption.startAngleTopCircle != circleAngleOption.startAngleTopCircle ||
+          oldDelegate.circleAngleOption.sweepAngleTopCircle != circleAngleOption.sweepAngleTopCircle;
+    }
+    return true; // Repaint if the delegate type changes or for other unknown reasons
   }
 }