Add NoiseStyle and NoiseFilter support with animation binding and SVG export

include/pagx/nodes/LayerFilter.h

@@ -23,7 +23,8 @@
 namespace pagx {
 
 /**
- * Base class for layer filters (BlurFilter, DropShadowFilter, InnerShadowFilter, BlendFilter, ColorMatrixFilter).
+ * Base class for layer filters (BlurFilter, DropShadowFilter, InnerShadowFilter, BlendFilter,
+ * ColorMatrixFilter, NoiseFilter).
  */
 class LayerFilter : public Node {
  public:

include/pagx/nodes/LayerStyle.h

@@ -24,7 +24,7 @@
 namespace pagx {
 
 /**
- * Base class for layer styles (DropShadowStyle, InnerShadowStyle, BackgroundBlurStyle).
+ * Base class for layer styles (DropShadowStyle, InnerShadowStyle, BackgroundBlurStyle, NoiseStyle).
  */
 class LayerStyle : public Node {
  public:

include/pagx/nodes/Node.h

@@ -117,6 +117,10 @@ enum class NodeType {
    * A background blur layer style.
    */
   BackgroundBlurStyle,
+  /**
+   * A noise layer style.
+   */
+  NoiseStyle,
 
   // Layer Filters
   /**
@@ -139,6 +143,10 @@ enum class NodeType {
    * A color matrix filter.
    */
   ColorMatrixFilter,
+  /**
+   * A noise filter.
+   */
+  NoiseFilter,
 
   // Elements (geometry, painters, modifiers, containers)
   /**

include/pagx/nodes/NoiseFilter.h

@@ -0,0 +1,97 @@
+/////////////////////////////////////////////////////////////////////////////////////////////////
+//
+//  Tencent is pleased to support the open source community by making libpag available.
+//
+//  Copyright (C) 2026 Tencent. All rights reserved.
+//
+//  Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
+//  except in compliance with the License. You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+//  unless required by applicable law or agreed to in writing, software distributed under the
+//  license is distributed on an "as is" basis, without warranties or conditions of any kind,
+//  either express or implied. see the license for the specific language governing permissions
+//  and limitations under the license.
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////
+
+#pragma once
+
+#include "pagx/nodes/LayerFilter.h"
+#include "pagx/types/BlendMode.h"
+#include "pagx/types/Color.h"
+#include "pagx/types/NoiseMode.h"
+
+namespace pagx {
+
+/**
+ * A noise filter that overlays procedural Perlin noise on the layer. Three noise modes are
+ * available: Mono (single color), Duo (two complementary colors), and Multi (preserving original
+ * noise RGB with enhanced contrast). Mode-specific fields for inactive modes are ignored; set the
+ * fields for the new mode after changing mode.
+ */
+class NoiseFilter : public LayerFilter {
+ public:
+  /**
+   * The noise mode. The default value is Mono.
+   */
+  NoiseMode mode = NoiseMode::Mono;
+
+  /**
+   * The noise grain size. Larger values produce coarser grains. Must be positive. The default value
+   * is 4.0.
+   */
+  float size = 4.0f;
+
+  /**
+   * The noise density in [0, 1]. Controls the proportion of visible noise pixels. The default value
+   * is 0.5.
+   */
+  float density = 0.5f;
+
+  /**
+   * The random seed for the noise pattern. The default value is 0.
+   */
+  float seed = 0.0f;
+
+  /**
+   * The blend mode used to composite the noise with the source image. The default value is Normal.
+   */
+  BlendMode blendMode = BlendMode::Normal;
+
+  /**
+   * The noise color for Mono mode. Ignored by Duo and Multi modes. The alpha component controls the
+   * noise opacity. The default value is black.
+   */
+  Color color = {};
+
+  /**
+   * The first noise color for Duo mode. Ignored by Mono and Multi modes. The alpha component
+   * controls its opacity. The default value is black.
+   */
+  Color firstColor = {};
+
+  /**
+   * The second noise color for Duo mode. Ignored by Mono and Multi modes. The alpha component
+   * controls its opacity. The default value is white.
+   */
+  Color secondColor = {1.0f, 1.0f, 1.0f, 1.0f};
+
+  /**
+   * The overall noise opacity for Multi mode, in [0, 1]. Ignored by Mono and Duo modes. The default
+   * value is 0.15.
+   */
+  float opacity = 0.15f;
+
+  NodeType nodeType() const override {
+    return NodeType::NoiseFilter;
+  }
+
+ private:
+  NoiseFilter() = default;
+
+  friend class PAGXDocument;
+};
+
+}  // namespace pagx

include/pagx/nodes/NoiseStyle.h

@@ -0,0 +1,91 @@
+/////////////////////////////////////////////////////////////////////////////////////////////////
+//
+//  Tencent is pleased to support the open source community by making libpag available.
+//
+//  Copyright (C) 2026 Tencent. All rights reserved.
+//
+//  Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
+//  except in compliance with the License. You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+//  unless required by applicable law or agreed to in writing, software distributed under the
+//  license is distributed on an "as is" basis, without warranties or conditions of any kind,
+//  either express or implied. see the license for the specific language governing permissions
+//  and limitations under the license.
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////
+
+#pragma once
+
+#include "pagx/nodes/LayerStyle.h"
+#include "pagx/types/Color.h"
+#include "pagx/types/NoiseMode.h"
+
+namespace pagx {
+
+/**
+ * A noise layer style that overlays procedural Perlin noise above the layer content. Three noise
+ * modes are available: Mono (single color), Duo (two complementary colors), and Multi (preserving
+ * original noise RGB with enhanced contrast). Mode-specific fields for inactive modes are ignored;
+ * set the fields for the new mode after changing mode.
+ */
+class NoiseStyle : public LayerStyle {
+ public:
+  /**
+   * The noise mode. The default value is Mono.
+   */
+  NoiseMode mode = NoiseMode::Mono;
+
+  /**
+   * The noise grain size. Larger values produce coarser grains. Must be positive. The default value
+   * is 4.0.
+   */
+  float size = 4.0f;
+
+  /**
+   * The noise density in [0, 1]. Controls the proportion of visible noise pixels. The default value
+   * is 0.5.
+   */
+  float density = 0.5f;
+
+  /**
+   * The random seed for the noise pattern. The default value is 0.
+   */
+  float seed = 0.0f;
+
+  /**
+   * The noise color for Mono mode. Ignored by Duo and Multi modes. The alpha component controls the
+   * noise opacity. The default value is black.
+   */
+  Color color = {};
+
+  /**
+   * The first noise color for Duo mode. Ignored by Mono and Multi modes. The alpha component
+   * controls its opacity. The default value is black.
+   */
+  Color firstColor = {};
+
+  /**
+   * The second noise color for Duo mode. Ignored by Mono and Multi modes. The alpha component
+   * controls its opacity. The default value is white.
+   */
+  Color secondColor = {1.0f, 1.0f, 1.0f, 1.0f};
+
+  /**
+   * The overall noise opacity for Multi mode, in [0, 1]. Ignored by Mono and Duo modes. The default
+   * value is 0.15.
+   */
+  float opacity = 0.15f;
+
+  NodeType nodeType() const override {
+    return NodeType::NoiseStyle;
+  }
+
+ private:
+  NoiseStyle() = default;
+
+  friend class PAGXDocument;
+};
+
+}  // namespace pagx

include/pagx/types/NoiseMode.h

@@ -0,0 +1,41 @@
+/////////////////////////////////////////////////////////////////////////////////////////////////
+//
+//  Tencent is pleased to support the open source community by making libpag available.
+//
+//  Copyright (C) 2026 Tencent. All rights reserved.
+//
+//  Licensed under the Apache License, Version 2.0 (the "License"); you may not use this file
+//  except in compliance with the License. You may obtain a copy of the License at
+//
+//      http://www.apache.org/licenses/LICENSE-2.0
+//
+//  unless required by applicable law or agreed to in writing, software distributed under the
+//  license is distributed on an "as is" basis, without warranties or conditions of any kind,
+//  either express or implied. see the license for the specific language governing permissions
+//  and limitations under the license.
+//
+/////////////////////////////////////////////////////////////////////////////////////////////////
+
+#pragma once
+
+namespace pagx {
+
+/**
+ * Noise modes for noise filters and noise layer styles.
+ */
+enum class NoiseMode {
+  /**
+   * Single-color noise. Noise pixels are filled with one color.
+   */
+  Mono,
+  /**
+   * Dual-color noise. The noise source is split into two complementary regions.
+   */
+  Duo,
+  /**
+   * Multi-color noise preserving original Perlin noise RGB with enhanced contrast.
+   */
+  Multi
+};
+
+}  // namespace pagx