Автоматизация умного объекта замены помогает вам создать вариации того же шаблона Photoshop с различными изображениями. с Aspose.PSD для .NET вы можете загрузить PSD, найти умные слои объектов, заменить их встроенный контент новым изображением и сохранить обновленный документ.
Предупреждения
- .NET 6 или позднее
- НУГЕТ :
Aspose.PSD
dotnet add package Aspose.PSD
Заменить первый умный объект в PSD
Этот пример загружает ПСД, найдёт первый SmartObjectLayer
, заменяет его содержимое PNG или JPEG, обновляет слой и сберегает PSD и предварительный просмотр ПNG.
// File: Program.cs
using System;
using System.IO;
using System.Linq;
using Aspose.PSD;
using Aspose.PSD.FileFormats.Psd;
using Aspose.PSD.FileFormats.Psd.Layers.SmartObjects;
using Aspose.PSD.ImageOptions;
class Program
{
static void Main()
{
var inputPsd = "template.psd";
var replacement = "replacement.png"; // any raster format supported by Aspose.PSD
var outputPsd = "output.psd";
var outputPreview = "output-preview.png";
if (!File.Exists(inputPsd) || !File.Exists(replacement))
{
Console.WriteLine("Missing input files.");
return;
}
using (var psd = (PsdImage)Image.Load(inputPsd))
{
// Find the first smart object layer
var smart = psd.Layers.OfType<SmartObjectLayer>().FirstOrDefault();
if (smart == null)
{
Console.WriteLine("No smart object layer found in PSD.");
}
else
{
// Load the replacement raster and replace contents
using var newContent = (RasterImage)Image.Load(replacement);
// Replace embedded contents and update the smart object
smart.ReplaceContents(newContent);
smart.UpdateModifiedContent();
}
// Save updated PSD
psd.Save(outputPsd);
// Optional preview export
psd.Save(outputPreview, new PngOptions());
}
Console.WriteLine("Done.");
}
}
Примечания
ReplaceContents
Заменяет встроенный контент умного объекта.UpdateModifiedContent
Обновляет рендерирующий слой после замены.- Сохранение предварительного просмотра PNG помогает вам подтвердить результат без открытия Photoshop.
Замена умного объекта по названию слоя
Используйте этот шаблон, когда в шаблоне есть несколько умных объектов, и вы хотите нацелить на конкретный по названию дисплея.
using System.Linq;
using Aspose.PSD;
using Aspose.PSD.FileFormats.Psd;
using Aspose.PSD.FileFormats.Psd.Layers.SmartObjects;
static void ReplaceByName(string psdPath, string layerName, string replacementPath, string outputPsd)
{
using var psd = (PsdImage)Image.Load(psdPath);
var smart = psd.Layers
.OfType<SmartObjectLayer>()
.FirstOrDefault(l => string.Equals(l.DisplayName, layerName, StringComparison.OrdinalIgnoreCase));
if (smart == null)
throw new InvalidOperationException($"Smart object layer '{layerName}' not found.");
using var newContent = (RasterImage)Image.Load(replacementPath);
smart.ReplaceContents(newContent);
smart.UpdateModifiedContent();
psd.Save(outputPsd);
}
Назовите его таким образом:
ReplaceByName("template.psd", "Product Image", "new-photo.jpg", "output.psd");
Заменить все умные объекты в PSD
Этот пример проходит через все слои умных объектов и заменяет каждый из них одним и тем же изображением.
using System.Linq;
using Aspose.PSD;
using Aspose.PSD.FileFormats.Psd;
using Aspose.PSD.FileFormats.Psd.Layers.SmartObjects;
static void ReplaceAll(string psdPath, string replacementPath, string outputPsd)
{
using var psd = (PsdImage)Image.Load(psdPath);
using var newContent = (RasterImage)Image.Load(replacementPath);
var smartLayers = psd.Layers.OfType<SmartObjectLayer>().ToList();
if (smartLayers.Count == 0)
throw new InvalidOperationException("No smart object layers found.");
foreach (var smart in smartLayers)
{
smart.ReplaceContents(newContent);
smart.UpdateModifiedContent();
}
psd.Save(outputPsd);
}
Управление связанными умными объектами
Если умный объект подключен к внешнему файлу, вы можете заменить цель ссылки, указывая его на новую картину на диске. UpdateModifiedContent
.
using System.Linq;
using Aspose.PSD;
using Aspose.PSD.FileFormats.Psd;
using Aspose.PSD.FileFormats.Psd.Layers.SmartObjects;
static void ReplaceLinked(string psdPath, string newLinkedFilePath, string outputPsd)
{
using var psd = (PsdImage)Image.Load(psdPath);
var linked = psd.Layers
.OfType<SmartObjectLayer>()
.FirstOrDefault(l => l.IsLinked);
if (linked == null)
throw new InvalidOperationException("No linked smart object layer found.");
// Point the layer to a new external file
linked.SetLinkedFile(newLinkedFilePath);
// Refresh layer rendering
linked.UpdateModifiedContent();
psd.Save(outputPsd);
}
Примечания
- Использование
IsLinked
Открыть связанные умные объекты. SetLinkedFile
обновляется внешний путь, используемый слоем.- Связанный файл должен быть поддерживаемым форматным растером.
Лучшие практики
- ** Размеры изображения**: Для наилучшего качества, соответствует заменительный аспект изображений соотношением и разрешению к оригинальным умным объектам.
- ** Управление цветом**: Сохранение консистентных цветовых профилей по шаблонам и заменительным активам.
- Автоматизация батареи: повторное использование загруженного
RasterImage
при замене множества слоев для уменьшения I/O и памяти. - Валидация: экспортируйте предварительный просмотр ПНГ после замены, чтобы подтвердить корректировку и масштабирование перед распределением ПСД.
- Отказ: Если в документе нет умных объектов, быстро провалиться с явной ошибкой или пропустить файл в комплектном режиме.
С помощью этих шаблонов вы можете построить надежные трубы для моделирования PSD, которые заменяют умные объекты по масштабу и сохраняют обновленные поставщики без открытия Photoshop.