Compartir a través de

Función MergeFontPackage (fontsub.h)

  • Artículo

La función MergeFontPackage manipula las fuentes creadas por CreateFontPackage. Es ligeramente más flexible que su nombre podría sugerir: puede controlar adecuadamente todas las fuentes de subconjuntos y paquetes de fuentes creados por CreateFontPackage. Puede convertir un paquete de fuentes en una fuente de trabajo y puede combinar un paquete de fuentes Delta en una fuente de trabajo preparada correctamente.

Normalmente, CreateFontPackage crea fuentes de subconjunto y paquetes de fuentes para pasar a una impresora o servidor de impresión; MergeFontPackage se ejecuta en esa impresora o servidor de impresión.

Sintaxis

unsigned long MergeFontPackage(
  [in]  const unsigned char  *puchMergeFontBuffer,
  [in]  const unsigned long  ulMergeFontBufferSize,
  [in]  const unsigned char  *puchFontPackageBuffer,
  [in]  const unsigned long  ulFontPackageBufferSize,
  [out] unsigned char        **ppuchDestBuffer,
  [out] unsigned long        *pulDestBufferSize,
  [out] unsigned long        *pulBytesWritten,
  [in]  const unsigned short usMode,
  [in]  CFP_ALLOCPROC        lpfnAllocate,
  [in]  CFP_REALLOCPROC      lpfnReAllocate,
  [in]  CFP_FREEPROC         lpfnFree,
  [in]  void                 *lpvReserved
);

Parámetros

[in] puchMergeFontBuffer

Puntero a un búfer que contiene una fuente con la que combinar. Esto solo se usa cuando usMode es TTFMFP_DELTA.

[in] ulMergeFontBufferSize

Especifica el tamaño de *puchMergeFontBuffer, en bytes.

[in] puchFontPackageBuffer

Puntero a un búfer que contiene un paquete de fuentes.

[in] ulFontPackageBufferSize

Especifica el tamaño de *puchMergeFontBuffer, en bytes.

[out] ppuchDestBuffer

Puntero a una variable de tipo unsigned char*. La función MergeFontPackage asignará un búfer **ppuchDestBuffer, mediante lpfnAllocate y lpfnReAllocate. Si la devolución es correcta, ese búfer contendrá la fuente combinada o expandida resultante. La aplicación es responsable de liberar finalmente ese búfer.

[out] pulDestBufferSize

Apunta a un long sin signo, que, al devolverse correctamente, especificará el tamaño asignado del búfer **ppuchDestBuffer.

[out] pulBytesWritten

Apunta a un long sin signo, que, al devolverse correctamente, especificará el número de bytes que se usan realmente en el búfer **ppuchDestBuffer.

[in] usMode

Especifica qué tipo de proceso se va a realizar. Seleccione uno de estos valores; no se pueden combinar.

Valor Significado
TTFMFP_SUBSET
 Copia una fuente de trabajo simple; vea los comentarios a continuación.

puchMergeFontBuffer se omitirá; puchFontPackageBuffer debe contener una fuente de trabajo creada por CreateFontPackage con usSubsetFormat establecido en TTFCFP_SUBSET; esta fuente de trabajo simplemente se copiará en ppuchDestBuffer.
TTFMFP_SUBSET1
 Convierte un paquete de fuentes en una fuente de trabajo combinable; vea los comentarios a continuación.

puchMergeFontBuffer se omitirá; puchFontPackageBuffer debe contener una fuente de trabajo combinable creada por CreateFontPackage con usSubsetFormat establecido en TTFCFP_SUBSET1. El resultado en **ppuchDestBuffer será una fuente de trabajo que se puede combinar con más adelante.
TTFMFP_DELTA
 Combina un paquete de fuentes Delta en una fuente de trabajo combinable; vea los comentarios a continuación.

*puchFontPackageBuffer debe contener un paquete de fuentes creado por CreateFontPackage con usSubsetFormat establecido en TTFCFP_DELTA y puchMergeFontBuffer debe contener un paquete de fuentes creado por una llamada anterior a MergeFontPackage con usMode establecido en TTFMFP_SUBSET1 o TTFMFP_DELTA. La fuente combinada resultante en **ppuchDestBuffer será una fuente de trabajo que se puede combinar con más adelante.

[in] lpfnAllocate

Función de devolución de llamada para asignar memoria inicial para ppuchDestBuffer y para búferes temporales.

[in] lpfnReAllocate

Función de devolución de llamada para reasignar memoria para ppuchDestBuffer y para búferes temporales.

[in] lpfnFree

Función de devolución de llamada para liberar memoria asignada por lpfnAllocate y lpfnReAllocate.

[in] lpvReserved

Debe establecerse en NULL.

Valor devuelto

Si la función se realiza correctamente, devuelve cero.

De lo contrario, devuelve un valor distinto de cero. Consulte Font-Package Function Error Messages (Mensajes de error de la función Font-Package) para obtener posibles devoluciones de error.

Comentarios

Esta función controla cuatro entidades distintas relacionadas, cada una de las cuales representa una fuente de subconjunto:

Entidad Producido por Se puede usar directamente como fuente
Fuente de trabajo simple CreateFontPackage con usSubsetFormat establecido en TFCFP_SUBSET. Sí
Paquete de fuentes CreateFontPackage con usSubsetFormat establecido en TTFCFP_SUBSET1. No
Paquete de fuentes delta CreateFontPackage con usSubsetFormat establecido en TTFCFP_DELTA. No
Fuente de trabajo combinable MergeFontPackage con usMode establecido en TTFMFP_SUBSET1 o TTFMFP_DELTA. Sí

Requisitos

   
Cliente mínimo compatible Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2003 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado fontsub.h
Library FontSub.lib
Archivo DLL FontSub.dll

Consulte también

CFP_ALLOCPROC

CFP_FREEPROC

CFP_REALLOCPROC

CreateFontPackage