Méthode RenderPageProgressive

Variante annulable de RenderPage qui pilote la boucle de rendu progressif de PDFium et interroge un IPdfCancellationToken entre les itérations afin que les rendus longue durée en haute résolution puissent être abandonnés en pleine page au lieu de bloquer jusqu'à l'achèvement

Color = clNone ou Color = clDefault sélectionne un fond transparent et un bitmap PDFium avec alpha ; les pixels non couverts gardent un alpha nul indépendamment de la requête native de transparence de fond, y compris les résultats partiels après annulation ; clWhite reste le fond opaque par défaut

RenderPageProgressive affiche la page courante dans le Bitmap fourni en utilisant la boucle FPDF_RenderPageBitmap_Start + FPDF_RenderPage_Continue de PDFium. Entre les itérations, le rappel IFSDK_PAUSE de PDFium interroge AToken.IsCancelled — lorsque l'application a annulé, la boucle se déroule proprement et le bitmap conserve le travail partiel effectué jusqu'alors

PDFium dessine directement dans un tampon bitmap destination compatible ; les tampons LCL natifs doivent aussi avoir l’ordre d’octets, décalages de canaux, ordre des lignes et pas attendus ; les autres dispositions sont converties selon leur description réelle d’image brute

La valeur de retour identifie comment le rendu s'est terminé :

• prsDone — le bitmap est entièrement rendu. Équivalent à un RenderPage synchrone réussi
• prsCancelled — l'appelant a annulé en pleine boucle. Le bitmap conserve le résultat partiel jusqu'à l'itération où l'annulation a été détectée ; traitez-le comme un contenu d'aperçu au mieux
• prsFailed — PDFium a signalé FPDF_RENDER_FAILED. L'état du bitmap est indéfini

Passez AToken = nil pour afficher jusqu'à l'achèvement sans jamais marquer de pause. Dans ce cas, la fonction continue toujours d'actionner FPDF_RenderPage_Continue jusqu'à DONE mais ne renvoie jamais prsCancelled. Cela est utile lorsque l'appelant veut les points de redessin intermédiaires de la boucle progressive (un OnPaint personnalisé qui reflète le bitmap en cours) mais n'a pas besoin d'annulation

• L’appelant doit allouer le bitmap ; Windows utilise pf32bit ; les bitmaps LCL natifs gardent leur description plateforme et n’utilisent le rendu direct que si la disposition réelle du tampon est compatible
• Width / Height sont en pixels (les dimensions du bitmap de destination). La page est mise à l'échelle pour tenir dans ces dimensions avant que la boucle progressive ne démarre
• RenderPageProgressive elle-même est synchrone du point de vue de l'appelant — elle renvoie quand le rendu se termine ou s'annule. Pour libérer le thread principal, pilotez RenderPageProgressive depuis un thread de travail. TPdf sérialise les appels de rendu par instance ; les appelants doivent néanmoins éviter de muter ou de décharger le document pendant qu'un rendu est en cours
• Une EPdfError est levée lorsque Bitmap vaut nil — le contrat exige un bitmap alloué par l'appelant car le chemin sans copie a besoin d'une disposition DIB connue

RenderPage, RenderTile