Função glLineWidth
A função glLineWidth especifica a largura das linhas rasterizadas.
void WINAPI glLineWidth(
GLfloat width
);
-
width
-
A largura das linhas rasterizadas. O padrão é 1.0.
Essa função não retorna um valor.
Os códigos de erro a seguir podem ser recuperados pela função glGetError .
Nome | Significado |
---|---|
|
width era menor ou igual a zero. |
|
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd. |
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
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 |
|
Biblioteca |
|
DLL |
|