> ## Documentation Index
> Fetch the complete documentation index at: https://docs.reducto.ai/llms.txt
> Use this file to discover all available pages before exploring further.

# Themes and backgrounds

## `ThemeColorScheme`

`PowerPoint.ThemeColorScheme`. Slides and layouts read their master's theme,
so a change here reaches every slide on that master.

Import from `@reductoai/pptx/officejs`.

### `ThemeColorScheme.getThemeColor()`

```ts theme={null}
getThemeColor(color: ThemeColor): string
```

`#RRGGBB`; Office.js returns a ClientResult.

### `ThemeColorScheme.load()`

```ts theme={null}
load(scheme: ThemeColorSet): void
```

Extension (VBA `ThemeColorScheme.Load`, Design > Colors): names the scheme and sets every slot.

### `ThemeColorScheme.read()`

```ts theme={null}
read(): ThemeColorSet | undefined
```

Extension (VBA `ThemeColorScheme.Load`, Design > Colors): the scheme's name and its twelve colours.

### `ThemeColorScheme.setThemeColor()`

```ts theme={null}
setThemeColor(color: ThemeColor, rgbColor: string): void
```

## `ThemeFontScheme`

Extension (VBA `Theme.ThemeFontScheme`): the master theme's heading and body typefaces,
which `+mj-lt`, `+mn-ea` and the other theme font references resolve to.

Import from `@reductoai/pptx/officejs`.

### `ThemeFontScheme.getThemeFont()`

```ts theme={null}
getThemeFont(role: ThemeFontRole, script?: ThemeFontScript): string
```

The typeface; "" when the theme names none for that script.

### `ThemeFontScheme.load()`

```ts theme={null}
load(scheme: ThemeFontSet): void
```

Extension (VBA `ThemeFontScheme.Load`, Design > Fonts): replaces the heading and body faces.

### `ThemeFontScheme.read()`

```ts theme={null}
read(): ThemeFontSet | undefined
```

Extension (Design > Fonts): the scheme's name and its heading and body faces.

### `ThemeFontScheme.setThemeFont()`

```ts theme={null}
setThemeFont(role: ThemeFontRole, script: ThemeFontScript, name: string): void
```

## `SlideBackground`

`PowerPoint.SlideBackground`. Following means the part states no `p:bg` of its own.

Import from `@reductoai/pptx/officejs`.

### SlideBackground properties

| Name | Type | Description |
| - | - | - |
| `fill` | `SlideBackgroundFill` | read-only |
| `areBackgroundGraphicsHidden` | `boolean` | |
| `colorMapping` | `SlideColorMapping` | Extension (`p:clrMapOvr`): "Dark" maps background 1/2 to dark 1/2 and text 1/2 to light 1/2, as PowerPoint's built-in dark layouts do, so theme-coloured text turns light. |
| `isMasterBackgroundFollowed` | `boolean` | |

### `SlideBackground.reset()`

```ts theme={null}
reset(): void
```

## `TextStyle`

VBA `TextStyle`: one of the master's `p:txStyles` lists.

Import from `@reductoai/pptx/officejs`.

### TextStyle properties

| Name | Type | Description |
| - | - | - |
| `levels` | `TextStyleLevelCollection` | read-only |
| `type` | `TextStyleType` | read-only |

## `SlideShowTransition`

Extension (VBA `SlideShowTransition`): how a slide takes part in the show.

Import from `@reductoai/pptx/officejs`.

### SlideShowTransition properties

| Name | Type | Description |
| - | - | - |
| `advanceOnClick` | `boolean` | VBA `SlideShowTransition.AdvanceOnClick`. |
| `advanceTime` | `number \| null` | VBA `SlideShowTransition.AdvanceTime` in seconds; null when the slide does not advance on its own. |
| `direction` | `SlideTransitionDirection \| null` | Extension: the side a wipe, push, cover or pull moves toward; null for other effects. |
| `duration` | `number` | VBA `SlideShowTransition.Duration` in seconds: `p14:dur`, else the length of the speed. |
| `entryEffect` | `SlideTransitionEffect` | VBA `SlideShowTransition.EntryEffect`, named after the DrawingML effect. |
| `hidden` | `boolean` | VBA `SlideShowTransition.Hidden`: `p:sld@show="0"`. The show and a PDF export skip the slide. |
| `speed` | `SlideTransitionSpeed` | VBA `SlideShowTransition.Speed`; Fast when unstated. |
