Java Doc for TextureAttributes.java in  » 6.0-JDK-Modules » java-3d » javax » media » j3d » Java Source Code / Java DocumentationJava Source Code and Java Documentation

• Texture mode - defines how the object and texture colors are blended. The mode may be one of the following:
• MODULATE - modulates the incoming color with the texture color.
  C' = C Ct
• DECAL - applies the texture color to the incoming color as a decal.
  C'_rgb = C_rgb (1 - Ct_a) + Ct_rgb Ct_a

  C'_a = C_a

• BLEND - blends the texture blend color with the incoming color.
  C'_rgb = C_rgb (1 - Ct_rgb) + Cb_rgb Ct_rgb

  C'_a = C_a Ct_a

  Note that if the texture format is INTENSITY, alpha is computed identically to red, green, and blue:
  C'_a = C_a (1 - Ct_a) + Cb_a Ct_a
• REPLACE - replaces the incoming color with the texture color.
  C' = Ct

• COMBINE - combines the object color with the texture color or texture blend color according to the combine operation as specified in the texture combine mode.

C = Incoming color to the texture unit state. For texture unit state 0, C is the object color Ct = Texture color
Cb = Texture blend color

• Combine Mode - defines the combine operation when texture mode specifies COMBINE. The combine mode includes the following:
  • COMBINE_REPLACE
    C' = C₀

  • COMBINE_MODULATE
    C' = C₀ C₁
  • COMBINE_ADD
    C' = C₀ + C₁

  • COMBINE_ADD_SIGNED
    C' = C₀ + C₁ - 0.5

  • COMBINE_SUBTRACT
    C' = C₀ - C₁

  • COMBINE_INTERPOLATE
    C' = C₀ C₂ + C₁ (1 - C₂)

  • COMBINE_DOT3
    C' = 4 * ( (C_0r - 0.5) * (C_1r - 0.5) + (C_0g - 0.5) * (C_1g - 0.5) + (C_0b - 0.5) * (C_1b - 0.5))

    where C_Nx is the x component of the Nth color operand in the combine operation.

    The value C' will be placed to the all three r,g,b components or the a component of the output.

where C₀, C₁ and C₂ are determined by the color source, and the color operand.

• Combine Color Source - defines the source for a color operand in the combine operation. The color source includes the following:
  • COMBINE_OBJECT_COLOR - object color

  • COMBINE_TEXTURE_COLOR - texture color

  • COMBINE_CONSTANT_COLOR - texture blend color

  • COMBINE_PREVIOUS_TEXTURE_UNIT_STATE - color from the previous texture unit state. For texture unit state 0, this is equivalent to COMBINE_OBJECT_COLOR.

• Combine Color Function - specifies the function for a color operand in the combine operation. The valid values are:
  • COMBINE_SRC_COLOR - the color function is f = C_rgb

  • COMBINE_ONE_MINUS_SRC_COLOR - the color function is f = (1 - C_rgb)

  • COMBINE_SRC_ALPHA - the color function is f = C_a

  • COMBINE_ONE_MINUS_SRC_ALPHA - the color function is f = (1 - C_a)

• Combine scale factor - specifies the scale factor to be applied to the output color of the combine operation. The valid values include: 1, 2, or 4.
• Transform - the texture transform object used to transform texture coordinates. The texture transform can translate, scale, or rotate the texture coordinates before the texture is applied to the object.
• Blend color - the constant texture blend color
• Perspective correction - the perspective correction mode used for color and texture coordinate interpolation. One of the following:
• NICEST - uses the nicest (highest quality) available method for texture mapping perspective correction.
• FASTEST - uses the fastest available method for texture mapping perspective correction.

• Texture color table - defines a table that is used to look up texture colors before applying the texture mode.

texture mode : REPLACE
blend color : black (0,0,0,0)
transform : identity
perspective correction mode : NICEST
texture color table : null
combine rgb mode : COMBINE_MODULATE
combine alpha mode : COMBINE_MODULATE
combine rgb source :
C₀=COMBINE_TEXTURE_COLOR
C₁=COMBINE_PREVIOUS_TEXTURE_UNIT_STATE
C₂=COMBINE_CONSTANT_COLOR

combine alpha source :
C₀=COMBINE_TEXTURE_COLOR
C₁=COMBINE_PREVIOUS_TEXTURE_UNIT_STATE
C₂=COMBINE_CONSTANT_COLOR

combine rgb function : COMBINE_SRC_COLOR
combine alpha function : COMBINE_SRC_ALPHA
combine rgb scale : 1
combine alpha scale : 1

When enabled, the texture color table is applied after the texture filtering operation and before texture application. Each of the r, g, b, and a components are clamped to the range [0,1], multiplied by textureColorTableSize-1, and rounded to the nearest integer. The resulting value for each component is then used as an index into the respective table for that component. If the texture color table contains 3 components, alpha is passed through unmodified.
Parameters:
  table - the new texture color table
exception:
  IllegalArgumentException - if table.lengthis not 3 or 4, or if the arrays for each component are not allthe same length, or if the texture color table sizeis not a power of 2
exception:
  CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
See Also:   Canvas3D.queryProperties
since:
   Java 3D 1.2