Libraries.Game.Graphics.TextureAttribute Documentation

Inherits from: Libraries.Game.Graphics.Attribute, Libraries.Language.Object

Variables Table

VariablesDescription
number offsetV
number scaleU
text REFLECTION_ALIAS
text DIFFUSE_ALIAS
text AMBIENT_ALIAS
text SPECULAR_ALIAS
integer EMISSIVE
text EMISSIVE_ALIAS
integer SPECULAR
integer AMBIENT
Libraries.Game.Graphics.TextureDescriptor descriptor
text BUMP_ALIAS
integer uvIndexThe index of the texture coordinate vertex attribute to use for this TextureAttribute. Whether this value is used, depends on the shader and Attribute type value. For basic (model specific) types (e.g. Diffuse, Normal, etc.), this value is usually ignored and the first texture coordinate vertex attribute is used.
number offsetU
integer BUMP
integer DIFFUSE
number scaleVThe index of the texture coordinate vertex attribute to use for this TextureAttribute. Whether this value is used, depends on the shader and Attribute type value. For basic (model specific) types (e.g. Diffuse, Normal, etc.), this value is usually ignored and the first texture coordinate vertex attribute is used.
integer BITMASK
integer NORMAL
text NORMAL_ALIAS
integer REFLECTION

Actions Documentation

Compare(Libraries.Language.Object object)

This action compares two object hash codes and returns an integer. The result is larger if this hash code is larger than the object passed as a parameter, smaller, or equal. In this case, -1 means smaller, 0 means equal, and 1 means larger. This action was changed in Quorum 7 to return an integer, instead of a CompareResult object, because the previous implementation was causing efficiency issues.

Parameters

Return

integer: The Compare result, Smaller, Equal, or Larger.

Example

Object o
Object t
integer result = o:Compare(t) //1 (larger), 0 (equal), or -1 (smaller)

CreateAmbient(Libraries.Game.Graphics.Texture texture)

CreateAmbient(Libraries.Game.Graphics.TextureDescriptor texture)

CreateBump(Libraries.Game.Graphics.Texture texture)

CreateBump(Libraries.Game.Graphics.TextureDescriptor texture)

CreateDiffuse(Libraries.Game.Graphics.Texture texture)

CreateDiffuse(Libraries.Game.Graphics.TextureDescriptor texture)

CreateEmissive(Libraries.Game.Graphics.TextureDescriptor texture)

CreateEmissive(Libraries.Game.Graphics.Texture texture)

CreateNormal(Libraries.Game.Graphics.TextureDescriptor texture)

CreateNormal(Libraries.Game.Graphics.Texture texture)

CreateReflection(Libraries.Game.Graphics.Texture texture)

CreateReflection(Libraries.Game.Graphics.TextureDescriptor texture)

CreateSpecular(Libraries.Game.Graphics.TextureDescriptor texture)

CreateSpecular(Libraries.Game.Graphics.Texture texture)

Equals(Libraries.Game.Graphics.Attribute other)

This action will test to see if two Attributes are of the same type. Note that it will not test if the contents of the Attributes are the same.

Parameters

Return

boolean: Whether or not the two attributes are of the same type.

Example

use Libraries.Game.Game
use Libraries.Game.Graphics.ColorAttribute
use Libraries.Game.Graphics.Attribute
use Libraries.Game.Graphics.Color

class Main is Game

    action Main
        StartGame()
    end

    action CreateGame
        Color color

        // Using the ColorAttribute class, which inherits from Attribute.
        ColorAttribute attribute1

        attribute1:SetAttribute(attribute1:GetDiffuseValue(), color:Green())
        Attribute attribute2 = attribute1:Copy()

        output "attribute1 = attribute2 is " + attribute1:Equals(attribute2)

    end
end

Equals(Libraries.Language.Object object)

This action determines if the given object is equal to this Attribute.

Parameters

Return

boolean: True if the object is an Attribute with the same type, otherwise it returns false.

GetAmbientValue()

This action returns the integer value representing an Ambient TextureAttribute.

Return

integer:

GetAttributeAlias(integer type)

GetAttributeAlias will take an integer code for a particular type of Attribute and return a text alias representing that type. Each class that inherits from Attribute will contain a series of actions that will return an integer code for a given type. The contents of this Attribute are not considered during this action, and can be ignored.

Parameters

  • integer type: An integer code describing an Attribute type.

Return

text: A text alias representing the described Attribute type.

Example

use Libraries.Game.Game
use Libraries.Game.Graphics.TextureAttribute

class Main is Game

    action Main
        StartGame()
    end

    action CreateGame
        // Using the TextureAttribute class, which inherits from Attribute.
        TextureAttribute attribute
        text alias = attribute:GetAttributeAlias(attribute:GetDiffuseValue())

        output "The alias for a diffuse TextureAttribute is " + alias
    end
end

GetAttributeMask()

This action returns the sum of all supported value types for a TextureAttribute.

Return

integer:

GetAttributeType(text alias)

GetAttributeType will take a text alias for a particular type of Attribute and return an integer code representing that type. Each class that inherits from Attribute will contain a series of public constant text fields that contain an alias for a given type. The contents of this Attribute are not considered during this action, and can be ignored.

Parameters

  • text alias: A text alias describing an Attribute type.

Return

integer: An integer code representing the described Attribute type.

Example

use Libraries.Game.Game
use Libraries.Game.Graphics.TextureAttribute

class Main is Game

    action Main
        StartGame()
    end

    action CreateGame
        // Using the TextureAttribute class, which inherits from Attribute.
        TextureAttribute attribute
        integer code = attribute:GetAttributeType(attribute:DIFFUSE_ALIAS)

        output "The type code for a diffuse TextureAttribute is " + code
    end
end

GetBumpValue()

This action returns the integer value representing a Bump TextureAttribute.

Return

integer:

GetDiffuseValue()

This action returns the integer value representing a Diffuse TextureAttribute.

Return

integer:

GetEmissiveValue()

This action returns the integer value representing an Emissive TextureAttribute.

Return

integer:

GetHashCode()

This action gets the hash code for an object.

Return

integer: The integer hash code of the object.

Example

Object o
integer hash = o:GetHashCode()

GetNormalValue()

This action returns the integer value representing a Normal TextureAttribute.

Return

integer:

GetReflectionValue()

This action returns the integer value representing a reflection TextureAttribute.

Return

integer:

GetSpecularValue()

This action returns the integer value representing a Specular TextureAttribute.

Return

integer:

GetType()

This action returns an integer code representing what type is stored in this Attribute. This can be compared against results from the GetAttributeType(text) action to more precisely determine what the meaning behind the code is.

Return

integer: An integer code representing this Attribute's type.

HashCode()

This action will return a hash code that identifies an Attribute by its type.

Return

integer:

Example

use Libraries.Game.Game
use Libraries.Game.Graphics.ColorAttribute
use Libraries.Game.Graphics.Attribute
use Libraries.Game.Graphics.Color

class Main is Game

    action Main
        StartGame()
    end

    action CreateGame
        // Using the ColorAttribute class, which inherits from Attribute.
        ColorAttribute attribute
        Color green
        green:SetColor(0, 1, 0, 1)
        attribute:SetAttribute(attribute:GetDiffuseValue(), green)

        output "The hash code for the attribute is " + attribute:GetHashCode()
    end
end

SetAttribute(integer setType, Libraries.Game.Graphics.TextureDescriptor description, number offU, number offV, number sU, number sV)

Parameters

SetAttribute(integer setType, Libraries.Game.Graphics.Texture texture)

Parameters

SetAttribute(integer setType, Libraries.Game.Graphics.TextureDescriptor description)

SetAttribute(integer setType)

SetAttribute will set data used by this Attribute. Note that most classes which inherit from Attribute will have their own implementations of SetAttribute which may require different parameters - e.g., to use SetAttribute in the ColorAttribute class, it requires both an integer type, but also a color. Most users should not use this action directly.

Parameters

  • integer setType: The type to set this Attribute to.

SupportsAttribute(integer type)

This aciton will test if the given integer value represents a supported attribute type for a TextureAttribute.

Parameters

  • integer type

Return

boolean: