spire-presentation 11.2.0__py3-none-macosx_11_0_arm64.whl

spire/presentation/ShapeAlignment.py

@@ -0,0 +1,34 @@
+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 ShapeAlignment(Enum):
+    """
+    Represents different alignment options for shapes.
+
+    This enumeration provides options for aligning and distributing shapes 
+    within a slide or container.
+
+    Values:
+        AlignLeft: Align shapes to the leftmost position.
+        AlignCenter: Align shapes to the horizontal center.
+        AlignRight: Align shapes to the rightmost position.
+        AlignTop: Align shapes to the topmost position.
+        AlignMiddle: Align shapes to the vertical middle.
+        AlignBottom: Align shapes to the bottom position.
+        DistributeVertically: Distribute shapes evenly along the vertical axis.
+        DistributeHorizontally: Distribute shapes evenly along the horizontal axis.
+    """
+    AlignLeft = 0
+    AlignCenter = 1
+    AlignRight = 2
+    AlignTop = 3
+    AlignMiddle = 4
+    AlignBottom = 5
+    DistributeVertically = 6
+    DistributeHorizontally = 7
+

spire/presentation/ShapeArrange.py

@@ -0,0 +1,26 @@
+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 ShapeArrange(Enum):
+    """
+    Represents arrangement operations for shapes in a z-order stack.
+
+    This enumeration provides options for changing the stacking order
+    of overlapping shapes.
+
+    Attributes:
+        BringToFront: Bring the shape to the front of all other shapes.
+        SendToBack: Send the shape behind all other shapes.
+        BringForward: Move the shape one level forward in the z-order.
+        SendBackward: Move the shape one level backward in the z-order.
+    """
+    BringToFront = 0
+    SendToBack = 1
+    BringForward = 2
+    SendBackward = 3
+

spire/presentation/ShapeBevelStyle.py

@@ -0,0 +1,89 @@
+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 ShapeBevelStyle (SpireObject) :
+    """
+    Contains properties defining 3D bevel effects for shapes.
+
+    This class controls the three-dimensional bevel effects applied to shapes,
+    including width, height, and style presets.
+    """
+    @property
+    def Width(self)->float:
+        """
+        Get or set the bevel width.
+
+        Returns:
+            float: The current bevel width measurement.
+        """
+        GetDllLibPpt().ShapeBevelStyle_get_Width.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeBevelStyle_get_Width.restype=c_double
+        ret = CallCFunction(GetDllLibPpt().ShapeBevelStyle_get_Width,self.Ptr)
+        return ret
+
+    @Width.setter
+    def Width(self, value:float):
+        """
+        Set the bevel width.
+
+        Args:
+            value (float): The new width value to set.
+        """
+        GetDllLibPpt().ShapeBevelStyle_set_Width.argtypes=[c_void_p, c_double]
+        CallCFunction(GetDllLibPpt().ShapeBevelStyle_set_Width,self.Ptr, value)
+
+    @property
+    def Height(self)->float:
+        """
+        Get or set the bevel height.
+
+        Returns:
+            float: The current bevel height measurement.
+        """
+        GetDllLibPpt().ShapeBevelStyle_get_Height.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeBevelStyle_get_Height.restype=c_double
+        ret = CallCFunction(GetDllLibPpt().ShapeBevelStyle_get_Height,self.Ptr)
+        return ret
+
+    @Height.setter
+    def Height(self, value:float):
+        """
+        Set the bevel height.
+
+        Args:
+            value (float): The new height value to set.
+        """
+        GetDllLibPpt().ShapeBevelStyle_set_Height.argtypes=[c_void_p, c_double]
+        CallCFunction(GetDllLibPpt().ShapeBevelStyle_set_Height,self.Ptr, value)
+
+    @property
+
+    def PresetType(self)->'BevelPresetType':
+        """
+        Get or set the bevel style type.
+
+        Returns:
+            BevelPresetType: The current bevel style preset.
+        """
+        GetDllLibPpt().ShapeBevelStyle_get_PresetType.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeBevelStyle_get_PresetType.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().ShapeBevelStyle_get_PresetType,self.Ptr)
+        objwraped = BevelPresetType(ret)
+        return objwraped
+
+    @PresetType.setter
+    def PresetType(self, value:'BevelPresetType'):
+        """
+        Set the bevel style type.
+
+        Args:
+            value (BevelPresetType): The new bevel preset type to apply.
+        """
+        GetDllLibPpt().ShapeBevelStyle_set_PresetType.argtypes=[c_void_p, c_int]
+        CallCFunction(GetDllLibPpt().ShapeBevelStyle_set_PresetType,self.Ptr, value.value)
+

spire/presentation/ShapeCollection.py

@@ -0,0 +1,75 @@
+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 ShapeCollection (  ShapeList) :
+
+    """
+    Represents a collection of shapes in a presentation.
+    """
+
+    def Equals(self ,obj:'SpireObject')->bool:
+        """
+        Determines if this collection is equal to another object.
+        
+        Args:
+            obj: The object to compare with this collection.
+            
+        Returns:
+            bool: True if the objects are equal, False otherwise.
+        """
+        intPtrobj:c_void_p = obj.Ptr
+
+        GetDllLibPpt().ShapeCollection_Equals.argtypes=[c_void_p ,c_void_p]
+        GetDllLibPpt().ShapeCollection_Equals.restype=c_bool
+        ret = CallCFunction(GetDllLibPpt().ShapeCollection_Equals,self.Ptr, intPtrobj)
+        return ret
+
+#
+#    def CopyTo(self ,array:'Array',index:int):
+#        """
+#    <summary>
+#        Copies all elements from the collection to the specified array.
+#    </summary>
+#    <param name="array">Target array.</param>
+#    <param name="index">Starting index in the target array.</param>
+#        """
+#        intPtrarray:c_void_p = array.Ptr
+#
+#        GetDllLibPpt().ShapeCollection_CopyTo.argtypes=[c_void_p ,c_void_p,c_int]
+#        CallCFunction(GetDllLibPpt().ShapeCollection_CopyTo,self.Ptr, intPtrarray,index)
+
+
+    @property
+    def IsSynchronized(self)->bool:
+        """
+        Indicates whether access to the collection is thread-safe.
+        
+        Returns:
+            bool: True if access is synchronized, False otherwise.
+        """
+        GetDllLibPpt().ShapeCollection_get_IsSynchronized.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeCollection_get_IsSynchronized.restype=c_bool
+        ret = CallCFunction(GetDllLibPpt().ShapeCollection_get_IsSynchronized,self.Ptr)
+        return ret
+
+    @property
+
+    def SyncRoot(self)->'SpireObject':
+        """
+        Gets an object that can be used to synchronize access to the collection.
+        
+        Returns:
+            SpireObject: An object used for synchronization.
+        """
+        GetDllLibPpt().ShapeCollection_get_SyncRoot.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeCollection_get_SyncRoot.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeCollection_get_SyncRoot,self.Ptr)
+        ret = None if intPtr==None else SpireObject(intPtr)
+        return ret
+
+

spire/presentation/ShapeElementFillSource.py

@@ -0,0 +1,29 @@
+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 ShapeElementFillSource(Enum):
+    """
+    Specifies how a shape element should be filled.
+    
+    Attributes:
+        NoFill: Element should not be filled.
+        Shape: Inherit fill from parent shape.
+        Lighten: Apply lightened fill effect.
+        LightenLess: Apply less lightened fill effect.
+        Darken: Apply darkened fill effect.
+        DarkenLess: Apply less darkened fill effect.
+        OwnFill: Use element's own fill properties.
+    """
+    NoFill = 0
+    Shape = 1
+    Lighten = 2
+    LightenLess = 3
+    Darken = 4
+    DarkenLess = 5
+    OwnFill = 6
+

spire/presentation/ShapeElementStrokeSource.py

@@ -0,0 +1,21 @@
+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 ShapeElementStrokeSource(Enum):
+    """
+    Specifies how a shape element should be stroked.
+    
+    Attributes:
+        NoStroke: Element should not have an outline.
+        Shape: Inherit stroke from parent shape.
+        OwnStroke: Use element's own stroke properties.
+    """
+    NoStroke = 0
+    Shape = 1
+    OwnStroke = 2
+

spire/presentation/ShapeLocking.py

@@ -0,0 +1,43 @@
+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 ShapeLocking (  SimpleShapeBaseLocking) :
+    """
+    Specifies locking properties for shapes.
+
+    Determines which operations are disabled on parent Autoshape elements,
+    particularly focusing on text editing restrictions.
+    """
+    @property
+    def TextEditingProtection(self)->bool:
+        """
+        Gets or sets text editing restriction status.
+
+        Returns:
+            bool: 
+            True = Editing text is disabled
+            False = Editing text is allowed
+        """
+        GetDllLibPpt().ShapeLocking_get_TextEditingProtection.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeLocking_get_TextEditingProtection.restype=c_bool
+        ret = CallCFunction(GetDllLibPpt().ShapeLocking_get_TextEditingProtection,self.Ptr)
+        return ret
+
+    @TextEditingProtection.setter
+    def TextEditingProtection(self, value:bool):
+        """
+        Sets text editing restriction status.
+
+        Args:
+            value (bool): 
+            True to disable text editing
+            False to allow text editing
+        """
+        GetDllLibPpt().ShapeLocking_set_TextEditingProtection.argtypes=[c_void_p, c_bool]
+        CallCFunction(GetDllLibPpt().ShapeLocking_set_TextEditingProtection,self.Ptr, value)
+

spire/presentation/ShapeNode.py

@@ -0,0 +1,99 @@
+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 ShapeNode (  Shape) :
+    """
+    Represents a node shape in a presentation.
+
+    This class provides access to the styling, type, adjustment points, 
+    and geometric properties of a node-based shape.
+    """
+    @property
+
+    def ShapeStyle(self)->'ShapeStyle':
+        """
+        Gets the style object for the shape.
+
+        Returns:
+            ShapeStyle: The style object defining visual properties of the shape.
+        """
+        GetDllLibPpt().ShapeNode_get_ShapeStyle.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeNode_get_ShapeStyle.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeNode_get_ShapeStyle,self.Ptr)
+        ret = None if intPtr==None else ShapeStyle(intPtr)
+        return ret
+
+
+    @property
+
+    def ShapeType(self)->'ShapeType':
+        """
+        Gets or sets the geometric type of the shape.
+
+        Returns:
+            ShapeType: Enum value representing the shape's geometry type.
+        """
+        GetDllLibPpt().ShapeNode_get_ShapeType.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeNode_get_ShapeType.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().ShapeNode_get_ShapeType,self.Ptr)
+        objwraped = ShapeType(ret)
+        return objwraped
+
+    @ShapeType.setter
+    def ShapeType(self, value:'ShapeType'):
+        GetDllLibPpt().ShapeNode_set_ShapeType.argtypes=[c_void_p, c_int]
+        CallCFunction(GetDllLibPpt().ShapeNode_set_ShapeType,self.Ptr, value.value)
+
+    @property
+
+    def Adjustments(self)->'ShapeAdjustCollection':
+        """
+        Gets the collection of shape adjustment points.
+
+        Returns:
+            ShapeAdjustCollection: Collection of points that adjust the shape's geometry.
+        """
+        GetDllLibPpt().ShapeNode_get_Adjustments.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeNode_get_Adjustments.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeNode_get_Adjustments,self.Ptr)
+        ret = None if intPtr==None else ShapeAdjustCollection(intPtr)
+        return ret
+
+
+
+    def Equals(self ,obj:'SpireObject')->bool:
+        """
+        Determines if this shape is equal to another object.
+
+        Args:
+            obj (SpireObject): The object to compare with.
+
+        Returns:
+            bool: True if objects are equal, False otherwise.
+        """
+        intPtrobj:c_void_p = obj.Ptr
+
+        GetDllLibPpt().ShapeNode_Equals.argtypes=[c_void_p ,c_void_p]
+        GetDllLibPpt().ShapeNode_Equals.restype=c_bool
+        ret = CallCFunction(GetDllLibPpt().ShapeNode_Equals,self.Ptr, intPtrobj)
+        return ret
+    
+    @property
+    def Points(self)->List['PointF']:
+        """
+        Gets the vertex points defining the shape's geometry.
+
+        Returns:
+            List[PointF]: Collection of points that make up the shape's outline.
+        """
+        GetDllLibPpt().ShapeNode_get_Points.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeNode_get_Points.restype=IntPtrArray
+        intPtrArray = CallCFunction(GetDllLibPpt().ShapeNode_get_Points,self.Ptr)
+        ret = GetObjVectorFromArray(intPtrArray, PointF)
+        return ret
+

spire/presentation/ShapeStyle.py

@@ -0,0 +1,221 @@
+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 ShapeStyle (  IActiveSlide, IActivePresentation) :
+    """
+    Represents a shape's style reference.
+
+    Provides access to color formatting, style indexes, and presentation context
+    for various visual aspects of a shape (line, fill, effects, font).
+    """
+    @property
+
+    def LineColor(self)->'ColorFormat':
+        """
+        Gets the outline color of the shape.
+
+        Returns:
+            ColorFormat: Read-only color format object for the shape's outline.
+        """
+        GetDllLibPpt().ShapeStyle_get_LineColor.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeStyle_get_LineColor.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeStyle_get_LineColor,self.Ptr)
+        ret = None if intPtr==None else ColorFormat(intPtr)
+        return ret
+
+
+    @property
+
+    def LineStyleIndex(self)->'UInt16':
+        """
+        Gets or sets the line style index in the style matrix.
+
+        Returns:
+            UInt16: Column index of the line style in theme matrices.
+        """
+        GetDllLibPpt().ShapeStyle_get_LineStyleIndex.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeStyle_get_LineStyleIndex.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeStyle_get_LineStyleIndex,self.Ptr)
+        ret = None if intPtr==None else UInt16(intPtr)
+        return ret
+
+
+    @LineStyleIndex.setter
+    def LineStyleIndex(self, value:'UInt16'):
+        """
+        Sets the line style index in the style matrix.
+
+        Args:
+            value (UInt16): New column index for line style.
+        """
+        GetDllLibPpt().ShapeStyle_set_LineStyleIndex.argtypes=[c_void_p, c_void_p]
+        CallCFunction(GetDllLibPpt().ShapeStyle_set_LineStyleIndex,self.Ptr, value.Ptr)
+
+    @property
+
+    def FillColor(self)->'ColorFormat':
+        """
+        Gets the fill color of the shape.
+
+        Returns:
+            ColorFormat: Read-only color format object for the shape's fill.
+        """
+        GetDllLibPpt().ShapeStyle_get_FillColor.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeStyle_get_FillColor.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeStyle_get_FillColor,self.Ptr)
+        ret = None if intPtr==None else ColorFormat(intPtr)
+        return ret
+
+
+    @property
+
+    def FillStyleIndex(self)->'Int16':
+        """
+        Gets or sets the fill style index in style matrices.
+
+        Returns:
+            Int16: 
+            0 = No fill
+            Positive = Index in theme's fill styles
+            Negative = Index in theme's background styles
+        """
+        GetDllLibPpt().ShapeStyle_get_FillStyleIndex.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeStyle_get_FillStyleIndex.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeStyle_get_FillStyleIndex,self.Ptr)
+        ret = None if intPtr==None else Int16(intPtr)
+        return ret
+
+
+    @FillStyleIndex.setter
+    def FillStyleIndex(self, value:'Int16'):
+        GetDllLibPpt().ShapeStyle_set_FillStyleIndex.argtypes=[c_void_p, c_void_p]
+        CallCFunction(GetDllLibPpt().ShapeStyle_set_FillStyleIndex,self.Ptr, value.Ptr)
+
+    @property
+
+    def EffectColor(self)->'ColorFormat':
+        """
+        Gets the effect color of the shape.
+
+        Returns:
+            ColorFormat: Read-only color format object for shape effects.
+        """
+        GetDllLibPpt().ShapeStyle_get_EffectColor.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeStyle_get_EffectColor.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeStyle_get_EffectColor,self.Ptr)
+        ret = None if intPtr==None else ColorFormat(intPtr)
+        return ret
+
+
+    @property
+
+    def EffectStyleIndex(self)->'UInt32':
+        """
+        Gets or sets the effect style index in the style matrix.
+
+        Returns:
+            UInt32: Column index of the effect style in theme matrices.
+        """
+        GetDllLibPpt().ShapeStyle_get_EffectStyleIndex.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeStyle_get_EffectStyleIndex.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeStyle_get_EffectStyleIndex,self.Ptr)
+        ret = None if intPtr==None else UInt32(intPtr)
+        return ret
+
+
+    @EffectStyleIndex.setter
+    def EffectStyleIndex(self, value:'UInt32'):
+        GetDllLibPpt().ShapeStyle_set_EffectStyleIndex.argtypes=[c_void_p, c_void_p]
+        CallCFunction(GetDllLibPpt().ShapeStyle_set_EffectStyleIndex,self.Ptr, value.Ptr)
+
+    @property
+
+    def FontColor(self)->'ColorFormat':
+        """
+        Gets the font color of the shape.
+
+        Returns:
+            ColorFormat: Read-only color format object for text.
+        """
+        GetDllLibPpt().ShapeStyle_get_FontColor.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeStyle_get_FontColor.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeStyle_get_FontColor,self.Ptr)
+        ret = None if intPtr==None else ColorFormat(intPtr)
+        return ret
+
+
+    @property
+
+    def FontCollectionIndex(self)->'FontCollectionIndex':
+        """
+        Gets or sets the font index in the font collection.
+
+        Returns:
+            FontCollectionIndex: Index value in the presentation's font collection.
+        """
+        GetDllLibPpt().ShapeStyle_get_FontCollectionIndex.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeStyle_get_FontCollectionIndex.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().ShapeStyle_get_FontCollectionIndex,self.Ptr)
+        objwraped = FontCollectionIndex(ret)
+        return objwraped
+
+    @FontCollectionIndex.setter
+    def FontCollectionIndex(self, value:'FontCollectionIndex'):
+        GetDllLibPpt().ShapeStyle_set_FontCollectionIndex.argtypes=[c_void_p, c_int]
+        CallCFunction(GetDllLibPpt().ShapeStyle_set_FontCollectionIndex,self.Ptr, value.value)
+
+
+    def Equals(self ,obj:'SpireObject')->bool:
+        """
+        Determines if this style is equal to another object.
+
+        Args:
+            obj (SpireObject): The object to compare with.
+
+        Returns:
+            bool: True if objects are equal, False otherwise.
+        """
+        intPtrobj:c_void_p = obj.Ptr
+
+        GetDllLibPpt().ShapeStyle_Equals.argtypes=[c_void_p ,c_void_p]
+        GetDllLibPpt().ShapeStyle_Equals.restype=c_bool
+        ret = CallCFunction(GetDllLibPpt().ShapeStyle_Equals,self.Ptr, intPtrobj)
+        return ret
+
+    @property
+
+    def Slide(self)->'ActiveSlide':
+        """
+        Gets the parent slide of the shape style.
+
+        Returns:
+            ActiveSlide: Read-only reference to the parent slide.
+        """
+        GetDllLibPpt().ShapeStyle_get_Slide.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeStyle_get_Slide.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeStyle_get_Slide,self.Ptr)
+        ret = None if intPtr==None else ActiveSlide(intPtr)
+        return ret
+
+
+    @property
+
+    def Presentation(self)->'Presentation':
+        """
+        Gets the parent presentation of the shape style.
+
+        Returns:
+            Presentation: Read-only reference to the parent presentation.
+        """
+        GetDllLibPpt().ShapeStyle_get_Presentation.argtypes=[c_void_p]
+        GetDllLibPpt().ShapeStyle_get_Presentation.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().ShapeStyle_get_Presentation,self.Ptr)
+        ret = None if intPtr==None else Presentation(intPtr)
+        return ret
+
+