powerpoint-toolbox/docs/USER_GUIDE.md

# 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

## Grid & Guidelines Tools

These tools help you align and position elements precisely on slides using grids and guidelines.

### Custom Grid

Creates a customizable grid overlay on the current slide to help with precise positioning and alignment.

**How to use:**
1. Navigate to the slide where you want to add a grid
2. In the Grid & Guidelines section, configure the grid options:
   - **Spacing** - Set the distance between grid lines (in points)
   - **Opacity** - Adjust how visible the grid appears
   - **Color** - Choose from blue, red, yellow, or green
3. Click "Create Grid" to add the grid to the current slide
4. Click "Remove Grid" to clear the grid from the slide

**Note:** The grid appears only on the current slide and is for visual reference only - it won't appear in presentation mode or exports.

### Guidelines

Add precise horizontal or vertical guidelines at specific positions on your slide.

**How to use:**
1. Navigate to the slide where you want to add guidelines
2. In the Grid & Guidelines section:
   - **Position** - Set the position of the guideline (in points from top/left)
   - **Type** - Choose horizontal or vertical
   - **Color** - Select a color for the guideline
3. Click "Add Guideline" to add the specified guideline
4. Click "Remove All" to clear all guidelines from the slide

**Tip:** Use different colors for different types of guidelines (e.g., blue for margins, red for key alignment points).

## 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 v1.1.0.

### What's New in v1.1.0

* **Performance Improvements** - Faster operations especially when working with multiple shapes
* **Enhanced Stability** - Improved error handling and recovery
* **Better UI Experience** - More responsive interface with improved scrolling
* **Accessibility Enhancements** - Better support for screen readers and keyboard navigation
* **Code Quality** - Improved TypeScript typing for increased reliability