# Edison PowerPoint Add-in User Guide

This guide will help you use the Edison PowerPoint Add-in to create professional presentations quickly and efficiently.

![Edison Add-in](../assets/edison-128.png)

## Getting Started

### Installation

1. If Edison is not already installed, download it from the [Microsoft AppSource](https://appsource.microsoft.com) or follow the installation instructions provided by your organization.

2. Open PowerPoint and navigate to the "Home" tab in the ribbon.

3. Click on the "Edison Pane" button to open the add-in taskpane.

### Interface Overview

The Edison taskpane is organized into several sections:

- **Content** - Tools for manipulating content and shapes
- **Progress Bar** - Add/remove presentation progress indicators
- **Confidential Marking** - Add/remove confidential labels
- **Draft Watermark** - Add/remove draft watermarks
- **Alignment** - Tools for aligning shapes and objects

## Content Tools

### Match Properties

This tool copies visual properties from the first selected shape to all other selected shapes.

**How to use:**
1. Select multiple shapes (the shape you want to copy properties FROM should be selected FIRST)
2. Click the "Match Properties" button
3. All selected shapes will now have the same formatting properties as the first shape

**Properties matched include:**
- Fill color and transparency
- Line style, color, and weight
- Text formatting (if applicable)
- Shadow effects

### Match Sizes

This tool resizes all selected shapes to match the dimensions of the first selected shape.

**How to use:**
1. Select multiple shapes (the shape with the desired size should be selected FIRST)
2. Click the "Match Sizes" button
3. All selected shapes will be resized to match the first shape's width and height

### Swap Positions

This tool exchanges the positions of two selected shapes while maintaining their size and formatting.

**How to use:**
1. Select exactly two shapes
2. Click the "Swap Positions" button
3. The shapes will exchange positions

**Note:** This tool requires exactly two shapes to be selected.

### Insert Titles

This tool adds slide titles to slides that are missing them.

**How to use:**
1. Click the "Insert Titles" button
2. The add-in will scan your presentation and add title placeholders to any slides that don't have titles

**Note:** This affects all slides in the presentation, not just the current slide.

### Round Image

This tool creates circular images by applying a circular mask.

**How to use:**
1. Select an image
2. Click the "Round Image" button
3. The image will be cropped to a circular shape

## Slide Enhancement Tools

### Progress Bar

Adds or removes a visual progress indicator at the bottom of each slide showing the current position in the presentation.

**How to use:**
1. Click "Add Progress Bar" to add a progress indicator to all slides
2. Click "Remove Progress Bar" to remove all progress indicators

**Note:** The progress bar automatically updates as you navigate through the presentation.

### Confidential Marking

Adds or removes a "Confidential" label to all slides in the presentation.

**How to use:**
1. Click "Add Confidential" to add the confidential label to all slides
2. Click "Remove Confidential" to remove all confidential labels

**Note:** The confidential marking appears in the bottom-right corner of each slide.

### Draft Watermark

Adds or removes a "DRAFT" watermark on slide masters to mark in-progress presentations.

**How to use:**
1. Click "Add Draft" to add a DRAFT watermark to the slide masters
2. Click "Remove Draft" to remove all DRAFT watermarks

**Note:** This adds the watermark to slide masters, affecting all slides in the presentation.

## Alignment Tools

These tools align selected objects horizontally or vertically on the slide.

### Horizontal Alignment

**How to use:**
1. Select one or more shapes
2. Click one of the horizontal alignment buttons:
   - **Left** - Aligns all shapes to the left edge
   - **Center** - Centers all shapes horizontally
   - **Right** - Aligns all shapes to the right edge

### Vertical Alignment

**How to use:**
1. Select one or more shapes
2. Click one of the vertical alignment buttons:
   - **Top** - Aligns all shapes to the top edge
   - **Middle** - Centers all shapes vertically
   - **Bottom** - Aligns all shapes to the bottom edge

## Tips and Best Practices

### Selection Order Matters

For tools like Match Properties and Match Sizes, the **first** object you select is the source. Make sure to select the reference object first, then add other objects to your selection.

### Keyboard Shortcuts for Selection

- **Ctrl+Click** (Windows) or **Cmd+Click** (Mac) to select multiple objects
- **Shift+Click** to select a range of objects
- **Ctrl+A** (Windows) or **Cmd+A** (Mac) to select all objects on a slide

### Working with Progress Bars

- Add the progress bar near the end of your presentation development
- If you add or remove slides, you may need to remove and re-add the progress bar

### Draft Watermarks for Review Cycles

- Add the DRAFT watermark when sharing presentations for review
- Remove the watermark before final distribution

## Troubleshooting

### Common Issues

**The add-in shows an error message:**
- Ensure you've selected the appropriate objects for the tool you're using
- For tools that require multiple selections, verify you have the correct number of objects selected

**Changes aren't appearing:**
- Wait for the "Success" message to appear before continuing
- If using slide master features (like Draft Watermark), you may need to switch to normal view to see changes

**The add-in is slow or unresponsive:**
- For large presentations, some operations may take longer
- Wait for the current operation to complete before starting another

### Getting Help

If you encounter issues not covered in this guide, contact your IT department or the add-in administrator.

## Version Information

This user guide is for Edison PowerPoint Add-in v0.1.0.