spire-presentation 10.6.4__py3-none-win_amd64.whl → 10.7.1__py3-none-win_amd64.whl

spire/presentation/{ColorScheme.py → drawing/ColorScheme.py}

@@ -8,17 +8,18 @@ import abc
 
 class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
     """
-    <summary>
-        Represents a color scheme, which is a set of eight colors used for the different elements of a slide, notes page, or handout, such as the title or background.
-    </summary>
+    Represents a color scheme with eight colors used for different slide elements.
     """
 
     def get_Item(self ,index:'ColorSchemeIndex')->'ColorFormat':
         """
-    <summary>
-        Gets the element at the specified index.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+        Gets color by index from the scheme.
+
+        Args:
+            index (ColorSchemeIndex): Color index in scheme.
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         enumindex:c_int = index.value
 
@@ -32,7 +33,13 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Equals(self ,obj:'SpireObject')->bool:
         """
+        Determines if two color schemes are equal.
 
+        Args:
+            obj (SpireObject): Scheme to compare.
+
+        Returns:
+            bool: True if schemes are equal.
         """
         intPtrobj:c_void_p = obj.Ptr
 
@@ -45,10 +52,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Dark1(self)->'ColorFormat':
         """
-    <summary>
         First dark color in the scheme.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_Dark1.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Dark1.restype=c_void_p
@@ -61,10 +68,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Light1(self)->'ColorFormat':
         """
-    <summary>
         First light color in the scheme.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_Light1.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Light1.restype=c_void_p
@@ -77,10 +84,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Dark2(self)->'ColorFormat':
         """
-    <summary>
         Second dark color in the scheme.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_Dark2.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Dark2.restype=c_void_p
@@ -93,10 +100,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Light2(self)->'ColorFormat':
         """
-    <summary>
         Second light color in the scheme.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_Light2.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Light2.restype=c_void_p
@@ -109,10 +116,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Accent1(self)->'ColorFormat':
         """
-    <summary>
         First accent color in the scheme.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_Accent1.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Accent1.restype=c_void_p
@@ -125,10 +132,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Accent2(self)->'ColorFormat':
         """
-    <summary>
         Second accent color in the scheme.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_Accent2.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Accent2.restype=c_void_p
@@ -141,10 +148,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Accent3(self)->'ColorFormat':
         """
-    <summary>
         Third accent color in the scheme.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_Accent3.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Accent3.restype=c_void_p
@@ -157,10 +164,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Accent4(self)->'ColorFormat':
         """
-    <summary>
         Fourth accent color in the scheme.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_Accent4.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Accent4.restype=c_void_p
@@ -173,10 +180,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Accent5(self)->'ColorFormat':
         """
-    <summary>
         Fifth accent color in the scheme.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_Accent5.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Accent5.restype=c_void_p
@@ -189,10 +196,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Accent6(self)->'ColorFormat':
         """
-    <summary>
         Sixth accent color in the scheme.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_Accent6.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Accent6.restype=c_void_p
@@ -205,10 +212,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def HyperlinkColor(self)->'ColorFormat':
         """
-    <summary>
-        Color for the hyperlinks.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+        Color for hyperlinks.
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_HyperlinkColor.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_HyperlinkColor.restype=c_void_p
@@ -221,10 +228,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def FollowedHyperlink(self)->'ColorFormat':
         """
-    <summary>
-        Color for the visited hyperlinks.
-            Read-only <see cref="T:Spire.Presentation.Drawing.ColorFormat" />.
-    </summary>
+        Color for visited hyperlinks.
+
+        Returns:
+            ColorFormat: Read-only color format.
         """
         GetDllLibPpt().ColorScheme_get_FollowedHyperlink.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_FollowedHyperlink.restype=c_void_p
@@ -237,10 +244,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Slide(self)->'ActiveSlide':
         """
-    <summary>
-        Gets the parent slide.
-            Read-only <see cref="T:Spire.Presentation.ActiveSlide" />.
-    </summary>
+        Parent slide of the color scheme.
+
+        Returns:
+            ActiveSlide: Read-only slide reference.
         """
         GetDllLibPpt().ColorScheme_get_Slide.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Slide.restype=c_void_p
@@ -253,7 +260,10 @@ class ColorScheme (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Presentation(self)->'Presentation':
         """
+        Parent presentation of the color scheme.
 
+        Returns:
+            Presentation: Read-only presentation reference.
         """
         GetDllLibPpt().ColorScheme_get_Presentation.argtypes=[c_void_p]
         GetDllLibPpt().ColorScheme_get_Presentation.restype=c_void_p

spire/presentation/{ColorSchemeIndex.py → drawing/ColorSchemeIndex.py}

@@ -8,9 +8,7 @@ import abc
 
 class ColorSchemeIndex(Enum):
     """
-    <summary>
-        Represents an index in a colorscheme.
-    </summary>
+    Represents color indexes in a color scheme.
     """
     Dark1 = 0
     Light1 = 1

spire/presentation/drawing/ColorType.py

@@ -0,0 +1,27 @@
+from enum import Enum
+from plum import dispatch
+from typing import TypeVar,Union,Generic,List,Tuple
+from spire.presentation.common import *
+from spire.presentation import *
+from ctypes import *
+import abc
+
+class ColorType(Enum):
+    """
+    Specifies the type of color representation in a presentation.
+    
+    Attributes:
+        none: Represents an undefined color type.
+        RGB: Color defined by Red, Green, Blue components.
+        HSL: Color defined by Hue, Saturation, Luminance components.
+        Scheme: Color from the presentation's theme scheme.
+        System: System-defined color (OS-level color definitions).
+        KnownColor: Predefined named colors from a known colors list.
+    """
+    none = -1
+    RGB = 0
+    HSL = 1
+    Scheme = 3
+    System = 4
+    KnownColor = 5
+

spire/presentation/{EffectDag.py → drawing/EffectDag.py}

@@ -8,17 +8,18 @@ import abc
 
 class EffectDag (  PptObject, IActiveSlide, IActivePresentation) :
     """
-    <summary>
-        Represents effect properties of shape.
-    </summary>
+    Represents effect properties of shape.
+    
+    This class provides access to various visual effects that can be applied to shapes.
     """
     @property
 
     def BlendEffect(self)->'BlendEffect':
         """
-    <summary>
-        Blur effect.
-    </summary>
+        Gets or sets the blend effect.
+        
+        Returns:
+            BlendEffect: The blend effect object.
         """
         GetDllLibPpt().EffectDag_get_BlendEffect.argtypes=[c_void_p]
         GetDllLibPpt().EffectDag_get_BlendEffect.restype=c_void_p
@@ -36,9 +37,10 @@ class EffectDag (  PptObject, IActiveSlide, IActivePresentation) :
 
     def FillOverlayEffect(self)->'FillOverlayEffect':
         """
-    <summary>
-        Fill overlay effect.
-    </summary>
+        Gets or sets the fill overlay effect.
+        
+        Returns:
+            FillOverlayEffect: The fill overlay effect object.
         """
         GetDllLibPpt().EffectDag_get_FillOverlayEffect.argtypes=[c_void_p]
         GetDllLibPpt().EffectDag_get_FillOverlayEffect.restype=c_void_p
@@ -56,9 +58,10 @@ class EffectDag (  PptObject, IActiveSlide, IActivePresentation) :
 
     def GlowEffect(self)->'GlowEffect':
         """
-    <summary>
-        Glow effect.
-    </summary>
+        Gets or sets the glow effect.
+        
+        Returns:
+            GlowEffect: The glow effect object.
         """
         GetDllLibPpt().EffectDag_get_GlowEffect.argtypes=[c_void_p]
         GetDllLibPpt().EffectDag_get_GlowEffect.restype=c_void_p
@@ -76,9 +79,10 @@ class EffectDag (  PptObject, IActiveSlide, IActivePresentation) :
 
     def InnerShadowEffect(self)->'InnerShadowEffect':
         """
-    <summary>
-        Inner shadow.
-    </summary>
+        Gets or sets the inner shadow effect.
+        
+        Returns:
+            InnerShadowEffect: The inner shadow effect object.
         """
         GetDllLibPpt().EffectDag_get_InnerShadowEffect.argtypes=[c_void_p]
         GetDllLibPpt().EffectDag_get_InnerShadowEffect.restype=c_void_p
@@ -96,9 +100,10 @@ class EffectDag (  PptObject, IActiveSlide, IActivePresentation) :
 
     def OuterShadowEffect(self)->'OuterShadowEffect':
         """
-    <summary>
-        Outer shadow.
-    </summary>
+        Gets or sets the outer shadow effect.
+        
+        Returns:
+            OuterShadowEffect: The outer shadow effect object.
         """
         GetDllLibPpt().EffectDag_get_OuterShadowEffect.argtypes=[c_void_p]
         GetDllLibPpt().EffectDag_get_OuterShadowEffect.restype=c_void_p
@@ -116,9 +121,10 @@ class EffectDag (  PptObject, IActiveSlide, IActivePresentation) :
 
     def PresetShadowEffect(self)->'PresetShadow':
         """
-    <summary>
-        Preset shadow.
-    </summary>
+        Gets or sets the preset shadow effect.
+        
+        Returns:
+            PresetShadow: The preset shadow effect object.
         """
         GetDllLibPpt().EffectDag_get_PresetShadowEffect.argtypes=[c_void_p]
         GetDllLibPpt().EffectDag_get_PresetShadowEffect.restype=c_void_p
@@ -136,9 +142,10 @@ class EffectDag (  PptObject, IActiveSlide, IActivePresentation) :
 
     def ReflectionEffect(self)->'ReflectionEffect':
         """
-    <summary>
-        Reflection. 
-    </summary>
+        Gets or sets the reflection effect.
+        
+        Returns:
+            ReflectionEffect: The reflection effect object.
         """
         GetDllLibPpt().EffectDag_get_ReflectionEffect.argtypes=[c_void_p]
         GetDllLibPpt().EffectDag_get_ReflectionEffect.restype=c_void_p
@@ -156,9 +163,10 @@ class EffectDag (  PptObject, IActiveSlide, IActivePresentation) :
 
     def SoftEdgeEffect(self)->'SoftEdgeEffect':
         """
-    <summary>
-        Soft edge.
-    </summary>
+        Gets or sets the soft edge effect.
+        
+        Returns:
+            SoftEdgeEffect: The soft edge effect object.
         """
         GetDllLibPpt().EffectDag_get_SoftEdgeEffect.argtypes=[c_void_p]
         GetDllLibPpt().EffectDag_get_SoftEdgeEffect.restype=c_void_p
@@ -175,7 +183,13 @@ class EffectDag (  PptObject, IActiveSlide, IActivePresentation) :
 
     def Equals(self ,obj:'SpireObject')->bool:
         """
+        Determines if the current EffectDag is equal to another object.
 
+        Args:
+            obj: The object to compare with the current object
+
+        Returns:
+            bool: True if the specified object is equal to the current object; otherwise, False
         """
         intPtrobj:c_void_p = obj.Ptr
 

spire/presentation/drawing/EffectFillType.py

@@ -0,0 +1,25 @@
+from enum import Enum
+from plum import dispatch
+from typing import TypeVar,Union,Generic,List,Tuple
+from spire.presentation.common import *
+from spire.presentation import *
+from ctypes import *
+import abc
+
+class EffectFillType(Enum):
+    """
+    Specifies types of fill effects that can be applied to presentation elements.
+    
+    Attributes:
+        none: No fill effect applied.
+        Remove: Fill effect that removes existing fills.
+        Freeze: Fill effect that freezes the current appearance.
+        Hold: Fill effect that maintains the current state.
+        Transition: Fill effect used during state transitions.
+    """
+    none = -1
+    Remove = 0
+    Freeze = 1
+    Hold = 2
+    Transition = 3
+

spire/presentation/{EffectNode.py → drawing/EffectNode.py}

@@ -8,7 +8,6 @@ import abc
 
 class EffectNode (SpireObject) :
     """
-    <summary>
-        Base class for immutable objects, which represent effect.
-    </summary>
+    Base class for immutable objects, which represent effect.
+    
     """

spire/presentation/{EffectStyle.py → drawing/EffectStyle.py}

@@ -8,18 +8,17 @@ import abc
 
 class EffectStyle (SpireObject) :
     """
-    <summary>
-        Represents an effect style.
-    </summary>
+    Represents an effect style that can be applied to presentation elements.
+    
+    Attributes:
+        EffectDag (EffectDag): Gets the effect format settings (read-only).
+        FormatThreeDFormat (FormatThreeD): Gets the 3D format settings (read-only).
     """
     @property
 
     def EffectDag(self)->'EffectDag':
         """
-    <summary>
-        Gets an effect format.
-            Readonly <see cref="P:Spire.Presentation.Drawing.EffectStyle.EffectDag" />.
-    </summary>
+        Gets the effect format settings for this style.
         """
         GetDllLibPpt().EffectStyle_get_EffectDag.argtypes=[c_void_p]
         GetDllLibPpt().EffectStyle_get_EffectDag.restype=c_void_p
@@ -32,10 +31,7 @@ class EffectStyle (SpireObject) :
 
     def FormatThreeDFormat(self)->'FormatThreeD':
         """
-    <summary>
-        Gets an 3d format.
-            Readonly <see cref="T:Spire.Presentation.Drawing.FormatThreeD" />.
-    </summary>
+        Gets the 3D format settings for this style.
         """
         GetDllLibPpt().EffectStyle_get_FormatThreeDFormat.argtypes=[c_void_p]
         GetDllLibPpt().EffectStyle_get_FormatThreeDFormat.restype=c_void_p
@@ -47,7 +43,13 @@ class EffectStyle (SpireObject) :
 
     def Equals(self ,obj:'SpireObject')->bool:
         """
-
+        Determines whether the current EffectStyle is equal to another object.
+        
+        Args:
+            obj: The object to compare with the current EffectStyle.
+            
+        Returns:
+            bool: True if the specified object is equal to the current EffectStyle; otherwise, False.
         """
         intPtrobj:c_void_p = obj.Ptr
 

spire/presentation/{ExtensionList.py → drawing/ExtensionList.py}

@@ -8,11 +8,14 @@ import abc
 
 class ExtensionList (SpireObject) :
     """
-
+    Manages extension data for presentation elements (internal use).
     """
     @property
     def IsEmpty(self)->bool:
         """
+        Indicates whether the extension list contains any data.
+        Returns:
+            True if the list is empty; otherwise, False.
 
         """
         GetDllLibPpt().ExtensionList_get_IsEmpty.argtypes=[c_void_p]