Работа с слоями

Создание группы слоев

Группа слоев состоит из одного или нескольких слоев и помогает организовать похожие или связанные слои. С помощью Aspose.PSD для .NET вы можете создать группу слоев. Для этого в класс PsdImage добавлен новый метод AddLayerGroup для добавления группы слоев.

Шаги для создания групп слоев просты:

• Создать экземпляр изображения, используя класс PsdImage с указанными шириной, высотой и параметрами изображения.
• Создать LayerGroup с указанным именем группы и индексом.
• Создать экземпляр класса Layer и присвоить ему изображение PSD.
• Добавить созданный слой в группу слоев, используя метод AddLayer, доступный в классе LayerGroup
• Сохранить результаты.

В следующем фрагменте кода показано, как создать группу слоев.

// For complete examples and data files, please go to https://github.com/aspose-psd/Aspose.PSD-for-.NET

string inputFile = dataDir + "ButtonTemp.psd";

var createOptions = new PsdOptions();
createOptions.Source = new FileCreateSource(inputFile, false);
createOptions.Palette = new PsdColorPalette(new Color[] { Color.Green });

using (var psdImage = (PsdImage)Image.Create(createOptions, 500, 500))
{
    LayerGroup group1 = psdImage.AddLayerGroup("Group 1", 0, true);

    Layer layer1 = new Layer(psdImage);
    layer1.Name = "Layer 1";
    group1.AddLayer(layer1);

    LayerGroup group2 = group1.AddLayerGroup("Group 2", 1);

    Layer layer2 = new Layer(psdImage);
    layer2.Name = "Layer 2";
    group2.AddLayer(layer2);

    Layer layer3 = new Layer(psdImage);
    layer3.Name = "Layer 3";
    group2.AddLayer(layer3);

    Layer layer4 = new Layer(psdImage);
    layer4.Name = "Layer 4";
    group1.AddLayer(layer4);

    psdImage.Save(dataDir + "LayerGroups_out.psd");
}

Переименование слоя

Вы можете использовать любое имя, которое вам нравится, но типичной практикой является использование общего описания объекта или элемента, находящегося на этом слое. В этой статье показано, как вы можете изменить имя слоя с использованием Aspose.PSD для .NET. Для этого в класс Layer было добавлено новое свойство DisplayName для корректного отображения имени слоя. Было замечено, что при сохранении Photoshop имени слоя с помощью свойства Name, корейские символы сохраняются как байт 63'?' в ASCII. Итак, если вы хотите правильно отображать имя слоя, то используйте свойство DisplayName, поскольку свойство Name не поддерживает корейские символы.

В следующем образце кода показано, как вы можете переименовать слой.

// For complete examples and data files, please go to https://github.com/aspose-psd/Aspose.PSD-for-.NET

// The path to the documents directory.
string dataDir = RunExamples.GetDataDir_PSD();

// make changes in layer names and save it
using (var image = (PsdImage)Image.Load(dataDir + "Korean_layers.psd"))
{
    for (int i = 0; i < image.Layers.Length; i++)
    {
         var layer = image.Layers[i];
         // set new value into DisplayName property
         layer.DisplayName += "_changed";
    }

    image.Save(dataDir + "Korean_layers_output.psd");
}

Поддержка связанных слоев

Связывание слоев аналогично группировке слоев. Если вы связываете два или более слоев, то это позволит вносить определенные изменения во все связанные слои. Например, если вы применяете преобразования к одному слою, то они будут применены ко всем остальным связанным слоям. В этой статье демонстрируется, как получать и разрывать связанные слои с помощью Aspose.PSD.

// For complete examples and data files, please go to https://github.com/aspose-psd/Aspose.PSD-for-.NET

{
    Layer[] layers = psd.Layers;

    // link all layers in one linked group
    short layersLinkGroupId = psd.LinkedLayersManager.LinkLayers(layers);

    // gets id for one layer
    short linkGroupId = psd.LinkedLayersManager.GetLinkGroupId(layers[0]);
    if (layersLinkGroupId != linkGroupId)
    {
        throw new Exception("layersLinkGroupId and linkGroupId are not equal.");
    }

    // gets all linked layers by link group id.
    Layer[] linkedLayers = psd.LinkedLayersManager.GetLayersByLinkGroupId(linkGroupId);

    // unlink each layer from group
    foreach (var linkedLayer in linkedLayers)
    {
        psd.LinkedLayersManager.UnlinkLayer(linkedLayer);
    }

    // retrieves NULL for a link group ID that has no layers in the group.
    linkedLayers = psd.LinkedLayersManager.GetLayersByLinkGroupId(linkGroupId);
    if (linkedLayers != null)
    {
        throw new Exception("The linkedLayers field is not NULL.");
    }
    psd.Save(dataDir + "LinkedLayerexample_output.psd");
}