Travailler avec des clips dans un fichier PS| Java

Ajouter un clip dans un document PS

Un clip dans un document PS est un chemin qui délimite le contenu de l’état graphique actuel qui sera affiché dans la visionneuse ou l’éditeur PS. Le contenu laissé au-delà des limites sera coupé.

Un chemin de détourage en Java peut être attribué de trois manières :

• par n’importe quelle classe implémentée java.awt.Shape pouvant contenir n’importe quelle forme fermée ;
• par contour de texte ;
• par une image bicolore de 1 bpp (bits par pixel) comme masque de pochoir ;

À l’heure actuelle, la bibliothèque Aspose.Page pour Java propose la première et la deuxième manière de découper. Dans l’exemple ci-dessous, nous obtenons une forme de cercle comme chemin de détourage et découpons un rectangle rempli de bleu dans le même état graphique.

Pour ajouter un clip au nouveau PsDocument avec la bibliothèque Aspose.Page pour Java dans cet exemple, nous procédons comme suit :

1. Créez un flux de sortie pour le fichier PS résultant.
2. Créez un objet PsSaveOptions avec les options par défaut.
3. Créez un PsDocument d’une page avec un flux de sortie déjà créé et enregistrez les options.
4. Créez un nouvel état graphique.
5. Créez une forme de cercle (objet java.awt.geom.Ellipse2D).
6. Définissez un clip avec ce chemin.
7. Définissez une peinture sur l’état graphique actuel de PsDocument.
8. Remplissez le chemin du rectangle avec la peinture actuelle.
9. Quittez l’état graphique actuel pour passer au niveau supérieur.
10. Traduisez à la place du rectangle rempli.
11. Tracez avec une ligne pointillée les limites du même rectangle au-dessus de celui rempli pour afficher les limites du rectangle rempli coupé.
12. Fermez la page.
13. Enregistrez le document.

// Demonstrates clipping by shape and clipping by text in PS document.
String outputFileName = "ApplyClipByShape_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create new 1-paged PS Document
PsDocument document = new PsDocument(getOutputDir() + outputFileName, options, false);

//Create graphics path from the rectangle
GeneralPath rectanglePath = new GeneralPath();
rectanglePath.append(new Rectangle2D.Float(0, 0, 300, 200), false);

////////////////////////////////////// Clipping by shape ///////////////////////////////

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

//Displace current graphics state on 100 points to the right and 100 points to the bottom.
document.translate(100, 100);

//Create graphics path from the circle
GeneralPath circlePath = new GeneralPath();
circlePath.append(new Ellipse2D.Float(50, 0, 200, 200), false);

//Add clipping by circle to the current graphics state
document.clip(circlePath);

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

//Fill the rectangle in the current graphics state (with clipping)
document.fill(rectanglePath);

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

//Displace upper level graphics state on 100 points to the right and 100 points to the bottom.
document.translate(100, 100);

//Create dashed stroke similar to Pen with DashStyle.Dash
float[] dash = new float[] { 5.0f };
BasicStroke stroke = new BasicStroke(2.0f, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER, 10.0f, dash, 0.0f);

document.setStroke(stroke);

//Draw the rectangle in the current graphics state (has no clipping) above clipped rectangle
document.draw(rectanglePath);

//Close current page
document.closePage();

//Save the document
document.save();

Voir Travailler avec des clips dans des documents PS dans .NET.

Le résultat de l’exécution de ce code apparaît comme

Dans l’exemple suivant, nous obtenons une police utilisée pour découper un rectangle rempli de bleu avec le contour du texte.

Pour ajouter un extrait de texte au nouveau PsDocument avec la bibliothèque Aspose.Page pour Java dans cet exemple, nous procédons comme suit :

1. Créez un flux de sortie pour le fichier PS résultant.
2. Créez un objet PsSaveOptions avec les options par défaut.
3. Créez un PsDocument d’une page avec un flux de sortie déjà créé et enregistrez les options.
4. Créez un nouvel état graphique.
5. Créez une police.
6. Définissez un clip avec le texte et la police.
7. Définissez une peinture sur l’état graphique actuel de PsDocument.
8. Remplissez le chemin du rectangle avec la peinture actuelle.
9. Quittez l’état graphique actuel pour passer au niveau supérieur.
10. Traduisez à la place du rectangle rempli.
11. Tracez avec une ligne pointillée les limites du même rectangle au-dessus de celui rempli pour afficher les limites du rectangle rempli coupé.
12. Fermez la page.
13. Enregistrez le document.

// Demonstrates clipping by text in PS document.
String outputFileName = "ApplyClipByText_outPS.ps";

//Create save options with A4 size
PsSaveOptions options = new PsSaveOptions();

// Create new 1-paged PS Document
PsDocument document = new PsDocument(getOutputDir() + outputFileName, options, false);

//Create graphics path from the rectangle
GeneralPath rectanglePath = new GeneralPath();
rectanglePath.append(new Rectangle2D.Float(0, 0, 300, 200), false);

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

//Displace current graphics state on 100 points to the right and 100 points to the bottom.
document.translate(100, 100);

float[] dash = new float[] { 5.0f };
BasicStroke stroke = new BasicStroke(2.0f, BasicStroke.CAP_BUTT, BasicStroke.JOIN_MITER, 10.0f, dash, 0.0f);

int fontSize = 120;
Font font = new Font("Arial", Font.BOLD, fontSize);

//Clip rectangle by text's outline
document.clipText("ABC", font, 20, fontSize + 10);

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

document.fill(rectanglePath);

document.writeGraphicsRestore();

document.translate(100, 100);

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

document.setStroke(stroke);
//Draw the rectangle in the current graphics state (has no clipping) above clipped rectangle
document.draw(rectanglePath);

//Close current page
document.closePage();

//Save the document
document.save();

Voir Travailler avec des clips dans des documents PS dans .NET.

Le résultat de l’exécution de ce code apparaît comme

Vous pouvez télécharger des exemples et des fichiers de données à partir de GitHub.