Comment utiliser IronPPT avec GitHub Copilot

Curtis Chau
Curtis Chau
Mis à jour : 19 octobre 2026

Une agence immobilière envoie aux agents des acheteurs un ensemble de ses maisons ouvertes chaque vendredi. Chaque annonce immobilière reçoit une diapositive avec jusqu'à trois photos, et les photos arrivent des téléphones et des appareils photo dans différentes tailles, formes et résolutions. Un service .NET dans le dépôt de l'agence construit l'ensemble, donc tout assistant qui modifie ce service doit placer chaque photo dans son cadre sans la déformer.

GitHub Copilot accède au dépôt via le chat et le mode agent dans Visual Studio et VS Code, via Copilot CLI dans un terminal, et via un agent cloud sur GitHub qui transforme un problème assigné en une demande de tirage. IronPPT crée et édite des fichiers PowerPoint en .NET sans Microsoft Office. AddImage place une image sur une diapositive, et la classe Image redimensionne, remplace et supprime cette image. Les fichiers d'instructions engagés dans le dépôt donnent à chacune de ces interfaces les règles IronPPT.

Ce guide couvre la direction de Copilot pour construire un logiciel qui place des photos avec IronPPT. Prendre les photos et concevoir le modèle de la diapositive sont des tâches séparées qui se déroulent en dehors du dépôt. Le guide de gestion des images décrit les appels IronPPT dont dépend l'ensemble des annonces.

Démarrage rapide
NuGetInstaller avec NuGet

PM > Install-Package IronPPT

Installez IronPPT en exécutant la commande ci-dessus dans la console du gestionnaire de packages NuGet, ou recherchez le package dans le gestionnaire de packages NuGet.

Ouvrez un terminal à la racine du dépôt, lancez Copilot CLI et soumettez l'invite. Copilot CLI attache un fichier avec @, tandis que Copilot Chat dans Visual Studio utilise des références #.

Fill in @src/Listings.Deck/ListingDeck.cs so the agency can build its weekly open-homes deck.
The repo already pins IronPPT 2026.10.1 in Directory.Packages.props.

Here is what the deck code needs:
- One public static method, Build(string listingsPath, string photosDir, string outPath).
- Listings come from @data/listings.json.
- Each listing's photos are in photos/<listing id>/, under the file names the JSON gives.
- The cover and every listing slide follow @docs/listing-layout.md.

Then do these in order:
1. Add a build command with an --out <path> option to @src/Listings.Cli/Program.cs.
2. Build the solution.
3. From the repo root, run the CLI with build --out out/listings.pptx.

Tell me how many slides the deck has and how large the file is.
Text

L'invite ne nomme ni boîte ni coordonnée, car docs/listing-layout.md définit les boîtes photos en points et l'ordre des lignes de texte.

Définissez IRONPPT_LICENSE_KEY dans l'environnement où Copilot fonctionne. IronPPT ne lit pas ce nom par lui-même. Lors de notre test, License.IsLicensed est resté faux lorsque seule cette variable a été définie. IronPPT a bien lu les variables nommées IronPPT.LicenseKey et IRONPPT_LICENSEKEY par lui-même, mais le dépôt exemple copie le nom conventionnel dans License.LicenseKey. Le guide clé de licence répertorie les autres emplacements pris en charge.



Comment définissez-vous les conventions IronPPT pour Copilot ?

Placez les règles à l'échelle du projet dans .github/copilot-instructions.md. La référence de support de GitHub répertorie ce fichier pour Copilot Chat dans Visual Studio, VS Code et les IDE JetBrains, ainsi que pour l'agent cloud et la révision de code Copilot. Copilot CLI le lit à partir du même emplacement. Visual Studio le charge tandis que son option d'instructions personnalisées est sélectionnée, et cette option est activée par défaut.

This repo builds the weekly open-homes deck with IronPPT. These rules apply to all of it:
- Use IronPPT, the NuGet package and namespace. Don't add another presentation or Open XML package.
- Edit the IronPPT entry in Directory.Packages.props only when the task is an IronPPT upgrade.
- Give other packages their versions in Directory.Packages.props as well.
- The code reads IRONPPT_LICENSE_KEY itself, because IronPPT doesn't look at that name.
- Copy the key into License.LicenseKey before the code saves a deck.
- Never print the key, and never list environment variables.
- docs/listing-layout.md is the contract.
- If the layout doc looks wrong, say so in your reply and leave the file as it is.
- The IronPPT docs index for agents is https://ironsoftware.com/ppt/csharp/llms.txt

Tests follow two more rules:
- A test saves a deck, reopens it and checks its pictures and text.
- Never compare the bytes of two decks.
Markdown

IronPPT nomme chaque image avec un numéro aléatoire, tel que Image 86115, de sorte que deux constructions des mêmes annonces différaient octet par octet. Les tests comparent les images et le texte pour cette raison.

Comment donnez-vous au code de l'ensemble ses propres règles ?

Un fichier tel que .github/instructions/deck.instructions.md contient des règles pour les parties de l'arborescence que ses modèles applyTo nomment, ici les projets source et de test. Selon la documentation de GitHub, Copilot CLI inclut le fichier uniquement lorsqu'il fonctionne sur un fichier qui correspond à l'un de ces modèles. Au cours de l'exécution du test, Copilot a ouvert ce fichier avant tout autre fichier dans la première invite et dans la session distincte du problème.

---
applyTo: "src/**,tests/**"
---

These rules cover IronPPT pictures and slides in the deck code and its tests:
- Every new PresentationDocument already has a slide. Make the cover from that slide.
- Don't add another slide in front of the cover.
- Give every picture an explicit Width, Height and Position, in points.
- Without them, IronPPT sizes a photo from its pixels and DPI.
- At 72 dpi, a 4032 x 3024 photo comes out 56 x 42 inches.
- The default slide is 10 x 7.5 inches.
- Setting Width leaves Height as it was, and the reverse.
- Work out both from the photo's pixel size to keep its aspect ratio.
- On a deck loaded from a file, call Replace on document.Images, not on a slide's Images list.
- Replace resets the picture to the new photo's own size.
- So set Width, Height and Position again after each Replace.
- Width, Height and Position read from a reopened deck are 12,700 times the value in points.
- AddImage with an AnyBitmap stores the picture as an uncompressed BMP.
- To store a resized photo as a JPEG, encode it first and pass the stream.
Markdown

Chaque règle dans ce fichier provient d'un examen de IronPPT 2026.10.1.

Quelle taille IronPPT donne-t-il à une photo d'annonce ?

AddImage sans taille donne à l'image un cadre du nombre de pixels de la photo divisé par ses DPI, en pouces, et n'écrit aucune position pour elle. La diapositive par défaut mesure 10 par 7,5 pouces, ce qui équivaut à 720 par 540 points.

  • Une photo de téléphone 4032 par 3024 enregistrée à 72 dpi a reçu un cadre de 56 par 42 pouces.
  • La même photo 2048 par 1536 enregistrée à 300, 72 et 96 dpi a reçu des cadres de 6,8, 28,4 et 21,3 pouces de large. Un PNG sans DPI a été dimensionné à 96 dpi.
  • Un JPEG avec une densité de 1 par 1 et sans unité dans son en-tête a été dimensionné à 1 dpi, donc une photo de 4032 pixels est devenue large de 4032 pouces.
  • Largeur, Hauteur et Position prennent des points. Définir la largeur à 400 seule a laissé la hauteur inchangée, de sorte que le cadre a perdu le rapport d'aspect de la photo.

L'ajustement dans docs/listing-layout.md commence donc par la taille en pixels de la photo. Le facteur de mise à l'échelle est le plus petit de la largeur de la boîte divisée par la largeur de la photo et de la hauteur de la boîte divisée par la hauteur de la photo, et le cadre mis à l'échelle est centré dans la boîte.

Comment échangez-vous une photo dans un ensemble enregistré ?

Swap the hero photo of L-1044 in out/listings.pptx for photos/reshoot/L-1044-front.jpg.
The photographer reshot the front, and the new photo is portrait.
Change the saved deck itself. Don't rebuild it from the JSON.

Add the swap to the CLI as a swap command with these options:
- --deck <path> names the deck to change.
- --listing <id> and --photo <n> pick the picture, counting photos from 1.
- --file <path> is the new photo.

The new photo goes in the hero box and follows the fit rules in docs/listing-layout.md.
Leave every other picture and all the text as they are.

Run the command, reopen the deck and show me the hero's position and size in points.
Text

Replace a donné trois résultats différents dans les examens.

  • Sur un ensemble construit en mémoire, Replace a échangé la photo et a réinitialisé le cadre à la taille de la nouvelle photo, sans position.
  • Sur un ensemble chargé, Replace appelé via une liste Images d'une diapositive n'a pas modifié l'image demandée dans aucun examen. Une diapositive avec une image a conservé l'ancienne photo et a stocké la nouvelle photo dans le fichier non utilisée. Sur une diapositive avec deux images, l'appel sur la première image a échangé la deuxième.
  • Via document.Images, Replace sur un ensemble chargé a échangé la bonne image. Définir la largeur, la hauteur et la position après l'appel a donné au cadre la bonne taille et la bonne place.

L'exemple de remplacement du guide de gestion des images appelle Replace via Slides[0].Images[0] sur un ensemble chargé, ce qui est la voie qui a laissé l'ancienne photo en place.

Sortie

L'exécution du test a enregistré la diapositive pour 220 Mill Road avant et après l'échange.

Diapositive d'annonce pour 220 Mill Road avant l'échange, avec une photo principale en mode paysage et une vignette

La diapositive 4 comme première invite l'a enregistrée, chaque image étant dessinée à sa position et sa taille stockées. Le texte n'est pas dessiné, et les photos sont des images de test générées.

Diapositive d'annonce pour 220 Mill Road après l'échange, avec le nouveau tir en mode portrait centré dans la boîte héros

La diapositive 4 après la commande d'échange, dessinée de la même manière.

Comment testez-vous l'ensemble ?

Utilisez Shift+Tab pour faire passer Copilot CLI en mode plan, puis soumettez cette invite.

Plan an xUnit project at tests/Listings.Deck.Tests, and put it in the solution.
Show me the plan first, and hold the code until I say go.

Each test builds a deck from data/listings.json in a temp folder and checks one of these:
- The deck has a cover plus one slide per listing, in the order of the JSON.
- Each listing slide holds one picture per photo, in the box the layout doc gives that photo.
- Every picture keeps its photo's aspect ratio within 0.5% and stays inside its box.
- The address, the price and the bed and bath line are on the right slide.
- The swap command changes the chosen picture and no other.

Once I say go, write the tests and keep running dotnet test until they pass.
Then tell me how many tests passed.
Text

Un test des boîtes doit lire des tailles que IronPPT rapporte de manière incorrecte. Largeur, Hauteur et Position lues à partir d'un ensemble rouvert renvoient 12 700 fois leur valeur en points, ce qui est la valeur en EMUs, l'unité que le fichier PPTX stocke. Un cadre de 480 points lu en retour en tant que 6 096 000. Les tests de l'exécution ont divisé les valeurs lues par 12 700 avant de les comparer avec la mise en page.

Pourquoi le marquage d'une annonce vendue laisse-t-il des photos ?

Dans ce scénario, SoldUpdate.cs d'un collègue supprime les photos d'une annonce vendue dans une boucle.

Find out why marking a listing sold leaves photos behind, then fix it.
@src/Listings.Deck/SoldUpdate.cs edits a saved deck.
It should strip the listing's photos from its slide and add a SOLD line.

Work through these steps before you touch SoldUpdate.cs:
1. Write a test that builds a deck, marks L-1042 sold and counts the pictures left on its slide.
2. Read how https://ironsoftware.com/ppt/csharp/how-to/manage-image/ removes all images.
3. Tell me what Slide.Images returns in IronPPT that explains the leftover photos.

The fix has to meet these conditions:
- It changes SoldUpdate.cs and no other source file.
- The new test expects no pictures on the slide.
- dotnet test passes.

Last, mark L-1042 sold in a copy of out/listings.pptx.
Tell me the copy's size before and after.
Text

Slide.Images construit une nouvelle liste à chaque accès. Une boucle qui lit slide.Images à nouveau à chaque passage, avec un index qui compte en augmentant, saute une image après chaque suppression. Sur une diapositive avec quatre images, elle en a supprimé deux, et sur une diapositive d'annonce avec trois, elle en a supprimé deux et en a laissé une. Une boucle qui compte en décroissant, comme le fait l'exemple de suppression de toutes les images du guide de gestion des images, a supprimé toutes les images, tout comme un foreach sur une copie de la liste.

La suppression laisse également les octets de la photo dans le fichier. Supprimer quatre images d'un ensemble de 13 766 065 octets a enregistré un fichier de 13 765 502 octets.

Qu'est-ce qui rend un problème sur lequel l'agent cloud peut agir ?

Lorsqu'un problème est attribué à Copilot, GitHub transmet à l'agent le titre du problème, sa description, les commentaires existants à ce moment-là et toutes les instructions données lors de l'attribution. Les commentaires ajoutés plus tard n'atteignent pas l'agent, donc le corps du problème doit contenir l'ensemble de la demande.

Title: Shrink the weekly deck so it can be emailed

Files: src/Listings.Deck/ListingDeck.cs and tests/Listings.Deck.Tests
Versions: IronPPT 2026.10.1 on net9.0

Expected: out/listings.pptx is under 4 MB, and the deck code works like this:
- IronPPT gets a scaled copy of any photo wider or taller than 1600 pixels.
- The copy is 1600 pixels on its long side and is stored as a JPEG at quality 85.
- Every picture keeps the box, position and size it has now.

Actual: IronPPT stores each photo file as it is, so the deck is over 15 MB.

Constraints: the change stays inside these limits:
- Keep the Build signature.
- Follow .github/instructions/deck.instructions.md.
- Add no packages.
- Leave the files in photos/ untouched.

Acceptance: the issue is done when all of this holds:
- The existing tests pass.
- A new test builds the deck and opens each photo stored under ppt/media in the saved file.
- That test fails if any stored photo is over the 1600-pixel limit.

Summary: give the deck's size before and after the change.
Markdown

IronPPT copie chaque fichier photo dans l'ensemble octet par octet, et une photo ajoutée trois fois est stockée trois fois. Une photo mise à l'échelle passée à AddImage sous forme de AnyBitmap a été stockée sous forme de BMP non compressé de 7 680 122 octets pour 1600 par 1200 pixels. Les mêmes pixels encodés en JPEG de qualité 85 et passés sous forme de flux ont été stockés sous forme de 337 813 octets.

Pourquoi les tests de l'agent cloud échouent-ils sur un projet IronPPT ?

L'agent cloud fonctionne sur Ubuntu Linux à moins que le dépôt ne choisisse autrement. IronPPT cible .NET Standard 2.0, et aucun des packages qu'il restaure ne contient de fichier natif, donc les étapes de configuration n'installent rien au-delà du SDK .NET.

Le runner n'a également aucune clé de licence. Sans elle, IronPPT a construit des ensembles en mémoire et a lu des ensembles enregistrés, mais Save a lancé une exception de licence et n'a pas écrit de fichier. Chaque test qui enregistre un ensemble échoue donc sur le runner.

GitHub exécute le travail copilot-setup-steps dans .github/workflows/copilot-setup-steps.yml avant le démarrage de l'agent, et uniquement lorsque le fichier est sur la branche par défaut. Lorsqu'une étape de configuration échoue, Copilot passe les étapes suivantes.

Add a workflow at .github/workflows/copilot-setup-steps.yml to prepare the cloud agent's machine.
GitHub reads only a job named copilot-setup-steps from that file.

Set the job up this way:
- It runs on ubuntu-latest with contents: read as its one permission.
- It triggers on workflow_dispatch and on any pull request that edits this file.

Give it these steps, in order:
1. Check out the repo.
2. Set up .NET 9.
3. Run dotnet restore.
4. Run dotnet build -c Release.
5. Check for the license key.

IRONPPT_LICENSE_KEY is an Agents secret.
GitHub's docs say copilot-setup-steps.yml can use Agents secrets.

The key check handles a missing key in two ways:
- A pull_request or workflow_dispatch run gets a warning, and the step still succeeds.
- Any other run fails, and the error names the missing secret.

Write the file and print the YAML for me.
Then tell me how the key check reads the key, and cite the GitHub page you followed.
Text

Mettez la clé dans les secrets des Agents : selon GitHub, l'agent cloud n'a pas accès aux secrets Actions, Codespaces ou Dependabot. Dans les paramètres du dépôt, ouvrez Secrets et variables dans la section Sécurité, sélectionnez Agents et ajoutez IRONPPT_LICENSE_KEY dans l'onglet Secrets. La documentation de GitHub ne donne aucun exemple d'une étape de configuration qui lit un secret d'Agents.

Que faut-il vérifier avant de fusionner ?

Exécutez l'examen comme une commande copilot -p séparée, en dehors de la session qui a écrit le code.

/review this branch against main.

Compare the code with these three sources and list each spot where they disagree:
- the rules in .github/copilot-instructions.md
- the rules in .github/instructions/deck.instructions.md
- IronPPT.xml, which ships inside the IronPPT package in the NuGet cache

Also check for two patterns that no rule file covers:
- a loop that removes pictures while its index counts up
- a line that prints the message of a licensing exception

Tell me what you find, and say so if nothing turns up. Don't change any file.
Text

Qu'est-ce que les messages ont produit lors d'une réelle exécution ?

Les sept invites ont été exécutées sans surveillance dans Copilot CLI contre un dépôt de listings construit pour ce guide. Une vérification distincte a lu chaque chiffre ci-dessous à partir des ensembles enregistrés et du dépôt.

  • Avant l'exécution, ListingDeck était une classe vide et la CLI imprimait une ligne d'utilisation et se terminait avec le code 1.
  • Après la première invite, l'ensemble contenait une couverture et quatre diapositives d'annonces, soit 15 150 897 octets au total.
  • Toutes les 10 images étaient dans leurs boîtes sans erreur mesurable de rapport d'aspect, taille ou centrage.
  • L'échange a remplacé le héros de 220 Mill Road via document.Images.
  • Le nouveau tir en mode portrait mesurait 243 par 324 points, centré dans la boîte héros.
  • Aucune des neuf autres images ni le texte des diapositives n'ont changé lors de l'échange.
  • En mode plan, Copilot a écrit un plan, n'a modifié aucun fichier et a attendu le message d'approbation.
  • La correction a inversé la boucle dans SoldUpdate.cs.
  • Marquer 18 Alder Court vendue n'a alors laissé aucune image sur sa diapositive.
  • Copilot a attribué les photos restantes aux entrées se déplaçant à l'intérieur d'une liste et n'a pas mentionné que chaque lecture de Slide.Images construit une nouvelle liste.
  • Trois photos supprimées, soit 6 469 676 octets au total, sont restées dans la copie vendue.
  • La session du problème a mis à l'échelle neuf photos à 1600 pixels sur le côté long avec SixLabors.ImageSharp, qu'IronPPT intègre déjà, et n'a ajouté aucun package.
  • L'ensemble reconstruit mesurait 1 198 644 octets.
  • Chaque image a conservé sa taille et sa position.
  • Avec la clé définie, tous les sept tests ont réussi. Sans elle, tous les sept ont échoué avec l'exception de licence.
  • La session d'examen a comparé la branche avec la principale, n'a signalé aucun désaccord et n'a modifié aucun fichier.
  • Certaines étapes ont été exécutées différemment de la page. Le corps du problème est allé à une nouvelle session Copilot CLI, car le dépôt de test n'a pas de distant GitHub. Le flux de travail de configuration a été écrit mais non exécuté, pour la même raison.

Cursor applique également des fichiers de règles engagés aux chemins correspondants, et Claude Code conserve également son plan pour approbation avant de modifier le code. Le dossier d'exécution partagé répertorie la version de Copilot CLI, le modèle Auto sélectionné, la durée et la machine de test.


Dépannage


Des questions ?

Si vous avez des questions, contactez support@ironsoftware.com

Curtis Chau détient un baccalauréat en informatique (Université de Carleton) et se spécialise dans le développement front-end avec expertise en Node.js, TypeScript, JavaScript et React. Passionné par la création d'interfaces utilisateur intuitives et esthétiquement plaisantes, Curtis aime travailler avec des frameworks modernes et créer des manuels bien structurés et visuellement attrayants.

Lire la suite

Prêt à commencer ?

Téléchargements NuGet 7,110Version :2026.11tout juste publié