PFND3DDDI_SETCONVOLUTIONKERNELMONO função de retorno de chamada (d3dumddi.h)

A função SetConvolutionKernelMono define a resolução e os pesos do filtro de kernel, que é usado quando o modo de filtragem de textura D3DTEXF_CONVOLUTIONMONO é definido.

Sintaxe

PFND3DDDI_SETCONVOLUTIONKERNELMONO Pfnd3dddiSetconvolutionkernelmono;

HRESULT Pfnd3dddiSetconvolutionkernelmono(
  HANDLE hDevice,
  const D3DDDIARG_SETCONVOLUTIONKERNELMONO *unnamedParam2
)
{...}

Parâmetros

hDevice

Um identificador para o dispositivo de exibição (contexto gráfico).

unnamedParam2

pData [in]

Um ponteiro para uma estrutura de D3DDDIARG_SETCONVOLUTIONKERNELMONO que descreve parâmetros para definir o kernel de convolução monocromática.

Retornar valor

SetConvolutionKernelMono retorna um dos seguintes valores:

Comentários

D3DTEXF_CONVOLUTIONMONO é um modo de filtro de textura usado para amostragem de texturas monocromáticas (ou seja, texturas formatadas como um bit por pixel (D3DDDIFMT_A1)). No runtime do Direct3D 9.L, o filtro de convolução é um filtro de caixa bidimensional (ou seja, todos os pesos = 1,0). No entanto, a função SetConvolutionKernelMono é definida para dar suporte a um filtro mais geral. Quando D3DTEXF_CONVOLUTIONMONO é definido como um amostrador de textura, o amostrador de textura declara D3DTSS_MIPFILTER, D3DTSS_MINFILTER e D3DTSS_MAGFILTER são ignorados. O endereço de textura D3DTADDRESS_BORDER com a cor da borda 0 deve ser aplicado nesse modo de filtragem. O driver de exibição do modo de usuário deve retornar um erro ou ignorar o primitivo renderizado se esse modo de filtragem for usado com uma textura não monocromática.

A seguinte fórmula é usada para executar a convolução:

Resultado = Soma(i=0, i <N_v)[ (R_i*(1 - alfa) + R_i+1*alfa) * S)]

Rk = Sum(j=0, j <N_u)[T_k,j*(1 - beta) + T_k,j+1*beta], em que 0 < k < N_v

S = 1 / (N_u * N_v)

N_u e N_v são a largura e a altura do kernel de filtro.

T_i,j são amostras de textura de uma textura monocromática no local (i, j).

A precisão das operações de filtro deve ser de pelo menos 6 bits.

Os valores de coordenada de textura interpolada (U, V) em um centro de pixels são as coordenadas do centro do kernel de filtro.

As coordenadas do exemplo de kernel do filtro superior esquerdo (U_f,Vf) são computadas como:

U_f = U * TextureWidth - N_u * 0,5

V_f = V * TextureHeight - N_v * 0,5

Então

beta = U_f - truncate(U_f)

alpha = V_f - truncado(V_f)

Requisitos

Confira também

D3DDDIARG_SETCONVOLUTIONKERNELMONO

D3DDDI_DEVICEFUNCS