Método IPrintOemUni::HalftonePattern (prcomoem.h)
El método IPrintOemUni::HalftonePattern se puede usar con impresoras compatibles con Unidrv para crear o modificar un patrón de medio tono antes de usarse en una operación de mediotonamiento.
Sintaxis
HRESULT HalftonePattern(
PDEVOBJ pdevobj,
PBYTE pHTPattern,
DWORD dwHTPatternX,
DWORD dwHTPatternY,
DWORD dwHTNumPatterns,
DWORD dwCallbackID,
PBYTE pResource,
DWORD dwResourceSize
);
Parámetros
pdevobj
Puntero proporcionado por el autor de la llamada a una estructura DEVOBJ .
pHTPattern
Puntero proporcionado por el autor de la llamada a un búfer que recibe el patrón de medio tono proporcionado por el método. El tamaño del búfer, en bytes, es:
(((dwHTPatternX * dwHTPatternY) + 3)/4) * 4 * dwHTNumPatterns
dwHTPatternX
Longitud proporcionada por el autor de la llamada, en píxeles, del patrón de medio tono, según lo especificado por el primer valor del atributo *HTPatternSize del archivo GPD.
dwHTPatternY
Alto proporcionado por el autor de la llamada, en píxeles, del patrón de medio tono, según lo especificado por el segundo valor del atributo *HTPatternSize del archivo GPD.
dwHTNumPatterns
Número de patrones proporcionados por el autor de la llamada, según lo especificado por el atributo *HTNumPatterns del archivo GPD. El número de patrones puede ser 1 o 3.
dwCallbackID
Valor proporcionado por el autor de la llamada que identifica el método halftone, tal y como especifica el atributo *HTCallbackID del archivo GPD.
pResource
Puntero proporcionado por el autor de la llamada a un búfer que contiene un patrón de medio tono, tal y como especifica el atributo *rcHTPatternID del archivo GPD. Puede ser NULL.
dwResourceSize
Tamaño proporcionado por el autor de la llamada del patrón de medio tono incluido en el búfer al que apunta pResource. Es cero si pResource es NULL.
Valor devuelto
El método debe devolver uno de los valores siguientes:
| Código devuelto | Descripción |
|---|---|
| S_OK | La operación se realizó correctamente. |
| E_FAIL | Error en la operación. |
| E_NOTIMPL | El método no está implementado. |
Comentarios
El método IPrintOemUni::HalftonePattern se usa para crear o modificar un patrón de medio tono antes de que Unidrv lo pase a GDI. Su propósito es permitir que los patrones de medio tono propietarios se almacenen como recursos cifrados o se generen en tiempo de ejecución.
Si se implementa el método IPrintOemUni::HalftonePattern y si la entrada de archivo GPD para el método halftoning seleccionado actualmente incluye un atributo *HTCallbackID , Unidrv llama al método IPrintOemUni::HalftonePattern antes de pasar un patrón de medio tono a GDI.
Si la entrada del archivo GPD para el método de halftoning seleccionado actualmente contiene una entrada *rcHTPatternID que identifica un recurso de RC_HTPATTERN, Unidrv obtiene el patrón y le pasa un puntero como valor del parámetro pResource . Esto permite almacenar el patrón como un recurso cifrado y usar el método IPrintOemUni::HalftonePattern para descodificar el patrón. El patrón descodificado debe devolverse en el búfer al que apunta pHTPattern.
También puede usar el método IPrintOemUni::HalftonePattern para generar un patrón de medio tono. En este caso no se necesita un recurso de RC_HTPATTERN, por lo que pResource es NULL. El método IPrintOemUni::HalftonePattern debe generar un patrón y devolverlo en el búfer al que apunta pHTPattern.
Si el método IPrintOemUni::HalftonePattern devuelve un patrón, se usa para todos los colores. Si el método devuelve tres patrones, deben especificarse en orden RGB.
En el ejemplo siguiente se muestra una implementación del método HalftonePattern de un complemento de representación. El método calcula la longitud en bytes de la matriz de patrones de HTPattern_DDK y, a continuación, copia los bytes de la matriz de patrones en el búfer al que apunta el parámetro pHTPattern de este método. La matriz de patrones puede contener uno o tres patrones, dependiendo de si el patrón se usa para todos los colores o tiene patrones rojos, verdes y azules independientes. Por motivos de brevedad, no se enumeran todos los elementos de la matriz de patrones.
static BYTE HTPattern_DDK[256] = {
129, 44, 59, 124, 143, 232, 166, ...
...
...
98, 202, 130, 148, 213, 101, 163, 72
};
HRESULT __stdcall IOemUni::HalftonePattern(
PDEVOBJ pdevobj,
PBYTE pHTPattern,
DWORD dwHTPatternX,
DWORD dwHTPatternY,
DWORD dwHTNumPatterns,
DWORD dwCallbackID,
PBYTE pResource,
DWORD dwResourceSize)
{
PBYTE pSrcPattern;
DWORD dwLen = sizeof(HTPattern_DDK);
if (dwLen != (((dwHTPatternX * dwHTPatternY) + 3) / 4) * 4 * dwHTNumPatterns)
return E_FAIL;
pSrcPattern = HTPattern_DDK;
while (dwLen-- > 0)
*pHTPattern++ = *pSrcPattern++;
return S_OK;
}
Una implementación de un método HalftonePattern en el complemento de representación debe ir acompañado de una característica Halftone en el archivo GPD. En el siguiente ejemplo de GPD se muestra una característica halftone cuya opción de HT_PAT_DDK_16x16 describe el patrón personalizado generado en el ejemplo anterior.
*Feature: Halftone
{
*rcNameID: =HALFTONING_DISPLAY
*HelpIndex: 12005
*DefaultOption: HT_PATSIZE_AUTO
*Option: HT_PATSIZE_AUTO
{
*rcNameID: =HT_AUTO_SELECT_DISPLAY
}
*Option: HT_PATSIZE_SUPERCELL_M
{
*rcNameID: =HT_SUPERCELL_DISPLAY
}
*Option: HT_PATSIZE_6x6_M
{
*rcNameID: =HT_DITHER6X6_DISPLAY
}
*Option: HT_PATSIZE_8x8_M
{
*rcNameID: =HT_DITHER8X8_DISPLAY
}
*Option: HT_PAT_DDK_16x16
{
*Name: "DDK 16x16"
*HTPatternSize: PAIR(16, 16)
*HTNumPatterns: 1
*HTCallbackID: 1
}
}
El método IPrintOemUni::HalftonePattern es opcional. Si un complemento de representación implementa este método, el método IPrintOemUni::GetImplementedMethod del complemento debe devolver S_OK cuando recibe "HalftonePattern" como entrada.
Para obtener más información sobre el mediotonamiento, vea Atributos de opción y halftoning personalizadospara la característica halftone.
Requisitos
| Requisito | Value |
|---|---|
| Plataforma de destino | Escritorio |
| Encabezado | prcomoem.h (incluya Prcomoem.h) |