Efeito de matriz Convolve

Use o efeito de matriz convolve para aplicar um kernel 2D arbitrário a uma imagem. Você pode usar esse efeito para desfocar, detectar bordas, regravar ou nitidez de uma imagem.

O CLSID para este efeito é CLSID_D2D1ConvolveMatrix.

• Imagem de exemplo
• Propriedades do efeito
• Modos de escala
• Modos de borda
• Bitmap de saída
• Requisitos
• Tópicos relacionados

Imagem de exemplo

O exemplo aqui mostra a entrada e saída do efeito de matriz convolve com um kernel 3 x 3.

Antes
Após

ComPtr<ID2D1Effect> convolveMatrixEffect;
m_d2dContext->CreateEffect(CLSID_D2D1ConvolveMatrix, &convolveMatrixEffect);

convolveMatrixEffect->SetInput(0, bitmap);
float matrix[9] = {-1, -1, -1, -1, 9, -1, -1, -1, -1};
convolveMatrixEffect->SetValue(D2D1_CONVOLVEMATRIX_PROP_KERNEL_MATRIX, matrix);

m_d2dContext->BeginDraw();
m_d2dContext->DrawImage(convolveMatrixEffect.Get());
m_d2dContext->EndDraw();

Propriedades do efeito

Nome para exibição e enumeração de índice	Descrição
KernelUnitLength D2D1_CONVOLVEMATRIX_PROP_KERNEL_UNIT_LENGTH	O tamanho de uma unidade no kernel. As unidades estão em (DIPs/unidade do kernel), onde uma unidade do kernel é o tamanho do elemento no kernel de convolução. Um valor de 1 (unidade DIP/kernel) corresponde a um pixel em uma imagem a 96 DPI. O tipo é FLOAT. O valor padrão é 1.0f.
Modo Scale: D2D1_CONVOLVEMATRIX_PROP_SCALE_MODE	O modo de interpolação que o efeito usa para dimensionar a imagem para o comprimento de unidade de kernel correspondente. Existem seis modos de escala que variam em qualidade e velocidade. O tipo é D2D1_CONVOLVEMATRIX_SCALE_MODE. O valor padrão é D2D1_CONVOLVEMATRIX_SCALE_MODE_LINEAR.
KernelSizeX D2D1_CONVOLVEMATRIX_PROP_KERNEL_SIZE_X	A largura da matriz do kernel. As unidades são especificadas em unidades de kernel. O tipo é UINT32. O valor padrão é 3.
KernelSizeY D2D1_CONVOLVEMATRIX_PROP_KERNEL_SIZE_Y	A altura da matriz do kernel. As unidades são especificadas em unidades de kernel. O tipo é UINT32. O valor padrão é 3.
KernelMatrix D2D1_CONVOLVEMATRIX_PROP_KERNEL_MATRIX	A matriz do kernel a ser aplicada à imagem. Os elementos do kernel não são limitados e são especificados como floats. O primeiro conjunto de números KernelSizeX no FLOAT[] corresponde à primeira linha no kernel. O segundo conjunto de números KernelSizeX corresponde à segunda linha, e assim por diante até as linhas KernelSizeY . O tipo é FLOAT[]. O valor padrão é {0.0f, 0.0f, 0.0f, 0.0f, 1.0f, 0.0f, 0.0f, 0.0f, 0.0f, 0.0f}.
Divisor D2D1_CONVOLVEMATRIX_PROP_DIVISOR	A matriz do kernel é aplicada a um pixel e, em seguida, o resultado é dividido por esse valor. 0 comporta-se como um valor de épsilon flutuante. O tipo é FLOAT. O valor padrão é 1.0f.
Desvio D2D1_CONVOLVEMATRIX_PROP_BIAS	O efeito aplica a matriz do kernel, o divisor e, em seguida, o viés é adicionado ao resultado. O viés é ilimitado e sem unidade. O tipo é FLOAT. O valor padrão é 0.0f.
KernelOffset D2D1_CONVOLVEMATRIX_PROP_KERNEL_OFFSET	Desloca o kernel de convolução de uma posição centralizada no pixel de saída para uma posição especificada à esquerda/direita e para cima/baixo. O deslocamento é definido em unidades do kernel. Com alguns deslocamentos e tamanhos de kernel, as amostras do kernel de convolução não pousam em um centro de imagem de pixel. Os valores de pixel para a amostra do kernel são calculados por interpolação bilinear. O tipo é D2D1_VECTOR_2F. O valor padrão é {0.0f, 0.0f}.
PreserveAlpha D2D1_CONVOLVEMATRIX_PROP_PRESERVE_ALPHA	Especifica se o kernel de convolução é aplicado ao canal alfa ou somente aos canais de cores. Se você definir isso como TRUE , o kernel de convolução será aplicado somente aos canais de cores. Se você definir isso como FALSE , o kernel de convolução será aplicado a todos os canais. O tipo é BOOL. O valor padrão é FALSE.
Modo Border: D2D1_CONVOLVEMATRIX_PROP_BORDER_MODE	O modo usado para calcular a borda da imagem, suave ou dura. Consulte Modos de borda para obter mais informações. O tipo é D2D1_BORDER_MODE. O valor padrão é D2D1_BORDER_MODE_SOFT.
GrampOutput D2D1_CONVOLVEMATRIX_PROP_CLAMP_OUTPUT	Se o efeito aperta os valores de cor entre 0 e 1 antes de o efeito passar os valores para o próximo efeito no gráfico. O efeito prende os valores antes de pré-multiplicar o alfa . Se você definir isso como TRUE, o efeito irá fixar os valores. Se você definir isso como FALSE, o efeito não prenderá os valores de cor, mas outros efeitos e a superfície de saída poderão fixar os valores se eles não forem de precisão alta o suficiente. O tipo é BOOL. O valor padrão é FALSE.

Modos de escala

Enumeração	Descrição
D2D1_CONVOLVEMATRIX_SCALE_MODE_NEAREST_NEIGHBOR	Mostra o ponto único mais próximo e usa-o. Esse modo usa menos tempo de processamento, mas produz a imagem de menor qualidade.
D2D1_CONVOLVEMATRIX_SCALE_MODE_LINEAR	Usa uma amostra de quatro pontos e interpolação linear. Esse modo gera uma imagem de qualidade superior ao modo vizinho mais próximo.
D2D1_CONVOLVEMATRIX_SCALE_MODE_CUBIC	Usa um kernel cúbico de 16 amostras para interpolação. Esse modo usa a maior parte do tempo de processamento, mas gera uma imagem de maior qualidade.
D2D1_CONVOLVEMATRIX_SCALE_MODE_MULTI_SAMPLE_LINEAR	Usa 4 amostras lineares em um único pixel para uma boa suavização de borda da borda. Esse modo é bom para reduzir em pequenas quantidades em imagens com poucos pixels.
D2D1_CONVOLVEMATRIX_SCALE_MODE_ANISOTROPIC	Usa filtragem anisotrópica para obter amostras de um padrão de acordo com a forma transformada do bitmap.
D2D1_CONVOLVEMATRIX_SCALE_MODE_HIGH_QUALITY_CUBIC	Usa um kernel cúbico de alta qualidade de tamanho variável para executar um pré-downscale da imagem se o downscaling estiver envolvido na matriz de transformação. Em seguida, usa o modo de interpolação cúbica para a saída final.

Observação

Se você não selecionar um modo, o efeito será D2D1_CONVOLVEMATRIX_SCALE_MODE_LINEAR padrão.

Modos de borda

Nome	Descrição
D2D1_BORDER_MODE_SOFT	O efeito preenche a imagem de entrada com pixels pretos transparentes para amostras fora dos limites de entrada quando aplica o kernel de convolução. Isso cria uma borda suave para a imagem e, no processo, expande o bitmap de saída pelo tamanho do kernel.
D2D1_BORDER_MODE_HARD	O efeito estende a imagem de entrada com uma transformação de borda do tipo espelho para amostras fora dos limites de entrada. O tamanho do bitmap de saída é igual ao tamanho do bitmap de entrada.

Bitmap de saída

O tamanho da saída do efeito depende do tamanho do kernel de convolução, do deslocamento do kernel, do comprimento da unidade do kernel e da configuração do modo de borda.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 8 e Atualização de plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos da Windows Store]
Servidor com suporte mínimo	Windows 8 e Atualização de plataforma para Windows 7 [aplicativos da área de trabalho | Aplicativos da Windows Store]
Cabeçalho	d2d1effects.h
Biblioteca	d2d1.lib, dxguid.lib

Tópicos relacionados

ID2D1Efeito