Flutter几何计算插件superdeclarative_geometry的使用

superdeclarative_geometry 是一个强大的Flutter插件，提供了对角度、极坐标及相关数学运算的一流支持。本文将介绍如何在Flutter项目中使用这个插件，并提供完整的示例代码。

快速入门

首先，在您的 pubspec.yaml 文件中添加 superdeclarative_geometry 依赖：

dependencies:
  superdeclarative_geometry: ^[VERSION]

请将 [VERSION] 替换为最新版本号。您可以在 pub.dev 上查看最新版本。

角度（Angles）

创建和操作角度

您可以从度数或弧度创建角度：

import 'package:superdeclarative_geometry/geometry.dart';

final degreesToRadians = Angle.fromDegrees(45);
final radiansToDegrees = Angle.fromRadians(pi / 4);

获取角度值：

print(degreesToRadians.degrees); // 输出 45.0
print(radiansToDegrees.radians); // 输出 π/4

判断角度的方向并强制其为正或负：

print(degreesToRadians.isPositive); // true
degreesToRadians.makeNegative();    // -45°

判断角度类别：

print(degreesToRadians.isAcute);    // true
print(degreesToRadians.category);   // Acute

比较两个角度是否等价：

print(Angle.fromDegrees(90).isEquivalentTo(Angle.fromDegrees(-270))); // true

进行角度的基本运算：

print(-Angle.fromDegrees(30));               // -30°
print(Angle.fromDegrees(30) + Angle.fromDegrees(15)); // 45°
print(Angle.fromDegrees(30) - Angle.fromDegrees(15)); // 15°
print(Angle.fromDegrees(45) * 2);            // 90°
print(Angle.fromDegrees(90) / 2);            // 45°

旋转角度：

final rotation = Angle.fromDegrees(30).rotate(Angle.fromDegrees(150));
print(rotation.degrees); // 180°

旋转（Rotations）

对于超出 (-360°, 360°) 范围的角度，可以使用 Rotation 类来表示：

final rotation = Rotation.fromDegrees(540);
print(rotation.degrees); // 540°

将旋转转换为角度：

print(Rotation.fromDegrees(540).reduceToAngle().degrees); // 180°

极坐标（Polar Coordinates）

定义极坐标：

final polarCoord = PolarCoord(100, Angle.fromDegrees(45));
print(polarCoord.toCartesian()); // 输出 (70.71, 70.71)

或者通过笛卡尔点定义：

final cartesianPolar = CartesianPolarCoords.fromPoint(Point(0, 100));

进行极坐标的运算：

final result = PolarCoord(100, Angle.fromDegrees(45)) + PolarCoord(200, Angle.fromDegrees(135));
print(result.radius); // 300
print(result.angle.degrees); // 90°

笛卡尔方向（Cartesian Orientations）

不同的应用场景对角度有不同的处理方式。superdeclarative_geometry 支持多种笛卡尔方向映射：

final polarCoord = PolarCoord(100, Angle.fromDegrees(30));

// 默认屏幕方向
final screenPoint = polarCoord.toCartesian();

// 数学方向
final mathPoint = polarCoord.toCartesian(orientation: CartesianOrientation.math);

// 导航方向
final navigationPoint = polarCoord.toCartesian(orientation: CartesianOrientation.navigation);

示例应用

以下是一个简单的Flutter应用示例，展示如何使用 superdeclarative_geometry 插件：

import 'package:flutter/material.dart';
import 'package:superdeclarative_geometry/geometry.dart';

void main() {
  runApp(MyApp());
}

class MyApp extends StatelessWidget {
  @override
  Widget build(BuildContext context) {
    return MaterialApp(
      title: 'Geometry Demo',
      theme: ThemeData(
        primarySwatch: Colors.blue,
      ),
      home: MyHomePage(),
    );
  }
}

class MyHomePage extends StatefulWidget {
  @override
  _MyHomePageState createState() => _MyHomePageState();
}

class _MyHomePageState extends State<MyHomePage> {
  @override
  Widget build(BuildContext context) {
    final angle = Angle.fromDegrees(45);
    final rotation = Rotation.fromDegrees(540);
    final polarCoord = PolarCoord(100, Angle.fromDegrees(45));

    return Scaffold(
      appBar: AppBar(
        title: Text('Geometry Demo'),
      ),
      body: Center(
        child: Column(
          mainAxisAlignment: MainAxisAlignment.center,
          children: <Widget>[
            Text('Angle in Degrees: ${angle.degrees}'),
            Text('Rotation in Degrees: ${rotation.degrees}'),
            Text('Polar Coord to Cartesian: (${polarCoord.toCartesian().x}, ${polarCoord.toCartesian().y})'),
          ],
        ),
      ),
    );
  }
}

以上代码展示了如何创建角度、旋转和极坐标，并将其映射到笛卡尔坐标系中。希望这些内容能帮助您更好地理解和使用 superdeclarative_geometry 插件。如果您觉得这个插件有价值，请考虑支持开发者！