/*许可协议说明
# ***** BEGIN LICENSE BLOCK *****
Copyright the original author or authors.
Licensed under the MOZILLA PUBLIC LICENSE, Version 1.1 (the "License");
you may not use this file except in compliance with the License.
You may obtain a copy of the License at
http://www.mozilla.org/MPL/MPL-1.1.html
Unless required by applicable law or agreed to in writing, software
distributed under the License is distributed on an "AS IS" BASIS,
WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
See the License for the specific language governing permissions and
limitations under the License.
# ***** END LICENSE BLOCK *****
*/
import sandy.core.data.Vertex;
import sandy.core.data.UVCoord;
import sandy.core.face.Face;
import sandy.core.face.TriFace3D;
import sandy.core.face.QuadFace3D;
import sandy.core.Object3D;
import sandy.primitive.Primitive3D;
/**
* Box
*
* <p>Box is a primitiv Object3D, to easy build a Cube/Box.</p>
* Box长方体是一个原始Object3D,很容易就能创建一个立方体/长方体
* @作者： Thomas Pfeiffer - kiroukou
* @version 1.0
* @date 12.07.2006
**/
class sandy.primitive.Box extends Object3D implements Primitive3D
{
/**
* Constructor
*
* <p>This is the constructor to call when you nedd to create a Box primitiv.</p>
* 这是一个构造函数，当你创建一个Box几何体时调用
* <p>This method will create a complete object with vertex,
* normales, texture coords and the faces.
* So it allows to have a custom 3D object easily</p>
*此方法将会创建一个具有顶点，法线，贴图坐标和面的复杂对象。所以使你很容易的自定义一个3D对象。
* @param rad 一个数，代表长方体的宽a Number represent the wide of the Box
* @param h 一个数，代表长方体的高a Number represent the height of the Box
* @param lg 一个数，代表长方体的深度a Number represent the depth of the Box
* @param mode 字符串，代表产生面的2个可用的模式，"tri"是三角面，而"quad"对应4边面。String represent the two available modes to generates the faces.
* "tri" is necessary to have faces with 3 points, and "quad" for 4 points.
*/
public function Box ( rad : Number,h : Number, lg : Number, mode:String, quality:Number )
{
super ();
_h = (h === undefined) ? 6 : h ;
_lg = (lg === undefined) ? 6 : lg ;
_radius = (rad === undefined) ? 100 : rad ;
_q = (undefined == quality || quality <= 0 || quality > 10) ? 1 : int(quality) ;
_mode = ( undefined == mode || (mode != 'tri' && mode != 'quad') ) ? 'tri' : mode;
generate ();
}
/**
* generate
*
* <p>Generate all is needed to construct the Object3D : </p>
* <ul>
* <li>{@link Vertex}</li>
* <li>{@link UVCoords}</li>
* <li>{@link TriFace3D}</li>
* </ul>
* <p>It can construct dynamically the object, taking care of your preferences given in arguments. <br/>
* Note in Sandy 0.1 all faces have only three points.
* This will change in the future version,
* and give to you the possibility to choose n points per faces</p>
*/
public function generate ( Void ) : Void
{
// initialisation初始化
aPoints = []; aNormals = []; _aFaces = [];
//we build points生成点（逆时针，由里到外)
var h2 : Number = - _h / 2;
var r2 : Number = _radius / 2;
var l2 : Number = _lg / 2;
var p0 : Vertex = new Vertex (-r2,-h2,l2);
aPoints.push (p0);
var p1 : Vertex = new Vertex (r2,-h2,l2);
aPoints.push (p1);
var p2 : Vertex = new Vertex (r2,h2,l2);
aPoints.push (p2);
var p3 : Vertex = new Vertex (-r2,h2,l2);
aPoints.push (p3);
var p4 : Vertex = new Vertex (-r2,-h2,-l2);
aPoints.push (p4);
var p5 : Vertex = new Vertex (r2,-h2,-l2);
aPoints.push (p5);
var p6 : Vertex = new Vertex (r2,h2,-l2);
aPoints.push (p6);
var p7 : Vertex = new Vertex (-r2,h2,-l2);
aPoints.push (p7);
// -- we setup texture coordinates设置贴图坐标
var uv0:UVCoord = addUVCoordinate (0, 0);
var uv1:UVCoord = addUVCoordinate (1, 0);
var uv2:UVCoord = addUVCoordinate (0, 1);
var uv3:UVCoord = addUVCoordinate (1, 1);
// -- Faces creation生成面
//Front Face前面
__tesselate(p0, p1, p2, p3,
uv0, uv1, uv3, uv2,
_q - 1 );
private function __tesselate( p0:Vertex, p1:Vertex, p2:Vertex, p3:Vertex,
uv0:UVCoord, uv1:UVCoord, uv2:UVCoord, uv3:UVCoord,
level:Number):Void
{
var f:Face;
if(level == 0 ) // End of recurssion递归结束
{
// -- We have the same normal for 2 faces, be careful to don't add extra normal我们让2个面具有相同法线，注意不要额外添加法线
if( _mode == 'tri' )
{
//前面
f = new TriFace3D( this, p0, p1, p3 );
f.setUVCoordinates( uv0, uv1, uv3 );
addFace( f );
f = new TriFace3D( this, p2, p3, p1 );
f.setUVCoordinates( uv2, uv3, uv1 );
addFace( f );
}
else if( _mode == 'quad' )
{
//前面
f = new QuadFace3D( this, p0, p1, p2, p3 );
f.setUVCoordinates( uv0, uv1, uv2, uv3 );
addFace( f );
}
}
else
{
//milieu de p0, p1;
var m01:Vertex = new Vertex( (p0.x+p1.x)/2, (p0.y+p1.y)/2, (p0.z+p1.z)/2 );
// milieu de p1 p2
var m12:Vertex = new Vertex( (p1.x+p2.x)/2, (p1.y+p2.y)/2, (p1.z+p2.z)/2 );
// milieu de p2 p3
var m23:Vertex = new Vertex( (p2.x+p3.x)/2, (p2.y+p3.y)/2, (p2.z+p3.z)/2 );
// milieu de p3 p0
var m30:Vertex = new Vertex( (p3.x+p0.x)/2, (p3.y+p0.y)/2, (p3.z+p0.z)/2 );
// milieu tout court
var center:Vertex = new Vertex( (p0.x+p1.x+p2.x+p3.x)/4, (p0.y+p1.y+p2.y+p3.y)/4, (p0.z+p1.z+p2.z+p3.z)/4 );
aPoints.push ( m01, m12, m23, m30, center );
//milieu de p0, p1;
var uv01:UVCoord = addUVCoordinate ((uv0.u+uv1.u)/2, (uv0.v+uv1.v)/2);
// milieu de p1 p2
var uv12:UVCoord = addUVCoordinate ( (uv1.u+uv2.u)/2, (uv1.v+uv2.v)/2 );
// milieu de p2 p3
var uv23:UVCoord = addUVCoordinate ( (uv2.u+uv3.u)/2, (uv2.v+uv3.v)/2 );
// milieu de p3 p0
var uv30:UVCoord = addUVCoordinate ( (uv3.u+uv0.u)/2, (uv3.v+uv0.v)/2 );
// milieu tout court
var uvcenter:UVCoord = addUVCoordinate ( (uv0.u+uv1.u+uv2.u+uv3.u)/4, (uv0.v+uv1.v+uv2.v+uv3.v)/4);
/**
* height of the Box长方体的高
*/
private var _h : Number;
/**
* depth of the Box长方体的深度
*/
private var _lg : Number;
/**
* wide of the Box长方体的宽
*/
private var _radius : Number ;
private var _q:Number;
/*
* Mode with 3 or 4 points per face模式字串，表明每个面是3点面还是4边面
*/
private var _mode : String;
}