Texture3D

Contribution Depot
1

I’ve created a Texture3D class (Basically copied Texture2D) to support 3D textures.



As far as I can tell, this is the only thing needed as Material and LwjglRenderer seemed to be already prepared for three dimensional textures.



So far I’ve added it to a new MaterialDef file and defined a sampler3D parameter in my shader and nothing complained. I’ve yet to actually use it. (I’m trying to render to it, but it seems I need a geometry shader to fill anything but the first layer.)



[java]

/*

  • Copyright © 2009-2010 jMonkeyEngine
  • All rights reserved.

    *
  • Redistribution and use in source and binary forms, with or without
  • modification, are permitted provided that the following conditions are
  • met:

    *
    • Redistributions of source code must retain the above copyright
  • notice, this list of conditions and the following disclaimer.

    *
    • Redistributions in binary form must reproduce the above copyright
  • notice, this list of conditions and the following disclaimer in the
  • documentation and/or other materials provided with the distribution.

    *
    • Neither the name of ‘jMonkeyEngine’ nor the names of its contributors
  • may be used to endorse or promote products derived from this software
  • without specific prior written permission.

    *
  • THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  • "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED
  • TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
  • PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
  • CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
  • EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
  • PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
  • PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF
  • LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING
  • NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS
  • SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.

    */



    package com.jme3.texture;



    import com.jme3.export.JmeExporter;

    import com.jme3.export.JmeImporter;

    import com.jme3.export.InputCapsule;

    import com.jme3.export.OutputCapsule;



    import java.io.IOException;



    /**
  • @author Maarten Steur

    */

    public class Texture3D extends Texture {



    private WrapMode wrapS = WrapMode.EdgeClamp;

    private WrapMode wrapT = WrapMode.EdgeClamp;

    private WrapMode wrapR = WrapMode.EdgeClamp;



    /**
  • Creates a new two-dimensional texture with default attributes.

    */

    public Texture3D(){

    super();

    }



    /**
  • Creates a new three-dimensional texture using the given image.
  • @param img The image to use.

    */

    public Texture3D(Image img){

    super();

    setImage(img);

    if (img.getFormat().isDepthFormat()){

    setMagFilter(MagFilter.Nearest);

    setMinFilter(MinFilter.NearestNoMipMaps);

    }

    }



    /**
  • Creates a new three-dimensional texture for the purpose of offscreen
  • rendering.

    *
  • @see com.jme3.texture.FrameBuffer

    *
  • @param width
  • @param height
  • @param depth
  • @param format

    */

    public Texture3D(int width, int height, int depth, Image.Format format){

    this(new Image(format, width, height, depth, null));

    }



    /**
  • Creates a new three-dimensional texture for the purpose of offscreen
  • rendering.

    *
  • @see com.jme3.texture.FrameBuffer

    *
  • @param width
  • @param height
  • @param format
  • @param numSamples

    */

    public Texture3D(int width, int height, int depth, int numSamples, Image.Format format){

    this(new Image(format, width, height, depth, null));

    getImage().setMultiSamples(numSamples);

    }



    @Override

    public Texture createSimpleClone() {

    Texture3D clone = new Texture3D();

    createSimpleClone(clone);

    return clone;

    }



    @Override

    public Texture createSimpleClone(Texture rVal) {

    rVal.setWrap(WrapAxis.S, wrapS);

    rVal.setWrap(WrapAxis.T, wrapT);

    rVal.setWrap(WrapAxis.R, wrapR);

    return super.createSimpleClone(rVal);

    }



    /**
  • <code>setWrap</code> sets the wrap mode of this texture for a
  • particular axis.

    *
  • @param axis
  •        the texture axis to define a wrapmode on.<br />
  • @param mode
  •        the wrap mode for the given axis of the texture.<br />
  • @throws IllegalArgumentException
  •         if axis or mode are null<br />

*/

public void setWrap(WrapAxis axis, WrapMode mode) {

if (mode == null) {

throw new IllegalArgumentException("mode can not be null.");

} else if (axis == null) {

throw new IllegalArgumentException("axis can not be null.");

}

switch (axis) {

case S:

this.wrapS = mode;

break;

case T:

this.wrapT = mode;

break;

case R:

this.wrapR = mode;

break;

}

}



/**

  • <code>setWrap</code> sets the wrap mode of this texture for all axis.

    *
  • @param mode
  •        the wrap mode for the given axis of the texture.<br />
  • @throws IllegalArgumentException
  •         if mode is null<br />

*/

public void setWrap(WrapMode mode) {

if (mode == null) {

throw new IllegalArgumentException("mode can not be null.");

}

this.wrapS = mode;

this.wrapT = mode;

this.wrapR = mode;

}



/**

  • <code>getWrap</code> returns the wrap mode for a given coordinate axis
  • on this texture.

    *
  • @param axis
  •        the axis to return for<br />
  • @return the wrap mode of the texture.
  • @throws IllegalArgumentException
  •         if axis is null<br />

*/

public WrapMode getWrap(WrapAxis axis) {

switch (axis) {

case S:

return wrapS;

case T:

return wrapT;

case R:

return wrapR;

}

throw new IllegalArgumentException("invalid WrapAxis: " + axis);

}



@Override

public Type getType() {

return Type.ThreeDimensional;

}



@Override

public boolean equals(Object other) {

if (!(other instanceof Texture3D)) {

return false;

}

Texture3D that = (Texture3D) other;

if (this.getWrap(WrapAxis.S) != that.getWrap(WrapAxis.S))

return false;

if (this.getWrap(WrapAxis.T) != that.getWrap(WrapAxis.T))

return false;

if (this.getWrap(WrapAxis.R) != that.getWrap(WrapAxis.R))

return false;

return super.equals(other);

}



@Override

public void write(JmeExporter e) throws IOException {

super.write(e);

OutputCapsule capsule = e.getCapsule(this);

capsule.write(wrapS, "wrapS", WrapMode.EdgeClamp);

capsule.write(wrapT, "wrapT", WrapMode.EdgeClamp);

capsule.write(wrapR, "wrapR", WrapMode.EdgeClamp);

}



@Override

public void read(JmeImporter e) throws IOException {

super.read(e);

InputCapsule capsule = e.getCapsule(this);

wrapS = capsule.readEnum("wrapS", WrapMode.class, WrapMode.EdgeClamp);

wrapT = capsule.readEnum("wrapT", WrapMode.class, WrapMode.EdgeClamp);

wrapR = capsule.readEnum("wrapR", WrapMode.class, WrapMode.EdgeClamp);

}



}



[/java]

1 Like