### Install pptxtojson with npm

Source: https://github.com/pipipi-pikachu/pptxtojson/blob/master/README.md

Install the library using npm. This is the first step before using it in your project.

```bash
npm install pptxtojson
```

--------------------------------

### Node.js Usage Example (Experimental)

Source: https://github.com/pipipi-pikachu/pptxtojson/blob/master/README.md

Example for using pptxtojson in a Node.js environment. Requires version 1.5.0 or higher. Reads a local .pptx file and parses it.

```javascript
const pptxtojson = require('pptxtojson/dist/index.cjs')
const fs = require('fs')

async function func() {
  const buffer = fs.readFileSync('test.pptx')

  const json = await pptxtojson.parse(buffer.buffer, {
    imageMode: 'base64',
    videoMode: 'none',
    audioMode: 'none',
  })
  console.log(json)
}

func()
```

--------------------------------

### Browser Usage Example

Source: https://github.com/pipipi-pikachu/pptxtojson/blob/master/README.md

Example of how to use pptxtojson in a browser environment. It involves an input file element and FileReader API to process the .pptx file.

```html
<input type="file" accept="application/vnd.openxmlformats-officedocument.presentationml.presentation"/>
```

```javascript
import { parse } from 'pptxtojson'

document.querySelector('input').addEventListener('change', evt => {
	const file = evt.target.files[0]
	
	const reader = new FileReader()
	reader.onload = async e => {
		const json = await parse(e.target.result, {
			imageMode: 'base64',
			videoMode: 'none',
			audioMode: 'none',
		})
		console.log(json)
	}
	reader.readAsArrayBuffer(file)
})
```

--------------------------------

### pptxtojson Output Structure

Source: https://github.com/pipipi-pikachu/pptxtojson/blob/master/README.md

An example of the JSON output structure generated by pptxtojson. It includes slides, theme colors, and document size.

```json
{
	"slides": [
		{
			"fill": {
				"type": "color",
				"value": "#FF0000"
			},
			"elements": [
				{
					"left":	0,
					"top": 0,
					"width": 72,
					"height":	72,
					"borderColor": "#1F4E79",
					"borderWidth": 1,
					"borderType": "solid",
					"borderStrokeDasharray": 0,
					"fill": {
						"type": "color",
						"value": "#FF0000"
					},
					"content": "<p style=\"text-align: center;\"><span style=\"font-size: 18pt;font-family: Calibri;\">TEST</span></p>",
					"isFlipV": false,
					"isFlipH": false,
					"rotate": 0,
					"vAlign": "mid",
					"name": "矩形 1",
					"type": "shape",
					"shapType": "rect"
				},
				// more...
			],
			"layoutElements": [
				// more...
			],
			"note": "演讲者备注内容..."
		},
		// more...
	],
	"themeColors": ['#4472C4', '#ED7D31', '#A5A5A5', '#FFC000', '#5B9BD5', '#70AD47'],
	"size": {
		"width": 960,
		"height": 540
	}
}
```

--------------------------------

### Parse .pptx File with pptxtojson

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Use the `parse` function to convert a .pptx file (as an ArrayBuffer) into a JSON object. Configure image, video, and audio output modes. This example shows browser-side file input and Node.js usage.

```javascript
import { parse } from 'pptxtojson'

// 浏览器端：监听 <input type="file"> 上传事件
document.querySelector('input[type="file"]').addEventListener('change', async (evt) => {
  const file = evt.target.files[0]
  const reader = new FileReader()

  reader.onload = async (e) => {
    try {
      const json = await parse(e.target.result, {
        imageMode: 'base64',  // 图片以 base64 输出（可选 'blob' | 'both' | 'none'）
        videoMode: 'blob',    // 视频以 blob URL 输出（可选 'none'）
        audioMode: 'blob',    // 音频以 blob URL 输出（可选 'none'）
      })

      console.log('幻灯片总数:', json.slides.length)
      console.log('幻灯片尺寸:', json.size)           // { width: 960, height: 540 }
      console.log('主题色:', json.themeColors)         // ['#4472C4', '#ED7D31', ...]
      console.log('内嵌字体:', json.usedFonts)         // ['微软雅黑', 'Calibri', ...]
      console.log('第一页元素:', json.slides[0].elements)
    } catch (err) {
      console.error('解析失败:', err)
    }
  }
  reader.readAsArrayBuffer(file)
})

// Node.js 端（1.5.0+ 实验性支持）
const pptxtojson = require('pptxtojson/dist/index.cjs')
const fs = require('fs')

async function parseFile() {
  const buffer = fs.readFileSync('presentation.pptx')
  const json = await pptxtojson.parse(buffer.buffer, {
    imageMode: 'base64',
    videoMode: 'none',
    audioMode: 'none',
  })
  console.log(JSON.stringify(json.slides[0], null, 2))
}
parseFile()
```

--------------------------------

### Options Configuration

Source: https://github.com/pipipi-pikachu/pptxtojson/blob/master/README.md

Explanation of the available options for the `parse` function, which control how media resources are handled.

```markdown
The `parse` function accepts an optional `options` object with the following properties:

- `imageMode`: Controls image resource parsing. Options: `base64`, `blob`, `both`, `none`. Default: `base64`.
  - `base64`: Parses only base64 encoded images.
  - `blob`: Parses only blob images.
  - `both`: Parses both base64 and blob images.
  - `none`: Does not parse image content.

- `videoMode`: Controls video resource parsing. Options: `blob`, `none`. Default: `none`.
  - `blob`: Parses video as blob.
  - `none`: Does not parse video content.

- `audioMode`: Controls audio resource parsing. Options: `blob`, `none`. Default: `none`.
  - `blob`: Parses audio as blob.
  - `none`: Does not parse audio content.
```

--------------------------------

### parse(file, options?)

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

The main entry point for parsing a .pptx file. It accepts an ArrayBuffer and optional configuration, returning a JSON object with slides, theme colors, fonts, and dimensions.

```APIDOC
## parse(file, options?)

### Description
This is the sole public export function of the library. It takes an `ArrayBuffer` of a .pptx file and optional configuration settings. It asynchronously returns a JSON object containing all slide data, including slides, theme colors, used fonts, and slide dimensions.

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **file** (ArrayBuffer) - Required - The .pptx file content as an ArrayBuffer.
- **options** (object) - Optional - Configuration options for parsing.
  - **imageMode** (string) - Optional - Controls how image resources are output. Supported values: `'base64'` (default), `'blob'`, `'both'`, `'none'`.
  - **videoMode** (string) - Optional - Controls how video resources are output. Supported values: `'blob'` (default), `'none'`.
  - **audioMode** (string) - Optional - Controls how audio resources are output. Supported values: `'blob'` (default), `'none'`.

### Request Example
```javascript
import { parse } from 'pptxtojson'

// Browser example
document.querySelector('input[type="file"]').addEventListener('change', async (evt) => {
  const file = evt.target.files[0]
  const reader = new FileReader()

  reader.onload = async (e) => {
    try {
      const json = await parse(e.target.result, {
        imageMode: 'base64',
        videoMode: 'blob',
        audioMode: 'blob',
      })
      console.log('Total slides:', json.slides.length)
      console.log('Slide size:', json.size)
      console.log('Theme colors:', json.themeColors)
      console.log('Used fonts:', json.usedFonts)
      console.log('First slide elements:', json.slides[0].elements)
    } catch (err) {
      console.error('Parsing failed:', err)
    }
  }
  reader.readAsArrayBuffer(file)
})

// Node.js example (experimental support for 1.5.0+)
const pptxtojson = require('pptxtojson/dist/index.cjs')
const fs = require('fs')

async function parseFile() {
  const buffer = fs.readFileSync('presentation.pptx')
  const json = await pptxtojson.parse(buffer.buffer, {
    imageMode: 'base64',
    videoMode: 'none',
    audioMode: 'none',
  })
  console.log(JSON.stringify(json.slides[0], null, 2))
}
parseFile()
```

### Response
#### Success Response (200)
- **slides** (array) - An array of slide objects, each containing elements, shapes, etc.
- **themeColors** (array) - An array of theme color strings (e.g., hex codes).
- **usedFonts** (array) - An array of strings representing the fonts used in the presentation.
- **size** (object) - An object with `width` and `height` properties indicating the slide dimensions in points.

#### Response Example
```json
{
  "slides": [
    {
      "elements": [
        {
          "type": "text",
          "content": "Example Text",
          "x": 100,
          "y": 100,
          "width": 200,
          "height": 50
        }
      ]
    }
  ],
  "themeColors": ["#4472C4", "#ED7D31"],
  "usedFonts": ["微软雅黑", "Calibri"],
  "size": {"width": 960, "height": 540}
}
```
```

--------------------------------

### options.imageMode

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Configures the output format for image resources within slides, supporting base64, blob, both, or none.

```APIDOC
## options.imageMode

### Description
This option controls the output format for image resources, including background images, image elements, and images used to fill shapes. It supports four modes: `'base64'` (default), `'blob'`, `'both'`, and `'none'`. Image data is stored in the `base64` and/or `blob` fields of the element, while the `ref` field always retains the internal file path reference.

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
- **imageMode** (string) - Required - Specifies the image output format. Options:
  - `'base64'`: Outputs images as base64 encoded strings. Suitable for server-side rendering or scenarios not relying on `URL.createObjectURL`.
  - `'blob'`: Outputs images as Blob URLs. Optimized for direct display in browsers and better memory management.
  - `'both'`: Outputs both base64 and blob URLs.
  - `'none'`: Does not parse image content, only retains the path reference. This is the fastest option.

### Request Example
```javascript
// Only output base64 (suitable for server-side rendering or scenarios not relying on URL.createObjectURL)
const jsonBase64 = await parse(arrayBuffer, { imageMode: 'base64' })
const imgEl = jsonBase64.slides[0].elements.find(el => el.type === 'image')
// imgEl.base64 => "data:image/png;base64,iVBORw0KGgo..."
// imgEl.blob   => ""

// Only output blob (suitable for direct display in browsers, more memory efficient)
const jsonBlob = await parse(arrayBuffer, { imageMode: 'blob' })
const imgEl2 = jsonBlob.slides[0].elements.find(el => el.type === 'image')
// imgEl2.blob  => "blob:http://localhost/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
// imgEl2.base64 => ""

// Output both base64 and blob
const jsonBoth = await parse(arrayBuffer, { imageMode: 'both' })

// Do not parse image content (only retain path reference, fastest)
const jsonNone = await parse(arrayBuffer, { imageMode: 'none' })
const imgEl3 = jsonNone.slides[0].elements.find(el => el.type === 'image')
// imgEl3.ref   => "ppt/media/image1.png"
// imgEl3.base64 => ""
// imgEl3.blob  => ""
```

### Response
#### Success Response (200)
- **slides** (array) - Array of slide objects. Each object may contain an `elements` array with image elements.
  - **elements[].base64** (string) - Base64 encoded image data if `imageMode` is `'base64'` or `'both'`.
  - **elements[].blob** (string) - Blob URL for the image if `imageMode` is `'blob'` or `'both'`.
  - **elements[].ref** (string) - Internal path reference to the image file.

#### Response Example
```json
{
  "slides": [
    {
      "elements": [
        {
          "type": "image",
          "ref": "ppt/media/image1.png",
          "base64": "data:image/png;base64,iVBORw0KGgo...",
          "blob": "blob:http://localhost/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
        }
      ]
    }
  ]
}
```
```

--------------------------------

### Parse PPTX and Log Slide Elements

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Parses a PPTX file into JSON and logs information about slide layout elements and content elements. The rendering order is demonstrated, with layout elements appearing below content elements.

```javascript
const json = await parse(arrayBuffer, { imageMode: 'base64' })
const slide = json.slides[0]

// 渲染顺序：layoutElements（背景装饰）在下，elements（内容）在上
const allElements = [...slide.layoutElements, ...slide.elements]
allElements.sort((a, b) => (a.order || 0) - (b.order || 0))

allElements.forEach(el => {
  console.log(`[${el.type}] order=${el.order}`, el.left, el.top)
})
```

--------------------------------

### Parse Video and Audio Elements - 'video' / 'audio'

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Extract video and audio elements, controlling resource loading with `videoMode` and `audioMode`. Supports various formats and provides direct URLs for external resources.

```javascript
const json = await parse(arrayBuffer, {
  videoMode: 'blob',
  audioMode: 'blob',
})

for (const el of json.slides[0].elements) {
  if (el.type === 'video') {
    console.log('视频引用路径:', el.ref)   // 'ppt/media/video1.mp4' 或外链 URL
    console.log('视频 blob URL:', el.blob) // 'blob:http://...' 或 ''
    // 可直接绑定到 <video src={el.blob || el.ref}>
  }
  if (el.type === 'audio') {
    console.log('音频引用路径:', el.ref)
    console.log('音频 blob URL:', el.blob)
    // 可直接绑定到 <audio src={el.blob || el.ref}>
  }
}
```

--------------------------------

### Configure Image Resource Parsing Modes

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Control how images within slides are parsed using the `imageMode` option. Choose between 'base64', 'blob', 'both', or 'none' to manage image data storage and retrieval.

```javascript
// 仅输出 base64（适合服务端渲染或不依赖 URL.createObjectURL 的场景）
const jsonBase64 = await parse(arrayBuffer, { imageMode: 'base64' })
const imgEl = jsonBase64.slides[0].elements.find(el => el.type === 'image')
// imgEl.base64 => "data:image/png;base64,iVBORw0KGgo..."
// imgEl.blob   => ""

// 仅输出 blob（适合浏览器直接展示，内存更优）
const jsonBlob = await parse(arrayBuffer, { imageMode: 'blob' })
const imgEl2 = jsonBlob.slides[0].elements.find(el => el.type === 'image')
// imgEl2.blob  => "blob:http://localhost/xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx"
// imgEl2.base64 => ""

// 同时输出 base64 和 blob
const jsonBoth = await parse(arrayBuffer, { imageMode: 'both' })

// 不解析图片内容（仅保留路径引用，速度最快）
const jsonNone = await parse(arrayBuffer, { imageMode: 'none' })
const imgEl3 = jsonNone.slides[0].elements.find(el => el.type === 'image')
// imgEl3.ref   => "ppt/media/image1.png"
// imgEl3.base64 => ""
// imgEl3.blob  => ""
```

--------------------------------

### Parse Slide Transition Animations - 'slide.transition'

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Access slide transition animation details, including type, duration, and direction. Supports inheritance from slide masters and layouts, with options for automatic page turning.

```javascript
const json = await parse(arrayBuffer)

for (const slide of json.slides) {
  const t = slide.transition
  if (!t) {
    console.log('无切换动画')
    continue
  }
  console.log('动画类型:', t.type)         // 'none' | 'fade' | 'push' | 'wipe' | 'zoom' 等
  console.log('持续时间:', t.duration)     // 毫秒，如 1000
  console.log('方向:', t.direction)        // 'l' | 'r' | 'u' | 'd' 等（部分动画有方向）
  if (t.autoNextAfter !== undefined) {
    console.log('自动翻页延时:', t.autoNextAfter, 'ms')
  }
}
```

--------------------------------

### Parse Formula Elements - 'math'

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Parse mathematical formulas into LaTeX strings, with fallback image representations in base64 or blob format. Handles inline formulas with associated text content.

```javascript
const json = await parse(arrayBuffer, { imageMode: 'base64' })

for (const el of json.slides[0].elements) {
  if (el.type === 'math') {
    console.log('LaTeX 表达式:', el.latex)
    // '\frac{-b \pm \sqrt{b^{2}-4ac}}{2a}'

    console.log('公式图片路径:', el.picRef)    // 'ppt/media/image2.emf'
    console.log('公式图片base64:', el.picBase64) // 'data:image/emf;base64,...'
    console.log('公式图片blob:', el.picBlob)

    // 当公式与文字混排时
    if (el.text) {
      console.log('混排文字:', el.text)         // HTML 富文本
    }

    // 渲染示例（使用 KaTeX）
    // katex.render(el.latex, document.getElementById('formula'))
  }
}
```

--------------------------------

### slide.fill

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Describes the background fill properties of a slide, supporting color, gradient, image, and pattern fills.

```APIDOC
## slide.fill

### Description
Each slide object has a `fill` property that describes the page background. It supports four types of fills: solid color, gradient, image, and pattern. Fill information is inherited hierarchically from the slide itself, its slide layout, and its slide master, with higher-level sources taking precedence.

### Parameters
#### Path Parameters
None

#### Query Parameters
None

#### Request Body
None (This describes a property of the parsed slide object).

### Request Example
None

### Response
#### Success Response (200)
- **slides[].fill** (object) - An object describing the slide's background fill.
  - **type** (string) - The type of fill. Possible values: `'color'`, `'gradient'`, `'image'`, `'pattern'`.
  - **value** (any) - The specific details of the fill, varying by type:
    - For `'color'`: A hex color string (e.g., `'#FF0000'`).
    - For `'gradient'`: An object with `rot` (rotation angle), `path` (gradient shape), and `colors` (an array of color stops with `pos` and `color`).
    - For `'image'`: An object with `base64` (image data), `opacity` (0-1), and potentially other image properties.
    - For `'pattern'`: An object with `type` (pattern name), `foregroundColor`, and `backgroundColor`.

#### Response Example
```javascript
const json = await parse(arrayBuffer, { imageMode: 'base64' })

for (const slide of json.slides) {
  const fill = slide.fill

  if (fill.type === 'color') {
    // Solid color background
    console.log('Background color:', fill.value) // '#FF0000'
  }
  else if (fill.type === 'gradient') {
    // Gradient background
    console.log('Gradient angle:', fill.value.rot)   // 45 (degrees)
    console.log('Gradient path:', fill.value.path)  // 'line' | 'circle' | 'rect' | 'shape'
    console.log('Gradient stops:', fill.value.colors)
    // [{ pos: '0%', color: '#FFFFFF' }, { pos: '100%', color: '#4472C4' }]
  }
  else if (fill.type === 'image') {
    // Image background
    console.log('Background image base64:', fill.value.base64) // "data:image/jpeg;base64,..."
    console.log('Background image opacity:', fill.value.opacity) // 0~1
  }
  else if (fill.type === 'pattern') {
    // Pattern background
    console.log('Pattern type:', fill.value.type)             // 'smCheck'
    console.log('Foreground color:', fill.value.foregroundColor)    // '#000000'
    console.log('Background color:', fill.value.backgroundColor)   // '#FFFFFF'
  }
}
```
```

--------------------------------

### Parse SmartArt Diagrams - 'diagram'

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Extract SmartArt diagrams, which are parsed into a structure containing child elements and a text list. Child elements can be rendered using standard text/shape logic.

```javascript
const json = await parse(arrayBuffer, { imageMode: 'base64' })

for (const el of json.slides[0].elements) {
  if (el.type === 'diagram') {
    console.log('SmartArt 位置:', el.left, el.top)
    console.log('SmartArt 尺寸:', el.width, el.height)

    // 文字内容清单（所有节点的文字汇总）
    console.log('文字列表:', el.textList) // ['流程一', '流程二', '流程三']

    // 子元素（可直接渲染）
    el.elements.forEach(child => {
      console.log('子元素类型:', child.type)     // 'text' | 'shape'
      console.log('子元素内容:', child.content)
      console.log('子元素位置:', child.left, child.top)
    })
  }
}
```

--------------------------------

### Parse Image Elements

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Extract image properties including references, base64 data, blob URLs, cropping information, and filter effects. Supports various image modes for parsing.

```javascript
const json = await parse(arrayBuffer, { imageMode: 'both' })

for (const el of json.slides[0].elements) {
  if (el.type === 'image') {
    console.log('图片路径:', el.ref)          // 'ppt/media/image1.png'
    console.log('base64:', el.base64)         // 'data:image/png;base64,ներ'
    console.log('blob URL:', el.blob)         // 'blob:http://...'
    console.log('裁剪形状:', el.geom)         // 'rect' | 'ellipse' | 'custom:circle' | ...
    console.log('裁剪范围:', el.rect)
    // { t: 10, b: 10, l: 5, r: 5 } — 单位: 千分之一百分比（‰%）

    if (el.filters) {
      console.log('亮度:', el.filters.brightness)         // -1 ~ 1
      console.log('对比度:', el.filters.contrast)         // -1 ~ 1
      console.log('饱和度:', el.filters.saturation)       // 0 ~ ...
      console.log('锐化:', el.filters.sharpen)            // 0 ~ 1
      console.log('柔化:', el.filters.soften)             // 0 ~ 1
      console.log('色温:', el.filters.colorTemperature)   // 数值（K）
    }
    if (el.borderWidth) {
      console.log('边框:', el.borderColor, el.borderWidth, el.borderType)
      // '#FF0000', 2, 'solid' | 'dashed' | 'dotted'
    }
  }
}
```

--------------------------------

### Parse Slide Background Fill Types

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Iterate through slides to access and interpret the `fill` property, which describes the background of each slide. This property can represent solid colors, gradients, images, or patterns, with values inherited from slide, layout, or master.

```javascript
const json = await parse(arrayBuffer, { imageMode: 'base64' })

for (const slide of json.slides) {
  const fill = slide.fill

  if (fill.type === 'color') {
    // 纯色背景
    console.log('背景颜色:', fill.value) // '#FF0000'
  }
  else if (fill.type === 'gradient') {
    // 渐变背景
    console.log('渐变角度:', fill.value.rot)   // 45 (度)
    console.log('渐变路径:', fill.value.path)  // 'line' | 'circle' | 'rect' | 'shape'
    console.log('渐变色标:', fill.value.colors)
    // [{ pos: '0%', color: '#FFFFFF' }, { pos: '100%', color: '#4472C4' }]
  }
  else if (fill.type === 'image') {
    // 图片背景
    console.log('背景图 base64:', fill.value.base64) // "data:image/jpeg;base64,..."
    console.log('背景图透明度:', fill.value.opacity) // 0~1
  }
  else if (fill.type === 'pattern') {
    // 图案背景
    console.log('图案类型:', fill.value.type)             // 'smCheck'
    console.log('前景色:', fill.value.foregroundColor)    // '#000000'
    console.log('背景色:', fill.value.backgroundColor)   // '#FFFFFF'
  }
}
```

--------------------------------

### Parse Chart Elements - 'chart'

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Iterate through slide elements to identify and extract data for various chart types like line, bar, pie, and scatter charts. Specific properties like bar direction, grouping, and hole size for doughnut charts are accessible.

```javascript
const json = await parse(arrayBuffer)

for (const el of json.slides[0].elements) {
  if (el.type === 'chart') {
    console.log('图表类型:', el.chartType)
    // 'lineChart' | 'barChart' | 'pieChart' | 'doughnutChart'
    // 'areaChart' | 'scatterChart' | 'bubbleChart' | 'radarChart'
    // 'surfaceChart' | 'stockChart' | 'line3DChart' | 'bar3DChart' ...

    console.log('系列颜色:', el.colors)    // ['#4472C4', '#ED7D31', ...]

    // 柱状图/折线图数据格式
    if (el.chartType === 'barChart') {
      console.log('柱状图方向:', el.barDir)   // 'bar'（水平）| 'col'（垂直）
      console.log('分组模式:', el.grouping)   // 'clustered' | 'stacked' | 'percentStacked'
      el.data.forEach(series => {
        console.log('系列名:', series.key)
        console.log('X轴标签:', series.xlabels)  // { '0': 'Q1', '1': 'Q2', ... }
        console.log('数据点:', series.values)    // [{ x: '0', y: 100 }, { x: '1', y: 150 }]
      })
    }

    // 饼图/环形图
    if (el.chartType === 'doughnutChart') {
      console.log('圆孔大小:', el.holeSize)    // 如 '75' (%)
    }

    // 折线图
    if (el.chartType === 'lineChart') {
      console.log('数据标记:', el.marker)      // true | false
    }
  }
}
```

--------------------------------

### Parse Text and Shape Elements

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Iterate through slide elements to extract properties of text and shape types. Content is returned as HTML, and shape-specific attributes like `shapType` and `path` are available.

```javascript
const json = await parse(arrayBuffer, { imageMode: 'base64' })
const slide = json.slides[0]

for (const el of slide.elements) {
  if (el.type === 'text' || el.type === 'shape') {
    console.log('元素名:', el.name)
    console.log('位置:', el.left, el.top)           // 单位: pt
    console.log('尺寸:', el.width, el.height)       // 单位: pt
    console.log('旋转角度:', el.rotate)              // 度
    console.log('水平翻转:', el.isFlipH)
    console.log('垂直翻转:', el.isFlipV)
    console.log('垂直对齐:', el.vAlign)             // 'top' | 'mid' | 'down'
    console.log('竖向文字:', el.isVertical)         // 仅 text 类型
    console.log('文本内容(HTML):', el.content)
    // "<p style=\"text-align: center;"><span style=\"font-size: 24pt;font-family: 微软雅黑;color: #FF0000;font-weight: bold;">标题文字</span></p>"

    if (el.fill) {
      console.log('填充类型:', el.fill.type)        // 'color' | 'gradient' | 'image' | 'pattern'
    }
    if (el.shadow) {
      console.log('阴影:', el.shadow)               // { type: 'outer', color: '#000000', ... }
    }
    if (el.link) {
      console.log('超链接:', el.link)               // 'https://example.com'
    }
    if (el.autoFit) {
      console.log('自动调整:', el.autoFit.type)     // 'shape' | 'text'
      console.log('字体缩放:', el.autoFit.fontScale) // 如 0.8
    }
    if (el.textInset) {
      console.log('文本内边距:', el.textInset)      // { top, right, bottom, left } 单位 pt
    }

    // 仅 shape 类型
    if (el.type === 'shape') {
      console.log('形状类型:', el.shapType)         // 'rect' | 'ellipse' | 'triangle' | 'custom' | ...
      console.log('SVG路径:', el.path)              // 'M0,0 L72,0 L72,72 L0,72 Z'
      console.log('调整参数:', el.keypoints)        // { adj: 0.5 }
    }
  }
}
```

--------------------------------

### Parse Table Elements

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Extract detailed table information including row heights, column widths, borders, and cell data. Each cell contains its text content (HTML), formatting, and span information.

```javascript
const json = await parse(arrayBuffer)

for (const el of json.slides[0].elements) {
  if (el.type === 'table') {
    console.log('表格位置:', el.left, el.top)
    console.log('行高:', el.rowHeights)    // [30, 30, 30] 单位: pt
    console.log('列宽:', el.colWidths)    // [120, 120, 120] 单位: pt
    console.log('整体边框:', el.borders)

    el.data.forEach((row, rowIndex) => {
      row.forEach((cell, colIndex) => {
        console.log(`[${rowIndex},${colIndex}]`, {
          text: cell.text,         // HTML 富文本
          fillColor: cell.fillColor,  // '#4472C4'
          fontColor: cell.fontColor,  // '#FFFFFF'
          fontBold: cell.fontBold,
          vAlign: cell.vAlign,        // 'top' | 'mid' | 'down'
          rowSpan: cell.rowSpan,      // 合并行数
          colSpan: cell.colSpan,      // 合并列数
          vMerge: cell.vMerge,        // 被纵向合并（不显示）
          hMerge: cell.hMerge,        // 被横向合并（不显示）
          borders: cell.borders,      // 单元格独立边框
        })
      })
    })
  }
}
```

--------------------------------

### Parse Grouped Elements - 'group'

Source: https://context7.com/pipipi-pikachu/pptxtojson/llms.txt

Handle grouped elements, where child element coordinates are relative to the group container and normalized by the group's scaling. This structure supports recursive nesting.

```javascript
const json = await parse(arrayBuffer)

function renderElement(el, depth = 0) {
  const indent = '  '.repeat(depth)
  console.log(`${indent}[${el.type}] 位置:(${el.left}, ${el.top}) 尺寸:${el.width}x${el.height}`)

  if (el.type === 'group' && el.elements) {
    el.elements.forEach(child => renderElement(child, depth + 1))
  }
}

json.slides[0].elements.forEach(el => renderElement(el))
// [group] 位置:(100, 50) 尺寸:300x200
//   [shape] 位置:(0, 0) 尺寸:100x100
//   [text] 位置:(110, 20) 尺寸:180x60
//   [group] 位置:(0, 110) 尺寸:300x80
//     [shape] 位置:(0, 0) 尺寸:150x80
//     [image] 位置:(160, 10) 尺寸:130x60
```

=== COMPLETE CONTENT === This response contains all available snippets from this library. No additional content exists. Do not make further requests.