Microsoft DirectX 9.0 SDK Update (October 2004)

BaseTexture.AutoGenerateFilterType Property

Language:

Note: This documentation is preliminary and is subject to change.

Retrieves or sets the filter type used for automatically generated sublevels.

Definition

Visual Basic .NET Public Property AutoGenerateFilterType As TextureFilter
C# public TextureFilter AutoGenerateFilterType { get; set; }
Managed C++ public: __property TextureFilter get_AutoGenerateFilterType();
public: __property void set_AutoGenerateFilterType(TextureFilter);
JScript .NET public function get AutoGenerateFilterType() : TextureFilter
public function set AutoGenerateFilterType(TextureFilter);

Property Value

Microsoft.DirectX.Direct3D.TextureFilter . A TextureFilter. A texture must be created with Usage.AutoGenerateMipMap to use this property. Any other usage value sets this property to TextureFilter.None.

This property is read/write. 

Remarks

Changing the filter type "dirties" the mipmap sublevels and causes them to be regenerated.

The (default) filter type set at texture creation time is Linear. If the driver does not support a linear filter, the filter type is set to Point. All filter types supported by the driver for regular texture filtering are supported for autogeneration except None. Setting the AutoGenerateFilterType property fails unless the driver sets the appropriate SupportsMinify* caps. These values are specified in the Caps.FilterCaps and/or Caps.CubeTextureFilterCaps members. For more information about texture filter types, see TextureFilter.

If the texture is not created with AutoGenerateMipMap, this method has no effect. In this case, an exception is not thrown. For more information about usage constants, see Usage.

Exceptions
InvalidCallException The method call is invalid. For example, a parameter might contain an invalid value.

Applies To

CubeTexture, Texture, VolumeTexture

See Also


© 2004 Microsoft Corporation. All rights reserved. Terms of use.

Feedback? Please provide us with your comments on this topic.
For more help, visit the DirectX Developer Center