Lavorare con i Livelli

Creare un Gruppo di Livelli

Un gruppo di livelli è costituito da uno o più livelli e aiuta ad organizzare livelli simili o correlati. Utilizzando Aspose.PSD per .NET è possibile creare un gruppo di livelli. A questo scopo, è stato aggiunto un nuovo metodo AddLayerGroup in una classe PsdImage per aggiungere il gruppo di livelli.

I passaggi per creare gruppi di livelli sono semplici come segue:

• Creare un’istanza di un’immagine utilizzando la classe PsdImage con larghezza, altezza e opzioni immagine specificate.
• Creare un LayerGroup con il nome del gruppo e l’indice specificati.
• Creare un’istanza della classe Layer ed assegnare l’immagine PSD ad essa.
• Aggiungere il livello creato al gruppo di livelli utilizzando il metodo AddLayer esposto dalla classe LayerGroup
• Salvare i risultati.

Il seguente frammento di codice mostra come creare un gruppo di livelli.

// 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");
}

Rinominare un Livello

Puoi utilizzare qualsiasi nome che desideri, ma la pratica tipica è utilizzare una descrizione generale dell’oggetto o dell’elemento che si trova in quel livello. Questo articolo dimostra come è possibile modificare il nome di un livello utilizzando Aspose.PSD per .NET. A questo scopo, è stata aggiunta una nuova proprietà DisplayName nella classe Layer per visualizzare correttamente un nome di livello. È stato osservato che quando Photoshop salva un nome di livello utilizzando la proprietà Name, allora i caratteri coreani vengono memorizzati come byte 63 ‘?’ in ASCII. Quindi, se desideri visualizzare correttamente un nome di livello, utilizza la proprietà DisplayName poiché la proprietà Name non supporta i caratteri coreani.

Il seguente esempio di codice mostra come è possibile rinominare un livello.

// 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");
}

Supporto dei Livelli Collegati

Il collegamento dei livelli è simile all’aggregazione dei livelli. Se stai collegando due o più livelli, ti consentirà di apportare determinate modifiche ad entrambi i livelli collegati. Ad esempio, se applichi trasformazioni a un livello allora verranno applicate a tutti gli altri livoni collegati. Questo articolo dimostra come puoi ottenere e scollegare i livelli collegati utilizzando 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");
}