Class SmartObjectProvider
Inhalt
[
Ausblenden
]SmartObjectProvider class
Definiert den intelligenten Objektanbieter, der das Abrufen/Festlegen von Datenquellen aus globalen Linkressourcen der PSD-Datei und deren Inhalt bereitstellt.
public class SmartObjectProvider
Methoden
| Name | Beschreibung |
|---|---|
| ConvertToSmartObject(params int[]) | Konvertiert Ebenen in ein eingebettetes Smart-Objekt. |
| ConvertToSmartObject(Layer[]) | Konvertiert Ebenen in ein eingebettetes Smart-Objekt. |
| EmbedAllLinked() | Bettet alle verknüpften Smart-Objekte in das Bild ein. |
| NewSmartObjectViaCopy(SmartObjectLayer) | Erstellt eine neue intelligente Objektebene durch Kopieren der Quellebene. |
| UpdateAllModifiedContent() | Aktualisiert den Inhalt aller geänderten Smart-Objekte im Bild. |
Beispiele
Der folgende Code demonstriert die Unterstützung der Aktualisierung verknüpfter Smart-Objekte.
[C#]
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));
}
}
// Dieses Beispiel zeigt, wie die externe oder eingebettete Smart-Objekt-Ebene mit diesen Methoden aktualisiert wird:
// RelinkToFile, UpdateModifiedContent, ExportContents
ExampleOfUpdatingSmartObjectLayer("rgb8_2x2_linked2.psd", 0x53, 0, 0, 2, 2, FileFormat.Png);
ExampleOfUpdatingSmartObjectLayer("r-embedded-png.psd", 0x207, 0, 0, 0xb, 0x10, FileFormat.Png);
void ExampleOfUpdatingSmartObjectLayer(
string filePath,
int contentsLength,
int left,
int top,
int right,
int bottom,
FileFormat format)
{
// Dieses Beispiel zeigt, wie Sie die Smart-Objekt-Ebene in der PSD-Datei ändern und ihren Inhalt exportieren/aktualisieren.
string fileName = Path.GetFileNameWithoutExtension(filePath);
string dataDir = "updating_output" + Path.DirectorySeparatorChar;
filePath = filePath;
string pngOutputPath = dataDir + fileName + "_modified.png";
string png2OutputPath = dataDir + fileName + "_updated_modified.png";
string psd2OutputPath = dataDir + fileName + "_updated_modified.psd";
string exportPath = dataDir + fileName + "_exported." + GetFormatExt(format);
using (PsdImage image = (PsdImage)Image.Load(filePath))
{
var smartObjectLayer = (SmartObjectLayer)image.Layers[0];
var contentType = smartObjectLayer.ContentType;
AssertAreEqual(contentsLength, smartObjectLayer.Contents.Length);
AssertAreEqual(left, smartObjectLayer.ContentsBounds.Left);
AssertAreEqual(top, smartObjectLayer.ContentsBounds.Top);
AssertAreEqual(right, smartObjectLayer.ContentsBounds.Right);
AssertAreEqual(bottom, smartObjectLayer.ContentsBounds.Bottom);
if (contentType == SmartObjectType.AvailableLinked)
{
Directory.CreateDirectory(Path.GetDirectoryName(exportPath));
// Lassen Sie uns das externe Smart-Objekt-Bild aus der PSD-Smart-Objekt-Ebene an einen neuen Speicherort exportieren
// weil wir es ändern werden.
smartObjectLayer.ExportContents(exportPath);
smartObjectLayer.RelinkToFile(exportPath);
}
// Lassen Sie uns den Inhalt des intelligenten Objekts umkehren: inneres (nicht zwischengespeichertes) Bild
using (var innerImage = (RasterImage)smartObjectLayer.LoadContents(new LoadOptions()))
{
InvertImage(innerImage);
using (var stream = new MemoryStream())
{
innerImage.Save(stream);
smartObjectLayer.Contents = stream.ToArray();
}
}
// Prüfen wir, ob sich der geänderte Inhalt noch nicht auf das Rendering auswirkt.
image.Save(pngOutputPath, new PngOptions() { ColorType = PngColorType.TruecolorWithAlpha });
smartObjectLayer.UpdateModifiedContent();
// Prüfen wir, ob sich der aktualisierte Inhalt auf das Rendern auswirkt und das PSD-Bild korrekt gespeichert wird
image.Save(psd2OutputPath, new PsdOptions(image));
image.Save(png2OutputPath, new PngOptions() { ColorType = PngColorType.TruecolorWithAlpha });
}
}
// Dieses Beispiel zeigt, wie das eingebettete Smart-Objekt mithilfe der ConvertToLinked-Methode in extern verlinkte Inhalte konvertiert wird.
ExampleOfEmbeddedSmartObjectLayerToLinkedConversion("new_panama-papers-4.psd", 0x10caa, 0, 0, 0x280, 0x169, FileFormat.Jpeg);
ExampleOfEmbeddedSmartObjectLayerToLinkedConversion("r3-embedded.psd", 0x207, 0, 0, 0xb, 0x10, FileFormat.Png);
ExampleOfEmbeddedSmartObjectLayerToLinkedConversion("r-embedded-tiff.psd", 0xca94, 0, 0, 0xb, 0x10, FileFormat.Tiff);
ExampleOfEmbeddedSmartObjectLayerToLinkedConversion("r-embedded-bmp.psd", 0x278, 0, 0, 0xb, 0x10, FileFormat.Bmp);
ExampleOfEmbeddedSmartObjectLayerToLinkedConversion("r-embedded-gif.psd", 0x3ec, 0, 0, 0xb, 0x10, FileFormat.Gif);
ExampleOfEmbeddedSmartObjectLayerToLinkedConversion("r-embedded-jpeg.psd", 0x327, 0, 0, 0xb, 0x10, FileFormat.Jpeg);
ExampleOfEmbeddedSmartObjectLayerToLinkedConversion("r-embedded-jpeg2000.psd", 0x519f, 0, 0, 0xb, 0x10, FileFormat.Jpeg2000);
ExampleOfEmbeddedSmartObjectLayerToLinkedConversion("r-embedded-psd.psd", 0xc074, 0, 0, 0xb, 0x10, FileFormat.Psd);
ExampleOfEmbeddedSmartObjectLayerToLinkedConversion("r-embedded-png.psd", 0x207, 0, 0, 0xb, 0x10, FileFormat.Png);
void ExampleOfEmbeddedSmartObjectLayerToLinkedConversion(
string filePath,
int contentsLength,
int left,
int top,
int right,
int bottom,
FileFormat format)
{
// Dies zeigt, wie eine eingebettete Smart-Objekt-Ebene in der PSD-Datei in eine externe konvertiert wird.
var formatExt = GetFormatExt(format);
string fileName = Path.GetFileNameWithoutExtension(filePath);
string dataDir = "to_linked_output" + Path.DirectorySeparatorChar;
filePath = filePath;
string pngOutputPath = dataDir + fileName + "_to_external.png";
string psdOutputPath = dataDir + fileName + "_to_external.psd";
string externalPath = dataDir + fileName + "_external." + formatExt;
using (PsdImage image = (PsdImage)Image.Load(filePath))
{
Directory.CreateDirectory(Path.GetDirectoryName(externalPath));
var smartObjectLayer = (SmartObjectLayer)image.Layers[0];
smartObjectLayer.ConvertToLinked(externalPath);
AssertAreEqual(contentsLength, smartObjectLayer.Contents.Length);
AssertAreEqual(left, smartObjectLayer.ContentsBounds.Left);
AssertAreEqual(top, smartObjectLayer.ContentsBounds.Top);
AssertAreEqual(right, smartObjectLayer.ContentsBounds.Right);
AssertAreEqual(bottom, smartObjectLayer.ContentsBounds.Bottom);
AssertAreEqual(SmartObjectType.AvailableLinked, smartObjectLayer.ContentType);
// Lassen Sie uns überprüfen, ob das konvertierte Bild korrekt gespeichert wird
image.Save(psdOutputPath, new PsdOptions(image));
image.Save(pngOutputPath, new PngOptions() { ColorType = PngColorType.TruecolorWithAlpha });
}
using (PsdImage image = (PsdImage)Image.Load(psdOutputPath))
{
var smartObjectLayer = (SmartObjectLayer)image.Layers[0];
AssertAreEqual(contentsLength, smartObjectLayer.Contents.Length);
AssertAreEqual(left, smartObjectLayer.ContentsBounds.Left);
AssertAreEqual(top, smartObjectLayer.ContentsBounds.Top);
AssertAreEqual(right, smartObjectLayer.ContentsBounds.Right);
AssertAreEqual(bottom, smartObjectLayer.ContentsBounds.Bottom);
AssertAreEqual(SmartObjectType.AvailableLinked, smartObjectLayer.ContentType);
}
}
// Dieses Beispiel zeigt, wie Sie eine externe Smart-Objekt-Ebene oder alle verknüpften Ebenen mithilfe der EmbedLinked-Methode in die PSD-Datei einbetten.
ExampleOfLinkedSmartObjectLayerToEmbeddedConversion("rgb8_2x2_linked.psd", 0x53, 0, 0, 2, 2, FileFormat.Png);
ExampleOfLinkedSmartObjectLayerToEmbeddedConversion("rgb8_2x2_linked2.psd", 0x53, 0, 0, 2, 2, FileFormat.Png);
void ExampleOfLinkedSmartObjectLayerToEmbeddedConversion(
string filePath,
int contentsLength,
int left,
int top,
int right,
int bottom,
FileFormat format)
{
string fileName = Path.GetFileNameWithoutExtension(filePath);
string dataDir = "to_embedded_output" + Path.DirectorySeparatorChar;
filePath = filePath;
string pngOutputPath = dataDir + fileName + "_to_embedded.png";
string psdOutputPath = dataDir + fileName + "_to_embedded.psd";
using (PsdImage image = (PsdImage)Image.Load(filePath))
{
var smartObjectLayer0 = (SmartObjectLayer)image.Layers[0];
smartObjectLayer0.EmbedLinked();
AssertAreEqual(contentsLength, smartObjectLayer0.Contents.Length);
AssertAreEqual(left, smartObjectLayer0.ContentsBounds.Left);
AssertAreEqual(top, smartObjectLayer0.ContentsBounds.Top);
AssertAreEqual(right, smartObjectLayer0.ContentsBounds.Right);
AssertAreEqual(bottom, smartObjectLayer0.ContentsBounds.Bottom);
if (image.Layers.Length >= 2)
{
var smartObjectLayer1 = (SmartObjectLayer)image.Layers[1];
AssertAreEqual(SmartObjectType.Embedded, smartObjectLayer0.ContentType);
AssertAreEqual(SmartObjectType.AvailableLinked, smartObjectLayer1.ContentType);
image.SmartObjectProvider.EmbedAllLinked();
foreach (Layer layer in image.Layers)
{
var smartLayer = layer as SmartObjectLayer;
if (smartLayer != null)
{
AssertAreEqual(SmartObjectType.Embedded, smartLayer.ContentType);
}
}
}
Directory.CreateDirectory(Path.GetDirectoryName(psdOutputPath));
// Lassen Sie uns überprüfen, ob das konvertierte Bild korrekt gespeichert wird
image.Save(psdOutputPath, new PsdOptions(image));
image.Save(pngOutputPath, new PngOptions() { ColorType = PngColorType.TruecolorWithAlpha });
}
using (PsdImage image = (PsdImage)Image.Load(psdOutputPath))
{
var smartObjectLayer = (SmartObjectLayer)image.Layers[0];
AssertAreEqual(contentsLength, smartObjectLayer.Contents.Length);
AssertAreEqual(left, smartObjectLayer.ContentsBounds.Left);
AssertAreEqual(top, smartObjectLayer.ContentsBounds.Top);
AssertAreEqual(right, smartObjectLayer.ContentsBounds.Right);
AssertAreEqual(bottom, smartObjectLayer.ContentsBounds.Bottom);
AssertAreEqual(SmartObjectType.Embedded, smartObjectLayer.ContentType);
}
}
// Dieses Beispiel zeigt, wie Sie die externe Smart-Objekt-Ebene von Adobe® Photoshop® ändern und ihren Inhalt exportieren/aktualisieren
// mit den Methoden ExportContents und ReplaceContents.
ExampleOfExternalSmartObjectLayerSupport("rgb8_2x2_linked.psd", 0x53, 0, 0, 2, 2, FileFormat.Png);
ExampleOfExternalSmartObjectLayerSupport("rgb8_2x2_linked2.psd", 0x4aea, 0, 0, 10, 10, FileFormat.Psd);
void ExampleOfExternalSmartObjectLayerSupport(string filePath, int contentsLength, int left, int top, int right, int bottom, FileFormat format)
{
string formatExt = GetFormatExt(format);
string fileName = Path.GetFileNameWithoutExtension(filePath);
string dataDir = "external_support_output" + Path.DirectorySeparatorChar;
filePath = filePath;
string pngOutputPath = dataDir + fileName + ".png";
string psdOutputPath = dataDir + fileName + ".psd";
string linkOutputPath = dataDir + fileName + "_inverted." + formatExt;
string png2OutputPath = dataDir + fileName + "_updated.png";
string psd2OutputPath = dataDir + fileName + "_updated.psd";
string exportPath = dataDir + fileName + "_export." + formatExt;
using (PsdImage image = (PsdImage)Image.Load(filePath))
{
var smartObjectLayer = (SmartObjectLayer)image.Layers[image.Layers.Length - 1];
AssertAreEqual(left, smartObjectLayer.ContentsBounds.Left);
AssertAreEqual(top, smartObjectLayer.ContentsBounds.Top);
AssertAreEqual(right, smartObjectLayer.ContentsBounds.Right);
AssertAreEqual(bottom, smartObjectLayer.ContentsBounds.Bottom);
AssertAreEqual(contentsLength, smartObjectLayer.Contents.Length);
AssertAreEqual(SmartObjectType.AvailableLinked, smartObjectLayer.ContentType);
Directory.CreateDirectory(Path.GetDirectoryName(exportPath));
// Lassen Sie uns das verknüpfte Smart-Objekt-Bild aus der PSD-Smart-Objekt-Ebene exportieren
smartObjectLayer.ExportContents(exportPath);
// Lassen Sie uns prüfen, ob das Originalbild korrekt gespeichert wird
image.Save(psdOutputPath, new PsdOptions(image));
image.Save(pngOutputPath, new PngOptions() { ColorType = PngColorType.TruecolorWithAlpha });
using (var innerImage = (RasterImage)smartObjectLayer.LoadContents(null))
{
AssertAreEqual(format, innerImage.FileFormat);
// Lassen Sie uns das verknüpfte Smart-Objekt-Bild invertieren
InvertImage(innerImage);
innerImage.Save(linkOutputPath);
// Lassen Sie uns das verknüpfte Smart-Objekt-Bild in der PSD-Ebene ersetzen
smartObjectLayer.ReplaceContents(linkOutputPath);
}
// Prüfen wir, ob das aktualisierte Bild korrekt gespeichert wird
image.Save(psd2OutputPath, new PsdOptions(image));
image.Save(png2OutputPath, new PngOptions() { ColorType = PngColorType.TruecolorWithAlpha });
}
}
// Invertiert das Bild.
void InvertImage(RasterImage innerImage)
{
var innerPsdImage = innerImage as PsdImage;
if (innerPsdImage != null)
{
InvertRasterImage(innerPsdImage.Layers[0]);
}
else
{
InvertRasterImage(innerImage);
}
}
// Invertiert das Rasterbild.
void InvertRasterImage(RasterImage innerImage)
{
var pixels = innerImage.LoadArgb32Pixels(innerImage.Bounds);
for (int i = 0; i < pixels.Length; i++)
{
var pixel = pixels[i];
var alpha = (int)(pixel & 0xff000000);
pixels[i] = (~(pixel & 0x00ffffff)) | alpha;
}
innerImage.SaveArgb32Pixels(innerImage.Bounds, pixels);
}
// Ruft die Formaterweiterung ab.
string GetFormatExt(FileFormat format)
{
string formatExt = format == FileFormat.Jpeg2000 ? "jpf" : format.ToString().ToLowerInvariant();
return formatExt;
}
Siehe auch
- namensraum Aspose.PSD.FileFormats.Psd
- Montage Aspose.PSD
