FabricJS – 设置 Polygon 对象的 HTMLCanvasElement 的裁剪偏移量

fabricjsjavascripthtml5 canvas更新于 2024/9/14 15:08:17

我们可以通过创建 fabric.Polygon 实例来创建 Polygon 对象。多边形对象的特征可以是任何由一组连接的直线段组成的封闭形状。由于它是 FabricJS 的基本元素之一，我们还可以通过应用角度、不透明度等属性轻松自定义它。

为了将多边形对象转换为 HTMLCanvasElement，我们使用 toCanvasElement 方法。它返回 HTMLCanvasElement 类型的 DOM 元素，该接口从 HTMLElement 接口继承了其属性和方法。我们使用 left 和 top 属性来设置多边形对象的 HTMLCanvasElement 的裁剪偏移量。

语法

toCanvasElement({ left: Number | top: Number }: Object):
HTMLCanvasElement

参数

options(可选) − 此参数接受 Object，它为我们的 HTMLCanvasElement 提供额外的自定义。使用此参数高度、左侧裁剪偏移和许多其他属性可以更改与 HTMLCanvasElement 相关的属性，其中 left 和 top 是属性。

选项键

left − 此属性接受 Number 值，表示裁剪左侧偏移。此属性是可选的。
top − 此属性接受 Number 值，表示裁剪顶部偏移量。此属性是可选的。

示例 1:使用 left 属性

让我们看一个代码示例，以查看当 toCanvasElement 方法与 left 属性一起使用时记录的输出。由于我们向其传递了一个值 100，因此它将用作左侧裁剪偏移量。我们还使用了 toDataURL 方法来显示 left 属性实际上如何影响多边形对象。我们可以从开发工具打开控制台，并在新选项卡中打开 url 字符串以查看输出图像。

<!DOCTYPE html>
<html>
<head>
   <!-- Adding the Fabric JS Library-->
   <script src="https://cdnjs.cloudflare.com/ajax/libs/fabric.js/510/fabric.min.js"></script>
</head>
<body>
   <h2>Using the left property</h2>
   <p>
      You can open console from dev tools, copy the url string and paste it in a new tab to see that the polygon object has been cropped by 100px offset from the left
   </p>
   <canvas id="canvas"></canvas>
   <script>
      
      // 初始化画布实例
      var canvas = new fabric.Canvas("canvas");
      canvas.setWidth(document.body.scrollWidth);
      canvas.setHeight(250);
      
      // 初始化多边形对象
      var polygon = new fabric.Polygon(
         [
            { x: 600, y: 310 },
            { x: 650, y: 450 },
            { x: 600, y: 480 },
            { x: 550, y: 480 },
            { x: 450, y: 460 },
            { x: 300, y: 210 },
         ],
         {
            fill: "#778899",
            stroke: "blue",
            strokeWidth: 5,
            top: 50, 
            left: 100,
            scaleX: 0.5,
            scaleY: 0.5,
         }
      );
      
      // 将其添加到画布
      canvas.add(polygon);
      
      // 使用左键的 toCanvasElement 方法
      var leftCropOffset = polygon.toCanvasElement({
         left: 100,
      });
      
      // 使用 toDataURL 方法
      console.log(leftCropOffset.toDataURL());
   </script>
</body>
</html>

示例 2:使用 top 属性

让我们看一个代码示例，以查看当 toCanvasElement 方法与 top 属性一起使用时记录的输出。由于我们传递了 100 的值，它将用作多边形的顶部裁剪偏移量。

<!DOCTYPE html>
<html>
<head>
   <!-- Adding the Fabric JS Library-->
   <script src="https://cdnjs.cloudflare.com/ajax/libs/fabric.js/510/fabric.min.js"></script>
</head>
<body>
   <h2>Using the top property</h2>
   <p>
      You can open console from dev tools, copy the url string and paste it in a new tab to see that the polygon object has been cropped by 100px offset from the top
   </p>
   <canvas id="canvas"></canvas>
   <script>
      
      // 初始化画布实例
      var canvas = new fabric.Canvas("canvas");
      canvas.setWidth(document.body.scrollWidth);
      canvas.setHeight(250);
      
      // 初始化多边形对象
      var polygon = new fabric.Polygon(
         [
            { x: 600, y: 310 },
            { x: 650, y: 450 },
            { x: 600, y: 480 },
            { x: 550, y: 480 },
            { x: 450, y: 460 },
            { x: 300, y: 210 },
         ],
         {
            fill: "#778899",
            stroke: "blue",
            strokeWidth: 5,
            top: 50,
            left: 100,
            scaleX: 0.5,
            scaleY: 0.5,
         }
      );
      
      // 将其添加到画布
      canvas.add(polygon);
      
      // 使用带有顶部键的 toCanvasElement 方法
      var topCropOffset = polygon.toCanvasElement({
         top: 100, 
      });
      
      // 使用 toDataURL 方法
      console.log(topCropOffset.toDataURL());
   </script>
</body>
</html>