ConvertTextToPaths

Edición de flujos de contenido, Fuentes

Descripción

Reescribe las instrucciones de muestra de texto de las páginas seleccionadas como invocaciones de Form XObject vectoriales, conservando la ubicación de glifos, el espaciado de texto, el modo de escritura, las transformaciones, el color de relleno, el color de trazo y la configuración de trazo

Los contornos de glifos TrueType y Type 1 se extraen una vez y se reutilizan para glifos repetidos. Los CharProcs Type 3 se convierten en Form XObjects ordinarios conservando su matriz de fuente, cuadro delimitador y ámbito de recursos. Se eliminan las instrucciones originales de visualización de texto y selección de fuente

La conversión es transaccional Cada capa de contenido seleccionada y cada Form anidado solicitado se analiza y convierte en memoria antes de modificar cualquier objeto PDF Las fuentes no compatibles, los modos de representación de recorte de texto del 4 al 7, el estado de texto mal formado y los ámbitos ambiguos de recursos Form compartidos fallan sin reescribir parcialmente el documento

El texto convertido deja de poder buscarse, seleccionarse o extraerse como texto Sigue siendo contenido vectorial escalable para representación e impresión

Sintaxis

Delphi

Function TPDFlib.ConvertTextToPaths(Const PageRange: WideString= ''; Options: Integer= PDF_TEXT_PATH_DEFAULT): Integer;

ActiveX

Function PDFlib::ConvertTextToPaths(PageRange As String, Options As Long) As Long

DLL

int DLConvertTextToPaths(int InstanceID, const wchar_t *PageRange, int Options);
int DLConvertTextToPathsA(int InstanceID, const char *PageRange, int Options);

Parámetros

PageRange	Expresión de intervalo de páginas que usa números de página basados en uno. Un valor vacío selecciona todas las páginas
Options	Combinación bit a bit de `PDF_TEXT_PATH_RECURSE_FORMS` para convertir XObjects Form anidados y `PDF_TEXT_PATH_PURGE_FONTS` para eliminar recursos de fuente de origen que ya no se usan `PDF_TEXT_PATH_DEFAULT` habilita ambas opciones

Valores devueltos

1 or greater	Número de instrucciones de visualización de texto convertidas
0	No se encontró texto apto, el intervalo o las opciones no eran válidos, o la conversión falló. Inspeccione `LastErrorCode` para distinguir los errores

Códigos de error

506	La fuente de origen no puede proporcionar un programa de glifos vectoriales compatible
507	Un modo de renderizado de recorte de texto requiere una ruta de recorte que no puede representarse mediante un Form de glifo independiente
508	El programa de texto, el estado de fuente o el ámbito recursivo de recursos Form está mal formado o es ambiguo

Ejemplo

Converted := PDF.ConvertTextToPaths('1-3,5', PDF_TEXT_PATH_DEFAULT);
If (Converted= 0)and (PDF.LastErrorCode<> 0) Then
  raise Exception.Create(PDF.LastError);