Class SoLeResource

SoLeResource class

Definiert die SoLeResource-Klasse, die Informationen über eine Smart-Objekt-Ebene in einer PSD-Datei enthält. Wird verwendet, um Smart-Objekt-Ebenen mit externen Dateiverknüpfungen in den Adobe® Photoshop®-Bildern zu unterstützen.

public class SoLeResource : SmartObjectResource

Konstrukteure

NameBeschreibung
SoLeResource()Initialisiert eine neue Instanz vonSoLeResource Klasse.
SoLeResource(Guid, bool, bool)Initialisiert eine neue Instanz vonSoLeResource Klasse.

Eigenschaften

NameBeschreibung
override AntiAliasPolicy { get; set; }Ruft die Anti-Alias-Richtlinie der Smart-Objekt-Layer-Daten im PSD-Bild ab oder legt sie fest.
Bottom { get; set; }Ruft die untere Position der platzierten Ebene im PSD-Bild ab oder legt sie fest.
Bounds { get; set; }Ruft die Grenzen der platzierten Ebene in der PSD-Datei ab oder legt sie fest.
Comp { get; set; }Ruft den Comp-Wert der Smart-Objekt-Layer-Daten in der PSD-Datei ab oder legt ihn fest. Ebenenkompositionen in Smart Objects
CompId { get; set; }Erhält oder setzt die ID der aktuell ausgewählten Komposition für das untergeordnete Dokument, die -1 ist, wenn keine ausgewählt ist. Kompositionen sind Kompositionen eines Seitenlayouts, die Designer erstellen können. Mithilfe von Ebenenkompositionen können Sie mehrere Versionen eines Layouts in einer einzigen Adobe® Photoshop®-Datei erstellen, verwalten und anzeigen. Eine Ebenenkomposition ist eine Momentaufnahme eines Zustands des Ebenenbedienfelds. Ebenenkompositionen speichern drei Arten von Ebenenoptionen, aber diese Eigenschaft erhält die Ebenenkompositions-Auswahlkennung für die intelligente Objektebene in der PSD-Datei. Ebenenkompositionen in Smart Objects
Crop { get; set; }Ruft den Zuschnitt der Smart-Objekt-Ebenendaten im PSD-Bild ab oder legt ihn fest.
DurationDenominator { get; set; }Ruft den Dauernenner ab oder legt ihn fest.
DurationNumerator { get; set; }Ruft den Dauerzähler ab oder legt ihn fest.
FrameCount { get; set; }Ruft die Bildanzahl der Smart-Objekt-Ebenendaten in der PSD-Datei ab oder legt sie fest.
FrameStepDenominator { get; set; }Ruft den Frame-Schritt-Nenner ab oder setzt ihn.
FrameStepNumerator { get; set; }Ruft den Frame-Schrittzähler ab oder setzt ihn.
Height { get; set; }Ruft die Höhe ab oder legt sie fest.
HorizontalMeshPoints { get; set; }Holt oder setzt die horizontalen Gitterpunkte der platzierten Ebene in der PSD-Datei.
HorizontalMeshPointUnit { get; set; }Ruft die Maßeinheit der horizontalen Netzpunkte ab oder legt sie fest.
IsCustom { get; set; }Ruft einen Wert ab oder legt einen Wert fest, der angibt, ob dieser Instanz-Warp-Stil benutzerdefiniert ist. Wenn wahr, enthält er Mesh-Punkte. Wenn auf „false“ gesetzt, werden Mesh-Punkte gelöscht.
override Items { get; set; }Ruft die Deskriptorelemente der Smart-Objekt-Layer-Daten in der PSD-Datei ab oder legt sie fest.
override Key { get; }Ruft den Sole-Smart-Object-Layer-Ressourcenschlüssel ab.
Left { get; set; }Ruft die linke Position der platzierten Ebene in der PSD-Datei ab oder legt sie fest.
override Length { get; }Ruft die Ressourcenlänge des intelligenten Objekts in Bytes ab.
NonAffineTransformMatrix { get; set; }Ruft die nicht affine Transformationsmatrix der Smart-Objekt-Layer-Daten in der PSD-Datei ab oder legt sie fest.
OriginalCompId { get; }Ruft die Original-ID der aktuell ausgewählten Komposition für das untergeordnete Dokument ab, die -1 ist, wenn keine ausgewählt ist. Diese Eigenschaft ruft die Original-Ebenen-Kompositionsauswahlkennung für die Smart-Objekt-Ebene in der PSD-Datei ab. Ebenenkompositionen in Smart Objects
override PageNumber { get; set; }Ruft die Seitenzahl der Smart-Objekt-Layer-Daten in der PSD-Datei ab oder legt sie fest.
Perspective { get; set; }Ruft den Perspektivenwert der platzierten Ebene in der PSD-Datei ab oder legt ihn fest.
PerspectiveOther { get; set; }Holt oder setzt den Perspective Other-Wert der platzierten Ebene in der PSD-Datei.
PlacedId { get; set; }Ruft die eindeutige Kennung dieser Smart-Objekt-Layer-Daten im PSD-Bild ab oder legt sie fest.
override PlacedLayerType { get; set; }Ruft den Typ der Smart-Objekt-Layer-Daten in der PSD-Datei ab oder legt ihn fest.
override PsdVersion { get; }Ruft die minimale PSD-Version ab, die für die Smart-Objekt-Ressource erforderlich ist. 0 zeigt keine Einschränkungen an.
Resolution { get; set; }Ruft die Auflösung der Smart-Objekt-Layer-Daten in der PSD-Datei ab oder legt sie fest.
ResolutionUnit { get; set; }Ruft die Auflösungsmaßeinheit der Smart-Objekt-Layer-Daten in der PSD-Datei ab oder legt sie fest.
Right { get; set; }Ruft die richtige Position der platzierten Ebene in der PSD-Datei ab oder legt sie fest.
override Signature { get; }Ruft die Smart-Objekt-Ressourcensignatur ab.
Top { get; set; }Ruft die oberste Position der platzierten Ebene im PSD-Bild ab oder legt sie fest.
override TotalPages { get; set; }Ruft die Gesamtseitenzahl der Smart-Objekt-Layer-Daten in der PSD-Datei ab oder legt sie fest.
override TransformMatrix { get; set; }Ruft die Transformationsmatrix der Smart-Objekt-Layer-Daten in der PSD-Datei ab oder legt sie fest.
override UniqueId { get; set; }Ruft die globale eindeutige Kennung der Smart-Objekt-Layer-Daten ab oder legt sie festSmartObjectResource im PSD-Bild.
UOrder { get; set; }Ruft den U-Ordnungswert der platzierten Ebene in der PSD-Datei ab oder legt ihn fest.
Value { get; set; }Ruft den Warp-Wert der platzierten Ebene im PSD-Bild ab oder legt ihn fest.
Version { get; }Ruft die Version der platzierten Ebene in der PSD-Datei ab, normalerweise 3.
VerticalMeshPoints { get; set; }Holt oder setzt die horizontalen Gitterpunkte der platzierten Ebene in der PSD-Datei.
VerticalMeshPointUnit { get; set; }Ruft die Maßeinheit der vertikalen Gitterpunkte ab oder legt sie fest.
VOrder { get; set; }Ruft den Wert der V-Ordnung der platzierten Ebene in der PSD-Datei ab oder legt ihn fest.
Width { get; set; }Ruft die Breite ab oder legt sie fest.

Methoden

NameBeschreibung
override Save(StreamContainer, int)Speichert die Smart-Objekt-Ressource im angegebenen Stream-Container.
override ToString()Gibt a zurückString die diese Instanz darstellt.

Felder

NameBeschreibung
const TypeToolKeyDer Typ-Tool-Infoschlüssel: ‘SoLE’.

Beispiele

Der folgende Code demonstriert die Unterstützung der Ressourcen SoLEResource, SmartObjectResource und PlacedResource.

[C#]

void AssertIsTrue(bool condition)
{
    if (!condition)
    {
        throw new FormatException(string.Format("Expected true"));
    }
}

void AssertAreEqual(object actual, object expected)
{
    var areEqual = object.Equals(actual, expected);
    if (!areEqual && actual is Array && expected is Array)
    {
        var actualArray = (Array)actual;
        var expectedArray = (Array)actual;
        if (actualArray.Length == expectedArray.Length)
        {
            for (int i = 0; i < actualArray.Length; i++)
            {
                if (!object.Equals(actualArray.GetValue(i), expectedArray.GetValue(i)))
                {
                    break;
                }
            }

            areEqual = true;
        }
    }

    if (!areEqual)
    {
        throw new FormatException(
            string.Format("Actual value {0} are not equal to expected {1}.", actual, expected));
    }
}

void CheckSmartObjectResourceValues(object[] expectedValue, SmartObjectResource resource)
{
    AssertAreEqual(expectedValue[0], resource.IsCustom);
    AssertAreEqual(expectedValue[2], resource.PageNumber);
    AssertAreEqual(expectedValue[3], resource.TotalPages);
    AssertAreEqual(expectedValue[4], resource.AntiAliasPolicy);
    AssertAreEqual(expectedValue[5], resource.PlacedLayerType);
    AssertAreEqual(8, resource.TransformMatrix.Length);
    AssertAreEqual((double[])expectedValue[6], resource.TransformMatrix);
    AssertAreEqual(expectedValue[7], resource.Value);
    AssertAreEqual(expectedValue[8], resource.Perspective);
    AssertAreEqual(expectedValue[9], resource.PerspectiveOther);
    AssertAreEqual(expectedValue[10], resource.Top);
    AssertAreEqual(expectedValue[11], resource.Left);
    AssertAreEqual(expectedValue[12], resource.Bottom);
    AssertAreEqual(expectedValue[13], resource.Right);
    AssertAreEqual(expectedValue[14], resource.UOrder);
    AssertAreEqual(expectedValue[15], resource.VOrder);

    AssertAreEqual(expectedValue[16], resource.Crop);
    AssertAreEqual(expectedValue[17], resource.FrameStepNumerator);
    AssertAreEqual(expectedValue[18], resource.FrameStepDenominator);
    AssertAreEqual(expectedValue[19], resource.DurationNumerator);
    AssertAreEqual(expectedValue[20], resource.DurationDenominator);
    AssertAreEqual(expectedValue[21], resource.FrameCount);
    AssertAreEqual(expectedValue[22], resource.Width);
    AssertAreEqual(expectedValue[23], resource.Height);
    AssertAreEqual(expectedValue[24], resource.Resolution);
    AssertAreEqual(expectedValue[25], resource.ResolutionUnit);
    AssertAreEqual(expectedValue[26], resource.Comp);
    AssertAreEqual(expectedValue[27], resource.CompId);
    AssertAreEqual(expectedValue[28], resource.OriginalCompId);
    AssertAreEqual(expectedValue[29], resource.PlacedId.ToString());
    AssertAreEqual(expectedValue[30], resource.NonAffineTransformMatrix);
    if (resource.IsCustom)
    {
        AssertAreEqual(expectedValue[31], resource.HorizontalMeshPointUnit);
        AssertAreEqual((double[])expectedValue[32], resource.HorizontalMeshPoints);
        AssertAreEqual(expectedValue[33], resource.VerticalMeshPointUnit);
        AssertAreEqual((double[])expectedValue[34], resource.VerticalMeshPoints);
    }
}

void SetNewSmartValues(SmartObjectResource resource, object[] newValues)
{
    // Diese Werte ändern wir nicht in der Ressource
    newValues[0] = resource.IsCustom;
    newValues[1] = resource.UniqueId.ToString();
    newValues[5] = resource.PlacedLayerType;
    newValues[14] = resource.UOrder;
    newValues[15] = resource.VOrder;
    newValues[28] = resource.OriginalCompId;

    // Diese Werte sollten auch in der PlLdResource (mit der angegebenen UniqueId) geändert werden
    // und einige von ihnen müssen mit dem unterstreichenden Smart-Objekt in der LinkDataSource übereinstimmen
    resource.PageNumber = (int)newValues[2]; // 2;
    resource.TotalPages = (int)newValues[3]; // 3;
    resource.AntiAliasPolicy = (int)newValues[4]; // 0;
    resource.TransformMatrix = (double[])newValues[6];
    resource.Value = (double)newValues[7]; // 1.23456789;
    resource.Perspective = (double)newValues[8]; // 0,123456789;
    resource.PerspectiveOther = (double)newValues[9]; // 0.987654321;
    resource.Top = (double)newValues[10]; // -126;
    resource.Left = (double)newValues[11]; // -215;
    resource.Bottom = (double)newValues[12]; // 248;
    resource.Right = (double)newValues[13]; // 145;
    resource.Crop = (int)newValues[16]; // 5;
    resource.FrameStepNumerator = (int)newValues[17]; // 1;
    resource.FrameStepDenominator = (int)newValues[18]; // 601;
    resource.DurationNumerator = (int)newValues[19]; // 2;
    resource.DurationDenominator = (int)newValues[20]; // 602;
    resource.FrameCount = (int)newValues[21]; // 11;
    resource.Width = (double)newValues[22]; // 541;
    resource.Height = (double)newValues[23]; // 249;
    resource.Resolution = (double)newValues[24]; // 144;
    resource.ResolutionUnit = (UnitTypes)newValues[25];
    resource.Comp = (int)newValues[26]; // 21;
    resource.CompId = (int)newValues[27]; // 22;
    resource.NonAffineTransformMatrix = (double[])newValues[30];

    // Diese eindeutige ID sollte gegebenenfalls in Referenzen geändert werden
    resource.PlacedId = new Guid((string)newValues[29]);  // "12345678-9abc-def0-9876-54321fecba98");
    if (resource.IsCustom)
    {
        resource.HorizontalMeshPointUnit = (UnitTypes)newValues[31];
        resource.HorizontalMeshPoints = (double[])newValues[32];
        resource.VerticalMeshPointUnit = (UnitTypes)newValues[33];
        resource.VerticalMeshPoints = (double[])newValues[34];
    }

    // Seien Sie vorsichtig mit einigen Parametern: Das gespeicherte Bild kann für Adobe® Photoshop® unlesbar werden
    ////resource.UOrder = 6;
    ////resource.VOrder = 9;

    // Ändern Sie dies nicht, sonst können Sie die freie Transformation nicht verwenden
    // oder ändern Sie das unterstreichende Smart-Objekt in den Vektortyp
    ////resource.PlacedLayerType = PlacedLayerType.Vector;

    // Es sollte eine gültige PlLdResource mit dieser eindeutigen ID geben
    ////resource.UniqueId = new Guid("98765432-10fe-cba0-1234-56789abcdef0");
}

object[] newSmartValues = new object[]
{
    true,
    null,
    2,
    3,
    0,
    PlacedLayerType.ImageStack,
    new double[8]
    {
        12.937922786050663,
        19.419959734187131,
        2.85445817782261,
        1.0540625423957124,
        7.20861031651307,
        14.634102808208553,
        17.292074924741144,
        4
    },
    1.23456789,
    0.123456789,
    0.987654321,
    -126d,
    -215d,
    248d,
    145d,
    4,
    4,
    5,
    1,
    601,
    2,
    602,
    11,
    541d,
    249d,
    144d,
    UnitTypes.Percent,
    21,
    22,
    23,
    "12345678-9abc-def0-9876-54321fecba98",
    new double[8]
    {
        129.937922786050663,
        195.419959734187131,
        26.85445817782261,
        12.0540625423957124,
        72.20861031651307,
        147.634102808208553,
        175.292074924741144,
        42
    },
    UnitTypes.Points,
    new double[16]
    {
        0.01d, 103.33333333333433d, 206.66686666666666d, 310.02d,
        0.20d, 103.33333333333533d, 206.69666666666666d, 310.03d,
        30.06d, 103.33333333336333d, 206.66660666666666d, 310.04d,
        04.05d, 103.33333333373333d, 206.66666166666666d, 310.05d
    },
    UnitTypes.Distance,
    new double[16]
    {
        0.06d, 0.07d, 0.08d, 0.09d,
        49.066666666666664d, 49.266666666666664d, 49.566666666666664d, 49.766666666666664d,
        99.133333333333329d, 99.433333333333329d, 99.633333333333329d, 99.833333333333329d,
        140, 141, 142, 143,
    },
};

object[] expectedValues = new object[]
{
    new object[]
    {
        false,
        "5867318f-3174-9f41-abca-22f56a75247e",
        1,
        1,
        0x10,
        PlacedLayerType.Raster,
        new double[8]
        {
            0, 0, 2, 0, 2, 2, 0, 2
        },
        0d,
        0d,
        0d,
        0d,
        0d,
        2d,
        2d,
        4,
        4,
        1,
        0,
        600,
        0,
        600,
        1,
        2d,
        2d,
        72d,
        UnitTypes.Density,
        -1,
        -1,
        -1,
        "64b3997c-06e0-be40-a349-41acf397c897",
        new double[8]
        {
            0, 0, 2, 0, 2, 2, 0, 2
        },
    }
};

var sourceFilePath = "rgb8_2x2_linked.psd";
var outputPath = "rgb8_2x2_linked_output.psd";
using (PsdImage image = (PsdImage)Image.Load(sourceFilePath))
{
    SoLeResource soleResource = null;
    int index = 0;
    foreach (Layer imageLayer in image.Layers)
    {
        foreach (var imageResource in imageLayer.Resources)
        {
            var resource = imageResource as SoLeResource;
            if (resource != null)
            {
                soleResource = resource;
                var expectedValue = (object[])expectedValues[index++];
                AssertAreEqual(expectedValue[1], resource.UniqueId.ToString());
                CheckSmartObjectResourceValues(expectedValue, resource);
                SetNewSmartValues(resource, newSmartValues);

                break;
            }
        }
    }

    AssertIsTrue(soleResource != null);
    image.Save(outputPath, new PsdOptions(image));
    using (PsdImage savedImage = (PsdImage)Image.Load(outputPath))
    {
        foreach (Layer imageLayer in savedImage.Layers)
        {
            foreach (var imageResource in imageLayer.Resources)
            {
                var resource = imageResource as SoLeResource;
                if (resource != null)
                {
                    CheckSmartObjectResourceValues(newSmartValues, resource);

                    break;
                }
            }
        }
    }
}

Siehe auch