> [Site index](https://perfectvector.com/llms.txt) — available pages and descriptions.

# SVG в PptxGenJS: четкий логотип на слайдах

> Добавьте настоящий SVG-логотип с PptxGenJS, сохраните пропорции, проверьте медиа внутри PPTX и готовый слайд в приложении для презентаций, которым пользуется ваша аудитория.

Source: https://perfectvector.com/ru/blog/pptxgenjs-svg-image

Language: ru
Author: Irene Kim
Published: 2026-09-28T08:00:00+09:00

Передайте настоящий SVG в `slide.addImage()`, задайте ему прямоугольник с пропорциями изображения и проверьте экспортированный слайд в приложении, где его будут показывать. [Images API PptxGenJS](https://gitbrent.github.io/PptxGenJS/docs/api-images/) принимает `path` изображения или закодированные `data`; числовые значения `x`, `y`, `w` и `h` задаются в дюймах. SVG внутри PPTX полезен, но одного успешного создания файла недостаточно, чтобы узнать, правильно ли его покажет конкретная программа просмотра.

В примере ниже используется исходный двухцветный логотип с настоящим отверстием. Мы создали презентацию с PptxGenJS 4.0.1, проверили ее медиа и отрисовали слайды в LibreOffice. Мы не проверяли эту презентацию в Microsoft PowerPoint. Если ваша команда распространяет файлы `.pptx`, включите приложение получателя в проверку.

## Начните с SVG из контуров, а не с переименованного растра

Сохраните это как `logo.svg`. У него `viewBox` с пропорциями 2:1, два цветных контура и прозрачное круглое отверстие, образованное через `fill-rule="evenodd"`. В нем нет связанных изображений или шрифтов, которые нужно загружать при открытии презентации.

```xml
<svg xmlns="http://www.w3.org/2000/svg" width="240" height="120" viewBox="0 0 240 120">
  <path fill="#176B68" fill-rule="evenodd" d="M24 10h104a14 14 0 0 1 14 14v72a14 14 0 0 1-14 14H24a14 14 0 0 1-14-14V24a14 14 0 0 1 14-14zm52 25a25 25 0 1 0 0 50 25 25 0 0 0 0-50z"/>
  <path fill="#E5A83D" d="M157 10h17l55 100h-21l-42-77-42 77h-19z"/>
</svg>
```

Само имя файла `.svg` мало что доказывает. Файл может содержать встроенное растровое изображение, поэтому проверьте графику, если единственная имеющаяся версия получена из экспорта PNG. [Руководство по форматам логотипов](https://perfectvector.com/ru/blog/logo-file-formats) поможет сохранить векторный оригинал для повторного использования вместо распространения копий только для презентаций.

## Добавьте логотип без изменения пропорций

Установите использованную в этой проверке версию командой `npm install pptxgenjs@4.0.1`. Сохраните этот скрипт Node как `make-deck.cjs` рядом с `logo.svg`, затем запустите `node make-deck.cjs`.

```js
const pptxgen = require("pptxgenjs");
const path = require("node:path");

const pptx = new pptxgen();
pptx.layout = "LAYOUT_WIDE";
const slide = pptx.addSlide();
const logo = path.join(__dirname, "logo.svg");

slide.addImage({ path: logo, x: 1.1, y: 1.3, w: 2.4, h: 1.2 });
slide.addImage({ path: logo, x: 6.3, y: 1.1, w: 4.8, h: 2.4 });

pptx.writeFile({ fileName: "logo-demo.pptx" });
```

Оба прямоугольника имеют пропорции 2:1, как SVG. Во втором размещении каждый размер удваивается. В нашей отрисовке отверстие, цвета и контур оставались узнаваемыми при обоих размерах. Это наблюдение относится к этому простому образцу и этому средству отрисовки; оно не гарантирует результат для любого эффекта SVG или приложения для презентаций.

Для намеренной ошибки мы поместили тот же логотип в прямоугольник **3.6 × 1.0 дюйма**. Его круглое отверстие стало овальным. Прямоугольник **3.6 × 1.8 дюйма** восстановил пропорции 2:1. Изменение только пиксельной `width` SVG не исправит размещение на слайде, где `w` и `h` не соответствуют пропорциям изображения.

![Отрисованный тестовый слайд с двухцветным SVG-логотипом, сжатым в прямоугольник 3.6 на 1.0 дюйма, рядом с тем же логотипом в правильных пропорциях 3.6 на 1.8 дюйма](https://perfectvector.com/blog/pptxgenjs-svg-image/sizing-test.webp)

*Реальная отрисовка нашей тестовой презентации PptxGenJS 4.0.1 в LibreOffice. Слева логотип 2:1 намеренно сжат; справа его пропорции сохранены. Это проверка размеров в LibreOffice, а не совместимости с Microsoft PowerPoint.*

## Проверьте комплект PPTX и отрисованный слайд

`.pptx` — ZIP-архив. Загляните в `ppt/media/`, чтобы подтвердить включение SVG в файл, затем откройте презентацию в целевой программе просмотра. Это отдельные проверки: архив может содержать изображение, тогда как приложение для презентаций показывает что-то другое.

```bash
unzip -l logo-demo.pptx | grep 'ppt/media/'
```

Наш тест с двумя слайдами и четырьмя размещениями содержал четыре медиафайла `.svg`. Он также содержал четыре файла с именами `.png`, первые байты которых были XML SVG, а не сигнатурами PNG. Поэтому суффикс `.png` в этом комплекте **не** доказывал наличие растрового запасного варианта. [Обсуждение проблемы SVG в Node у PptxGenJS](https://github.com/gitbrent/PptxGenJS/issues/963) фиксирует прежние проблемы предпросмотра и программ просмотра; проверяйте свою установленную версию и экспортированный файл, а не предполагайте, что это обсуждение описывает каждую сборку.

Реальная отрисовка LibreOffice показала оба логотипа правильного размера и намеренно сжатый. Мы проверили видимые цвета, прозрачное отверстие и разницу между кругом и овалом. По этой отрисовке нельзя заключить, как Microsoft PowerPoint или другая программа просмотра обработает ту же презентацию.

## Если SVG отсутствует или выглядит неверно

| Симптом                                                       | Первая проверка                                                                                  | Следующее действие                                                                                                          |
| ------------------------------------------------------------- | ------------------------------------------------------------------------------------------------ | --------------------------------------------------------------------------------------------------------------------------- |
| Скрипт не может прочитать изображение                         | Является ли `path` абсолютным или относительным к выполняемому скрипту, как задумано?            | Во время разработки запишите вычисленный локальный путь в журнал и убедитесь, что исходный файл открывается самостоятельно. |
| Презентация существует, но логотип пустой                     | Действительно ли SVG присутствует в `ppt/media/`? Какое приложение и версия открыли презентацию? | Попробуйте простой SVG только из контуров, затем проверьте передаваемую презентацию в приложении аудитории.                 |
| Логотип растянут                                              | Соответствует ли отношение `w:h` пропорциям `viewBox` SVG?                                       | Задайте `w` и `h` на слайде исходя из одного целевого размера и пропорций исходника.                                        |
| Логотип выглядит правильно, но его части нельзя редактировать | Это вставленная графика, а не фигуры Office?                                                     | Сохраните оригинал SVG; используйте отдельный процесс редактирования, если нужны собственные редактируемые фигуры.          |

Если конкретный файл отображается пустым, проверьте копию, содержащую только один простой контур с заливкой. Если она работает, добавляйте остальные контуры и эффекты поэтапно. Не используйте сообщение на форуме как доказательство, что все SVG не работают в одной программе просмотра. Если приложение получателя не может надежно отображать SVG, проверенная копия PNG может быть практичным запасным вариантом для *внешнего вида*, хотя презентация при этом лишается масштабируемых медиа на основе контуров.

Импортированная SVG-графика также отличается от собственных фигур Office. [Инструкции Microsoft по редактированию SVG](https://support.microsoft.com/en-us/office/graphics-visuals/edit-svg-images-in-microsoft-365) описывают **Convert to Shape** для изменения отдельных частей в поддерживаемых процессах PowerPoint. `addImage()` PptxGenJS не выполняет это преобразование. Для ручных правок после передачи используйте [руководство по преобразованию SVG в фигуры PowerPoint](https://perfectvector.com/ru/blog/powerpoint-svg-convert-to-shape) и проверьте выделенные части в целевом приложении.

## Как это выглядит с PerfectVector

Если утвержденный оригинал логотипа уже в SVG, используйте его. Если у вас есть только небольшой плоский логотип PNG или JPG, [векторизатор логотипов PerfectVector](https://perfectvector.com/ru/vectorize-logo) может восстановить пробные контуры перед этапом PptxGenJS. Проверьте цвета, мелкие надписи, фон и отверстия в предпросмотре; исправьте все важное для бренда перед размещением скачанного SVG на слайдах. Созданной презентации по-прежнему нужны описанные выше проверки архива и программы просмотра. PerfectVector подготавливает графику; он не создает и не проверяет презентацию.

Фотографию или сложное изображение с теневыми переходами может быть лучше оставить в растре. Для очень простого знака ручная перерисовка утвержденной геометрии в векторном редакторе может быть быстрее и предсказуемее трассировки. Если аудитории нужны редактируемые объекты Office вместо масштабируемого вставленного логотипа, создайте эти объекты в процессе работы со слайдами и проверьте требование редактирования напрямую.

## Частые вопросы

**Превращает ли `addImage()` SVG в редактируемые фигуры PowerPoint?**
Нет. Он вставляет изображение. Если нужно перекрашивать или перемещать отдельные части в PowerPoint, проверьте отдельный процесс Convert to Shape на копии в поддерживаемом приложении.

**Почему SVG выглядит сжатым на созданном слайде?**
Сравните пропорции `viewBox` SVG с отношением `w:h` на слайде. Логотип 240 × 120 имеет пропорции 2:1, поэтому размещению шириной 3.6 дюйма нужна высота 1.8 дюйма для сохранения пропорций.

**Достаточно ли найти SVG в `ppt/media/`, чтобы одобрить презентацию?**
Нет. Это подтверждает упаковку SVG-медиа, но не доказывает, что целевое приложение для презентаций правильно отображает логотип. Откройте готовую презентацию в нем и проверьте размер, цвета, отверстия и эффекты.

## Источники

1. [PptxGenJS — Images API](https://gitbrent.github.io/PptxGenJS/docs/api-images/) — Описывает входные данные `addImage`, единицы размеров и поддержку SVG программами просмотра.
2. [PptxGenJS — SVG in Node.js issue](https://github.com/gitbrent/PptxGenJS/issues/963) — Фиксирует прежнее поведение предпросмотра SVG и программ просмотра, из-за которого нужно проверять реальный архив и отрисовку.
3. [Microsoft — Edit SVG images in Microsoft 365](https://support.microsoft.com/en-us/office/graphics-visuals/edit-svg-images-in-microsoft-365) — Различает вставку SVG-графики и ее преобразование в редактируемые фигуры Office.

***

Есть только растровый логотип? [Создайте пробный SVG](https://perfectvector.com/ru/vectorize-logo), проверьте его контуры и отверстия, затем соберите небольшую тестовую презентацию и проверьте результат в приложении вашей аудитории.

## Explore

- [Read the HTML article](https://perfectvector.com/ru/blog/pptxgenjs-svg-image)
- [Шрифты SVG в resvg: загрузите нужную гарнитуру](https://perfectvector.com/ru/blog/resvg-svg-fonts.md)
- [SVG в PDFKit: векторный логотип без растеризации](https://perfectvector.com/ru/blog/pdfkit-svg.md)
- [Product facts](https://perfectvector.com/product-facts.md)
- [FAQ](https://perfectvector.com/faq.md)
- [Pricing and credits](https://perfectvector.com/pricing.md)
