IPrintOemUni::HalftonePattern メソッド (prcomoem.h)

[アーティクル]
02/26/2024

IPrintOemUni::HalftonePattern メソッドは、Unidrv でサポートされているプリンターと共に使用して、ハーフトーン処理で使用される前にハーフトーンパターンを作成または変更できます。

構文

HRESULT HalftonePattern(
  PDEVOBJ pdevobj,
  PBYTE   pHTPattern,
  DWORD   dwHTPatternX,
  DWORD   dwHTPatternY,
  DWORD   dwHTNumPatterns,
  DWORD   dwCallbackID,
  PBYTE   pResource,
  DWORD   dwResourceSize
);

パラメーター

pdevobj

呼び出し元が指定した DEVOBJ 構造体へのポインター。

pHTPattern

メソッド指定のハーフトーンパターンを受け取るバッファーへの呼び出し元提供のポインター。バッファーサイズ (バイト単位) は次のとおりです。

(((dwHTPatternX * dwHTPatternY) + 3)/4) * 4 * dwHTNumPatterns

dwHTPatternX

GPD ファイルの *HTPatternSize 属性の最初の値で指定されたハーフトーンパターンの呼び出し元指定の長さ (ピクセル単位)。

dwHTPatternY

GPD ファイルの *HTPatternSize 属性の 2 番目の値で指定されたハーフトーンパターンの呼び出し元指定の高さ (ピクセル単位)。

dwHTNumPatterns

GPD ファイルの *HTNumPatterns 属性で指定された、呼び出し元から指定されたパターンの数。パターンの数は、1 または 3 のいずれかになります。

dwCallbackID

GPD ファイルの *HTCallbackID 属性で指定されたハーフトーンメソッドを識別する呼び出し元指定の値。

pResource

GPD ファイルの *rcHTPatternID 属性で指定されたハーフトーンパターンを含むバッファーへの呼び出し元指定ポインター。 NULL を指定できます。

dwResourceSize

pResource が指すバッファーに含まれるハーフトーンパターンの呼び出し元指定サイズ。 pResource が NULL の場合、これは 0 です。

戻り値

メソッドは、次のいずれかの値を返す必要があります。

リターンコード	説明
S_OK	操作が成功しました。
E_FAIL	操作が失敗しました。
E_NOTIMPL	このメソッドは実装されていません。

注釈

IPrintOemUni::HalftonePattern メソッドは、Unidrv が GDI に渡す前にハーフトーンパターンを作成または変更するために使用されます。その目的は、独自のハーフトーンパターンを暗号化されたリソースとして格納するか、実行時に生成できるようにすることです。

IPrintOemUni::HalftonePattern メソッドが実装され、現在選択されているハーフトニングメソッドの GPD ファイルエントリに *HTCallbackID 属性が含まれている場合、Unidrv は、GDI にハーフトーンパターンを渡す前に IPrintOemUni::HalftonePattern メソッドを呼び出します。

現在選択されているハーフトニングメソッドの GPD ファイルエントリに、RC_HTPATTERN リソースを識別する *rcHTPatternID エントリが含まれている場合、Unidrv はパターンを取得し、 pResource パラメーター値としてポインターを渡します。これにより、パターンを暗号化されたリソースとして格納し、 IPrintOemUni::HalftonePattern メソッドを使用してパターンをデコードできます。デコードされたパターンは、 pHTPattern によって指されるバッファーで返される必要があります。

IPrintOemUni::HalftonePattern メソッドを使用してハーフトーンパターンを生成することもできます。この場合、RC_HTPATTERN リソースは必要ないので、 pResource は NULL です。 IPrintOemUni::HalftonePattern メソッドは、パターンを生成し、pHTPattern が指すバッファーで返す必要があります。

IPrintOemUni::HalftonePattern メソッドが 1 つのパターンを返す場合は、すべての色に使用されます。メソッドが 3 つのパターンを返す場合は、RGB 順序で指定する必要があります。

次の例は、レンダリングプラグインの HalftonePattern メソッドの実装を示しています。メソッドは、HTPattern_DDKパターン配列の長さをバイト単位で計算し、パターン配列内のバイトを、このメソッドの pHTPattern パラメーターが指すバッファーにコピーします。パターン配列には、パターンがすべての色に使用されているか、個別の赤、緑、青のパターンがあるかに応じて、1 つまたは 3 つのパターンを含めることができます。簡潔にするために、パターン配列のすべての要素が一覧表示されるわけではありません。

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;
}

レンダリングプラグインでの HalftonePattern メソッドの実装には、GPD ファイルに Halftone 機能を伴う必要があります。次の GPD の例は、前のサンプルで生成されたカスタマイズされたパターンをHT_PAT_DDK_16x16 オプションで記述するハーフトーン機能を示しています。


*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

    }

}

IPrintOemUni::HalftonePattern メソッドは省略可能です。レンダリングプラグインがこのメソッドを実装する場合、プラグインの IPrintOemUni::GetImplementedMethod メソッドは、"HalftonePattern" を入力として受け取ったときにS_OKを返す必要があります。

ハーフトーンの詳細については、「ハーフトーン機能のカスタマイズされたハーフトニングとオプション属性」を参照してください。

要件

要件	値
対象プラットフォーム	デスクトップ
Header	prcomoem.h (Prcomoem.h を含む)

こちらもご覧ください

IPrintOemUni インターフェイス

IPrintOemUni::ImageProcessing

IPrintOemUni::HalftonePattern メソッド (prcomoem.h)

構文

パラメーター

戻り値

注釈

要件

こちらもご覧ください

フィードバック

フィードバック

その他のリソース