Metodo IPrintOemUni::HalftonePattern (prcomoem.h)
Il metodo IPrintOemUni::HalftonePattern può essere usato con le stampanti supportate da Unidrv per creare o modificare un modello halftone prima di usarlo in un'operazione di halftoning.
Sintassi
HRESULT HalftonePattern(
PDEVOBJ pdevobj,
PBYTE pHTPattern,
DWORD dwHTPatternX,
DWORD dwHTPatternY,
DWORD dwHTNumPatterns,
DWORD dwCallbackID,
PBYTE pResource,
DWORD dwResourceSize
);
Parametri
pdevobj
Puntatore fornito dal chiamante a una struttura DEVOBJ .
pHTPattern
Puntatore fornito dal chiamante a un buffer che riceve il modello halftone fornito dal metodo. Le dimensioni del buffer, in byte, sono:
(((dwHTPatternX * dwHTPatternY) + 3)/4) * 4 * dwHTNumPatterns
dwHTPatternX
Lunghezza fornita dal chiamante, espressa in pixel, del modello halftone, come specificato dal primo valore nell'attributo *HTPatternSize del file GPD.
dwHTPatternY
Altezza fornita dal chiamante, in pixel, del pattern halftone, come specificato dal secondo valore nell'attributo *HTPatternSize del file GPD.
dwHTNumPatterns
Numero di modelli fornito dal chiamante, come specificato dall'attributo *HTNumPatterns del file GPD. Il numero di modelli può essere 1 o 3.
dwCallbackID
Valore fornito dal chiamante che identifica il metodo halftone, come specificato dall'attributo *HTCallbackID del file GPD.
pResource
Puntatore fornito dal chiamante a un buffer contenente un modello halftone, come specificato dall'attributo *rcHTPatternID del file GPD. Può essere NULL.
dwResourceSize
Dimensione fornita dal chiamante del pattern halftone contenuto nel buffer a cui punta pResource. Questo valore è zero se pResource è NULL.
Valore restituito
Il metodo deve restituire uno dei valori seguenti:
| Codice restituito | Descrizione |
|---|---|
| S_OK | Operazione completata. |
| E_FAIL | Operazione non riuscita. |
| E_NOTIMPL | Il metodo non è implementato. |
Commenti
Il metodo IPrintOemUni::HalftonePattern viene usato per creare o modificare un modello di mezzotone prima che Unidrv lo passi a GDI. Lo scopo è consentire l'archiviazione di modelli proprietari di semitoni come risorse crittografate o generate in fase di esecuzione.
Se viene implementato il metodo IPrintOemUni::HalftonePattern e se la voce di file GPD per il metodo di halftoning attualmente selezionato include un attributo *HTCallbackID , Unidrv chiama il metodo IPrintOemUni::HalftonePattern prima di passare un modello a mezzotone a GDI.
Se la voce del file GPD per il metodo di halftoning attualmente selezionato contiene una voce *rcHTPatternID che identifica una risorsa RC_HTPATTERN, Unidrv ottiene il modello e passa un puntatore al metodo come valore del parametro pResource . In questo modo è possibile archiviare il modello come risorsa crittografata e usare il metodo IPrintOemUni::HalftonePattern per decodificare il modello. Il modello decodificato deve essere restituito nel buffer a cui punta pHTPattern.
È anche possibile usare il metodo IPrintOemUni::HalftonePattern per generare un modello a mezzotone. In questo caso non è necessaria una risorsa RC_HTPATTERN, quindi pResource è NULL. Il metodo IPrintOemUni::HalftonePattern deve generare un criterio e restituirlo nel buffer a cui punta pHTPattern.
Se il metodo IPrintOemUni::HalftonePattern restituisce un motivo, viene usato per tutti i colori. Se il metodo restituisce tre modelli, devono essere specificati in ordine RGB.
Nell'esempio seguente viene illustrata un'implementazione del metodo HalftonePattern di un plug-in di rendering. Il metodo calcola la lunghezza in byte della matrice di criteri di HTPattern_DDK e quindi copia i byte nella matrice di criteri nel buffer a cui punta il parametro pHTPattern di questo metodo. La matrice di pattern può contenere uno o tre modelli, a seconda che il modello venga usato per tutti i colori o abbia modelli rosso, verde e blu separati. Per brevità, non tutti gli elementi della matrice di pattern sono elencati.
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;
}
Un'implementazione di un metodo HalftonePattern nel plug-in di rendering deve essere accompagnata da una funzionalità Halftone nel file GPD. Nell'esempio di GPD seguente viene illustrata una funzionalità Halftone la cui opzione HT_PAT_DDK_16x16 descrive il modello personalizzato generato nell'esempio precedente.
*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
}
}
Il metodo IPrintOemUni::HalftonePattern è facoltativo. Se un plug-in per il rendering implementa questo metodo, il metodo IPrintOemUni::GetImplementedMethod del plug-in deve restituire S_OK quando riceve "HalftonePattern" come input.
Per altre informazioni sul halftoning, vedere Customd Halftoning and Option Attributes for the Halftone Feature .For more information about halftoning, see Customized Halftoning and Option Attributes for the Halftone Feature.
Requisiti
| Requisito | Valore |
|---|---|
| Piattaforma di destinazione | Desktop |
| Intestazione | prcomoem.h (include Prcomoem.h) |