API Reference

Class

PowerPointDesignBrief

Namespace OfficeIMO.PowerPoint
Assembly OfficeIMO.PowerPoint
Modifiers sealed

Small deck design brief that can resolve a brand, purpose, identity, and optional custom directions into one or more deterministic deck designs.

Inheritance

  • Object
  • PowerPointDesignBrief

Usage

This type appears in these public API surfaces even when no hand-authored example is attached directly to the page.

Accepted by parameters

Constructors

public PowerPointDesignBrief(String accentColor, String seed) #

Creates a brief from a brand accent and stable seed.

Parameters

accentColor System.String requiredposition: 0
seed System.String requiredposition: 1

Methods

public PowerPointDesignBrief AddDirection(PowerPointDesignDirection direction) #
Returns: PowerPointDesignBrief

Adds one caller-supplied creative direction.

Parameters

direction OfficeIMO.PowerPoint.PowerPointDesignDirection requiredposition: 0
public PowerPointDesignBrief ClearDesignPreferences() #
Returns: PowerPointDesignBrief

Clears direction ordering preferences.

public IReadOnlyList<PowerPointDeckDesign> CreateAlternatives(Int32 count = 0) #
Returns: IReadOnlyList<PowerPointDeckDesign>

Creates deterministic deck design alternatives from this brief.

Parameters

count System.Int32 = 0 optionalposition: 0
public PowerPointDeckDesign CreateDesign(Int32 alternativeIndex = 0) #
Returns: PowerPointDeckDesign

Creates one deterministic deck design from this brief.

Parameters

alternativeIndex System.Int32 = 0 optionalposition: 0
public IReadOnlyList<PowerPointDeckDesignSummary> DescribeAlternatives(Int32 count = 0) #
Returns: IReadOnlyList<PowerPointDeckDesignSummary>

Creates lightweight descriptions of generated alternatives without requiring callers to inspect the deck objects.

Parameters

count System.Int32 = 0 optionalposition: 0
DescribeDeckPlan 2 overloads
public IReadOnlyList<PowerPointDeckPlanSlideRenderSummary> DescribeDeckPlan(PowerPointDeckPlan plan, Int32 alternativeIndex = 0) #
Returns: IReadOnlyList<PowerPointDeckPlanSlideRenderSummary>

Creates lightweight descriptions of how a deck plan would resolve under one design alternative.

Parameters

plan OfficeIMO.PowerPoint.PowerPointDeckPlan requiredposition: 0
alternativeIndex System.Int32 = 0 optionalposition: 1
public IReadOnlyList<PowerPointDeckPlanSlideRenderSummary> DescribeDeckPlan(PowerPointDeckPlan plan, Int32 alternativeIndex, Int32 slideIndexOffset) #
Returns: IReadOnlyList<PowerPointDeckPlanSlideRenderSummary>

Creates lightweight descriptions of how a deck plan would resolve under one design alternative, using an existing composer slide count for fallback seed generation.

Parameters

plan OfficeIMO.PowerPoint.PowerPointDeckPlan requiredposition: 0
alternativeIndex System.Int32 requiredposition: 1
slideIndexOffset System.Int32 requiredposition: 2
DescribeDeckPlanAlternatives 2 overloads
public IReadOnlyList<PowerPointDeckPlanAlternativeSummary> DescribeDeckPlanAlternatives(PowerPointDeckPlan plan, Int32 count = 0) #
Returns: IReadOnlyList<PowerPointDeckPlanAlternativeSummary>

Creates lightweight descriptions of how a deck plan would resolve across several design alternatives.

Parameters

plan OfficeIMO.PowerPoint.PowerPointDeckPlan requiredposition: 0
count System.Int32 = 0 optionalposition: 1
public IReadOnlyList<PowerPointDeckPlanAlternativeSummary> DescribeDeckPlanAlternatives(PowerPointDeckPlan plan, Int32 count, Int32 slideIndexOffset) #
Returns: IReadOnlyList<PowerPointDeckPlanAlternativeSummary>

Creates lightweight descriptions of how a deck plan would resolve across several design alternatives, using an existing composer slide count for fallback seed generation.

Parameters

plan OfficeIMO.PowerPoint.PowerPointDeckPlan requiredposition: 0
count System.Int32 requiredposition: 1
slideIndexOffset System.Int32 requiredposition: 2
public PowerPointDesignBrief ForPurpose(String purpose) #
Returns: PowerPointDesignBrief

Sets the plain-language deck purpose used for recipe matching.

Parameters

purpose System.String requiredposition: 0
public static PowerPointDesignBrief FromBrand(String accentColor, String seed, String purpose = null) #
Returns: PowerPointDesignBrief

Creates a brief from a brand accent and stable seed.

Parameters

accentColor System.String requiredposition: 0
seed System.String requiredposition: 1
purpose System.String = null optionalposition: 2
public IReadOnlyList<PowerPointDeckDesignRecommendation> RecommendAlternatives(Int32 count = 0) #
Returns: IReadOnlyList<PowerPointDeckDesignRecommendation>

Creates lightweight recommendations explaining why generated alternatives fit this brief.

Parameters

count System.Int32 = 0 optionalposition: 0
RecommendDeckPlanAlternative 2 overloads
public PowerPointDeckPlanAlternativeSummary RecommendDeckPlanAlternative(PowerPointDeckPlan plan, Int32 count = 0) #
Returns: PowerPointDeckPlanAlternativeSummary

Selects the strongest content-fit recommendation for a deck plan.

Parameters

plan OfficeIMO.PowerPoint.PowerPointDeckPlan requiredposition: 0
count System.Int32 = 0 optionalposition: 1
public PowerPointDeckPlanAlternativeSummary RecommendDeckPlanAlternative(PowerPointDeckPlan plan, Int32 count, Int32 slideIndexOffset) #
Returns: PowerPointDeckPlanAlternativeSummary

Selects the strongest content-fit recommendation for a deck plan, using an existing composer slide count for fallback seed generation.

Parameters

plan OfficeIMO.PowerPoint.PowerPointDeckPlan requiredposition: 0
count System.Int32 requiredposition: 1
slideIndexOffset System.Int32 requiredposition: 2
RecommendDeckPlanAlternatives 2 overloads
public IReadOnlyList<PowerPointDeckPlanAlternativeSummary> RecommendDeckPlanAlternatives(PowerPointDeckPlan plan, Int32 count = 0) #
Returns: IReadOnlyList<PowerPointDeckPlanAlternativeSummary>

Creates content-fit recommendations for a deck plan, ordered with the strongest match first.

Parameters

plan OfficeIMO.PowerPoint.PowerPointDeckPlan requiredposition: 0
count System.Int32 = 0 optionalposition: 1
public IReadOnlyList<PowerPointDeckPlanAlternativeSummary> RecommendDeckPlanAlternatives(PowerPointDeckPlan plan, Int32 count, Int32 slideIndexOffset) #
Returns: IReadOnlyList<PowerPointDeckPlanAlternativeSummary>

Creates content-fit recommendations for a deck plan, ordered with the strongest match first, using an existing composer slide count for fallback seed generation.

Parameters

plan OfficeIMO.PowerPoint.PowerPointDeckPlan requiredposition: 0
count System.Int32 requiredposition: 1
slideIndexOffset System.Int32 requiredposition: 2
public PowerPointDesignBrief WithDirections(IEnumerable<PowerPointDesignDirection> directions) #
Returns: PowerPointDesignBrief

Replaces recipe-based alternatives with caller-supplied creative directions.

Parameters

directions System.Collections.Generic.IEnumerable{OfficeIMO.PowerPoint.PowerPointDesignDirection} requiredposition: 0
public PowerPointDesignBrief WithFonts(String headingFontName = null, String bodyFontName = null) #
Returns: PowerPointDesignBrief

Applies font overrides while preserving the rest of the selected recipe or direction.

Parameters

headingFontName System.String = null optionalposition: 0
bodyFontName System.String = null optionalposition: 1
public PowerPointDesignBrief WithIdentity(String name = null, String eyebrow = null, String footerLeft = null, String footerRight = null) #
Returns: PowerPointDesignBrief

Sets deck identity chrome shared by generated slides.

Parameters

name System.String = null optionalposition: 0
eyebrow System.String = null optionalposition: 1
footerLeft System.String = null optionalposition: 2
footerRight System.String = null optionalposition: 3
public PowerPointDesignBrief WithLayoutStrategy(PowerPointAutoLayoutStrategy layoutStrategy) #
Returns: PowerPointDesignBrief

Chooses how Auto slide variants should balance content fit, design variety, and compactness.

Parameters

layoutStrategy OfficeIMO.PowerPoint.PowerPointAutoLayoutStrategy requiredposition: 0
public PowerPointDesignBrief WithPalette(String secondaryAccentColor = null, String tertiaryAccentColor = null, String warmAccentColor = null, String surfaceColor = null, String panelBorderColor = null) #
Returns: PowerPointDesignBrief

Applies optional supporting palette overrides while preserving the primary brand accent.

Parameters

secondaryAccentColor System.String = null optionalposition: 0
tertiaryAccentColor System.String = null optionalposition: 1
warmAccentColor System.String = null optionalposition: 2
surfaceColor System.String = null optionalposition: 3
panelBorderColor System.String = null optionalposition: 4
public PowerPointDesignBrief WithPaletteStyle(PowerPointPaletteStyle paletteStyle) #
Returns: PowerPointDesignBrief

Chooses a supporting palette strategy while preserving the primary brand accent.

Parameters

paletteStyle OfficeIMO.PowerPoint.PowerPointPaletteStyle requiredposition: 0
public PowerPointDesignBrief WithPreferredDensities(params PowerPointSlideDensity[] densities) #
Returns: PowerPointDesignBrief

Prefers one or more slide densities when ordering recipe or custom directions.

Parameters

densities OfficeIMO.PowerPoint.PowerPointSlideDensity[] requiredposition: 0
public PowerPointDesignBrief WithPreferredMoods(params PowerPointDesignMood[] moods) #
Returns: PowerPointDesignBrief

Prefers one or more moods when ordering recipe or custom directions.

Parameters

moods OfficeIMO.PowerPoint.PowerPointDesignMood[] requiredposition: 0
public PowerPointDesignBrief WithPreferredVisualStyles(params PowerPointVisualStyle[] visualStyles) #
Returns: PowerPointDesignBrief

Prefers one or more visual styles when ordering recipe or custom directions.

Parameters

visualStyles OfficeIMO.PowerPoint.PowerPointVisualStyle[] requiredposition: 0
public PowerPointDesignBrief WithRecipe(PowerPointDesignRecipe recipe) #
Returns: PowerPointDesignBrief

Uses an explicit recipe instead of matching one from the purpose text.

Parameters

recipe OfficeIMO.PowerPoint.PowerPointDesignRecipe requiredposition: 0
public PowerPointDesignBrief WithVariety(PowerPointDesignVariety variety) #
Returns: PowerPointDesignBrief

Sets how broad generated alternatives should be.

Parameters

variety OfficeIMO.PowerPoint.PowerPointDesignVariety requiredposition: 0

Properties

public String AccentColor { get; } #

Brand accent color used to derive the deck palette.

public String Seed { get; } #

Stable seed used to make generated alternatives repeatable.

public String Purpose { get; set; } #

Plain-language purpose used to select a built-in recipe when no explicit recipe is set.

public PowerPointDesignRecipe Recipe { get; set; } #

Explicit recipe. When omitted, the purpose text is matched against built-in recipes.

public String Name { get; set; } #

Optional display name passed into generated deck themes.

public String Eyebrow { get; set; } #

Optional default eyebrow for generated slides.

public String FooterLeft { get; set; } #

Optional left footer for generated slides.

public String FooterRight { get; set; } #

Optional right footer for generated slides.

public String HeadingFontName { get; set; } #

Optional heading font override applied to every generated alternative.

public String BodyFontName { get; set; } #

Optional body font override applied to every generated alternative.

public String SecondaryAccentColor { get; set; } #

Optional secondary accent override applied after recipe variations.

public String TertiaryAccentColor { get; set; } #

Optional tertiary accent override applied after recipe variations.

public String WarmAccentColor { get; set; } #

Optional warm accent override applied after recipe variations.

public String SurfaceColor { get; set; } #

Optional surface color override applied after recipe variations.

public String PanelBorderColor { get; set; } #

Optional panel border color override applied after recipe variations.

public Nullable<PowerPointPaletteStyle> PaletteStyle { get; set; } #

Optional supporting palette strategy applied before explicit palette color overrides.

public Nullable<PowerPointAutoLayoutStrategy> LayoutStrategy { get; set; } #

Optional Auto layout strategy applied to generated design alternatives.

public PowerPointDesignVariety Variety { get; set; } #

Controls how far generated alternatives should move from the selected recipe or preferred direction.

public IReadOnlyList<PowerPointDesignDirection> Directions { get; } #

Caller-supplied creative directions. When present, these take precedence over recipes.

public IReadOnlyList<PowerPointDesignMood> PreferredMoods { get; } #

Preferred moods used to rank recipe or custom directions before alternatives are created.

public IReadOnlyList<PowerPointSlideDensity> PreferredDensities { get; } #

Preferred slide densities used to rank recipe or custom directions before alternatives are created.

public IReadOnlyList<PowerPointVisualStyle> PreferredVisualStyles { get; } #

Preferred visual styles used to rank recipe or custom directions before alternatives are created.