Função glLineWidth

A função glLineWidth especifica a largura das linhas rasterizadas.

Sintaxe

void WINAPI glLineWidth(
   GLfloat width
);

Parâmetros

width

A largura das linhas rasterizadas. 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	width 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 glLineWidth especifica a largura rasterizada de linhas com alias e suavizadas. O uso de uma largura de linha diferente de 1,0 tem efeitos diferentes, dependendo se a suavização de linha está habilitada. A suavização de linha é controlada chamando glEnable e glDisable com GL_LINE_SMOOTH de argumento.

Se a suavização de linha estiver desabilitada, a largura real será determinada arredondando a largura fornecida para o inteiro mais próximo. (Se o arredondamento resultar no valor 0,0, será como se a largura da linha fosse 1,0) Se | ? x | = | ? y |, i pixels são preenchidos em cada coluna que é rasterizada, onde i é o valor arredondado de largura. Caso contrário, os pixels i são preenchidos em cada linha que é rasterizada.

Se a suavização estiver habilitada, a rasterização de linha produzirá um fragmento para cada quadrado de pixel que cruza a região que está dentro do retângulo com largura igual à largura da linha atual, comprimento igual ao comprimento real da linha e centralizado no segmento de linha matemática. O valor de cobertura para cada fragmento é a área de coordenadas da janela da interseção da região retangular com o quadrado de pixel correspondente. Esse valor é salvo e usado na etapa final de rasterização.

Nem todas as larguras podem ter suporte quando a suavização de linha está habilitada. Se uma largura sem suporte for solicitada, a largura com suporte mais próxima será usada. Somente a largura 1.0 tem suporte garantido; outros dependem da implementação. O intervalo de larguras com suporte e a diferença de tamanho entre as larguras com suporte dentro do intervalo podem ser consultados chamando glGet com argumentos GL_LINE_WIDTH_RANGE e GL_LINE_WIDTH_GRANULARITY.

A largura da linha especificada por glLineWidth sempre é retornada quando GL_LINE_WIDTH é consultado. A fixação e o arredondamento para linhas com alias e suavizadas não têm efeito sobre o valor especificado.

A largura de linha não suavizada pode ser fixada a um máximo dependente de implementação. Embora esse máximo não possa ser consultado, ele não deve ser menor que o valor máximo para linhas suavizadas, arredondado para o valor inteiro mais próximo.

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

glGet com GL_LINE_WIDTH de argumento

glGet com GL_LINE_WIDTH_RANGE de argumento

glGet com GL_LINE_WIDTH_GRANULARITY de argumento

glIsEnabled com argumento GL_LINE_SMOOTH

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