Método RenderPageProgressive

Color = clNone o Color = clDefault seleccionan un fondo transparente y un bitmap PDFium con canal alfa; los píxeles sin cubrir conservan alfa cero independientemente de la consulta nativa de transparencia del fondo de página, incluso en resultados parciales devueltos tras cancelar; clWhite sigue siendo el fondo opaco predeterminado

RenderPageProgressive renderiza la página actual en el Bitmap suministrado mediante el ciclo FPDF_RenderPageBitmap_Start + FPDF_RenderPage_Continue de PDFium. Entre iteraciones, la devolución de llamada IFSDK_PAUSE de PDFium consulta AToken.IsCancelled — cuando la aplicación ha cancelado, el ciclo se desenreda limpiamente y el mapa de bits conserva el trabajo parcial realizado hasta ese momento

PDFium renderiza directamente en un buffer de bitmap de destino compatible; los buffers LCL nativos también deben tener el orden de bytes, desplazamientos de canales, orden de líneas y stride esperados; los demás formatos se convierten usando su descripción real de imagen cruda

El valor devuelto identifica cómo terminó el renderizado:

• prsDone — el mapa de bits está completamente renderizado. Equivalente a un RenderPage síncrono exitoso
• prsCancelled — el llamador canceló a mitad del ciclo. El mapa de bits conserva el resultado parcial hasta la iteración en que se detectó la cancelación; trátelo como contenido de vista previa de mejor esfuerzo
• prsFailed — PDFium informó FPDF_RENDER_FAILED. El estado del mapa de bits queda indefinido

Pase AToken = nil para renderizar hasta completar sin pausarse nunca. En ese caso la función sigue bombeando FPDF_RenderPage_Continue hasta DONE, pero nunca devuelve prsCancelled. Esto es útil cuando el llamador quiere los puntos de redibujado intermedios del ciclo progresivo (un OnPaint personalizado que refleja el mapa de bits en progreso) pero no necesita cancelación

• El llamador debe asignar el bitmap; en Windows se usa pf32bit; los bitmaps LCL nativos conservan su descripción de plataforma y solo usan renderizado directo cuando la disposición real del buffer es compatible
• Width / Height están en píxeles (las dimensiones del mapa de bits de destino). La página se escala para ajustarse a esas dimensiones antes de que comience el ciclo progresivo
• RenderPageProgressive en sí es síncrono desde el punto de vista del llamador — devuelve cuando el renderizado termina o se cancela. Para liberar el hilo principal, impulse RenderPageProgressive desde un hilo de trabajo. TPdf serializa las llamadas de renderizado por instancia; los llamadores aún deben evitar modificar o descargar el documento mientras un renderizado está en curso
• Se lanza un EPdfError cuando Bitmap es nil — el contrato requiere un mapa de bits asignado por el llamador porque la ruta sin copia necesita una disposición DIB conocida