Zum Inhalt springen

Branding

Das Branding-Subsystem wendet während einer Evaluierung sichtbares Evaluierungs-Branding auf erzeugte PDFs an und wendet unter einer bezahlten Lizenz nichts an. Es wird im Paket nextpdf/enterprise ausgeliefert, regelt das Evaluierungsverhalten über alle Editionen hinweg und wird vollständig von der Lizenz gesteuert — nicht vom Anwendungscode. Für die durchgängige Evaluierungsgeschichte siehe Trial and Evaluation Branding; diese Seite dokumentiert das Branding-Subsystem selbst.

Terminal-Fenster
composer require nextpdf/enterprise:^3

Die Laufzeitumgebung hat einen Branding-Modus mit zwei Zuständen, modelliert durch BrandingMode:

  • None — kein Evaluierungs-Branding. Bezahlte und normale Ausgabe wird nie verändert. Dies ist der Standard.
  • EvaluationWatermark — sichtbares Evaluierungs-Branding wird auf erzeugte PDFs angewendet.

BrandingStrategyFactory ordnet den Modus einer Strategie zu: NullBrandingStrategy für None (sie führt keine Arbeit aus und erzeugt keine Veränderung) und EvaluationBrandingStrategy für EvaluationWatermark. Der Lizenzzustand — nicht der Anwendungscode — wählt den Modus aus. Eine bezahlte Lizenz erzeugt nie gebrandete Ausgabe, und es gibt keinen Produktions-Build zum Umschalten und kein Code-Flag zum Setzen.

Diese Seite beschreibt ausschließlich das Laufzeitverhalten. Sie gibt keine Gewährleistung und keine Aussage über Anspruchsberechtigung oder Rechtswirkung ab; die für Ihre Evaluierung oder Ihr Abonnement geltenden Bedingungen werden ausschließlich durch Ihren Lizenzvertrag definiert.

ConceptBehavior
BrandingModeZwei Zustände: None (Standard, keine Veränderung) oder EvaluationWatermark.
BrandingStrategyFactoryLöst einen BrandingMode zu einer Strategie auf.
EvaluationBrandingStrategyWendet das Evaluierungs-Wasserzeichen und die Metadaten-Dekoration an.
NullBrandingStrategyNo-op-Strategie für bezahlte / normale Ausgabe.
EvaluationBrandingConfigUnveränderlicher Wasserzeichentext, Metadaten-Dekoration, Schriftgröße, Graustufe und Winkel.

Das Branding-Subsystem wird im Paket nextpdf/enterprise unter dem Capability-Code enterprise.branding ausgeliefert und regelt das Evaluierungsverhalten über alle Editionen hinweg. Es ist hier auf Verhaltensebene dokumentiert und wird vollständig von der Lizenz gesteuert.

Es gibt keine aufrufbare Anwendungs-API: Der Branding-Modus wird vom Lizenzumschlag ausgewählt, nicht vom Anwendungscode, sodass diese Seite die Abschnitte Code sample — Quick start / Code sample — Production auslässt, die Referenzen aufrufbarer APIs tragen. Die einzige umsetzbare Konfiguration ist die Installation des Pakets und der Lizenz; die Front-Matter für deterministische Builds unten zeigt, wie man eine branding-freie Ausgabe in einem Reproduzierbarkeitsprofil zusichert:

# Front matter for a reproducible (no-evaluation-branding) build profile.
# BrandingMode::None is the default; a paid license keeps it None.
reproducibility_profile: structural
branding_mode_expected: none # assert null strategy: no watermark, no metadata markers

Wenn die aktive Lizenz EvaluationWatermark auswählt, tut die Evaluierungsstrategie Folgendes:

  • Sie zeichnet einen hellgrauen diagonalen Wasserzeichentext auf jede Seite, gerendert als Seiteninhaltsstrom in einem isolierten Grafikzustand, sodass er den umgebenden Inhalt oder Ihr Layout nicht verändert;
  • sie hängt ein Evaluierungs-Suffix an die Producer-Metadaten des Dokuments an;
  • sie stellt ein Evaluierungs-Präfix den Subject-Metadaten des Dokuments voran.

Das Wasserzeichen verwendet eine Base14-Schrift und eine Rotationsmatrix, um den Text diagonal über die Seitenmitte zu positionieren. Das Konfigurationsobjekt ist unveränderlich und validiert seine Eingaben (zum Beispiel darf der Wasserzeichentext nicht leer sein und die Schriftgröße muss positiv sein).

Unter einer bezahlten (nicht-Evaluierungs-) Lizenz ist der Branding-Modus None und die Null-Strategie wird ausgewählt: kein Wasserzeichen, kein Producer-Suffix, kein Subject-Präfix. Die Ausgabe ist identisch mit einer Ausgabe, die ganz ohne Branding-Subsystem erzeugt wurde. Das Entfernen des Evaluierungs-Brandings erfordert keine Codeänderung — installieren Sie eine bezahlte Lizenz, und das nächste erzeugte Dokument ist ungebrandet.

  • Branding erscheint, wenn der Lizenzzustand evaluierungsartig ist. Dies spiegelt den Lizenzzustand wider, keinen Defekt; prüfen Sie den Lizenzstatus und verlängern Sie über das Lizenzportal.
  • Das Wasserzeichen ist absichtlich zentriert und diagonal, damit die Evaluierungsausgabe eindeutig ist; es ist nicht darauf ausgelegt, für die Produktion abgestimmt zu werden. Eine bezahlte Lizenz entfernt es vollständig.
  • Producer- und Subject-Metadaten tragen während einer Evaluierung Evaluierungsmarkierungen und fehlen unter einer bezahlten Lizenz.

Das Wasserzeichen ist ein kleiner, fester Inhaltsstrom pro Seite mit vernachlässigbarem Einfluss auf die Erzeugungszeit oder die Dokumentgröße. Unter einer bezahlten Lizenz führt das Subsystem keine Arbeit aus. Das Seiten-Performance-Budget spiegelt das Rendern der Dokumentation wider.

Evaluierungs-Branding ist eine Sichtbarkeitsmarkierung, keine Sicherheitskontrolle. Es kennzeichnet Evaluierungsausgabe. Es ist keine digitale Signatur und darf nicht als solche herangezogen werden. Für manipulationssichere Ausgabe verwenden Sie die in der Funktionsmatrix beschriebenen Signierfähigkeiten. Die Lizenz, die den Branding-Modus auswählt, ist ein signierter Umschlag, dessen Aussteller-Signatur die Laufzeitumgebung verifiziert.

Das Branding-Subsystem fügt ein festes Wasserzeichen und Metadatenmarkierungen hinzu; es liest oder überträgt keinen Dokumenteninhalt und führt keine Netzwerkaufrufe aus.

Das Subsystem protokolliert keinen Dokumenteninhalt. Lizenzzustandsübergänge, die den Branding-Modus ändern, werden über das Lizenzierungs-Subsystem sichtbar gemacht, nicht hier.

Für diese Seite wird keine Standardkonformität beansprucht. Sie beschreibt ausschließlich das Laufzeitverhalten. Sie gibt keine Gewährleistung, Zertifizierung oder Anspruchsberechtigung an oder impliziert sie. Die Bedingungen Ihrer Evaluierung oder Ihres Abonnements werden ausschließlich durch Ihren Lizenzvertrag definiert.

Dieses Modul führt keine kryptografischen Operationen aus. Die Verifizierung der Lizenzsignatur wird vom Lizenzierungs-Subsystem übernommen.

Das Branding-Subsystem selbst verarbeitet keine externe Eingabe über den aufgelösten Branding-Modus hinaus. Der Lizenzumschlag, der den Modus auswählt, ist signiert, und seine Aussteller-Signatur wird von der Laufzeitumgebung verifiziert; das Fälschen des Modus würde das Fälschen dieser Signatur erfordern.

Evaluieren Sie den vollständigen Funktionsumfang mit Evaluierungs-Branding und entfernen Sie das Branding anschließend, indem Sie eine bezahlte Lizenz installieren — keine Codeänderungen, kein separater Build. Siehe Trial and Evaluation Branding für den vollständigen Evaluierungslebenszyklus. Um eine Evaluierung zu starten, besuchen Sie das Lizenzportal.

Dieses Subsystem wird im NextPDF Enterprise-Paket unter dem Capability-Code enterprise.branding ausgeliefert und regelt das Evaluierungsverhalten über alle Editionen hinweg. Sein Modus wird von der Lizenz ausgewählt, nicht vom Anwendungscode. Lizenz erwerben.

Dieses Subsystem wird durch den Capability-Code enterprise.branding im Paket nextpdf/enterprise geschaltet. Anders als die meisten Enterprise-Oberflächen hat es einen dedizierten Capability-Code, weil es das Evaluierungsverhalten über alle Editionen hinweg regelt. Der Branding-Modus wird zur Laufzeit aus dem Lizenzumschlag aufgelöst; kein Anwendungs-Flag wählt ihn aus.

  • BrandingMode hat zwei Zustände: None (Standard; keine Veränderung der Ausgabe) und EvaluationWatermark.
  • Unter einer bezahlten (nicht-Evaluierungs-) Lizenz ist der Modus None und die Null-Strategie wird ausgewählt: Die Ausgabe ist identisch mit einer Ausgabe, die ganz ohne Branding-Subsystem erzeugt wurde.
  • Unter einer Evaluierungslizenz zeichnet die Strategie ein diagonales Wasserzeichen in einem isolierten Grafikzustand und hängt Evaluierungsmarkierungen an die Producer- und Subject-Metadaten an.
  • Das Konfigurationsobjekt ist unveränderlich und validiert seine Eingaben (Wasserzeichentext nicht leer, Schriftgröße positiv).

Diese öffentliche Seite beschreibt ausschließlich extern beobachtbares Verhalten. Sie enthält keine internen Namespace-Pfade, keine internen Trait-Namen, keine Runbook-Dateinamen und keine internen Ticket-Präfixe. Detaillierte Interna befinden sich in der zugangsbeschränkten Deep Reference unter NDA.

Das Branding-Subsystem wird im Paket nextpdf/enterprise ausgeliefert, regelt jedoch das Evaluierungsverhalten über alle Editionen hinweg, einschließlich reiner Core- und Pro-Bereitstellungen, die eine Evaluierungslizenz verwenden. Es gibt kein reines Core-Branding-Subsystem, auf das zurückgegriffen werden könnte; eine bezahlte Lizenz in jeder Edition löst zu BrandingMode::None auf.

Es gibt kein separates Pro-Branding-Subsystem. Dasselbe nextpdf/enterprise-Branding-Subsystem regelt das Evaluierungsverhalten für Pro-Bereitstellungen; eine bezahlte Pro-Lizenz löst zu BrandingMode::None auf, genau wie eine bezahlte Enterprise-Lizenz.

Die Auflösung des Branding-Modus, das Rendern des Wasserzeichens und die Metadaten-Dekoration werden nur auf Verhaltensebene beschrieben. Die interne Zuordnung von Lizenzzustand zu Modus, die interne Wasserzeichengeometrie und die interne Verdrahtung der Strategy-Factory liegen außerhalb des Geltungsbereichs der öffentlichen Oberfläche und werden hier nicht wiedergegeben.

Der Lizenzumschlag, der den Branding-Modus auswählt, ist ein signiertes Artefakt, dessen Aussteller-Signatur die Laufzeitumgebung verifiziert; Lizenzbereitstellung, -verlängerung und sichere Speicherung der Lizenz liegen in der Verantwortung des Betreibers. Das Subsystem führt keine Netzwerkaufrufe aus und liest keinen Dokumenteninhalt.

Diese Seite beschreibt ausschließlich das Laufzeitverhalten. Sie gibt keine Gewährleistung, Zertifizierung oder Anspruchsberechtigung an oder impliziert sie, und sie stellt keine Rechtsberatung dar. Die Bedingungen Ihrer Evaluierung oder Ihres Abonnements — einschließlich, welches Branding gilt und für wie lange — werden ausschließlich durch Ihren Lizenzvertrag definiert. Konsultieren Sie diesen Vertrag oder wenden Sie sich an den Vertrieb.