So you want to replace your cube’s sides with some fresh BitmapData? At runtime?
As you probably noticed before, there isn’t much of a reference on the Internet explaining on how to change the material of a cube (or any other 3D DisplayObject) in PaperVision3D.
You probably already know that you can assign wonderful materials like ColorMaterial, BitmapMaterial, etc to a cube by using a MaterialsList in its constructor.
But what should we do if we want to change the material after the cube has already been created?
The first thing you’d tried is to reapply the cube’s materials property (cube.materials = myNewMaterialsList) but you’ll notice that won’t work.
After looking for a few days I found the solution on how to reapply a new material (it has some limitation though).
The rescuing phrase:
cube.materials.getMaterialByName("front").bitmap = image;
Where “image” is a BitmapData Object.
Before you test this, keep in mind that there are a few limitations before this actually works (I don’t think its meant to be used like this)
Keep in mind that you are changing the side of the cube to a new bitmap so in the constructor of the cube: define the material of the side you want to change as BitmapData.
The code I used (there are several possibilities to do this):
var defaultFrontMaterial:BitmapMaterial = new BitmapMaterial(new BitmapData(267, 375, false, 0xFFFFFF));
defaultFrontMaterial.smooth = true;
defaultFrontMaterial.doubleSided = false;
var defaultBackMaterial:BitmapMaterial = new BitmapMaterial(new BitmapData(267, 375, false, 0xFFFFFF));
defaultBackMaterial.smooth = true;
defaultBackMaterial.doubleSided = false;
// Materials
materials = new MaterialsList(
{
front: defaultFrontMaterial,
back: defaultBackMaterial,
right: new ColorMaterial(0xFFFFFF, 1),
left: new ColorMaterial(0xFFFFFF, 1),
top: new ColorMaterial(0xFFFFFF, 1),
bottom: new ColorMaterial(0xFFFFFF, 1)
} );
The default material you are about to create for the cube’s front side should have the same dimension of that particular side. If you try to make the new BitmapData with a height and width of 1px and a solid color, you’ll end up with a rescaled image when you try to reapply the new material. (You might think: this default BitmapData side won’t display an image so why wouldn’t I make it 1px by 1px, but that’s a wrong thought :p).
And that’s it! I hope this method works for your particular case. This technique also works perfectly if the side has multiple faces (segments).
Many thanks to my collegues for supporting me and many thanks to PaperVision developers for the great API but let’s all hope they’ll make setters for applying new materials at runtime.
Technorati Tags: as3, change material, cube, flash, materials, materialslist, papervision, papervision3D, side
