python-pptx2 2.13.0__py3-none-any.whl

pptx2/enum/dml.py

@@ -0,0 +1,740 @@
+"""Enumerations used by DrawingML objects."""
+
+from __future__ import annotations
+
+from pptx2.enum.base import BaseEnum, BaseXmlEnum
+
+
+class MSO_COLOR_TYPE(BaseEnum):
+    """
+    Specifies the color specification scheme
+
+    Example::
+
+        from pptx2.enum.dml import MSO_COLOR_TYPE
+
+        assert shape.fill.fore_color.type == MSO_COLOR_TYPE.SCHEME
+
+    MS API Name: "MsoColorType"
+
+    http://msdn.microsoft.com/en-us/library/office/ff864912(v=office.15).aspx
+    """
+
+    RGB = (1, "Color is specified by an |RGBColor| value.")
+    """Color is specified by an |RGBColor| value."""
+
+    SCHEME = (2, "Color is one of the preset theme colors")
+    """Color is one of the preset theme colors"""
+
+    HSL = (101, "Color is specified using Hue, Saturation, and Luminosity values")
+    """Color is specified using Hue, Saturation, and Luminosity values"""
+
+    PRESET = (102, "Color is specified using a named built-in color")
+    """Color is specified using a named built-in color"""
+
+    SCRGB = (103, "Color is an scRGB color, a wide color gamut RGB color space")
+    """Color is an scRGB color, a wide color gamut RGB color space"""
+
+    SYSTEM = (
+        104,
+        "Color is one specified by the operating system, such as the window background color.",
+    )
+    """Color is one specified by the operating system, such as the window background color."""
+
+
+class MSO_FILL_TYPE(BaseEnum):
+    """
+    Specifies the type of bitmap used for the fill of a shape.
+
+    Alias: ``MSO_FILL``
+
+    Example::
+
+        from pptx2.enum.dml import MSO_FILL
+
+        assert shape.fill.type == MSO_FILL.SOLID
+
+    MS API Name: `MsoFillType`
+
+    http://msdn.microsoft.com/EN-US/library/office/ff861408.aspx
+    """
+
+    BACKGROUND = (
+        5,
+        "The shape is transparent, such that whatever is behind the shape shows through."
+        " Often this is the slide background, but if a visible shape is behind, that will"
+        " show through.",
+    )
+    """The shape is transparent, such that whatever is behind the shape shows through.
+
+    Often this is the slide background, but if a visible shape is behind, that will show through.
+    """
+
+    GRADIENT = (3, "Shape is filled with a gradient")
+    """Shape is filled with a gradient"""
+
+    GROUP = (101, "Shape is part of a group and should inherit the fill properties of the group.")
+    """Shape is part of a group and should inherit the fill properties of the group."""
+
+    PATTERNED = (2, "Shape is filled with a pattern")
+    """Shape is filled with a pattern"""
+
+    PICTURE = (6, "Shape is filled with a bitmapped image")
+    """Shape is filled with a bitmapped image"""
+
+    SOLID = (1, "Shape is filled with a solid color")
+    """Shape is filled with a solid color"""
+
+    TEXTURED = (4, "Shape is filled with a texture")
+    """Shape is filled with a texture"""
+
+
+MSO_FILL = MSO_FILL_TYPE
+
+
+class MSO_LINE_DASH_STYLE(BaseXmlEnum):
+    """Specifies the dash style for a line.
+
+    Alias: ``MSO_LINE``
+
+    Example::
+
+        from pptx2.enum.dml import MSO_LINE
+
+        shape.line.dash_style = MSO_LINE.DASH_DOT_DOT
+
+    MS API name: `MsoLineDashStyle`
+
+    https://learn.microsoft.com/en-us/office/vba/api/Office.MsoLineDashStyle
+    """
+
+    DASH = (4, "dash", "Line consists of dashes only.")
+    """Line consists of dashes only."""
+
+    DASH_DOT = (5, "dashDot", "Line is a dash-dot pattern.")
+    """Line is a dash-dot pattern."""
+
+    DASH_DOT_DOT = (6, "lgDashDotDot", "Line is a dash-dot-dot pattern.")
+    """Line is a dash-dot-dot pattern."""
+
+    LONG_DASH = (7, "lgDash", "Line consists of long dashes.")
+    """Line consists of long dashes."""
+
+    LONG_DASH_DOT = (8, "lgDashDot", "Line is a long dash-dot pattern.")
+    """Line is a long dash-dot pattern."""
+
+    ROUND_DOT = (3, "sysDot", "Line is made up of round dots.")
+    """Line is made up of round dots."""
+
+    SOLID = (1, "solid", "Line is solid.")
+    """Line is solid."""
+
+    SQUARE_DOT = (2, "sysDash", "Line is made up of square dots.")
+    """Line is made up of square dots."""
+
+    DASH_STYLE_MIXED = (-2, "", "Not supported.")
+    """Return value only, indicating more than one dash style applies."""
+
+
+MSO_LINE = MSO_LINE_DASH_STYLE
+
+
+class MSO_LINE_CAP_STYLE(BaseXmlEnum):
+    """Specifies the end-cap style for a line.
+
+    Alias: ``MSO_LINE_CAP``
+
+    Example::
+
+        from pptx2.enum.dml import MSO_LINE_CAP
+
+        shape.line.cap = MSO_LINE_CAP.ROUND
+
+    Maps to the `cap` attribute on `<a:ln>`.
+    """
+
+    FLAT = (3, "flat", "Flat end cap (no extension beyond the line end).")
+    """Flat end cap (no extension beyond the line end)."""
+
+    ROUND = (1, "rnd", "Rounded end cap.")
+    """Rounded end cap."""
+
+    SQUARE = (2, "sq", "Square end cap (extends past the line end).")
+    """Square end cap (extends past the line end)."""
+
+
+MSO_LINE_CAP = MSO_LINE_CAP_STYLE
+
+
+class MSO_LINE_COMPOUND_STYLE(BaseXmlEnum):
+    """Specifies the compound (multi-stroke) style for a line.
+
+    Alias: ``MSO_LINE_COMPOUND``
+
+    Example::
+
+        from pptx2.enum.dml import MSO_LINE_COMPOUND
+
+        shape.line.compound = MSO_LINE_COMPOUND.DOUBLE
+
+    Maps to the `cmpd` attribute on `<a:ln>`.
+    """
+
+    SINGLE = (1, "sng", "Single line.")
+    """Single line."""
+
+    THICK_THIN = (2, "thickThin", "Thick line followed by thin.")
+    """Thick line followed by thin."""
+
+    THIN_THICK = (3, "thinThick", "Thin line followed by thick.")
+    """Thin line followed by thick."""
+
+    DOUBLE = (4, "dbl", "Two parallel lines of equal width.")
+    """Two parallel lines of equal width."""
+
+    TRIPLE = (5, "tri", "Three parallel lines (thin-thick-thin).")
+    """Three parallel lines (thin-thick-thin)."""
+
+
+MSO_LINE_COMPOUND = MSO_LINE_COMPOUND_STYLE
+
+
+class MSO_LINE_JOIN_STYLE(BaseEnum):
+    """Specifies the join style at corners of a stroked line.
+
+    Alias: ``MSO_LINE_JOIN``
+
+    Example::
+
+        from pptx2.enum.dml import MSO_LINE_JOIN
+
+        shape.line.join = MSO_LINE_JOIN.ROUND
+
+    Each member corresponds to a child element of `<a:ln>`: `<a:round/>`,
+    `<a:bevel/>`, or `<a:miter/>`.
+    """
+
+    ROUND = (1, "Round join — corresponds to `<a:round/>`.")
+    """Round join — corresponds to `<a:round/>`."""
+
+    BEVEL = (2, "Bevel join — corresponds to `<a:bevel/>`.")
+    """Bevel join — corresponds to `<a:bevel/>`."""
+
+    MITER = (3, "Miter join — corresponds to `<a:miter/>`.")
+    """Miter join — corresponds to `<a:miter/>`."""
+
+
+MSO_LINE_JOIN = MSO_LINE_JOIN_STYLE
+
+
+class MSO_LINE_END_TYPE(BaseXmlEnum):
+    """Specifies the arrowhead style at one end of a line.
+
+    Example::
+
+        from pptx2.enum.dml import MSO_LINE_END_TYPE
+
+        shape.line.head_end.type = MSO_LINE_END_TYPE.ARROW
+
+    Maps to the `type` attribute on `<a:headEnd>` / `<a:tailEnd>`.
+    """
+
+    NONE = (1, "none", "No arrowhead.")
+    """No arrowhead."""
+
+    ARROW = (2, "arrow", "Open arrowhead.")
+    """Open arrowhead."""
+
+    DIAMOND = (3, "diamond", "Diamond-shaped end.")
+    """Diamond-shaped end."""
+
+    OVAL = (4, "oval", "Oval (filled circle) end.")
+    """Oval (filled circle) end."""
+
+    STEALTH = (5, "stealth", "Stealth (concave) arrowhead.")
+    """Stealth (concave) arrowhead."""
+
+    TRIANGLE = (6, "triangle", "Filled triangular arrowhead.")
+    """Filled triangular arrowhead."""
+
+
+class MSO_LINE_END_SIZE(BaseXmlEnum):
+    """Specifies the relative size of an arrowhead's width or length.
+
+    Used by both `head_end.width` / `head_end.length` and the corresponding
+    `tail_end` properties. Maps to the `w` and `len` attributes on
+    `<a:headEnd>` / `<a:tailEnd>`.
+    """
+
+    SMALL = (1, "sm", "Small arrowhead width or length.")
+    """Small arrowhead width or length."""
+
+    MEDIUM = (2, "med", "Medium arrowhead width or length.")
+    """Medium arrowhead width or length."""
+
+    LARGE = (3, "lg", "Large arrowhead width or length.")
+    """Large arrowhead width or length."""
+
+
+class MSO_PATTERN_TYPE(BaseXmlEnum):
+    """Specifies the fill pattern used in a shape.
+
+    Alias: ``MSO_PATTERN``
+
+    Example::
+
+        from pptx2.enum.dml import MSO_PATTERN
+
+        fill = shape.fill
+        fill.patterned()
+        fill.pattern = MSO_PATTERN.WAVE
+
+    MS API Name: `MsoPatternType`
+
+    https://learn.microsoft.com/en-us/office/vba/api/Office.MsoPatternType
+    """
+
+    __deprecated_aliases__ = {"ERCENT_40": "PERCENT_40"}
+
+    CROSS = (51, "cross", "Cross")
+    """Cross"""
+
+    DARK_DOWNWARD_DIAGONAL = (15, "dkDnDiag", "Dark Downward Diagonal")
+    """Dark Downward Diagonal"""
+
+    DARK_HORIZONTAL = (13, "dkHorz", "Dark Horizontal")
+    """Dark Horizontal"""
+
+    DARK_UPWARD_DIAGONAL = (16, "dkUpDiag", "Dark Upward Diagonal")
+    """Dark Upward Diagonal"""
+
+    DARK_VERTICAL = (14, "dkVert", "Dark Vertical")
+    """Dark Vertical"""
+
+    DASHED_DOWNWARD_DIAGONAL = (28, "dashDnDiag", "Dashed Downward Diagonal")
+    """Dashed Downward Diagonal"""
+
+    DASHED_HORIZONTAL = (32, "dashHorz", "Dashed Horizontal")
+    """Dashed Horizontal"""
+
+    DASHED_UPWARD_DIAGONAL = (27, "dashUpDiag", "Dashed Upward Diagonal")
+    """Dashed Upward Diagonal"""
+
+    DASHED_VERTICAL = (31, "dashVert", "Dashed Vertical")
+    """Dashed Vertical"""
+
+    DIAGONAL_BRICK = (40, "diagBrick", "Diagonal Brick")
+    """Diagonal Brick"""
+
+    DIAGONAL_CROSS = (54, "diagCross", "Diagonal Cross")
+    """Diagonal Cross"""
+
+    DIVOT = (46, "divot", "Pattern Divot")
+    """Pattern Divot"""
+
+    DOTTED_DIAMOND = (24, "dotDmnd", "Dotted Diamond")
+    """Dotted Diamond"""
+
+    DOTTED_GRID = (45, "dotGrid", "Dotted Grid")
+    """Dotted Grid"""
+
+    DOWNWARD_DIAGONAL = (52, "dnDiag", "Downward Diagonal")
+    """Downward Diagonal"""
+
+    HORIZONTAL = (49, "horz", "Horizontal")
+    """Horizontal"""
+
+    HORIZONTAL_BRICK = (35, "horzBrick", "Horizontal Brick")
+    """Horizontal Brick"""
+
+    LARGE_CHECKER_BOARD = (36, "lgCheck", "Large Checker Board")
+    """Large Checker Board"""
+
+    LARGE_CONFETTI = (33, "lgConfetti", "Large Confetti")
+    """Large Confetti"""
+
+    LARGE_GRID = (34, "lgGrid", "Large Grid")
+    """Large Grid"""
+
+    LIGHT_DOWNWARD_DIAGONAL = (21, "ltDnDiag", "Light Downward Diagonal")
+    """Light Downward Diagonal"""
+
+    LIGHT_HORIZONTAL = (19, "ltHorz", "Light Horizontal")
+    """Light Horizontal"""
+
+    LIGHT_UPWARD_DIAGONAL = (22, "ltUpDiag", "Light Upward Diagonal")
+    """Light Upward Diagonal"""
+
+    LIGHT_VERTICAL = (20, "ltVert", "Light Vertical")
+    """Light Vertical"""
+
+    NARROW_HORIZONTAL = (30, "narHorz", "Narrow Horizontal")
+    """Narrow Horizontal"""
+
+    NARROW_VERTICAL = (29, "narVert", "Narrow Vertical")
+    """Narrow Vertical"""
+
+    OUTLINED_DIAMOND = (41, "openDmnd", "Outlined Diamond")
+    """Outlined Diamond"""
+
+    PERCENT_10 = (2, "pct10", "10% of the foreground color.")
+    """10% of the foreground color."""
+
+    PERCENT_20 = (3, "pct20", "20% of the foreground color.")
+    """20% of the foreground color."""
+
+    PERCENT_25 = (4, "pct25", "25% of the foreground color.")
+    """25% of the foreground color."""
+
+    PERCENT_30 = (5, "pct30", "30% of the foreground color.")
+    """30% of the foreground color."""
+
+    PERCENT_40 = (6, "pct40", "40% of the foreground color.")
+    """40% of the foreground color."""
+
+    ERCENT_40 = (6, "pct40", "40% of the foreground color.")
+    """Deprecated alias for :attr:`PERCENT_40` (preserved for back-compat)."""
+
+    PERCENT_5 = (1, "pct5", "5% of the foreground color.")
+    """5% of the foreground color."""
+
+    PERCENT_50 = (7, "pct50", "50% of the foreground color.")
+    """50% of the foreground color."""
+
+    PERCENT_60 = (8, "pct60", "60% of the foreground color.")
+    """60% of the foreground color."""
+
+    PERCENT_70 = (9, "pct70", "70% of the foreground color.")
+    """70% of the foreground color."""
+
+    PERCENT_75 = (10, "pct75", "75% of the foreground color.")
+    """75% of the foreground color."""
+
+    PERCENT_80 = (11, "pct80", "80% of the foreground color.")
+    """80% of the foreground color."""
+
+    PERCENT_90 = (12, "pct90", "90% of the foreground color.")
+    """90% of the foreground color."""
+
+    PLAID = (42, "plaid", "Plaid")
+    """Plaid"""
+
+    SHINGLE = (47, "shingle", "Shingle")
+    """Shingle"""
+
+    SMALL_CHECKER_BOARD = (17, "smCheck", "Small Checker Board")
+    """Small Checker Board"""
+
+    SMALL_CONFETTI = (37, "smConfetti", "Small Confetti")
+    """Small Confetti"""
+
+    SMALL_GRID = (23, "smGrid", "Small Grid")
+    """Small Grid"""
+
+    SOLID_DIAMOND = (39, "solidDmnd", "Solid Diamond")
+    """Solid Diamond"""
+
+    SPHERE = (43, "sphere", "Sphere")
+    """Sphere"""
+
+    TRELLIS = (18, "trellis", "Trellis")
+    """Trellis"""
+
+    UPWARD_DIAGONAL = (53, "upDiag", "Upward Diagonal")
+    """Upward Diagonal"""
+
+    VERTICAL = (50, "vert", "Vertical")
+    """Vertical"""
+
+    WAVE = (48, "wave", "Wave")
+    """Wave"""
+
+    WEAVE = (44, "weave", "Weave")
+    """Weave"""
+
+    WIDE_DOWNWARD_DIAGONAL = (25, "wdDnDiag", "Wide Downward Diagonal")
+    """Wide Downward Diagonal"""
+
+    WIDE_UPWARD_DIAGONAL = (26, "wdUpDiag", "Wide Upward Diagonal")
+    """Wide Upward Diagonal"""
+
+    ZIG_ZAG = (38, "zigZag", "Zig Zag")
+    """Zig Zag"""
+
+    MIXED = (-2, "", "Mixed pattern (read-only).")
+    """Mixed pattern (read-only)."""
+
+
+MSO_PATTERN = MSO_PATTERN_TYPE
+
+
+class MSO_THEME_COLOR_INDEX(BaseXmlEnum):
+    """An Office theme color, one of those shown in the color gallery on the formatting ribbon.
+
+    Alias: ``MSO_THEME_COLOR``
+
+    Example::
+
+        from pptx2.enum.dml import MSO_THEME_COLOR
+
+        shape.fill.solid()
+        shape.fill.fore_color.theme_color = MSO_THEME_COLOR.ACCENT_1
+
+    MS API Name: `MsoThemeColorIndex`
+
+    http://msdn.microsoft.com/en-us/library/office/ff860782(v=office.15).aspx
+    """
+
+    NOT_THEME_COLOR = (0, "", "Indicates the color is not a theme color.")
+    """Indicates the color is not a theme color."""
+
+    ACCENT_1 = (5, "accent1", "Specifies the Accent 1 theme color.")
+    """Specifies the Accent 1 theme color."""
+
+    ACCENT_2 = (6, "accent2", "Specifies the Accent 2 theme color.")
+    """Specifies the Accent 2 theme color."""
+
+    ACCENT_3 = (7, "accent3", "Specifies the Accent 3 theme color.")
+    """Specifies the Accent 3 theme color."""
+
+    ACCENT_4 = (8, "accent4", "Specifies the Accent 4 theme color.")
+    """Specifies the Accent 4 theme color."""
+
+    ACCENT_5 = (9, "accent5", "Specifies the Accent 5 theme color.")
+    """Specifies the Accent 5 theme color."""
+
+    ACCENT_6 = (10, "accent6", "Specifies the Accent 6 theme color.")
+    """Specifies the Accent 6 theme color."""
+
+    BACKGROUND_1 = (14, "bg1", "Specifies the Background 1 theme color.")
+    """Specifies the Background 1 theme color."""
+
+    BACKGROUND_2 = (16, "bg2", "Specifies the Background 2 theme color.")
+    """Specifies the Background 2 theme color."""
+
+    DARK_1 = (1, "dk1", "Specifies the Dark 1 theme color.")
+    """Specifies the Dark 1 theme color."""
+
+    DARK_2 = (3, "dk2", "Specifies the Dark 2 theme color.")
+    """Specifies the Dark 2 theme color."""
+
+    FOLLOWED_HYPERLINK = (12, "folHlink", "Specifies the theme color for a clicked hyperlink.")
+    """Specifies the theme color for a clicked hyperlink."""
+
+    HYPERLINK = (11, "hlink", "Specifies the theme color for a hyperlink.")
+    """Specifies the theme color for a hyperlink."""
+
+    LIGHT_1 = (2, "lt1", "Specifies the Light 1 theme color.")
+    """Specifies the Light 1 theme color."""
+
+    LIGHT_2 = (4, "lt2", "Specifies the Light 2 theme color.")
+    """Specifies the Light 2 theme color."""
+
+    TEXT_1 = (13, "tx1", "Specifies the Text 1 theme color.")
+    """Specifies the Text 1 theme color."""
+
+    TEXT_2 = (15, "tx2", "Specifies the Text 2 theme color.")
+    """Specifies the Text 2 theme color."""
+
+    MIXED = (
+        -2,
+        "",
+        "Indicates multiple theme colors are used, such as in a group shape (read-only).",
+    )
+    """Indicates multiple theme colors are used, such as in a group shape (read-only)."""
+
+
+MSO_THEME_COLOR = MSO_THEME_COLOR_INDEX
+
+
+class BevelPreset(BaseXmlEnum):
+    """Preset bevel style for the top or bottom face of a 3-D shape.
+
+    Used with ``shape.three_d.bevel_top`` and ``shape.three_d.bevel_bottom``.
+
+    Maps to the ``prst`` attribute on ``<a:bevelT>`` / ``<a:bevelB>``.
+    """
+
+    ANGLE = (1, "angle", "Angle bevel.")
+    """Angle bevel."""
+
+    ART_DECO = (2, "artDeco", "Art Deco bevel.")
+    """Art Deco bevel."""
+
+    CIRCLE = (3, "circle", "Circle bevel.")
+    """Circle bevel."""
+
+    CONVEX = (4, "convex", "Convex bevel.")
+    """Convex bevel."""
+
+    COOL_SLANT = (5, "coolSlant", "Cool slant bevel.")
+    """Cool slant bevel."""
+
+    CROSS = (6, "cross", "Cross bevel.")
+    """Cross bevel."""
+
+    DIVOT = (7, "divot", "Divot bevel.")
+    """Divot bevel."""
+
+    HARD_EDGE = (8, "hardEdge", "Hard edge bevel.")
+    """Hard edge bevel."""
+
+    NONE = (9, "none", "No bevel.")
+    """No bevel."""
+
+    RELAXED_INSET = (10, "relaxedInset", "Relaxed inset bevel.")
+    """Relaxed inset bevel."""
+
+    RIBLET = (11, "riblet", "Riblet bevel.")
+    """Riblet bevel."""
+
+    SLOPE = (12, "slope", "Slope bevel.")
+    """Slope bevel."""
+
+    SOFT_ROUND = (13, "softRound", "Soft round bevel.")
+    """Soft round bevel."""
+
+
+class PresetMaterial(BaseXmlEnum):
+    """Preset 3-D surface material for a shape.
+
+    Used with ``shape.three_d.preset_material``.
+
+    Maps to the ``prstMaterial`` attribute on ``<a:sp3d>``.
+    """
+
+    # Read-only alias: python-pptx2 <= 2.8.0 emitted the camelCase "softMetal"
+    # (invalid per ISO ST_PresetMaterialType). Accept it on read so decks
+    # written by those versions still load; writing always uses "softmetal".
+    __xml_read_aliases__ = {"softMetal": "softmetal"}
+
+    CLEAR = (1, "clear", "Clear (transparent) material.")
+    """Clear (transparent) material."""
+
+    DK_EDGE = (2, "dkEdge", "Dark-edge material.")
+    """Dark-edge material."""
+
+    FLAT = (3, "flat", "Flat (non-reflective) material.")
+    """Flat (non-reflective) material."""
+
+    LEGACY_MATTE = (4, "legacyMatte", "Legacy matte material.")
+    """Legacy matte material."""
+
+    LEGACY_METAL = (5, "legacyMetal", "Legacy metal material.")
+    """Legacy metal material."""
+
+    LEGACY_PLASTIC = (6, "legacyPlastic", "Legacy plastic material.")
+    """Legacy plastic material."""
+
+    LEGACY_WIREFRAME = (7, "legacyWireframe", "Legacy wireframe material.")
+    """Legacy wireframe material."""
+
+    MATTE = (8, "matte", "Matte material.")
+    """Matte material."""
+
+    METAL = (9, "metal", "Metal material.")
+    """Metal material."""
+
+    NONE = (10, "none", "No explicit material (leaves prstMaterial unset).")
+    """No explicit material.
+
+    Assigning this to ``shape.three_d.preset_material`` *clears* the material
+    (leaves ``prstMaterial`` unset) rather than emitting the token ``"none"``,
+    which is invalid per ISO ``ST_PresetMaterialType`` and would make
+    PowerPoint report the file as broken. For an explicit flat surface use
+    :attr:`FLAT`.
+    """
+
+    PLASTIC = (11, "plastic", "Plastic material.")
+    """Plastic material."""
+
+    POWDER = (12, "powder", "Powder material.")
+    """Powder material."""
+
+    SOFT_EDGE = (13, "softEdge", "Soft-edge material.")
+    """Soft-edge material."""
+
+    SOFT_METAL = (14, "softmetal", "Soft-metal material.")
+    """Soft-metal material.
+
+    The ISO/IEC 29500 ``ST_PresetMaterialType`` enumeration spells this value
+    all-lowercase (``softmetal``); every other material is camelCase. Emitting
+    ``softMetal`` fails schema validation and PowerPoint repairs the file.
+    """
+
+    TRANSLUCENT_POWDER = (15, "translucentPowder", "Translucent powder material.")
+    """Translucent powder material."""
+
+    WARM_MATTE = (16, "warmMatte", "Warm matte material.")
+    """Warm matte material."""
+
+
+class MSO_PRESET_SHADOW(BaseXmlEnum):
+    """Preset-shadow style for a shape.
+
+    Used with ``shape.preset_shadow.preset``.  Maps to the (schema-required)
+    ``prst`` attribute on ``<a:prstShdw>``, whose ISO/IEC 29500
+    ``ST_PresetShadowVal`` enumeration spans the twenty values ``shdw1`` ..
+    ``shdw20``.  The bare strings ``"shdw1"`` .. ``"shdw20"`` are also accepted
+    by ``preset_shadow.preset`` for convenience.
+    """
+
+    SHADOW_1 = (1, "shdw1", "Preset shadow 1 (top-left offset).")
+    """Preset shadow 1."""
+
+    SHADOW_2 = (2, "shdw2", "Preset shadow 2.")
+    """Preset shadow 2."""
+
+    SHADOW_3 = (3, "shdw3", "Preset shadow 3.")
+    """Preset shadow 3."""
+
+    SHADOW_4 = (4, "shdw4", "Preset shadow 4.")
+    """Preset shadow 4."""
+
+    SHADOW_5 = (5, "shdw5", "Preset shadow 5.")
+    """Preset shadow 5."""
+
+    SHADOW_6 = (6, "shdw6", "Preset shadow 6.")
+    """Preset shadow 6."""
+
+    SHADOW_7 = (7, "shdw7", "Preset shadow 7.")
+    """Preset shadow 7."""
+
+    SHADOW_8 = (8, "shdw8", "Preset shadow 8.")
+    """Preset shadow 8."""
+
+    SHADOW_9 = (9, "shdw9", "Preset shadow 9.")
+    """Preset shadow 9."""
+
+    SHADOW_10 = (10, "shdw10", "Preset shadow 10.")
+    """Preset shadow 10."""
+
+    SHADOW_11 = (11, "shdw11", "Preset shadow 11.")
+    """Preset shadow 11."""
+
+    SHADOW_12 = (12, "shdw12", "Preset shadow 12.")
+    """Preset shadow 12."""
+
+    SHADOW_13 = (13, "shdw13", "Preset shadow 13.")
+    """Preset shadow 13."""
+
+    SHADOW_14 = (14, "shdw14", "Preset shadow 14.")
+    """Preset shadow 14."""
+
+    SHADOW_15 = (15, "shdw15", "Preset shadow 15.")
+    """Preset shadow 15."""
+
+    SHADOW_16 = (16, "shdw16", "Preset shadow 16.")
+    """Preset shadow 16."""
+
+    SHADOW_17 = (17, "shdw17", "Preset shadow 17.")
+    """Preset shadow 17."""
+
+    SHADOW_18 = (18, "shdw18", "Preset shadow 18.")
+    """Preset shadow 18."""
+
+    SHADOW_19 = (19, "shdw19", "Preset shadow 19.")
+    """Preset shadow 19."""
+
+    SHADOW_20 = (20, "shdw20", "Preset shadow 20 (bottom-right offset).")
+    """Preset shadow 20."""