Struct AutoShape 

pub struct AutoShape { /* private fields */ }

自选形状（带或不带文本都可以）。

Implementations

impl AutoShape

pub fn new(name: impl Into<String>, geometry: PresetGeometry) -> Self

构造一个指定几何形状（不设置位置/尺寸，由调用方决定）。

pub fn from_sp(sp: OxmlSp) -> Self

从 oxml OxmlSp 构造包装。

pub fn sp(&self) -> &OxmlSp

取出内部 oxml 引用。

pub fn sp_mut(&mut self) -> &mut OxmlSp

取出内部 oxml 可变引用。

pub fn text_frame(&self) -> &TextBody

文本体不可变引用。

pub fn text_frame_mut(&mut self) -> &mut TextBody

文本体可变引用。

pub fn properties(&self) -> &ShapeProperties

形状属性不可变引用。

pub fn properties_mut(&mut self) -> &mut ShapeProperties

形状属性可变引用。

pub fn set_fill(&mut self, fill: Fill)

设填充。

pub fn set_fill_color(&mut self, c: impl Into<Color>)

便捷方法：设填充为指定 RGB 颜色。

对应 python-pptx 中 shape.fill.solid(); shape.fill.fore_color.rgb = RGBColor(r, g, b)。

pub fn set_stroke_color(&mut self, c: impl Into<Color>)

便捷方法：设描边颜色。

pub fn set_stroke_width(&mut self, w: Emu)

便捷方法：设描边宽度（EMU）。通常 Pt(1.0).emu()。

pub fn set_outer_shadow(&mut self, shadow: ShadowEffect)

设置外阴影（<a:outerShdw>）。覆盖既有外阴影，保留其他效果。

对标 python-pptx shape.shadow.inherit = False + shape.shadow.outerShadow。

示例

sh.set_outer_shadow(ShadowEffect {
    dir: 2_700_000,        // 向下（1/60000 度）
    dist: 38_100,          // 3pt（EMU）
    blur_rad: 38_100,
    color: Color::RGB(RGBColor(0x80, 0x80, 0x80)),
    rot_with_shape: None,
});

pub fn set_inner_shadow(&mut self, shadow: ShadowEffect)

设置内阴影（<a:innerShdw>）。

pub fn set_glow(&mut self, glow: GlowEffect)

设置发光（<a:glow>）。

pub fn set_soft_edge(&mut self, rad: i64)

设置柔化边缘（<a:softEdge>）。

pub fn set_reflection(&mut self, reflection: ReflectionEffect)

设置反射（<a:reflection>）。

pub fn clear_effects(&mut self)

清除所有效果（删除整个 <a:effectLst> 元素）。

pub fn set_3d_rotation(&mut self, lat_deg: f64, lon_deg: f64, rev_deg: f64)

设置三维旋转（<a:rot lat="..." lon="..." rev="..."/>）。

三个角度均以度为单位（用户直觉），内部转换为 1/60000 度（OOXML ST_Angle）。 若 scene3d 不存在则自动创建默认 Scene3d（正交前视图 + 平衡光）。

参数

• lat_deg：纬度（-90°~90°，正值抬头）
• lon_deg：经度（0°~360°，正值右转）
• rev_deg：滚转（沿视线轴的旋转，正值顺时针）

示例

sh.set_3d_rotation(30.0, 45.0, 0.0); // 抬头 30° + 右转 45°

pub fn set_3d_extrusion(&mut self, height_emu: i32, color: Option<Color>)

设置三维拉伸高度与可选拉伸颜色（<a:sp3d extrusionH="..."> + <a:extrusionClr>）。

参数

• height_emu：拉伸高度（EMU，38100 = 3pt）
• color：拉伸颜色（None 表示不写出 <a:extrusionClr>）

pub fn set_3d_bevel( &mut self, top_w: i32, top_h: i32, bottom_w: i32, bottom_h: i32, )

设置三维棱台（<a:bevelT> + <a:bevelB>）。

参数

• top_w / top_h：顶部棱台的宽高（EMU，63500 = 5pt）
• bottom_w / bottom_h：底部棱台的宽高（EMU）

pub fn set_3d_material(&mut self, material: MaterialPreset)

设置三维材质预设（<a:sp3d prstMaterial="...">）。

pub fn clear_3d(&mut self)

清除所有三维效果（删除 scene3d + sp3d）。

pub fn scene_3d(&self) -> Option<&Scene3d>

取三维场景引用（camera + lightRig）。None 表示未设置 3D 场景。

pub fn scene_3d_mut(&mut self) -> &mut Option<Scene3d>

取三维场景可变引用（可直接操作 camera / lightRig）。

pub fn sp_3d(&self) -> Option<&Sp3d>

取形状三维属性引用（拉伸/棱台/材质）。

pub fn sp_3d_mut(&mut self) -> &mut Option<Sp3d>

取形状三维属性可变引用。

pub fn locks(&self) -> Option<&ShapeLocks>

读取形状锁定（<a:spLocks>）。None 表示未设置。

pub fn locks_mut(&mut self) -> &mut ShapeLocks

读取形状锁定的可变引用。若未设置，自动初始化为空 ShapeLocks（无任何锁定）。

pub fn lock_select(&mut self, locked: bool)

便捷锁定：禁止选中（noSelect="1"）。

pub fn lock_move(&mut self, locked: bool)

便捷锁定：禁止移动（noMove="1"）。

pub fn lock_resize(&mut self, locked: bool)

便捷锁定：禁止缩放（noResize="1"）。

pub fn lock_rotate(&mut self, locked: bool)

便捷锁定：禁止旋转（noRot="1"）。

pub fn lock_group(&mut self, locked: bool)

便捷锁定：禁止组合（noGrp="1"）。

pub fn clear_locks(&mut self)

清除所有锁定。

pub fn set_lock(&mut self, lock_type: LockType, locked: bool)

统一锁定入口：按 crate::oxml::shape::LockType 设置指定锁定（TODO-027 高阶 API）。

对标 python-pptx 风格 shape.set_lock(MSO_SHAPE_LOCK_TYPE.Select, True)。 比 lock_select / lock_move 等具名方法更通用，可覆盖所有 12 种锁定类型。

参数

• lock_type：锁定类型枚举；
• locked：true 启用，false 解除。

示例

sh.set_lock(LockType::Select, true);
sh.set_lock(LockType::ChangeAspect, true);
assert!(sh.locks().unwrap().get_lock(LockType::Select));

pub fn style(&self) -> Option<&ShapeStyle>

读取主题样式引用（<p:style>）。None 表示未设置。

pub fn set_style(&mut self, style: ShapeStyle)

设置主题样式引用（<p:style>）。

对标 python-pptx shape.style 的底层元素引用方式。

参数

• style：主题样式（line_ref / fill_ref / effect_ref / font_ref）

pub fn clear_style(&mut self)

清除主题样式引用。

pub fn set_text(&mut self, t: impl Into<String>)

便捷方法：设文本（单段单 Run）。多段请用 text_frame_mut().add_paragraph。

pub fn text(&self) -> String

文本快捷访问：返回首段首 Run 的文本（多段时只反映首段）。

pub fn adjustments(&self) -> &[AdjustmentValue]

取调整值列表（不可变）。

对标 python-pptx shape.adjustments。

pub fn adjustments_mut(&mut self) -> &mut Vec<AdjustmentValue>

取调整值列表（可变）。

如果几何不是 Preset 变体，返回空 Vec 的可变引用（实际是临时变量）。 调用方应确保几何是 Preset 类型后再调用。

pub fn set_adjustment(&mut self, idx: usize, value: f64)

设置指定索引的调整值（归一化 0.0-1.0）。

对标 python-pptx shape.adjustments[0] = 0.15。

参数

• idx：调整值索引（0-based）；
• value：归一化值（0.0-1.0）。

行为

• 若 idx 超出现有列表长度，自动追加新条目；
• 新条目的 name 默认为 "adj" （首个）或 "adjN"（后续）。

pub fn adjustment_value(&self, idx: usize) -> Option<f64>

取指定索引的调整值归一化值（0.0-1.0）。

对标 python-pptx shape.adjustments[0]。

Trait Implementations

impl Clone for AutoShape

fn clone(&self) -> AutoShape

Returns a duplicate of the value.

fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Debug for AutoShape

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl Default for AutoShape

fn default() -> AutoShape

Returns the “default value” for a type.

impl Shape for AutoShape

fn rotation(&self) -> f64

旋转角度（度数，正向顺时针）。

fn set_rotation(&mut self, deg: f64)

设置旋转角度。OOXML 内部单位是“60000 分之一度“， 本方法在读写时自动转换。

fn id(&self) -> u32

形状唯一 ID（在所属 slide 内）。

fn set_id(&mut self, id: u32)

设置 ID。

fn name(&self) -> &str

形状名。

fn set_name(&mut self, name: String)

设置形状名。

fn shape_type(&self) -> &'static str

形状类型（如 "text_box" / "picture" / …）。

fn left(&self) -> Emu

左上角 x（EMU）。

fn set_left(&mut self, emu: Emu)

设置左上角 x。

fn top(&self) -> Emu

左上角 y（EMU）。

fn set_top(&mut self, emu: Emu)

设置左上角 y。

fn width(&self) -> Emu

宽（EMU）。

fn set_width(&mut self, emu: Emu)

设置宽。

fn height(&self) -> Emu

高（EMU）。

fn set_height(&mut self, emu: Emu)

设置高。