# 图片参数 (Image Props)

图片参数来自 `ImageProps`（继承 `PositionProps`、`DataOrPathProps`、`ObjectNameProps`），用于 `slide.addImage()` 方法。

---

## 位置属性 (PositionProps)

- **x**：水平位置
  - 类型：`Coord`（`number | `${number}%``）
  - 单位：英寸（number）或百分比（`'50%'`）

- **y**：垂直位置
  - 类型：`Coord`
  - 单位：英寸或百分比

- **w**：宽度
  - 类型：`Coord`
  - 单位：英寸或百分比

- **h**：高度
  - 类型：`Coord`
  - 单位：英寸或百分比

---

## 数据/路径属性 (DataOrPathProps)

- **path**：图片 URL 或本地路径
  - 类型：`string`
  - 示例：`'https://onedrives.com/myimg.png'`、`'/home/gitbrent/images/myimg.png'`

- **data**：base64 编码数据
  - 类型：`string`
  - 格式：`'image/png;base64,iVtDafDrBF[...]='`
  - 说明：base64 编码的图片数据，用时可避免路径/服务器问题

---

## 对象名称属性 (ObjectNameProps)

- **objectName**：对象名称
  - 类型：`string`
  - 说明：替代默认的 "Object N" 名称，在 PowerPoint 选择窗格中显示
  - 默认值：`'Object 1'`
  - 始于：v3.10.0

---

## 图片专有属性 (ImageProps)

- **altText**：替代文字（无障碍）
  - 类型：`string`
  - 说明：PowerPoint 中右击图片 > "编辑替代文字"

- **flipH**：水平翻转
  - 类型：`boolean`
  - 取值范围：`true` / `false`
  - 默认值：`false`

- **flipV**：垂直翻转
  - 类型：`boolean`
  - 取值范围：`true` / `false`
  - 默认值：`false`

- **hyperlink**：超链接
  - 类型：`HyperlinkProps`
  - 子参数：
    - **hyperlink.slide**：链接到页码
      - 类型：`number`
    - **hyperlink.url**：链接 URL
      - 类型：`string`
    - **hyperlink.tooltip**：超链接提示
      - 类型：`string`

- **placeholder**：占位符类型
  - 类型：`string`
  - 取值范围：`'body'`、`'header'`、`'footer'`、`'title'` 等
  - 示例：`'body'`

- **rotate**：旋转角度
  - 类型：`number`
  - 取值范围：`-360`–`360`（度）
  - 默认值：`0`
  - 示例：`180`（旋转 180 度）

- **rounding**：启用图片圆角
  - 类型：`boolean`
  - 默认值：`false`

- **shadow**：阴影
  - 类型：`ShadowProps`
  - 子参数：
    - **shadow.type**：阴影类型
      - 类型：`'outer' | 'inner' | 'none'`
      - 默认值：`'none'`
    - **shadow.opacity**：不透明度
      - 类型：`number`
      - 取值范围：`0.0`–`1.0`
    - **shadow.blur**：模糊
      - 类型：`number`
      - 取值范围：`0`–`100`（pt）
      - 默认值：`0`
    - **shadow.angle**：角度
      - 类型：`number`
      - 取值范围：`0`–`359`（度）
      - 默认值：`0`
    - **shadow.offset**：偏移距离
      - 类型：`number`
      - 取值范围：`0`–`200`（pt）
      - 默认值：`0`
    - **shadow.color**：阴影颜色
      - 类型：`HexColor`
      - 格式：6 位十六进制（无 `#`）
    - **shadow.rotateWithShape**：阴影是否随形状旋转
      - 类型：`boolean`
      - 默认值：`false`

- **sizing**：图片大小调整
  - 类型：`{ type: 'contain' | 'cover' | 'crop', w: Coord, h: Coord, x?: Coord, y?: Coord }`
  - 子参数：
    - **sizing.type**：调整类型
      - 类型：`'contain' | 'cover' | 'crop'`
      - 取值范围：
        - `contain` — 包含（保持比例适配）
        - `cover` — 覆盖（填充区域）
        - `crop` — 裁剪
    - **sizing.w**：图片宽度
      - 类型：`Coord`（英寸或百分比）
    - **sizing.h**：图片高度
      - 类型：`Coord`（英寸或百分比）
    - **sizing.x**：裁剪左偏移
      - 类型：`Coord`（仅用于 `crop` 模式）
    - **sizing.y**：裁剪上偏移
      - 类型：`Coord`（仅用于 `crop` 模式）

- **transparency**：透明度
  - 类型：`number`
  - 取值范围：`0`–`100`（百分比）
  - 默认值：`0`
  - 示例：`25`（25% 透明）

---

## ShadowProps

用于 `shadow` 属性的类型定义（图表、图片、文字通用）。

- **type**：阴影类型
  - 类型：`'outer' | 'inner' | 'none'`
  - 默认值：`'none'`

- **opacity**：不透明度
  - 类型：`number`
  - 取值范围：`0.0`–`1.0`
  - 示例：`0.5`（50% 不透明）

- **blur**：模糊大小
  - 类型：`number`
  - 取值范围：`0`–`100`（pt）
  - 默认值：`0`

- **angle**：阴影角度
  - 类型：`number`
  - 取值范围：`0`–`359`（度）
  - 默认值：`0`

- **offset**：阴影偏移距离
  - 类型：`number`
  - 取值范围：`0`–`200`（pt）
  - 默认值：`0`

- **color**：阴影颜色
  - 类型：`HexColor`
  - 格式：6 位十六进制（无 `#`）

- **rotateWithShape**：是否随形状旋转
  - 类型：`boolean`
  - 默认值：`false`

---

## HyperlinkProps

用于 `hyperlink` 属性的类型定义。

- **slide**：链接到页码
  - 类型：`number`
  - 说明：跳转到演示文稿的指定幻灯片

- **url**：超链接 URL
  - 类型：`string`
  - 说明：链接到外部网址

- **tooltip**：超链接提示
  - 类型：`string`
  - 说明：鼠标悬停时显示的文字