VolumeLoader.FromVolume(Volume,PaletteEntry,Box,Volume,Filter,Int32) Method (Microsoft.DirectX.Direct3D)

Loads a volume from another volume.


Visual Basic Public Shared Sub FromVolume( _
    ByVal destVolume As Volume, _
    ByRef destPalette As PaletteEntry, _
    ByVal destBox As Box, _
    ByVal srcVolume As Volume, _
    ByVal filter As Filter, _
    ByVal colorKey As Integer _
C# public static void FromVolume(
    Volume destVolume,
    out PaletteEntry destPalette,
    Box destBox,
    Volume srcVolume,
    Filter filter,
    int colorKey
C++ public:
static void FromVolume(
    [Out] PaletteEntrydestPalette,
    Box destBox,
    Filter filter,
    int colorKey
JScript public static function FromVolume(
    destVolume : Volume,
    destPalette : PaletteEntry,
    destBox : Box,
    srcVolume : Volume,
    filter : Filter,
    colorKey : int


destVolume Microsoft.DirectX.Direct3D.Volume
A Volume object that specifies the destination volume.
destPalette Microsoft.DirectX.Direct3D.PaletteEntry[]
Array of PaletteEntry structures containing a 256-color palette that represents the palette for the destination volume. This parameter can be 0.
destBox Microsoft.DirectX.Direct3D.Box
A Box structure that specifies the destination box. Omit this parameter to specify the entire volume.
srcVolume Microsoft.DirectX.Direct3D.Volume
A Volume object that specifies the source volume.
filter Microsoft.DirectX.Direct3D.Filter
One or more Filter flags that control how the image is filtered.
colorKey System.Int32
An Int32Leave Site value to replace with transparent black, or 0 to disable the color key. This is always a 32-bit ARGB color that is independent of the source image format. Alpha is significant, and usually should be set to FF for opaque color keys. For example, for opaque black, the value is equal to 0xFF000000.


Writing to any surface except the "zero" level surface of the volume texture does not cause the dirty rectangle to be updated. If FromFile is called and the texture is not already dirty (which is unlikely under normal usage scenarios), the application must explicitly call VolumeTexture.AddDirtyBox on the volume texture.



The method call is invalid. For example, a method's parameter might contain an invalid value.


The data is invalid.

See Also