Estrutura GDIINFO (winddi.h)

A estrutura GDIINFO descreve os recursos gráficos de um determinado dispositivo.

Sintaxe

typedef struct _GDIINFO {
  ULONG     ulVersion;
  ULONG     ulTechnology;
  ULONG     ulHorzSize;
  ULONG     ulVertSize;
  ULONG     ulHorzRes;
  ULONG     ulVertRes;
  ULONG     cBitsPixel;
  ULONG     cPlanes;
  ULONG     ulNumColors;
  ULONG     flRaster;
  ULONG     ulLogPixelsX;
  ULONG     ulLogPixelsY;
  ULONG     flTextCaps;
  ULONG     ulDACRed;
  ULONG     ulDACGreen;
  ULONG     ulDACBlue;
  ULONG     ulAspectX;
  ULONG     ulAspectY;
  ULONG     ulAspectXY;
  LONG      xStyleStep;
  LONG      yStyleStep;
  LONG      denStyleStep;
  POINTL    ptlPhysOffset;
  SIZEL     szlPhysSize;
  ULONG     ulNumPalReg;
  COLORINFO ciDevice;
  ULONG     ulDevicePelsDPI;
  ULONG     ulPrimaryOrder;
  ULONG     ulHTPatternSize;
  ULONG     ulHTOutputFormat;
  ULONG     flHTFlags;
  ULONG     ulVRefresh;
  ULONG     ulBltAlignment;
  ULONG     ulPanningHorzRes;
  ULONG     ulPanningVertRes;
  ULONG     xPanningAlignment;
  ULONG     yPanningAlignment;
  ULONG     cxHTPat;
  ULONG     cyHTPat;
  LPBYTE    pHTPatA;
  LPBYTE    pHTPatB;
  LPBYTE    pHTPatC;
  ULONG     flShadeBlend;
  ULONG     ulPhysicalPixelCharacteristics;
  ULONG     ulPhysicalPixelGamma;
} GDIINFO, *PGDIINFO;

Membros

ulVersion

Especifica o número de versão do driver. A ordenação de bytes de ulVersion tem o seguinte formato.

Os 16 bits de ordem alta devem ser definidos como zero. Os bits 8 a 15 especificam o número de versão do sistema operacional da Microsoft para o qual o driver foi projetado. Os 4 bits de ordem superior desse intervalo especificam o número principal da versão, os 4 bits de ordem inferior contêm o número secundário da versão. Os 8 bits de ordem inferior de ulVersion especificam o número de versão do driver de exibição; esse valor deve ser incrementado para cada versão do arquivo binário do driver de exibição.

O programa De exibição no Painel de Controle indica o número de versão contido em ulVersion, juntamente com outras informações específicas do driver.

ulTechnology

Especifica a tecnologia do dispositivo. Esse membro pode ser um dos valores listados na tabela a seguir.

ulHorzSize

Especifica a largura da superfície física. Um valor positivo indica que a largura está em unidades de milímetros, enquanto um valor negativo indica que a largura está em unidades de micrometers.

ulVertSize

Especifica a altura da superfície física. Um valor positivo indica que a altura está em unidades de milímetros, enquanto um valor negativo indica que a altura está em unidades de micrometers.

ulHorzRes

Especifica a largura em pixels da superfície física (dispositivos de exibição) ou da superfície imprimível (impressoras).

Consulte também ulDesktopHorzRes.

ulVertRes

Especifica a altura em pixels da superfície física (dispositivos de exibição) ou da superfície imprimível (impressoras).

cBitsPixel

Especifica o número de bits adjacentes em cada plano de cores. O número total de bits por pixel é o produto de cBitsPixel e cPlanes.

cPlanes

Especifica o número de planos de cores.

ulNumColors

Para dispositivos palettizados, ulNumColors especifica o número de entradas na paleta de cores padrão. Para dispositivos não armazenados (que não incluem impressoras), ulNumColors é definido como -1.

flRaster

É reservado e deve ser deixado definido como zero.

ulLogPixelsX

Especifica a resolução de largura do dispositivo em pixels lógicos por polegada.

Para impressoras, esse membro deve ser definido como a resolução da impressora no dpi.

Para exibições, esse membro deve ser definido como 96.

ulLogPixelsY

Especifica a resolução de altura do dispositivo em pixels lógicos por polegada.

Para impressoras, esse membro deve ser definido como a resolução da impressora no dpi.

Para exibições, esse membro deve ser definido como 96.

flTextCaps

Especifica um sinalizador que descreve os recursos de texto do Windows 3.1. Se o driver TC_SCROLLBLT sinalizador estiver nesse membro, ele indicará que o console deve executar a rolagem de texto redesenhando toda a tela, usando a função DrvTextOut fornecida pelo driver em vez das funções DrvBitBlt ou DrvCopyBits . O driver deve definir esse sinalizador se as transferências de bloco de bits de tela para tela estiverem lentas. Se esse sinalizador não estiver definido, o driver solicitará implicitamente que o console execute rolagens de texto por meio de DrvBitBlt/DrvCopyBits.

ulDACRed

ulDACGreen

ulDACBlue

Especifica o número de exibição de bits da DAC para a cor especificada.

ulAspectX

Especifica a largura relativa de um pixel de dispositivo, no intervalo de um a 1000.

ulAspectY

Especifica a altura relativa de um pixel de dispositivo, no intervalo de um a 1000.

ulAspectXY

Especifica a raiz quadrada da soma dos quadrados de ulAspectX e ulAspectY.

xStyleStep

Especifica o numerador de avanço de estilo para linhas x principais, dx. Para obter informações adicionais, consulte a seção Comentários a seguir e Linhas Cosméticas Estilizadas.

yStyleStep

Especifica o numerador de avanço de estilo para linhas principais y, dy. Para obter informações adicionais, consulte a seção Comentários a seguir e Linhas Cosméticas Estilizadas.

denStyleStep

Especifica o denominador de style advance, D. Para obter informações adicionais, consulte a seção Comentários a seguir e Linhas Cosméticas Estilizadas.

ptlPhysOffset

Especifica uma estrutura POINTL que contém o tamanho, em pixels, da margem não aritmável de uma superfície.

szlPhysSize

Especifica uma estrutura SIZEL que contém o tamanho, em pixels, de toda a superfície, incluindo margens não aritmáveis. Uma estrutura SIZEL é idêntica a uma estrutura SIZE .

ulNumPalReg

Especifica o número de registros de paleta para um dispositivo indexado.

ciDevice

É uma estrutura COLORINFO que define as cores do dispositivo no espaço de coordenadas do CIE.

ulDevicePelsDPI

Para impressoras, especifica o número de pixels (ou pontos ou bocais) por polegada se os pixels forem dispostos lado a lado sem sobreposição ou espaço entre. Por exemplo, se o tamanho de um pixel for de 0,001 polegada, esse valor será igual a um dividido por 0,001. Se o membro for zero, o halftoning GDI calculará esse número com base na suposição de que todos os pixels estão conectados sem sobreposição.

Como o tamanho do ponto físico para a maioria das impressoras é maior do que o tamanho do ponto medido, a GDI usa esse valor para aproximar quantos nós físicos podem ser colocados, com base no tamanho da célula (tamanho do padrão). Em seguida, uma regressão de log é executada para determinar o que é mais linear; ou seja, onde os ponto devem ser colocados para a melhor cobertura para otimizar a cobertura de pixels de dispositivo sobrepostos (ganho de ponto).

Para exibições, esse membro deve ser definido como zero.

ulPrimaryOrder

Especifica a ordem de bits das cores primárias do dispositivo ou dos números do plano para a saída de meio tom. Esse membro pode ser um dos valores listados na tabela a seguir.

ulHTPatternSize

Especifica o tamanho do padrão de meio tom. Os valores que terminam com AxBM são variações dos padrões AxB . Em outras palavras, SIZEAxB e SIZE_AxB_M diferem por quais pixels são iluminados em um padrão A x B. Esse membro pode ser um dos seguintes valores:

HT_PATSIZE_2x2

HT_PATSIZE_2x2_M

HT_PATSIZE_4x4

HT_PATSIZE_4x4_M

HT_PATSIZE_6x6

HT_PATSIZE_6x6_M

HT_PATSIZE_8x8

HT_PATSIZE_8x8_M

HT_PATSIZE_10x10

HT_PATSIZE_10x10_M

HT_PATSIZE_12x12

HT_PATSIZE_12x12_M

HT_PATSIZE_14x14

HT_PATSIZE_14x14_M

HT_PATSIZE_16x16

HT_PATSIZE_16x16_M

HT_PATSIZE_SUPERCELL

HT_PATSIZE_SUPERCELL_M

HT_PATSIZE_USER

HT_PATSIZE_MAX_INDEX

HT_PATSIZE_DEFAULT

ulHTOutputFormat

Especifica o formato de saída preferencial para halftone. HT_FORMAT_4BPP usa apenas 8 cores de intensidade total, enquanto HT_FORMATP_IRGB usa todas as 16 cores, incluindo as cores de meia intensidade. Supõe-se que um formato 5 x 5 x 5 (5 bits por cor) seja usado para HT_FORMAT_16BPP. Esse membro pode ser um dos seguintes valores:

HT_FORMAT_1BPP

HT_FORMAT_4BPP

HT_FORMAT_4BPP_IRGB

HT_FORMAT_8BPP

HT_FORMAT_16BPP

HT_FORMAT_24BPP

HT_FORMAT_32BPP

flHTFlags

Especifica uma combinação de sinalizadores que descrevem o dispositivo. Esses sinalizadores são necessários para o halftoning. Esse membro pode ser uma combinação dos seguintes valores:

ulVRefresh

A taxa de atualização de vídeo para o modo de exibição atual. Esse é o valor retornado pelo driver de miniporto para a taxa de atualização para o modo atual.

O programa Display no Painel de Controle exibe a taxa de atualização contida no membro ulVRefresh.

ulBltAlignment

Esse membro indica o alinhamento x preferido para transferências de bloco de bits para o dispositivo. Um valor zero indica que as transferências de bloco de bits são aceleradas; qualquer outro número não negativo indica que as transferências de bloco de bits não são aceleradas e fornece o alinhamento horizontal preferencial como um pixel múltiplo.

Esse valor é usado pelo sistema para determinar o alinhamento padrão para posições de janela e também é usado para definir o padrão inicial de arrastar completo durante a instalação. Um valor igual a zero indica que o arrastar completo deve estar ativado por padrão; qualquer valor diferente de zero indica que o arrastar completo deve estar desativado por padrão.

ulPanningHorzRes

ulPanningVertRes

Deve ser ignorado pelo driver e permanecer inicializado como zero.

xPanningAlignment

yPanningAlignment

Deve ser ignorado pelo driver e permanecer inicializado como zero.

cxHTPat

cyHTPat

Especifique a largura e a altura, respectivamente, em pixels, do padrão de dither de meio-tom fornecido pelo usuário. O valor de cxHTPat deve estar no intervalo HT_USERPAT_CX_MIN para HT_USERPAT_CX_MAX, inclusive. O valor de cyHTPat deve estar no intervalo HT_USERPAT_CY_MIN para HT_USERPAT_CY_MAX, inclusive. Essas constantes são definidas em winddi.h. Consulte a seção Comentários a seguir para obter mais informações.

pHTPatA

pHTPatB

pHTPatC

Aponte para os padrões de halftone dither definidos pelo usuário para as cores primárias A, B e C, respectivamente, conforme definido pelo valor PRIMARY_ORDER_XXX no membro ulPrimaryOrder . Cada padrão dither deve ser uma matriz de bytes bidimensional válida de tamanho cxHTPat por cyHTPat. Consulte a seção Comentários a seguir para obter mais informações.

flShadeBlend

Especifica um conjunto de sinalizadores que indicam os recursos de sombreamento e mesclagem do dispositivo. Os drivers de exibição devem ignorar esse membro e deixá-lo definido como zero. Para drivers de impressora, o valor que o driver coloca nesse membro é o valor que o GDI relata quando um aplicativo chama GetDeviceCaps(hdc, SHADEBLENDCAPS). A função GetDeviceCaps é descrita na documentação do SDK do Microsoft Window.

ulPhysicalPixelCharacteristics

Especifica a maneira como os fragmentos de cor são configurados para formar pixels no dispositivo de exibição. Os fragmentos de cor no dispositivo de exibição podem ser organizados em ordem RGB ou, em ordem BGR, completamente independentes da ordenação RGB no buffer de quadros. Os fragmentos de cor podem ser configurados em faixas horizontais nas quais todos os fragmentos em uma linha são da mesma cor. Como alternativa, os fragmentos de cor podem ser configurados em listras verticais, nas quais todos os fragmentos em uma coluna são da mesma cor. A distribuição vertical é preferencial, pois fornece efetivamente três fragmentos separados em uma linha para cada pixel, proporcionando assim maior resolução horizontal de subpixels.

O membro ulPhysicalPixelCharacteristics deve ser definido como um dos valores mostrados na tabela a seguir:

ulPhysicalPixelGamma

Especifica o gama do dispositivo de exibição. Esse membro deve ser definido como o gama do pixel físico, dimensionado por um fator de 1000 ou para um dos valores a seguir. Por exemplo, um valor gama de 2,2 seria representado como 2200.

Comentários

O GDI inicializa essa estrutura zero antes de chamar a função DrvEnablePDEV fornecida pelo driver.

Os membros xStyleStep, yStyleStep e denStyleStep definem como um estilo de linha cosmética deve avançar à medida que desenha cada pixel de uma linha cosmética. A quantidade avançada ao longo do estilo de cada pixel é definida como uma fração que depende se a linha tem estilo x ou estilo y. Se a linha for estilo x, o estilo avançará pela quantidade fracionária dx/D para cada pixel movido na direção x. Caso contrário, o estilo avança por dy/D para cada pixel movido na direção y.

Os ponto no estilo de linha predefinido PS_DOT têm cada uma unidade de comprimento. Se o driver definir xStyleStep como um e denStyleStep como 5, uma linha horizontal pontilhada consistirá em 5 pixels on seguido de 5 pixels-off, repetido.

Cada um desses três números deve ser menor que 65536, embora os membros caps sejam valores LONG. Essas etapas de estilo são definidas pelo driver para garantir que os nós e traços em uma linha sejam um tamanho agradável no dispositivo de saída. As etapas horizontais e verticais podem ser diferentes para corrigir as proporções de proporções nãotriviais. Por exemplo, em uma tela EGA, cujos pixels são 33% maiores do que largos, você pode definir:

pdevcaps->xStyleStep   =  3;    // For an EGA
pdevcaps->yStyleStep   =  4;
pdevcaps->denStyleStep = 12;

Nesse caso, as linhas pontilhadas horizontais são de 4 pixels on, 4 pixels off, pois o estilo avança 3/12 ou 1/4 para cada pixel. As linhas pontilhadas verticais são de 3 pixels on/3 pixels-off.

As linhas estilizadas ficarão melhores se as etapas de estilo x e y forem divididas uniformemente no denominador de estilo, como no exemplo anterior. Isso fornece traços e ponto que têm sempre o mesmo comprimento.

A GDI precisa dessas informações para que suas funções de bitmap possam emular exatamente o que o dispositivo faz em sua própria superfície. Os aplicativos podem acessar essas informações para determinar exatamente quais pixels serão ativados para linhas estilizadas. Consulte também linhas cosméticas estilizadas.

Os membros relacionados ao halftone, cxHTPat, cyHTPat, pHTPatA, pHTPatB e pHTPatC, podem ser usados em um plug-in de renderização Unidrv do OEM para definir um padrão de meio-tom personalizado que consiste em uma ou três cores. Esses membros só serão verificados se o membro ulHTPatternSize estiver definido como HT_PATSIZE_USER. Nesse caso, um OEM pode usar esses membros para definir um padrão de meio-tom personalizado, com base em dados armazenados em um arquivo de recurso ou gerados por um módulo de personalização OEM. Os membros cxHTPat e cyHTPat definem o tamanho de cada uma das três matrizes de padrão de meio tom bidimensional. Os membros pHTPatA, pHTPatB e pHTPatC apontam para as respectivas matrizes de padrão para cada cor. Se apenas uma matriz de padrões for usada, pHTPatA, pHTPatB e pHTPatC apontarão para ela.

Cada limite de bytes em um local específico em um padrão de dither halftone determina se o pixel no local do plano de saída correspondente estará ativado ou desativado. Um valor de limite zero em um local específico na matriz de padrões indica que o local de pixel correspondente é ignorado (é preto). Os valores de limite de 1 a 255 fornecem o padrão dither com 255 níveis de cinza; se o valor de pixel no plano de saída for maior ou igual ao valor limite desse local, o pixel será ativado. Um valor de pixel menor que seu valor de limite correspondente faz com que seu pixel seja desativado no plano de saída. Consulte Halftoning personalizado em Personalizando drivers de impressora da Microsoft para obter mais informações.

Requisitos

Confira também

CIECHROMA

COLORINFO

DrvBitBlt

DrvCopyBits

DrvEnablePDEV

DrvTextOut