【Openxml】将Openxml的椭圆弧线arcTo转为Svg的椭圆弧线

  • A+
所属分类:.NET技术
摘要

本文将介绍如何将OpenXml的actTo转为Svg的弧线(a)首先下面是一段OpenXml的arcTo弧线

本文将介绍如何将OpenXml的actTo转为Svg的弧线(a)

OpenXml的artTo

首先下面是一段OpenXml的arcTo弧线

<arcTo wR="152403" hR="152403" stAng="cd4" swAng="-5400000" /> 

假设我们当前的点是(0,0),这时候我们已知的信息如下:

  • 当前点坐标:(x1,y1)=(0,0)
  • 椭圆的半径:半长轴 rx=wR=152403,半短轴 ry=hR=152403
  • 起始角到结束角的夹角:起始角θ1=stAng=cd4,夹角Δθ=swAng,结束角θ2=θ1+Δθ
  • 是否优(大)弧:fA=|Δθ|>Π(180°)
  • 顺逆时针:fS=|Δθ|>0°

目前Svg的椭圆弧线参数字符串为以下:

a  rx  ry  x-axis-rotation  large-arc-flag  sweep-flag  x  y  

其中涉及到的参数:

参数 说明 备注
rx 椭圆半长轴 已知:rx=wR=152403
ry 椭圆半短轴 已知:ry=hR=152403
x-axis-rotation 椭圆相对于坐标系的旋转角度,角度数而非弧度数 已知:0
large-arc-flag 是否优(大)弧:0否,1是 已知:fA=|Δθ|>Π(180°)
sweep-flag 绘制方向:0逆时针,1顺时针 已知:fS=|Δθ|>0°
x 圆弧终点的x坐标 未知
y 圆弧终点的y坐标 未知

因此实际上,我们需要求出的则是圆弧终点坐标就能够完成最终换算到Svg椭圆弧线字符串了

求椭圆弧上任意一点的二维矩阵方程式

以下是我从W3C的SVG官方文档中获取到的关于椭圆任意一点的二维矩阵方程式:

【Openxml】将Openxml的椭圆弧线arcTo转为Svg的椭圆弧线

因此的存在以下两个(开始点和终点)椭圆任意一点的二维矩阵方程式:

【Openxml】将Openxml的椭圆弧线arcTo转为Svg的椭圆弧线

其中涉及到的参数:

参数 说明 备注
(x1,y1) 当前坐标 已知:(0,0)
(x2,y2) 终点坐标 未知
φ 椭圆相对于坐标系的旋转角度 已知:0°
θ1 起始角 已知:stAng
Δθ 起始角到结束角的夹角 已知:swAng
(cx,cy) 椭圆中心坐标点 未知
fA 是否优(大)弧 已知:fA=|Δθ|>Π(180°)
fS 绘制方向 已知:fS=Δθ>0°

因此推导公式如下:

步骤1:

因为开始点的椭圆任意一点的二维矩阵方程式为

【Openxml】将Openxml的椭圆弧线arcTo转为Svg的椭圆弧线

所以能够得出两行一列矩阵CxCy为:

【Openxml】将Openxml的椭圆弧线arcTo转为Svg的椭圆弧线

步骤2:

因为终点的椭圆任意一点的二维矩阵方程式为

【Openxml】将Openxml的椭圆弧线arcTo转为Svg的椭圆弧线

因此将矩阵CxCy带入到终点点的椭圆任意一点的二维矩阵方程式:

【Openxml】将Openxml的椭圆弧线arcTo转为Svg的椭圆弧线

代码部分

在写代码之前,我们需要安装一些所需要用到的库,Openxml单位换算为Pixel的库和矩阵运算用到的库:

通过nuget包的控制台执行以下命令:

Openxml单位换算库

Install-Package dotnetCampus.OpenXmlUnitConverter -Version 1.5.1 

矩阵运算库

Install-Package MathNet.Numerics -Version 5.0.0-alpha02 

然后正式开始我们的代码,我们通过WPF应用窗体来展示效果:

前端xaml代码:

<Window x:Class="OpenxmlActToSvgSample.MainWindow"         xmlns="http://schemas.microsoft.com/winfx/2006/xaml/presentation"         xmlns:x="http://schemas.microsoft.com/winfx/2006/xaml"         xmlns:d="http://schemas.microsoft.com/expression/blend/2008"         xmlns:mc="http://schemas.openxmlformats.org/markup-compatibility/2006"         xmlns:local="clr-namespace:OpenxmlActToSvgSample"         mc:Ignorable="d"         Title="MainWindow" Height="450" Width="800">     <Grid>         <Path x:Name="Path" Stroke="Blue" HorizontalAlignment="Center" VerticalAlignment="Center"/>     </Grid> </Window> 

后端cs代码:

        public MainWindow()         {             InitializeComponent();              //Openxml的360° circle             const double c = 21600000d;             //circle divide 4             var cd4 = c / 4;              //<arcTo wR="152403" hR="152403" stAng="cd4" swAng="-5400000" />             var wR = 152403;             var hR = 152403;             var stAng = cd4;             var swAng = -5400000d;              StringBuilder stringPath=new StringBuilder();             var currentPoint=new Point(0, 0);             stringPath.Append($"M {currentPoint.X} {currentPoint.Y}");              ParseOpenxmlArcTo(stringPath, wR, hR, stAng, swAng, currentPoint);             this.Path.Data=Geometry.Parse(stringPath.ToString());         }            private Point  ParseOpenxmlArcTo(StringBuilder stringPath, double wR, double hR, double stAng, double swAng, Point currentPoint)         {             const string comma = ",";              //将Openxml的角度转为真实的角度             var θ1 = new Angle((int)stAng).ToRadiansValue();             var Δθ = new Angle((int)swAng).ToRadiansValue();             //旋转角             var φ = 0d;             //是否是大弧             var isLargeArcFlag = Math.Abs(Δθ) > Math.PI;             //是否是顺时针             var isClockwise = Δθ > 0;              var rx = new Emu(wR).ToPixel().Value;             var ry = new Emu(hR).ToPixel().Value;              //获取终点坐标             var pt = GetArBitraryPoint(rx, ry, swAng, stAng, φ, currentPoint);              currentPoint = pt;              // 格式如下             // A rx ry x-axis-rotation large-arc-flag sweep-flag x y             // 这里 large-arc-flag 是 1 和 0 表示             stringPath.Append("A")                    .Append(rx) //rx                    .Append(comma)                    .Append(ry) //ry                    .Append(comma)                    .Append(φ) // x-axis-rotation                    .Append(comma)                    .Append(isLargeArcFlag ? "1" : "0") //large-arc-flag                    .Append(comma)                    .Append(isClockwise ? "1" : "0") // sweep-flag                    .Append(comma)                    .Append(pt.X)                    .Append(comma)                    .Append(pt.Y)                    .Append(' ');             return currentPoint;          }           /// <summary>         /// 获取椭圆任意一点坐标         /// </summary>         /// <returns></returns>         private static Point GetArBitraryPoint(double rx, double ry, double Δθ, double θ1, double φ, Point currentPoint)         {             //开始点的椭圆任意一点的二维矩阵方程式             var matrixX1Y1 = DenseMatrix.OfArray(new double[2, 1]             {                 { currentPoint.X},                 { currentPoint.Y}             });              var matrix1 = DenseMatrix.OfArray(new double[2, 2]             {             { Math.Cos(φ),-Math.Sin(φ)},             { Math.Sin(φ),Math.Cos(φ)}             });             var matrix2 = DenseMatrix.OfArray(new double[2, 1]             {                 { rx*Math.Cos(θ1)},                 { ry*Math.Sin(θ1)}             });             var matrixCxCy = matrixX1Y1 - (matrix1 * matrix2);              //终点的椭圆任意一点的二维矩阵方程式             var matrix3 = DenseMatrix.OfArray(new double[2, 1]             {                 { rx*Math.Cos(θ1+Δθ)},                 { ry*Math.Sin(θ1+Δθ)}             });              var matrixX2Y2 = matrix1 * matrix3 + matrixCxCy;              return new Point(matrixX2Y2.Values[0], matrixX2Y2.Values[1]);          } 

效果如下:

【Openxml】将Openxml的椭圆弧线arcTo转为Svg的椭圆弧线

可以看到,我们成功的绘制出我们的一条椭圆弧线,虽然很简单,但是其实这条弧线是我取ppt形状缺角矩形当中的一条弧线,在绘制其形状时候,上述方法会自动根据arcTo的数据来自动判断弧线的大小弧、顺逆时针等情况的绘制

【Openxml】将Openxml的椭圆弧线arcTo转为Svg的椭圆弧线

源码

BlogCodeSample/OpenxmlActToSvgSample at main · ZhengDaoWang/BlogCodeSample

参考

Implementation Notes — SVG 2

【OpenXml】Pptx的形状转为WPF的Geometry - RyzenAdorer - 博客园

dotnet OpenXML SDK 形状几何 Geometry 的计算公式含义