Arbeiten mit Transformationen in PS-Datei | Java

Transformieren Sie einen Inhalt im PS-Dokument

In diesem Artikel betrachten wir, wie man verschiedene Transformationen durchführt: Verschiebung, Skalierung, Drehung und Scherung auf einem zu PsDocument hinzugefügten Rechteckpfad.

Wir teilen ein Code-Snippet in mehrere Codeteile auf: den Anfang, das Ende und jede Transformation separat. Eine Transformation in PostScript erfolgt immer in einem Grafikzustand, der durch die Operatoren “gsave” und “grestore” gebunden ist. Daher gibt es in unserem PsDocument die Methoden “writeGraphicsSave()” und “writeGraphicsRestore()”. Zwischen diesen Methoden können wir beliebige Inhalte hinzufügen, einschließlich des Zustands verschachtelter Grafiken, und beliebige Transformationen oder Beschneidungen vornehmen. Diese Transformationen wirken sich nicht auf äußere Grafikzustände aus, wohl aber auf verschachtelte.

Wenn wir eine Transformation ohne die Methoden “writeGraphicsSave()” und “writeGraphicsRestore()” durchführen, führen wir sie im Grafikzustand der oberen Ebene und allen Inhalten durch das heißt in PsDocument wird dieser Transformation unterzogen.

Ein Algorithmus zum Festlegen einer Transformation für den Inhalt eines Dokuments von Grund auf umfasst die folgenden Schritte:

1. Erstellen Sie einen Ausgabestream für die resultierende PS-Datei.
2. Erstellen Sie PsSaveOptions.
3. Erstellen Sie PsDocument mit dem bereits erstellten Ausgabestream und den Speicheroptionen.
4. Speichern Sie einen Grafikstatus. Also haben wir einen neuen Grafikstatus erstellt, der vorherige Grafikstatus wurde in einen Grafikstatusstapel gelegt.
5. Fügen Sie die erforderliche Transformation hinzu: Translation, Skalierung, Rotation, Scherung oder eine beliebige Kombination davon. In unserem Code zeigen wir den Einfluss jeder Transformationskomponente einzeln und am Ende jeweils drei.
6. Fügen Sie den für die Transformation erforderlichen Inhalt hinzu. In unserem Fall haben wir java.awt.geom.Rectangle2D erstellt und es dann gefüllt. Wir haben vor allen Transformationen ein Rechteck erstellt und es nach jeder Transformation im aktuellen Grafikstatus einfach gefüllt.
7. Stellen Sie den Grafikstatus wieder her, um zum vorherigen Zustand zurückzukehren, auf den sich die angewendeten Transformationen nicht auswirken. In unserem Fall handelt es sich um einen Grafikstatus der oberen Ebene.

In diesem Codeteil erstellen wir PsDocument aus einem Ausgabestream und PsSaveOptions, übersetzen den Grafikstatus der oberen Ebene in die Punkte 100,100, um das erste Rechteck zu versetzen, und erstellen schließlich das erste Rechteck:

//Create an output stream for PostScript document
FileOutputStream outPsStream = new FileOutputStream(dataDir + "Tranformations_outPS.ps");
//Create a save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create new PS Document with the page opened
PsDocument document = new PsDocument(outPsStream, options, false);

document.translate(100, 100);

//Create a rectangle
Shape shape = new Rectangle2D.Float(0, 0, 150, 100);

Hier legen wir die Farbe Orange als aktuelle Farbe für den Grafikstatus der oberen Ebene fest und füllen dieses Rechteck.

Die resultierende PS-Datei zeigt die erste Form, die sich im Grafikstatus der oberen Ebene befindet und keiner Transformation unterzogen wurde:

////////////////////////////////////// No transformations ///////////////////////////////////////////////////////////////
//Set paint in graphics state on upper level
document.setPaint(Color.ORANGE);

//Fill the first rectangle that is on on upper level graphics state and that is without any transformations.
document.fill(shape);
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Jetzt erstellen wir einen neuen Grafikstatus, der an 250 Punkten auf der X-Achse relativ zum Grafikstatus der oberen Ebene verschoben wird, und fügen zu diesem neuen Grafikstatus dasselbe Rechteck hinzu, das mit der Farbe Blau bemalt ist. Am Ende verlassen wir den aktuellen Grafikstatus und wechseln zum Grafikstatus der oberen Ebene:

////////////////////////////////////// Translation //////////////////////////////////////////////////////////////////////
//Save graphics state in order to return back to this state after transformation
document.writeGraphicsSave();

//Displace current graphics state on 250 to the right. So we add translation component to the current transformation.
document.translate(250, 0);

//Set paint in the current graphics state
document.setPaint(Color.BLUE);

//Fill the second rectangle in the current graphics state (has translation transformation)
document.fill(shape);

//Restore graphics state to the previus (upper) level
document.writeGraphicsRestore();
/////////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Übersetzen Sie den Grafikstatus der oberen Ebene, um die nächsten Rechtecke zu platzieren:

//Displace on 200 to the bottom.
document.translate(0, 200);

Hier erstellen wir einen Grafikstatus, der auf 0,5 x-Achse und 0,75 x Y-Achse skaliert wird, und fügen zu diesem neuen Grafikstatus dasselbe Rechteck hinzu, das mit der Farbe Rot bemalt ist. Am Ende verlassen wir den aktuellen Grafikstatus und wechseln zum Grafikstatus der oberen Ebene:

////////////////////////////////////// Scaling //////////////////////////////////////////////////////////////////////////
//Save the graphics state in order to return back to this state after transformation
document.writeGraphicsSave();

//Scale current graphics state on 0.5 in X axis and on 0.75f in Y axis. So we add scale component to the current transformation.
document.scale(0.5f, 0.75f);

//Set paint in the current graphics state
document.setPaint(Color.RED);

//Fill the third rectangle in the current graphics state (has scale transformation)
document.fill(shape);

//Restore graphics state to the previus (upper) level
document.writeGraphicsRestore();
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Übersetzen Sie den Grafikstatus der oberen Ebene, um die nächsten Rechtecke zu platzieren:

//Displace upper level graphics state on 250 to the right.
document.translate(250, 0);

Dann erstellen wir einen neuen Grafikzustand, der relativ zum Grafikzustand der oberen Ebene um 45 Grad im Uhrzeigersinn gedreht wird, und fügen diesem neuen Grafikzustand dasselbe Rechteck hinzu, das mit der Farbe Grün bemalt ist. Am Ende verlassen wir den aktuellen Grafikstatus und wechseln zum Grafikstatus der oberen Ebene:

////////////////////////////////////// Rotation //////////////////////////////////////////////////////////////////////
//Save graphics state in order to return back to this state after transformation
document.writeGraphicsSave();

//Rotate current graphics state on 45 degrees around origin of current graphics state (350, 300). So we add rotation component to the current transformation.
document.rotate(45);

//Set paint in the current graphics state
document.setPaint(Color.GREEN);

//Fill the fourth rectangle in the current graphics state (has rotation transformation)
document.fill(shape);

//Restore graphics state to the previus (upper) level
document.writeGraphicsRestore();
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Übersetzen Sie den Grafikstatus der oberen Ebene, um die nächsten Rechtecke in den leeren Bereich auf der Seite einzufügen.

//Returns upper level graphics state back to the left and displace on 200 to the bottom.
document.translate(-250, 200);

Dann erstellen wir einen neuen Grafikzustand, der geschert wird, und fügen diesem neuen Grafikzustand dasselbe Rechteck hinzu, das mit der Farbe Rosa bemalt ist. Am Ende verlassen wir den aktuellen Grafikstatus und wechseln zum Grafikstatus der oberen Ebene:

////////////////////////////////////// Shearing //////////////////////////////////////////////////////////////////////
//Save graphics state in order to return back to this state after transformation
document.writeGraphicsSave();

//Shear current graphics state. So we add shear component to the current transformation.
document.shear(0.1f, 0.2f);

//Set paint in the current graphics state
document.setPaint(new Color(255,192,203));

//Fill the fifth rectangle in the current graphics state (has shear transformation)
document.fill(shape);

//Restore graphics state to the previous (upper) level
document.writeGraphicsRestore();
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Übersetzen Sie den Grafikstatus der oberen Ebene, um die nächsten Rechtecke in den leeren Bereich auf der Seite einzufügen.

//Displace upper level graphics state on 250 to the right.
document.translate(250, 0);

Jetzt erstellen wir den letzten Grafikzustand, der einer komplexen Transformation unterzogen wird, die Übersetzungs-, Skalierungs- und Rotationskomponenten enthält, und fügen diesem neuen Grafikzustand dasselbe Rechteck hinzu, das mit der Farbe Aquamarin bemalt ist. Am Ende verlassen wir den aktuellen Grafikstatus und wechseln zum Grafikstatus der oberen Ebene:

////////////////////////////////////// Complex transformation ////////////////////////////////////////////////////////
//Save graphics state in order to return back to this state after transformation
document.writeGraphicsSave();

//Transform current graphics state with complex transformation. So we add translation, scale and rotation components to the current transformation.
document.transform(new AffineTransform(1.2f, -0.965925f, 0.258819f, 1.5f, 0f, 50));

//Set paint in the current graphics state
document.setPaint(new Color(127,255,212));

//Fill the sixth rectangle in the current graphics state (has complex transformation)
document.fill(shape);

//Restore graphics state to the previus (upper) level
document.writeGraphicsRestore();
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Übersetzen Sie den Grafikstatus der oberen Ebene, um das letzte Rechteck im leeren Bereich der Seite zu platzieren:

//Returns upper level graphics state back to the left and displace on 200 to the bottom.
document.translate(-250, 200);

Das letzte gefüllte Rechteck, das wir wieder in den Grafikzustand der oberen Ebene eingefügt haben, zeigt, dass es keinen Transformationen der Grafikzustände der unteren Ebene und keinen Farbänderungen darin unterzogen wurde. Die orange Farbe verbleibt in der aktuellen Farbe:

////////////////////////////////////// Again no transformation ////////////////////////////////////////////////////////
//Demonstrates that current graphics state's color is orange that was set up at the beginning of the code. 
//Fill the seventh rectangle in the current graphics state (has no transformation)
document.fill(path);
//////////////////////////////////////////////////////////////////////////////////////////////////////////////////////

Abschließend schließen wir die aktuelle Seite und speichern das Dokument:

//Close current page
document.closePage();

//Save the document
document.save();
}

Siehe Arbeiten mit Transformationen im PS-Dokument in .NET.

Das Ergebnis der Ausführung dieses Codes ist das nächste

Sie können Beispiele und Datendateien herunterladen von GitHub.