Signatur
Beschreibung
ps_set_border_style legt den visuellen Stil des Rahmens fest, der um Annotationen (z. B. Hyperlinks oder Notizen) in einem mit der ps-Extension erzeugten PostScript-Dokument gezeichnet wird. Diese Funktion muss vor dem Erstellen der entsprechenden Annotation aufgerufen werden, damit die Einstellungen wirksam sind.
Der Parameter style bestimmt das Linienmuster des Rahmens. Typische Werte sind "solid" für eine durchgezogene Linie und "dashed" für eine gestrichelte Linie. Mit width wird die Stärke der Rahmenlinie in PostScript-Punkten angegeben.
Diese Funktion ist besonders nützlich, wenn interaktive PDF- oder PostScript-Dokumente mit klar erkennbaren Linkbereichen erstellt werden sollen. In Kombination mit ps_set_border_color und ps_set_border_dash lassen sich Annotationsrahmen vollständig individualisieren.
Beachte, dass die ps-PECL-Extension in modernen PHP-Umgebungen selten eingesetzt wird und eine separate Installation erfordert. Die Funktion gibt true bei Erfolg und false bei einem Fehler zurück.
Parameter
| Name | Typ | Default | Beschreibung |
|---|---|---|---|
| $psdoc Pflicht | resource | Die Ressource des PostScript-Dokuments, wie sie von ps_new() zurückgegeben wurde. |
|
| $style Pflicht | string | Der Rahmenstil der Annotation. Mögliche Werte sind "solid" (durchgezogene Linie) und "dashed" (gestrichelte Linie). |
|
| $width Pflicht | float | Die Breite des Rahmens in PostScript-Punkten. Ein Wert von 0.0 erzeugt keinen sichtbaren Rahmen. |
Rückgabewert
true bei Erfolg zurück, false wenn ein Fehler aufgetreten ist (z. B. ungültige Ressource oder unbekannter Stil).Beispiele
Einfacher Hyperlink mit durchgezogenem Rahmen
<?php
// PostScript-Dokument erstellen
$psdoc = ps_new();
ps_open_file($psdoc, 'ausgabe.ps');
ps_begin_page($psdoc, 595, 842);
// Rahmenstil auf "solid" mit Breite 1.5 Punkte setzen
ps_set_border_style($psdoc, 'solid', 1.5);
// Hyperlink-Annotation hinzufügen
ps_add_weblink($psdoc, 100, 700, 300, 720, 'https://www.example.com');
ps_end_page($psdoc);
ps_close($psdoc);
ps_delete($psdoc);
echo 'PostScript-Dokument mit Rahmen-Annotation erstellt.';
?>Gestrichelter Rahmen für eine Notiz-Annotation
<?php
$psdoc = ps_new();
ps_open_file($psdoc, 'notiz.ps');
ps_begin_page($psdoc, 595, 842);
// Gestrichelten Rahmenstil mit Breite 2.0 Punkte wählen
ps_set_border_style($psdoc, 'dashed', 2.0);
// Optional: Farbe des Rahmens setzen
ps_set_border_color($psdoc, 1.0, 0.0, 0.0); // Rot
// Notiz-Annotation einfügen
ps_add_note($psdoc, 150, 600, 350, 630, 'Hinweis', 'Bitte überprüfen!', 'Note', 0);
ps_end_page($psdoc);
ps_close($psdoc);
ps_delete($psdoc);
echo 'Notiz-Annotation mit gestricheltem rotem Rahmen erstellt.';
?>// Wichtig · Fallstricke
Reihenfolge beachten: ps_set_border_style muss vor dem Erstellen der Annotation aufgerufen werden, da die Einstellungen zum Zeitpunkt des Annotations-Aufrufs ausgewertet werden. Nachträgliche Änderungen wirken sich nicht auf bereits erstellte Annotationen aus.
Die ps-Extension ist eine PECL-Extension und standardmäßig nicht in PHP enthalten. Sie muss separat installiert werden (pecl install ps). In modernen Projekten wird häufig auf Alternativen wie FPDF, TCPDF oder mPDF zurückgegriffen, die keine externe Extension benötigen.
Ein width-Wert von 0.0 unterdrückt die Rahmenanzeige in vielen Viewern vollständig, was nützlich sein kann, wenn unsichtbare klickbare Bereiche gewünscht werden.