Função glPointSize

A função glPointSize especifica o diâmetro dos pontos rasterizados.

Sintaxe

void WINAPI glPointSize(
   GLfloat size
);

Parâmetros

size

O diâmetro dos pontos rasterizados. O padrão é 1.0.

Retornar valor

Essa função não retorna um valor.

Códigos de erro

Os códigos de erro a seguir podem ser recuperados pela função glGetError .

Nome Significado
GL_INVALID_VALUE
o tamanho era menor ou igual a zero.
GL_INVALID_OPERATION
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glPointSize especifica o diâmetro rasterizado dos pontos aliased e antialiased. O uso de um tamanho de ponto diferente de 1,0 tem efeitos diferentes, dependendo se a suavização de ponto está habilitada. A suavização de ponto é controlada chamando glEnable e glDisable com GL_POINT_SMOOTH de argumento.

Se a suavização de ponto estiver desabilitada, o tamanho real será determinado arredondando o tamanho fornecido para o inteiro mais próximo. (Se o arredondamento resultar no valor 0, será como se o tamanho do ponto fosse 1.) Se o tamanho arredondado for ímpar, o ponto central (x,y) do fragmento de pixel que representa o ponto será calculado como

(xw + .5, yw + .5)

em que os subscritos w indicam coordenadas de janela. Todos os pixels que estão dentro da grade quadrada do tamanho arredondado centralizado em (x,y) compõem o fragmento. Se o tamanho for uniforme, o ponto central será

(xw + .5, yw + .5)

e os centros do fragmento rasterizado são as coordenadas de janela de meio inteiro dentro do quadrado do tamanho arredondado centralizado em (x,y). Todos os fragmentos de pixel produzidos na rasterização de um ponto não fundamentado recebem os mesmos dados associados; o do vértice correspondente ao ponto.

Se a suavização estiver habilitada, a rasterização de ponto produzirá um fragmento para cada quadrado de pixel que cruza a região localizada dentro do círculo com diâmetro igual ao tamanho do ponto atual e centralizada nos pontos (xw ,yw ). O valor de cobertura para cada fragmento é a área de coordenadas da janela da interseção da região circular com o quadrado de pixel correspondente. Esse valor é salvo e usado na etapa de rasterização final. Os dados associados a cada fragmento são os dados associados ao ponto que está sendo rasterizado.

Nem todos os tamanhos têm suporte quando a suavização de ponto está habilitada. Se um tamanho sem suporte for solicitado, o tamanho com suporte mais próximo será usado. Há garantia de suporte apenas para o tamanho 1.0; outros dependem da implementação. O intervalo de tamanhos com suporte e a diferença de tamanho entre os tamanhos com suporte dentro do intervalo podem ser consultados chamando glGet com argumentos GL_POINT_SIZE_RANGE e GL_POINT_SIZE_GRANULARITY.

O tamanho do ponto especificado pelo glPointSize sempre é retornado quando GL_POINT_SIZE é consultado. A fixação e o arredondamento para pontos alias e suavizados não têm efeito sobre o valor especificado.

O tamanho do ponto não suavizado pode ser fixado a um máximo dependente da implementação. Embora esse máximo não possa ser consultado, ele não deve ser menor que o valor máximo para pontos suavizados, arredondado para o valor inteiro mais próximo.

As seguintes funções recuperam informações relacionadas ao glPointSize:

glGet com GL_POINT_SIZE de argumento

glGet com GL_POINT_SIZE_RANGE de argumento

glGet com GL_POINT_SIZE_GRANULARITY de argumento

glIsEnabled com GL_POINT_SMOOTH de argumento

Requisitos

Requisito Valor
Cliente mínimo com suporte
Windows 2000 Professional [somente aplicativos da área de trabalho]
Servidor mínimo com suporte
Windows 2000 Server [somente aplicativos da área de trabalho]
Cabeçalho
Gl.h
Biblioteca
Opengl32.lib
DLL
Opengl32.dll

Confira também

glBegin

glEnable

glEnd

glIsEnabled