Compartilhar via


Função glMultMatrixf

As funções glMultMatrixd e glMultMatrixf multiplicam a matriz atual por uma matriz arbitrária.

Sintaxe

void WINAPI glMultMatrixf(
   const GLfloat *m
);

Parâmetros

m

Um ponteiro para uma matriz 4x4 armazenada em ordem de coluna principal como 16 valores consecutivos.

Retornar valor

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

Códigos de erro

O código de erro a seguir pode ser recuperado pela função glGetError .

Nome Significado
GL_INVALID_OPERATION
A função foi chamada entre uma chamada para glBegin e a chamada correspondente para glEnd.

Comentários

A função glMultMatrix multiplica a matriz atual pela especificada em m. Ou seja, se M for a matriz atual e T for a matriz passada para glMultMatrix, M será substituído por M T.

A matriz atual é a matriz de projeção, matriz de modelview ou matriz de textura, determinada pelo modo de matriz atual (consulte glMatrixMode).

O parâmetro m aponta para uma matriz 4x4 de valores de ponto flutuante de precisão simples ou de precisão dupla armazenados em ordem de coluna principal. Ou seja, a matriz é armazenada conforme mostrado na imagem a seguir.

! [Diagrama mostrando a matriz 4x4 para a qual o parâmetro m aponta.]

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

glGet com GL_MATRIX_MODE de argumento

glGet com GL_MODELVIEW_MATRIX de argumento

glGet com GL_PROJECTION_MATRIX de argumento

glGet com GL_TEXTURE_MATRIX 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

glEnd

glLoadIdentity

glLoadMatrix

glMatrixMode

glPushMatrix