MQMaterial class manages a material.
Basic | |
DeleteThis | Delete this material class |
GetUniqueID | Get an unique ID of this material |
Attributes | |
GetName | Get a name |
GetShader | Get a shader type |
GetVertexColor | Get a type of a vertex color |
GetColor | Get a base color |
GetAlpha | Get a transparency |
GetDiffuse | Get a diffuse value |
GetAmbient | Get an ambient value |
GetEmission | Get an emission value |
GetSpecular | Get a specular value |
GetPower | Get a power of a specular |
GetTextureName | Get a filename of a texture mapping |
GetAlphaName | Get a filename of an alpha mapping |
GetBumpName | Get a filename of a bump mapping |
GetMappingType | Get a projection type for a mapping |
GetMappingPosition | Get a projection position for a mapping |
GetMappingScaling | Get a projection scaling for a mapping |
GetMappingAngle | Get a projection angle for a mapping |
SetName | Set a name |
SetShader | Set a shader type |
SetVertexColor | Set a type of a vertex color |
SetColor | Set a base color |
SetAlpha | Set a transparency |
SetDiffuse | Set a diffuse value |
SetAmbient | Set an ambient value |
SetEmission | Set an emission value |
SetSpecular | Set a specular value |
SetPower | Set a power of a specular |
SetTextureName | Set a filename of a texture mapping |
SetAlphaName | Set a filename of an alpha mapping |
SetBumpName | Set a filename of a bump mapping |
SetMappingType | Set a projection type for a mapping |
SetMappingPosition | Set a projection position for a mapping |
SetMappingScaling | Set a projection scaling for a mapping |
SetMappingAngle | Set a projection angle for a mapping |
void MQMaterial::DeleteThis(void);
It deletes a material class.
This function is available for the material registered in a document. You must use MQDocument::DeleteMaterial() to delete a material that is not registered to any documents.
UINT MQMaterial::GetUniqueID(void);
(new in Rev2.40)
It gets an unique ID of the material.
An unique ID is assigned when the material is registered to the document by MQDocument::AddMaterial().
void MQMaterial::GetName(char *buffer, int size);
It stores this material's name to 'buffer'.
int MQMaterial::GetShader(void);
(new in Rev2.30)
It gets a type of a shader of the material.
int MQMaterial::GetVertexColor(void);
(new in Rev2.30)
It gets a type of a vertex color.
MQColor MQMaterial::GetColor(void);
It gets a base color of this material.
float MQMaterial::GetAlpha(void);
float MQMaterial::GetDiffuse(void);
float MQMaterial::GetAmbient(void);
float MQMaterial::GetEmission(void);
float MQMaterial::GetSpecular(void);
float MQMaterial::GetPower(void);
It gets an alpha value (transparency), a diffuse value, an ambient value, an emission value, a specular value and a power of a specular.
It returns from 0 to 1. (from 0 to 100 for GetPower() only)
void MQMaterial::GetTextureName(char *buffer, int size);
void MQMaterial::GetAlphaName(char *buffer, int size);
void MQMaterial::GetBumpName(char *buffer, int size);
It stores a filename of a texture mapping, an alpha mapping and a bump mapping to the 'buffer'. The 'filename' is usually a relative path, and it is an absolute path in case that the filename is originally set as an absolute path.
You can use MQDocument::FindMappingFile()
to convert a returned relative path to an absolute path.
int MQMaterial::GetMappingType(void);
(new in Rev2.30)
It gets a type of a projection for a mapping.
MQPoint MQMaterial::GetMappingPosition(void);
(new in Rev2.30)
It gets a projection position for a mapping.
MQPoint MQMaterial::GetMappingScaling(void);
(new in Rev2.30)
It gets a projection scaling rate for a mapping.
MQAngle MQMaterial::GetMappingAngle(void);
(new in Rev2.30)
It gets a projection angle for a mapping.
void MQMaterial::SetName(const char *name);
It sets the material's name.
void MQMaterial::SetShader(int shader);
(new in Rev2.30)
It sets a type of a shader.
void MQMaterial::SetVertexColor(int value);
(new in Rev2.30)
It sets a type of a vertex color.
void MQMaterial::SetColor(MQColor color);
It sets a base color of the material.
void MQMaterial::SetAlpha(float value);
void MQMaterial::SetDiffuse(float value);
void MQMaterial::SetAmbient(float value);
void MQMaterial::SetEmission(float value);
void MQMaterial::SetSpecular(float value);
void MQMaterial::SetPower(float value);
It sets an alpha value (transparency), a diffuse value, an ambient value, an emission value, a specular value and a power of a specular.
The 'value' must be from 0 to 1. It must be from 0 to 100 in SetPower() only.
void MQMaterial::SetTextureName(const char *name);
void MQMaterial::SetAlphaName(const char *name);
void MQMaterial::SetBumpName(const char *name);
It assigns a texture mapping, an alpha mapping and a bump mapping with the specified filename. The name can be both a relative path and an absolute path.
void MQMaterial::SetMappingType(int type);
(new in Rev2.30)
It sets a type of a projection for a mapping.
void MQMaterial::SetMappingPosition(MQPoint pos);
(new in Rev2.30)
It sets a projection position for a mapping.
void MQMaterial::SetMappingScaling(MQPoint scale);
(new in Rev2.30)
It sets a projection scaling for a mapping.
void MQMaterial::SetMappingAngle(MQAngle angle);
(new in Rev2.30)
It sets a projection angle for a mapping.