THPDFHeadlessRenderAccess
Le record dans HPDFHeadlessRenderAccess est retourné par THPDFHeadlessDocument.GetRenderAccess(PageIndex) pour un accès séquentiel en lecture seule au graphe du document courant
Le document propriétaire doit rester chargé et inchangé pendant toute l'utilisation ; les pointeurs, dictionnaires de ressources et résultats de callbacks sont empruntés, et les appelants ne doivent ni les libérer ni les modifier
| Champ | Contrat |
|---|---|
Context | Pointeur de document opaque passé inchangé à chaque callback |
PageDictionary, PageResources | Dictionnaire de page résolu et dictionnaire de ressources hérité |
Resolve: THPDFHeadlessRenderResolve | Résout un objet emprunté via les chemins xref, object-stream et sécurité existants |
ReadStream: THPDFHeadlessRenderReadStream | Retourne les octets décodés avec le maximum fourni appliqué avant le décodage, plafonné par le budget du document |
ReadImageBytes: THPDFHeadlessRenderReadImage | Authentifie et déchiffre un stream d'image, décode des filtres de préfixe bornés, et retourne soit des samples décodés, soit le payload final JPEG, JPEG 2000, CCITT ou JBIG2 avec son nom de filtre terminal et son dictionnaire DecodeParms emprunté |
FontResolver: THPDFHeadlessRenderFontResolver | Crée une interface vers le décodeur de polices de ressources existant |
RequireExtractionPermission: THPDFHeadlessRenderPermission | Vérifie l'annulation et la permission d'extraction authentifiée |
RequireOutputPath: THPDFHeadlessRenderOutputPath | Vérifie l'annulation et rejette les alias de source par chemin canonique et identité physique de fichier sans créer de fichier |
CancellationToken | Cancellation token du document emprunté, détenu par l'appelant |
MaxDecodedBytes, MaxDepth | Bornes supérieures héritées des options du document |
CatalogDictionary: THPDFDictionaryObject prête le catalog résolu pour la configuration d'optional-content ; nil signifie qu'aucun catalog n'a été fourni et que les structures d'optional-content n'ont aucun effet de visibilité
ResolveOptional: THPDFHeadlessRenderResolve résout les appartenances à des groupes optionnels et retourne nil pour les références manquantes, supprimées ou de génération périmée ; les objets vivants valides conservent le parsing normal, les vérifications object-stream, sécurité, annulation et profondeur, et leurs erreurs se propagent
Initialisez les records d'accès assemblés manuellement avec Default(THPDFHeadlessRenderAccess) avant d'assigner les callbacks ; un ResolveOptional nil utilise le resolver ordinaire, et un catalog nil préserve le rendering sans configuration d'optional-content
Les renderers de sortie doivent appeler RequireOutputPath(Context, FileName) avant de créer un fichier et appliquer leurs propres politiques de staging, publication et budget de destination
Lifetime: IHPDFHeadlessRenderLifetime conserve un bail de durée de vie du graphe ; nil reste valide pour le rendering statique, tandis que les états de viewer explicites exigent un bail valide et rejettent un accès expiré avant d'invoquer les callbacks
Une vue est invalide après que le document propriétaire a été fermé, rechargé, modifié ou détruit