spire-presentation 11.2.0__py3-none-macosx_11_0_arm64.whl

spire/presentation/PresetCameraType.py

@@ -0,0 +1,76 @@
+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 PresetCameraType(Enum):
+    """
+    Enumerates predefined camera perspectives for 3D object visualization.
+    """
+    none = -1
+    IsometricBottomDown = 0
+    IsometricBottomUp = 1
+    IsometricLeftDown = 2
+    IsometricLeftUp = 3
+    IsometricOffAxis1Left = 4
+    IsometricOffAxis1Right = 5
+    IsometricOffAxis1Top = 6
+    IsometricOffAxis2Left = 7
+    IsometricOffAxis2Right = 8
+    IsometricOffAxis2Top = 9
+    IsometricOffAxis3Bottom = 10
+    IsometricOffAxis3Left = 11
+    IsometricOffAxis3Right = 12
+    IsometricOffAxis4Bottom = 13
+    IsometricOffAxis4Left = 14
+    IsometricOffAxis4Right = 15
+    IsometricRightDown = 16
+    IsometricRightUp = 17
+    IsometricTopDown = 18
+    IsometricTopUp = 19
+    LegacyObliqueBottom = 20
+    LegacyObliqueBottomLeft = 21
+    LegacyObliqueBottomRight = 22
+    LegacyObliqueFront = 23
+    LegacyObliqueLeft = 24
+    LegacyObliqueRight = 25
+    LegacyObliqueTop = 26
+    LegacyObliqueTopLeft = 27
+    LegacyObliqueTopRight = 28
+    LegacyPerspectiveBottom = 29
+    LegacyPerspectiveBottomLeft = 30
+    LegacyPerspectiveBottomRight = 31
+    LegacyPerspectiveFront = 32
+    LegacyPerspectiveLeft = 33
+    LegacyPerspectiveRight = 34
+    LegacyPerspectiveTop = 35
+    LegacyPerspectiveTopLeft = 36
+    LegacyPerspectiveTopRight = 37
+    ObliqueBottom = 38
+    ObliqueBottomLeft = 39
+    ObliqueBottomRight = 40
+    ObliqueLeft = 41
+    ObliqueRight = 42
+    ObliqueTop = 43
+    ObliqueTopLeft = 44
+    ObliqueTopRight = 45
+    OrthographicFront = 46
+    PerspectiveAbove = 47
+    PerspectiveAboveLeftFacing = 48
+    PerspectiveAboveRightFacing = 49
+    PerspectiveBelow = 50
+    PerspectiveContrastingLeftFacing = 51
+    PerspectiveContrastingRightFacing = 52
+    PerspectiveFront = 53
+    PerspectiveHeroicExtremeLeftFacing = 54
+    PerspectiveHeroicExtremeRightFacing = 55
+    PerspectiveHeroicLeftFacing = 56
+    PerspectiveHeroicRightFacing = 57
+    PerspectiveLeft = 58
+    PerspectiveRelaxed = 59
+    PerspectiveRelaxedModerately = 60
+    PerspectiveRight = 61
+

spire/presentation/PresetLightRigType.py

@@ -0,0 +1,61 @@
+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 PresetLightRigType(Enum):
+    """
+    Enumerates predefined lighting configurations for 3D object rendering.
+    
+    Attributes:
+        none: No preset lighting applied.
+        Balanced: Evenly distributed lighting.
+        BrightRoom: Bright room-like illumination.
+        Chilly: Cool-toned lighting effect.
+        Contrasting: High-contrast lighting setup.
+        Flat: Uniform, shadowless lighting.
+        Flood: Intense floodlight illumination.
+        Freezing: Extreme cool-toned lighting.
+        Glow: Soft glowing light effect.
+        Harsh: Strong directional lighting with sharp shadows.
+        LegacyFlat1: Legacy flat lighting preset 1.
+        # ... (other legacy presets)
+        Morning: Simulated morning light conditions.
+        Soft: Soft diffused lighting.
+        Sunrise: Warm sunrise-like lighting.
+        Sunset: Warm sunset-like lighting.
+        ThreePt: Standard three-point lighting setup.
+        TwoPt: Two-point lighting configuration.
+    """
+    none = -1
+    Balanced = 0
+    BrightRoom = 1
+    Chilly = 2
+    Contrasting = 3
+    Flat = 4
+    Flood = 5
+    Freezing = 6
+    Glow = 7
+    Harsh = 8
+    LegacyFlat1 = 9
+    LegacyFlat2 = 10
+    LegacyFlat3 = 11
+    LegacyFlat4 = 12
+    LegacyHarsh1 = 13
+    LegacyHarsh2 = 14
+    LegacyHarsh3 = 15
+    LegacyHarsh4 = 16
+    LegacyNormal1 = 17
+    LegacyNormal2 = 18
+    LegacyNormal3 = 19
+    LegacyNormal4 = 20
+    Morning = 21
+    Soft = 22
+    Sunrise = 23
+    Sunset = 24
+    ThreePt = 25
+    TwoPt = 26
+

spire/presentation/PresetMaterialType.py

@@ -0,0 +1,47 @@
+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 PresetMaterialType(Enum):
+    """
+    Enumerates the types of material presets that can be applied to shapes.
+    
+    Attributes:
+        none: No material preset applied.
+        Clear: Transparent material effect.
+        DkEdge: Dark edge material effect.
+        Flat: Flat, non-reflective material.
+        LegacyMatte: Legacy matte finish material.
+        LegacyMetal: Legacy metallic material effect.
+        LegacyPlastic: Legacy plastic material effect.
+        LegacyWireframe: Legacy wireframe material effect.
+        Matte: Non-glossy, diffuse material.
+        Metal: Reflective metallic material.
+        Plastic: Semi-gloss plastic material.
+        Powder: Soft, powdery material texture.
+        SoftEdge: Material with soft-edged lighting.
+        Softmetal: Soft metallic material effect.
+        TranslucentPowder: Semi-transparent powdery material.
+        WarmMatte: Warm-toned matte finish material.
+    """
+    none = -1
+    Clear = 0
+    DkEdge = 1
+    Flat = 2
+    LegacyMatte = 3
+    LegacyMetal = 4
+    LegacyPlastic = 5
+    LegacyWireframe = 6
+    Matte = 7
+    Metal = 8
+    Plastic = 9
+    Powder = 10
+    SoftEdge = 11
+    Softmetal = 12
+    TranslucentPowder = 13
+    WarmMatte = 14
+

spire/presentation/PresetShadowValue.py

@@ -0,0 +1,36 @@
+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 PresetShadowValue(Enum):
+    """
+    Defines the types of preset shadow effects available for presentation elements.
+    
+    These enumerated values represent different preconfigured shadow effects that
+    can be applied to shapes, text, and other slide objects.
+    """
+    TopLeftDrop = 0
+    TopLeftLargeDrop = 1
+    BackLeftLongPerspective = 2
+    BackRightLongPerspective = 3
+    TopLeftDoubleDrop = 4
+    BottomRightSmallDrop = 5
+    FrontLeftLongPerspective = 6
+    FrontRightLongPerspective = 7
+    OuterBox3D = 8
+    InnerBox3D = 9
+    BackCenterPerspective = 10
+    TopRightDrop = 11
+    FrontBottom = 12
+    BackLeftPerspective = 13
+    BackRightPerspective = 14
+    BottomLeftDrop = 15
+    BottomRightDrop = 16
+    FrontLeftPerspective = 17
+    FrontRightPerspective = 18
+    TopLeftSmallDrop = 19
+

spire/presentation/RectangleAlignment.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 RectangleAlignment(Enum):
+    """
+    Specifies the alignment position of a rectangular object.
+    
+    Defines 9-point alignment positions for rectangular objects within a containing space.
+    """
+    none = -1
+    TopLeft = 0
+    Top = 1
+    TopRight = 2
+    Left = 3
+    Center = 4
+    Right = 5
+    BottomLeft = 6
+    Bottom = 7
+    BottomRight = 8
+

spire/presentation/RelativeRectangle.py

@@ -0,0 +1,207 @@
+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 RelativeRectangle (SpireObject) :
+    """
+    Represents a rectangle defined using relative coordinates (percentages).
+    
+    Used to specify positions and dimensions relative to a container element,
+    with values typically ranging from 0.0 to 100.0.
+    """
+    @property
+    def X(self)->float:
+        """
+        Gets the X-coordinate of the rectangle's origin.
+        
+        Returns:
+            float: The relative X-position as a percentage.
+        """
+        GetDllLibPpt().RelativeRectangle_get_X.argtypes=[c_void_p]
+        GetDllLibPpt().RelativeRectangle_get_X.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().RelativeRectangle_get_X,self.Ptr)
+        return ret
+
+    @X.setter
+    def X(self, value:float):
+        """
+        Sets the X-coordinate of the rectangle's origin.
+        
+        Args:
+            value: The relative X-position percentage to set.
+        """
+        GetDllLibPpt().RelativeRectangle_set_X.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().RelativeRectangle_set_X,self.Ptr, value)
+
+    @property
+    def Y(self)->float:
+        """
+        Gets the Y-coordinate of the rectangle's origin.
+        
+        Returns:
+            float: The relative Y-position as a percentage.
+        """
+        GetDllLibPpt().RelativeRectangle_get_Y.argtypes=[c_void_p]
+        GetDllLibPpt().RelativeRectangle_get_Y.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().RelativeRectangle_get_Y,self.Ptr)
+        return ret
+
+    @Y.setter
+    def Y(self, value:float):
+        GetDllLibPpt().RelativeRectangle_set_Y.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().RelativeRectangle_set_Y,self.Ptr, value)
+
+    @property
+    def Width(self)->float:
+        """
+        Gets the Width of the rectangle.
+        
+        Returns:
+            float: The relative Width as a percentage.
+        """
+        GetDllLibPpt().RelativeRectangle_get_Width.argtypes=[c_void_p]
+        GetDllLibPpt().RelativeRectangle_get_Width.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().RelativeRectangle_get_Width,self.Ptr)
+        return ret
+
+    @Width.setter
+    def Width(self, value:float):
+        GetDllLibPpt().RelativeRectangle_set_Width.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().RelativeRectangle_set_Width,self.Ptr, value)
+
+    @property
+    def Height(self)->float:
+        """
+        Gets the Height of the rectangle.
+        
+        Returns:
+            float: The relative Height as a percentage.
+        """
+        GetDllLibPpt().RelativeRectangle_get_Height.argtypes=[c_void_p]
+        GetDllLibPpt().RelativeRectangle_get_Height.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().RelativeRectangle_get_Height,self.Ptr)
+        return ret
+
+    @Height.setter
+    def Height(self, value:float):
+        GetDllLibPpt().RelativeRectangle_set_Height.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().RelativeRectangle_set_Height,self.Ptr, value)
+
+    @property
+    def Left(self)->float:
+        """
+        Sets the Left of the rectangle.
+        
+        Args:
+            value: The relative Left percentage to set.
+        """
+        GetDllLibPpt().RelativeRectangle_get_Left.argtypes=[c_void_p]
+        GetDllLibPpt().RelativeRectangle_get_Left.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().RelativeRectangle_get_Left,self.Ptr)
+        return ret
+
+    @Left.setter
+    def Left(self, value:float):
+        GetDllLibPpt().RelativeRectangle_set_Left.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().RelativeRectangle_set_Left,self.Ptr, value)
+
+    @property
+    def Top(self)->float:
+        """
+        Gets the Top of the rectangle.
+        
+        Returns:
+            float: The relative Top as a percentage.
+        """
+        GetDllLibPpt().RelativeRectangle_get_Top.argtypes=[c_void_p]
+        GetDllLibPpt().RelativeRectangle_get_Top.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().RelativeRectangle_get_Top,self.Ptr)
+        return ret
+
+    @Top.setter
+    def Top(self, value:float):
+        GetDllLibPpt().RelativeRectangle_set_Top.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().RelativeRectangle_set_Top,self.Ptr, value)
+
+    @property
+    def Right(self)->float:
+        """
+        Gets the Right of the rectangle.
+        
+        Returns:
+            float: The relative Right as a percentage.
+        """
+        GetDllLibPpt().RelativeRectangle_get_Right.argtypes=[c_void_p]
+        GetDllLibPpt().RelativeRectangle_get_Right.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().RelativeRectangle_get_Right,self.Ptr)
+        return ret
+
+    @Right.setter
+    def Right(self, value:float):
+        GetDllLibPpt().RelativeRectangle_set_Right.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().RelativeRectangle_set_Right,self.Ptr, value)
+
+    @property
+    def Bottom(self)->float:
+        """
+        Gets the Bottom of the rectangle.
+        
+        Returns:
+            float: The relative Bottom as a percentage.
+        """
+        GetDllLibPpt().RelativeRectangle_get_Bottom.argtypes=[c_void_p]
+        GetDllLibPpt().RelativeRectangle_get_Bottom.restype=c_float
+        ret = CallCFunction(GetDllLibPpt().RelativeRectangle_get_Bottom,self.Ptr)
+        return ret
+
+    @Bottom.setter
+    def Bottom(self, value:float):
+        GetDllLibPpt().RelativeRectangle_set_Bottom.argtypes=[c_void_p, c_float]
+        CallCFunction(GetDllLibPpt().RelativeRectangle_set_Bottom,self.Ptr, value)
+
+    @dispatch
+
+    def Transform(self ,rect:RectangleF)->RectangleF:
+        """
+        Transforms a RectangleF using the current relative rectangle values.
+        
+        Args:
+            rect: The source rectangle to transform.
+        
+        Returns:
+            RectangleF: The transformed rectangle.
+        """
+        intPtrrect:c_void_p = rect.Ptr
+
+        GetDllLibPpt().RelativeRectangle_Transform.argtypes=[c_void_p ,c_void_p]
+        GetDllLibPpt().RelativeRectangle_Transform.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().RelativeRectangle_Transform,self.Ptr, intPtrrect)
+        ret = None if intPtr==None else RectangleF(intPtr)
+        return ret
+
+
+    @dispatch
+
+    def Transform(self ,rect:'RelativeRectangle')->'RelativeRectangle':
+        """
+        Transforms another RelativeRectangle using the current relative rectangle values.
+        
+        Args:
+            rect: The source relative rectangle to transform.
+        
+        Returns:
+            RelativeRectangle: The transformed relative rectangle.
+        """
+        intPtrrect:c_void_p = rect.Ptr
+
+        GetDllLibPpt().RelativeRectangle_TransformR.argtypes=[c_void_p ,c_void_p]
+        GetDllLibPpt().RelativeRectangle_TransformR.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().RelativeRectangle_TransformR,self.Ptr, intPtrrect)
+        ret = None if intPtr==None else RelativeRectangle(intPtr)
+        return ret
+
+

spire/presentation/Section.py

@@ -0,0 +1,187 @@
+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 Section (SpireObject) :
+    """
+    Represents a logical grouping of slides in a presentation.
+    Sections help organize slides into named groups for better management.
+    """
+#    @property
+#
+#    def SlideIdList(self)->'List1':
+#        """
+#    <summary>
+#        get IDs of slides in this section.
+#    </summary>
+#        """
+#        GetDllLibPpt().Section_get_SlideIdList.argtypes=[c_void_p]
+#        GetDllLibPpt().Section_get_SlideIdList.restype=c_void_p
+#        intPtr = CallCFunction(GetDllLibPpt().Section_get_SlideIdList,self.Ptr)
+#        ret = None if intPtr==None else List1(intPtr)
+#        return ret
+#
+
+
+    def GetSlides(self)->List['ISlide']:
+        """
+        Retrieves all slides contained within this section.
+        
+        Returns:
+            List[ISlide]: A list of slide objects belonging to this section.
+        """
+        GetDllLibPpt().Section_GetSlides.argtypes=[c_void_p]
+        GetDllLibPpt().Section_GetSlides.restype=IntPtrArray
+        intPtrArray = CallCFunction(GetDllLibPpt().Section_GetSlides,self.Ptr)
+        ret = GetObjVectorFromArray(intPtrArray, ISlide)
+        return ret
+
+
+
+    def Move(self ,index:int,slide:'ISlide'):
+        """
+        Relocates a slide to a new position within this section.
+        
+        Args:
+            index: Target position index (0-based).
+            slide: Slide object to be moved.
+        """
+        intPtrslide:c_void_p = slide.Ptr
+
+        GetDllLibPpt().Section_Move.argtypes=[c_void_p ,c_int,c_void_p]
+        CallCFunction(GetDllLibPpt().Section_Move,self.Ptr, index,intPtrslide)
+
+
+    def Insert(self ,index:int,slide:'ISlide')->'ISlide':
+        """
+        Inserts a slide at the specified position within this section.
+        
+        Args:
+            index: Target insertion position (0-based).
+            slide: Slide object to insert.
+            
+        Returns:
+            ISlide: The inserted slide object.
+        """
+        intPtrslide:c_void_p = slide.Ptr
+
+        GetDllLibPpt().Section_Insert.argtypes=[c_void_p ,c_int,c_void_p]
+        GetDllLibPpt().Section_Insert.restype=c_void_p
+        intPtr = CallCFunction(GetDllLibPpt().Section_Insert,self.Ptr, index,intPtrslide)
+        ret = None if intPtr==None else ISlide(intPtr)
+        return ret
+
+
+
+    def AddRange(self ,slides:'IList'):
+        """
+        Adds multiple slides to the end of this section.
+        
+        Args:
+            slides: List of slide objects to add.
+        """
+        slide_ptrs = [s.Ptr for s in slides]
+
+        num_slides = len(slide_ptrs)
+        slide_ptr_array = (c_void_p * num_slides)(*slide_ptrs)
+        GetDllLibPpt().Section_AddRange.argtypes=[c_void_p ,c_void_p]
+        CallCFunction(GetDllLibPpt().Section_AddRange,self.Ptr, slide_ptr_array,num_slides)
+
+
+
+    def RemoveAt(self ,index:int):
+        """
+        Removes the slide at the specified position.
+        
+        Args:
+            index: Position index of slide to remove (0-based).
+        """
+        
+        GetDllLibPpt().Section_RemoveAt.argtypes=[c_void_p ,c_int]
+        CallCFunction(GetDllLibPpt().Section_RemoveAt,self.Ptr, index)
+
+
+    def Remove(self ,slide:'ISlide'):
+        """
+        Removes a specific slide from this section.
+        
+        Args:
+            slide: Slide object to remove.
+        """
+        intPtrslide:c_void_p = slide.Ptr
+
+        GetDllLibPpt().Section_Remove.argtypes=[c_void_p ,c_void_p]
+        CallCFunction(GetDllLibPpt().Section_Remove,self.Ptr, intPtrslide)
+
+
+    def RemoveRange(self ,startIndex:int,count:int):
+        """
+        Removes a range of consecutive slides.
+        
+        Args:
+            startIndex: Starting position index (0-based).
+            count: Number of slides to remove.
+        """
+        
+        GetDllLibPpt().Section_RemoveRange.argtypes=[c_void_p ,c_int,c_int]
+        CallCFunction(GetDllLibPpt().Section_RemoveRange,self.Ptr, startIndex,count)
+
+    @property
+
+    def Name(self)->str:
+        """
+        Gets or sets the display name of the section.
+        
+        Returns:
+            str: Current section name.
+        """
+        GetDllLibPpt().Section_get_Name.argtypes=[c_void_p]
+        GetDllLibPpt().Section_get_Name.restype=c_void_p
+        ret = PtrToStr(CallCFunction(GetDllLibPpt().Section_get_Name,self.Ptr))
+        return ret
+
+
+    @Name.setter
+    def Name(self, value:str):
+        valuePtr = StrToPtr(value)
+        GetDllLibPpt().Section_set_Name.argtypes=[c_void_p, c_char_p]
+        CallCFunction(GetDllLibPpt().Section_set_Name,self.Ptr,valuePtr)
+
+    @property
+
+    def Id(self)->str:
+        """
+        Gets or sets the unique identifier for the section.
+        
+        Returns:
+            str: Unique section identifier.
+        """
+        GetDllLibPpt().Section_get_Id.argtypes=[c_void_p]
+        GetDllLibPpt().Section_get_Id.restype=c_void_p
+        ret = PtrToStr(CallCFunction(GetDllLibPpt().Section_get_Id,self.Ptr))
+        return ret
+
+
+    @Id.setter
+    def Id(self, value:str):
+        valuePtr = StrToPtr(value)
+        GetDllLibPpt().Section_set_Id.argtypes=[c_void_p, c_char_p]
+        CallCFunction(GetDllLibPpt().Section_set_Id,self.Ptr,valuePtr)
+
+    @property
+    def Index(self)->int:
+        """
+        Gets the position index of this section in the parent collection.
+        
+        Returns:
+            int: Zero-based index position.
+        """
+        GetDllLibPpt().Section_get_Index.argtypes=[c_void_p]
+        GetDllLibPpt().Section_get_Index.restype=c_int
+        ret = CallCFunction(GetDllLibPpt().Section_get_Index,self.Ptr)
+        return ret
+