X_ Funciones de ClibPDF

ClibPDF Le permite crear documentos PDF con PHP_ Está disponible en FastIO pero no es software libre_ Debería leer la licencia antes de comenzar a utilizar ClibPDF_ Si usted no puede cumplir el acuerdo de la licencia considere el utilizar la pdflib de Thomas Merz, que tambien es muy potente_ La funcionalidad y la API de ClibPDF son similares a la pdflib de Thomas Merz pero, de acuerdo con FastIO, ClibPDF es mas rápida y crea documentos mas pequeños_ Esto puede haber cambiado con la nueva versión 2_0 de pdflib_ Un simple banco de pruebas (el ejemplo pdfclock_c de pdflib 2_0 trasformado en un script php) en realidad no muestra ninguna diferencia en velocidad_ Por tanto, pruebe las dos y vea cual hace el mejor trabajo para usted_

Esta documentación debería ser leída junto con el manual de ClibPDF ya que este explica la librería con mucho mas detalle_

Muchas funciones en le ClibPDF nativa y el módulo PHP, así como en pdflib, tienen el mismo nombre_ Todas las funciones excepto cpdf_open() toman el manejador del documento com el primer parámetro_ Actualmente este manejador no se usa internamente desde que ClibPDF no soporta la creación de varios documentos PDF al mismo tiempo_ Realmente, ni debería intentarlo, los resultados son impredecibles_ No puedo supervisar cuales son las consecuencias en un sistema multihilo_ De acuerdo con el autor de ClibPDF, esto cambiará en alguno de las próximas veriones (la versión actual, cuando eto fue escrito es 1_10)_ Si usted necesita esta capacidad, use el módulo pdflib_

Nota: La función cpdf_set_font() ha cambiado desde que PHP3 soporta fuentes asiáticas_ El parámetro que codifica ya no es un entero sino una cadena_

Una gran ventaja de ClibPDF sobre pdflib es la posibilidad de crear el documento PDF completamente en memoria sin usar ficheros temporales_ Esto también proporciona la capaciad de pasar coordenadas en una unidad de longitud predefinida_ Esta es una cualidad útil pero puede ser simulada con pdf_translate()_

La mayoría de las funciones son fáciles de usar_ La parte mas difícil es, probablemente, crear un documento PDF muy simple_ El siguiente ejemplo debería ayudarle a comenzar_ En él se crea un documento con una página_ La página contiene el texto "Times_Roman" con una fuente de 30pt_ El texto está subrayado_

Ejemplo 1_ Ejemplo simple de ClibPDF

<?php
$cpdf = cpdf_open(0);
cpdf_page_init($cpdf, 1, 0, 595, 842);
cpdf_add_outline($cpdf, 0, 0, 0, 1, "Page 1");
cpdf_set_font($cpdf, "Times_Roman", 30, "WinAnsiEncoding");
cpdf_set_text_rendering($cpdf, 1);
cpdf_text($cpdf, "Times Roman outlined", 50, 750);
cpdf_moveto($cpdf, 50, 740);
cpdf_lineto($cpdf, 330, 740);
cpdf_stroke($cpdf);
cpdf_finalize($cpdf);
Header("Content_type: application/pdf");
cpdf_output_buffer($cpdf);
cpdf_close($cpdf);
?>

La distribución de pdflib contiene un ejemplo mas comlejo que crea una serie de páginas con un reloj analógico_ Aquí está ese ejemplo convertido en PHP usando la extensión ClibPDF:

Ejemplo 2_ Ejemplo con pdfclock de la distribución pdflib 2_0

<?php
$radius = 200;
$margin = 20;
$pagecount = 40;

$pdf = cpdf_open(0);
cpdf_set_creator($pdf, "pdf_clock_php3");
cpdf_set_title($pdf, "Reloj Analigico");
  
while($pagecount__ > 0) {
  cpdf_page_init($pdf, $pagecount+1, 0, 2 * ($radius + $margin), 2 * ($radius + $margin), 1_0);
  
  cpdf_set_page_animation($pdf, 4, 0_5, 0, 0, 0);  /* limpiar */
  
  cpdf_translate($pdf, $radius + $margin, $radius + $margin);
  cpdf_save($pdf);
  cpdf_setrgbcolor($pdf, 0_0, 0_0, 1_0);
  
  /*  cambio de minuto */
  cpdf_setlinewidth($pdf, 2_0);
  for ($alpha = 0; $alpha < 360; $alpha += 6)
    {
    cpdf_rotate($pdf, 6_0);
    cpdf_moveto($pdf, $radius, 0_0);
    cpdf_lineto($pdf, $radius_$margin/3, 0_0);
    cpdf_stroke($pdf);
    }
  
  cpdf_restore($pdf);
  cpdf_save($pdf);
 
  /* cambios de 5 minutos */
  cpdf_setlinewidth($pdf, 3_0);
  for ($alpha = 0; $alpha < 360; $alpha += 30)
  {
    cpdf_rotate($pdf, 30_0);
    cpdf_moveto($pdf, $radius, 0_0);
    cpdf_lineto($pdf, $radius_$margin, 0_0);
    cpdf_stroke($pdf);
  }

  $ltime = getdate();

  /* dibujar la aguja de las horas */
  cpdf_save($pdf);
  cpdf_rotate($pdf, _(($ltime['minutos']/60_0) + $ltime['horas'] _ 3_0) * 30_0);
  cpdf_moveto($pdf, _$radius/10, _$radius/20);
  cpdf_lineto($pdf, $radius/2, 0_0);
  cpdf_lineto($pdf, _$radius/10, $radius/20);
  cpdf_closepath($pdf);
  cpdf_fill($pdf);
  cpdf_restore($pdf);

  /* dibujar el minutero */
  cpdf_save($pdf);
  cpdf_rotate($pdf, _(($ltime['segundos']/60_0) + $ltime['minutos'] _ 15_0) * 6_0);
  cpdf_moveto($pdf, _$radius/10, _$radius/20);
  cpdf_lineto($pdf, $radius * 0_8, 0_0);
  cpdf_lineto($pdf, _$radius/10, $radius/20);
  cpdf_closepath($pdf);
  cpdf_fill($pdf);
  cpdf_restore($pdf);

  /* dibujar la seguna mano */
  cpdf_setrgbcolor($pdf, 1_0, 0_0, 0_0);
  cpdf_setlinewidth($pdf, 2);
  cpdf_save($pdf);
  cpdf_rotate($pdf, _(($ltime['segundos'] _ 15_0) * 6_0));
  cpdf_moveto($pdf, _$radius/5, 0_0);
  cpdf_lineto($pdf, $radius, 0_0);
  cpdf_stroke($pdf);
  cpdf_restore($pdf);

  /* dibujar un pequeno circulo en el centro */
  cpdf_circle($pdf, 0, 0, $radius/30);
  cpdf_fill($pdf);

  cpdf_restore($pdf);

  cpdf_finalize_page($pdf, $pagecount+1);
}

cpdf_finalize($pdf);
Header("Content_type: application/pdf");
cpdf_output_buffer($pdf);
cpdf_close($pdf);
?>

Tabla de contenidos
cpdf_add_annotation __ Añade una anotación
cpdf_add_outline __ Añade una marca en la página actual
cpdf_arc __ Dibuja un arco
cpdf_begin_text __ Inicializa una sección de texto
cpdf_circle __ Dibuja un círculo
cpdf_clip __ Ajusta al camino actual
cpdf_close __ Cierra un documento PDF
cpdf_closepath_fill_stroke __ Cierra, llena y traza el camino actual
cpdf_closepath_stroke __ Cierra el camino y dibuja una línea a lo largo del camino
cpdf_closepath __ Cierra el camino
cpdf_continue_text __ Pone texto en la línea siguiente
cpdf_curveto __ Dibuja una curva
cpdf_end_text __ Finaliza una sección de texto
cpdf_fill_stroke __ LLena y traza el camino actual
cpdf_fill __ LLena el camino actual
cpdf_finalize_page __ Finaliza una página
cpdf_finalize __ Finaliza un documento
cpdf_global_set_document_limits __ Sets document limits for any pdf document
cpdf_import_jpeg __ Abre una imagen JPEG
cpdf_lineto __ Dibuja una línea
cpdf_moveto __ Define el punto actual
cpdf_newpath __ Starts a new path
cpdf_open __ Abre un nuevo documento PDF
cpdf_output_buffer __ Pone el documento PDF en el buffer de memoria
cpdf_page_init __ Comienza una nueva página
cpdf_place_inline_image __ Situa una imagen en la página
cpdf_rect __ Dibuja un rectángulo
cpdf_restore __ Restaura un entorno formalmente salvado
cpdf_rlineto __ Dibuja una línea
cpdf_rmoveto __ Define el punto actual
cpdf_rotate_text __ Sets text rotation angle
cpdf_rotate __ Define la rotación
cpdf_save_to_file __ Escribe el documento PDF en un fichero
cpdf_save __ Salva el entorno actual
cpdf_scale __ Define la escala
cpdf_set_action_url __ Sets hyperlink
cpdf_set_char_spacing __ Determina el espacio entre caracteres
cpdf_set_creator __ Define el campo creator en el documento PDF
cpdf_set_current_page __ Define la página actual
cpdf_set_font_directories __ Sets directories to search when using external fonts
cpdf_set_font_map_file __ Sets fontname to filename translation map when using external fonts
cpdf_set_font __ Selecciona la fuente y el tamaño actual
cpdf_set_horiz_scaling __ Define la escala horizontal del texto
cpdf_set_keywords __ Pone el valor del campo 'keywords'(palabras clave) de un documento PDF
cpdf_set_leading __ Define la distancias entre las líneas de texto
cpdf_set_page_animation __ Define la separación entre páginas
cpdf_set_subject __ Define el valor del campo subjet de un documento PDF
cpdf_set_text_matrix __ Define la matriz de texto
cpdf_set_text_pos __ Define la posición del texto
cpdf_set_text_rendering __ Determina cómo es presentado el texto
cpdf_set_text_rise __ Define la elevación del texto
cpdf_set_title __ Define el campo title de un documento PDF
cpdf_set_viewer_preferences __ How to show the document in the viewer
cpdf_set_word_spacing __ Define el espacio entre palabras
cpdf_setdash __ Defina el patrón de la raya
cpdf_setflat __ Define la monotonía
cpdf_setgray_fill __ Pone el color de relleno al valor gris
cpdf_setgray_stroke __ Define el color para dibujar al valor gris
cpdf_setgray __ Pone el color de relleno y dibujo a gris
cpdf_setlinecap __ Define el parámetro linecap
cpdf_setlinejoin __ Define el parámetro linejoin
cpdf_setlinewidth __ Define la profundidad de la línea
cpdf_setmiterlimit __ Define el límite del inglete
cpdf_setrgbcolor_fill __ Pone el color de relleno a l valor de clor rgb
cpdf_setrgbcolor_stroke __ Pone el color de dibujo al valor de color rgb
cpdf_setrgbcolor __ Pone el color de relleno y dibujo al valor de color rgb
cpdf_show_xy __ Muestra texto en la posición
cpdf_show __ Muestra el texto en la posición actual
cpdf_stringwidth __ Devuelve la anchura del texto en la fuente actual
cpdf_stroke __ Dibuja una línea a lo largo del camino
cpdf_text __ Muestra texto conparámetros
cpdf_translate __ Define el sistema de origen de coordenadas