Project

General

Profile

Download (21.2 KB) Statistics
| Branch: | Revision:

library / src / main / java / org / distorted / library / mesh / MeshBase.java @ 0d4aae88

1
///////////////////////////////////////////////////////////////////////////////////////////////////
2
// Copyright 2016 Leszek Koltunski                                                               //
3
//                                                                                               //
4
// This file is part of Distorted.                                                               //
5
//                                                                                               //
6
// Distorted is free software: you can redistribute it and/or modify                             //
7
// it under the terms of the GNU General Public License as published by                          //
8
// the Free Software Foundation, either version 2 of the License, or                             //
9
// (at your option) any later version.                                                           //
10
//                                                                                               //
11
// Distorted is distributed in the hope that it will be useful,                                  //
12
// but WITHOUT ANY WARRANTY; without even the implied warranty of                                //
13
// MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the                                 //
14
// GNU General Public License for more details.                                                  //
15
//                                                                                               //
16
// You should have received a copy of the GNU General Public License                             //
17
// along with Distorted.  If not, see <http://www.gnu.org/licenses/>.                            //
18
///////////////////////////////////////////////////////////////////////////////////////////////////
19

    
20
package org.distorted.library.mesh;
21

    
22
import android.opengl.GLES31;
23
import android.opengl.Matrix;
24

    
25
import org.distorted.library.effect.MatrixEffect;
26
import org.distorted.library.main.DistortedLibrary;
27
import org.distorted.library.main.InternalBuffer;
28
import org.distorted.library.program.DistortedProgram;
29

    
30
import java.nio.ByteBuffer;
31
import java.nio.ByteOrder;
32
import java.nio.FloatBuffer;
33
import java.util.ArrayList;
34

    
35
///////////////////////////////////////////////////////////////////////////////////////////////////
36
/**
37
 * Abstract class which represents a Mesh, ie an array of vertices (rendered as a TRIANGLE_STRIP).
38
 * <p>
39
 * If you want to render to a particular shape, extend from here, construct a float array
40
 * containing per-vertex attributes, and call back setAttribs().
41
 */
42
public abstract class MeshBase
43
   {
44
   // sizes of attributes of an individual vertex.
45
   private static final int POS_DATA_SIZE= 3; // vertex coordinates: x,y,z
46
   private static final int NOR_DATA_SIZE= 3; // normal vector: x,y,z
47
   private static final int INF_DATA_SIZE= 3; // 'inflate' vector: x,y,z
48
   private static final int TEX_DATA_SIZE= 2; // texture coordinates: s,t
49

    
50
   static final int POS_ATTRIB   = 0;
51
   static final int NOR_ATTRIB   = POS_DATA_SIZE;
52
   static final int INF_ATTRIB   = POS_DATA_SIZE + NOR_DATA_SIZE;
53
   static final int TEX_ATTRIB   = POS_DATA_SIZE + NOR_DATA_SIZE + INF_DATA_SIZE;
54
   static final int VERT_ATTRIBS = POS_DATA_SIZE + NOR_DATA_SIZE + INF_DATA_SIZE + TEX_DATA_SIZE;  // number of attributes of a 'normal' vertex
55
   static final int TRAN_ATTRIBS = POS_DATA_SIZE + POS_DATA_SIZE;                                  // number of attributes of a transform feedback vertex
56

    
57
   private static final int BYTES_PER_FLOAT = 4;
58

    
59
   private static final int OFFSET_POS = POS_ATTRIB*BYTES_PER_FLOAT;
60
   private static final int OFFSET_NOR = NOR_ATTRIB*BYTES_PER_FLOAT;
61
   private static final int OFFSET_INF = INF_ATTRIB*BYTES_PER_FLOAT;
62
   private static final int OFFSET_TEX = TEX_ATTRIB*BYTES_PER_FLOAT;
63
   private static final int TRAN_SIZE  = TRAN_ATTRIBS*BYTES_PER_FLOAT;
64
   private static final int VERT_SIZE  = VERT_ATTRIBS*BYTES_PER_FLOAT;
65

    
66
   private boolean mShowNormals;      // when rendering this mesh, draw normal vectors?
67
   private InternalBuffer mVBO, mTFO; // main vertex buffer and transform feedback buffer
68
   private int mNumVertices;
69
   private float[] mVertAttribs;      // packed: PosX,PosY,PosZ, NorX,NorY,NorZ, InfX,InfY,InfZ, TexS,TexT
70
   private float mInflate;
71
   private float mBoundingX, mBoundingY, mBoundingZ;
72
   private float mStretchX, mStretchY, mStretchZ;
73

    
74
   private class Component
75
     {
76
     private int mEndIndex;
77
     private float[] mTextureMap;
78

    
79
     Component(int end)
80
       {
81
       mEndIndex = end;
82

    
83
       mTextureMap    = new float[4];
84
       mTextureMap[0] = 0.0f;  // LowerLeft_X
85
       mTextureMap[1] = 0.0f;  // LowerLeft_Y
86
       mTextureMap[2] = 1.0f;  // Width
87
       mTextureMap[3] = 1.0f;  // Height
88
       }
89
     Component(Component original)
90
       {
91
       mEndIndex = original.mEndIndex;
92
       mTextureMap = new float[4];
93
       System.arraycopy(original.mTextureMap,0,mTextureMap,0,4);
94
       }
95

    
96
     void setMap(float[] newMap)
97
       {
98
       mTextureMap = newMap;
99
       }
100
     }
101

    
102
   private ArrayList<Component> mComponent;
103

    
104
///////////////////////////////////////////////////////////////////////////////////////////////////
105

    
106
   MeshBase(float bx, float by, float bz)
107
     {
108
     mBoundingX = bx/2;
109
     mBoundingY = by/2;
110
     mBoundingZ = bz/2;
111

    
112
     mStretchX = 1.0f;
113
     mStretchY = 1.0f;
114
     mStretchZ = 1.0f;
115

    
116
     mShowNormals = false;
117
     mInflate     = 0.0f;
118
     mComponent   = new ArrayList<>();
119

    
120
     mVBO = new InternalBuffer(GLES31.GL_ARRAY_BUFFER             , GLES31.GL_STATIC_READ);
121
     mTFO = new InternalBuffer(GLES31.GL_TRANSFORM_FEEDBACK_BUFFER, GLES31.GL_STATIC_READ);
122
     }
123

    
124
///////////////////////////////////////////////////////////////////////////////////////////////////
125
// copy constructor
126

    
127
   MeshBase(MeshBase original)
128
     {
129
     mBoundingX = original.mBoundingX;
130
     mBoundingY = original.mBoundingY;
131
     mBoundingZ = original.mBoundingZ;
132

    
133
     mStretchX = original.mStretchX;
134
     mStretchY = original.mStretchY;
135
     mStretchZ = original.mStretchZ;
136

    
137
     mShowNormals = original.mShowNormals;
138
     mInflate     = original.mInflate;
139

    
140
     int size = original.mComponent.size();
141
     mComponent = new ArrayList<>();
142
     for(int i=0; i<size; i++)
143
       {
144
       Component comp = new Component(original.mComponent.get(i));
145
       mComponent.add(comp);
146
       }
147

    
148
     mVBO = new InternalBuffer(GLES31.GL_ARRAY_BUFFER             , GLES31.GL_STATIC_READ);
149
     mTFO = new InternalBuffer(GLES31.GL_TRANSFORM_FEEDBACK_BUFFER, GLES31.GL_STATIC_READ);
150

    
151
     System.arraycopy(original.mVertAttribs,0,mVertAttribs,0,original.mNumVertices*VERT_ATTRIBS);
152
     setAttribs(mVertAttribs);
153
     }
154

    
155
///////////////////////////////////////////////////////////////////////////////////////////////////
156
// change mVertAttribs from index 'begin' to index 'end' (inclusive) to the new Texture Map.
157
// x varies from -mBoundingX to +mBoundingX; y accordingly.
158

    
159
   private void changeTextureMap( float[] newMap, float[] oldMap, int begin, int end)
160
     {
161

    
162
     }
163

    
164
///////////////////////////////////////////////////////////////////////////////////////////////////
165

    
166
   int numComponents()
167
     {
168
     return mComponent.size();
169
     }
170

    
171
///////////////////////////////////////////////////////////////////////////////////////////////////
172

    
173
   void setBounding(float bx, float by, float bz)
174
     {
175
     mBoundingX = bx/2;
176
     mBoundingY = by/2;
177
     mBoundingZ = bz/2;
178
     }
179

    
180
///////////////////////////////////////////////////////////////////////////////////////////////////
181
// when a derived class is done computing its mesh, it has to call this method.
182

    
183
   void setAttribs(float[] vertexAttribs)
184
     {
185
     mNumVertices = vertexAttribs.length/VERT_ATTRIBS;
186
     mVertAttribs = vertexAttribs;
187

    
188
     mComponent.add(new Component(mNumVertices));
189

    
190
     FloatBuffer attribs = ByteBuffer.allocateDirect(mNumVertices*VERT_SIZE).order(ByteOrder.nativeOrder()).asFloatBuffer();
191
     attribs.put(vertexAttribs).position(0);
192

    
193
     mVBO.setData(mNumVertices*VERT_SIZE, attribs);
194
     mTFO.setData(mNumVertices*TRAN_SIZE, null   );
195
     }
196

    
197
///////////////////////////////////////////////////////////////////////////////////////////////////
198
// called from MeshJoined
199

    
200
   void join(MeshBase[] meshes)
201
     {
202
     MeshBase mesh;
203
     Component comp;
204
     int com, num, len = meshes.length;
205
     int origVertices = mNumVertices;
206

    
207
     // compute new numVertices; take care of Components
208

    
209
     if( origVertices>0 )
210
       {
211
       com = mComponent.size();
212
       mNumVertices+= ( mNumVertices%2==1 ? 2:1 );
213
       mComponent.get(com-1).mEndIndex = mNumVertices;
214
       }
215

    
216
     for(int i=0; i<len; i++)
217
       {
218
       mesh = meshes[i];
219
       com = mesh.mComponent.size();
220

    
221
       for(int j=0; j<com; j++)
222
         {
223
         comp = new Component(mesh.mComponent.get(j));
224
         comp.mEndIndex += mNumVertices;
225
         mComponent.add(comp);
226
         }
227

    
228
       num = mesh.mNumVertices;
229
       mNumVertices+= (i<len-1 ? ( num%2==1 ? num+2 : num+1 ) : num);
230
       }
231

    
232
     // allocate new attrib array
233
     float[] newAttribs = new float[VERT_ATTRIBS*mNumVertices];
234
     num = origVertices;
235

    
236
     if( origVertices>0 )
237
       {
238
       System.arraycopy(mVertAttribs,                             0, newAttribs,                         0, VERT_ATTRIBS*num);
239
       System.arraycopy(mVertAttribs, VERT_ATTRIBS*(origVertices-1), newAttribs, VERT_ATTRIBS*origVertices, VERT_ATTRIBS    );
240
       origVertices++;
241

    
242
       if( num%2==1 )
243
         {
244
         System.arraycopy(mVertAttribs, VERT_ATTRIBS*(origVertices-1), newAttribs, VERT_ATTRIBS*origVertices, VERT_ATTRIBS);
245
         origVertices++;
246
         }
247
       }
248

    
249
     for(int i=0; i<len; i++)
250
       {
251
       mesh = meshes[i];
252
       num = mesh.mNumVertices;
253

    
254
       System.arraycopy(mesh.mVertAttribs, 0, newAttribs, VERT_ATTRIBS*origVertices, VERT_ATTRIBS    );
255
       origVertices++;
256
       System.arraycopy(mesh.mVertAttribs, 0, newAttribs, VERT_ATTRIBS*origVertices, VERT_ATTRIBS*num);
257
       origVertices+=num;
258

    
259
       if( i<len-1 )
260
         {
261
         System.arraycopy(mesh.mVertAttribs, VERT_ATTRIBS*(num-1), newAttribs, VERT_ATTRIBS*origVertices, VERT_ATTRIBS);
262
         origVertices++;
263

    
264
         if( num%2==1 )
265
           {
266
           System.arraycopy(mesh.mVertAttribs, VERT_ATTRIBS*(num-1), newAttribs, VERT_ATTRIBS*origVertices, VERT_ATTRIBS);
267
           origVertices++;
268
           }
269
         }
270
       }
271

    
272
     if( origVertices!=mNumVertices )
273
       {
274
       android.util.Log.e("mesh", "join: origVertices: "+origVertices+" numVertices: "+mNumVertices);
275
       }
276

    
277
     mVertAttribs = newAttribs;
278

    
279
     FloatBuffer attribs = ByteBuffer.allocateDirect(mNumVertices*VERT_SIZE).order(ByteOrder.nativeOrder()).asFloatBuffer();
280
     attribs.put(mVertAttribs).position(0);
281

    
282
     mVBO.setData(mNumVertices*VERT_SIZE, attribs);
283
     mTFO.setData(mNumVertices*TRAN_SIZE, null   );
284
     }
285

    
286
///////////////////////////////////////////////////////////////////////////////////////////////////
287
/**
288
 * Not part of public API, do not document (public only because has to be used from the main package)
289
 *
290
 * @y.exclude
291
 */
292
   public int getTFO()
293
     {
294
     return mTFO.mIndex[0];
295
     }
296

    
297
///////////////////////////////////////////////////////////////////////////////////////////////////
298
/**
299
 * Not part of public API, do not document (public only because has to be used from the main package)
300
 *
301
 * @y.exclude
302
 */
303
   public int getNumVertices()
304
     {
305
     return mNumVertices;
306
     }
307

    
308
///////////////////////////////////////////////////////////////////////////////////////////////////
309
/**
310
 * Not part of public API, do not document (public only because has to be used from the main package)
311
 *
312
 * @y.exclude
313
 */
314
   public void bindVertexAttribs(DistortedProgram program)
315
     {
316
     GLES31.glBindBuffer(GLES31.GL_ARRAY_BUFFER, mVBO.mIndex[0] );
317
     GLES31.glVertexAttribPointer(program.mAttribute[0], POS_DATA_SIZE, GLES31.GL_FLOAT, false, VERT_SIZE, OFFSET_POS);
318
     GLES31.glVertexAttribPointer(program.mAttribute[1], NOR_DATA_SIZE, GLES31.GL_FLOAT, false, VERT_SIZE, OFFSET_NOR);
319
     GLES31.glVertexAttribPointer(program.mAttribute[2], INF_DATA_SIZE, GLES31.GL_FLOAT, false, VERT_SIZE, OFFSET_INF);
320
     GLES31.glVertexAttribPointer(program.mAttribute[3], TEX_DATA_SIZE, GLES31.GL_FLOAT, false, VERT_SIZE, OFFSET_TEX);
321
     GLES31.glBindBuffer(GLES31.GL_ARRAY_BUFFER, 0);
322
     }
323

    
324
///////////////////////////////////////////////////////////////////////////////////////////////////
325
/**
326
 * Not part of public API, do not document (public only because has to be used from the main package)
327
 *
328
 * @y.exclude
329
 */
330
   public void bindTransformAttribs(DistortedProgram program)
331
     {
332
     GLES31.glBindBuffer(GLES31.GL_ARRAY_BUFFER, mTFO.mIndex[0] );
333
     GLES31.glVertexAttribPointer(program.mAttribute[0], POS_DATA_SIZE, GLES31.GL_FLOAT, false, 0, 0);
334
     GLES31.glBindBuffer(GLES31.GL_ARRAY_BUFFER, 0);
335
     }
336

    
337
///////////////////////////////////////////////////////////////////////////////////////////////////
338
/**
339
 * Not part of public API, do not document (public only because has to be used from the main package)
340
 *
341
 * @y.exclude
342
 */
343
   public void setInflate(float inflate)
344
     {
345
     mInflate = inflate;
346
     }
347

    
348
///////////////////////////////////////////////////////////////////////////////////////////////////
349
/**
350
 * Not part of public API, do not document (public only because has to be used from the main package)
351
 *
352
 * @y.exclude
353
 */
354
   public float getInflate()
355
     {
356
     return mInflate;
357
     }
358

    
359
///////////////////////////////////////////////////////////////////////////////////////////////////
360
// PUBLIC API
361
///////////////////////////////////////////////////////////////////////////////////////////////////
362
/**
363
 * When rendering this Mesh, do we want to render the Normal vectors as well?
364
 * <p>
365
 * Will work only on OpenGL ES >= 3.0 devices.
366
 *
367
 * @param show Controls if we render the Normal vectors or not.
368
 */
369
   public void setShowNormals(boolean show)
370
     {
371
     mShowNormals = (DistortedLibrary.GLSL >= 300 && show);
372
     }
373

    
374
///////////////////////////////////////////////////////////////////////////////////////////////////
375
/**
376
 * When rendering this mesh, should we also draw the normal vectors?
377
 *
378
 * @return <i>true</i> if we do render normal vectors
379
 */
380
   public boolean getShowNormals()
381
     {
382
     return mShowNormals;
383
     }
384

    
385
///////////////////////////////////////////////////////////////////////////////////////////////////
386
/**
387
 * Release all internal resources.
388
 */
389
   public void markForDeletion()
390
     {
391
     mVertAttribs = null;
392

    
393
     mVBO.markForDeletion();
394
     mTFO.markForDeletion();
395
     }
396

    
397
///////////////////////////////////////////////////////////////////////////////////////////////////
398
/**
399
 * Apply all Effects to the vertex mesh. Overwrite the mesh in place.
400
 * <p>
401
 * This is a static, permanent modification of the vertices contained in this Mesh. If the effects
402
 * contain any Dynamics, they will be evaluated at 0.
403
 *
404
 * Please note that calling this once with the complete list of Effects will be much faster than
405
 * calling it repeatedly with one Effect at a time, as we have to reallocate the array of vertices
406
 * each time.
407
 */
408
   public void apply(MatrixEffect[] effects)
409
     {
410
     float[][] matrix = new float[effects.length][16];
411
     float[] tmp;
412
     float[] array = new float[7];
413
     float x,y,z;
414
     int numEffects = 0;
415

    
416
     for(MatrixEffect eff: effects)
417
       {
418
       if( eff!=null )
419
         {
420
         Matrix.setIdentityM(matrix[numEffects],0);
421
         eff.compute(array,0,0,0);
422
         eff.apply(matrix[numEffects], array, 0);
423
         numEffects++;
424
         }
425
       }
426

    
427
     for(int index=0; index<mNumVertices*VERT_ATTRIBS; index+=VERT_ATTRIBS )
428
       {
429
       for(int mat=0; mat<numEffects; mat++)
430
         {
431
         tmp = matrix[mat];
432

    
433
         x = mVertAttribs[index+POS_ATTRIB  ];
434
         y = mVertAttribs[index+POS_ATTRIB+1];
435
         z = mVertAttribs[index+POS_ATTRIB+2];
436

    
437
         mVertAttribs[index+POS_ATTRIB  ] = tmp[0]*x + tmp[4]*y + tmp[ 8]*z + tmp[12];
438
         mVertAttribs[index+POS_ATTRIB+1] = tmp[1]*x + tmp[5]*y + tmp[ 9]*z + tmp[13];
439
         mVertAttribs[index+POS_ATTRIB+2] = tmp[2]*x + tmp[6]*y + tmp[10]*z + tmp[14];
440

    
441
         x = mVertAttribs[index+NOR_ATTRIB  ];
442
         y = mVertAttribs[index+NOR_ATTRIB+1];
443
         z = mVertAttribs[index+NOR_ATTRIB+2];
444

    
445
         mVertAttribs[index+NOR_ATTRIB  ] = tmp[0]*x + tmp[4]*y + tmp[ 8]*z;
446
         mVertAttribs[index+NOR_ATTRIB+1] = tmp[1]*x + tmp[5]*y + tmp[ 9]*z;
447
         mVertAttribs[index+NOR_ATTRIB+2] = tmp[2]*x + tmp[6]*y + tmp[10]*z;
448

    
449
         x = mVertAttribs[index+INF_ATTRIB  ];
450
         y = mVertAttribs[index+INF_ATTRIB+1];
451
         z = mVertAttribs[index+INF_ATTRIB+2];
452

    
453
         mVertAttribs[index+INF_ATTRIB  ] = tmp[0]*x + tmp[4]*y + tmp[ 8]*z;
454
         mVertAttribs[index+INF_ATTRIB+1] = tmp[1]*x + tmp[5]*y + tmp[ 9]*z;
455
         mVertAttribs[index+INF_ATTRIB+2] = tmp[2]*x + tmp[6]*y + tmp[10]*z;
456
         }
457
       }
458

    
459
     FloatBuffer attribs = ByteBuffer.allocateDirect(mNumVertices*VERT_SIZE).order(ByteOrder.nativeOrder()).asFloatBuffer();
460
     attribs.put(mVertAttribs).position(0);
461

    
462
     mVBO.setData(mNumVertices*VERT_SIZE, attribs);
463
     mTFO.setData(mNumVertices*TRAN_SIZE, null   );
464
     }
465

    
466
///////////////////////////////////////////////////////////////////////////////////////////////////
467
/**
468
 * Sets texture maps for all components of this mesh.
469
 * <p>
470
 * Please note that calling this once with the complete list of Maps will be much faster than
471
 * calling it repeatedly with one Maps at a time, as we have to reallocate the array of vertices
472
 * each time.
473
 * 'maps' needs to be maps[NumComponentsInThisMesh][4]. [0] is the lower-left corner's X, [1]- its Y,
474
 * [2] - width, [3] - height of the map.
475
 * For example map[0] = new float { 0.0, 0.5, 0.5, 0.5 } sets the 0th component texture map to the
476
 * upper-left quadrant of the texture.
477
 */
478
   public void setTextureMap(float[][] maps)
479
     {
480
     int num_comp = mComponent.size();
481
     int num_maps = maps.length;
482
     int min = num_comp<num_maps ? num_comp : num_maps;
483
     int lastEnd = 0;
484

    
485
     for(int i=0; i<min; i++)
486
       {
487
       if( maps[i]!=null )
488
         {
489
         Component comp = mComponent.get(i);
490
         changeTextureMap(maps[i],comp.mTextureMap,lastEnd,comp.mEndIndex);
491
         comp.setMap(maps[i]);
492
         lastEnd = comp.mEndIndex;
493
         }
494
       }
495

    
496
     FloatBuffer attribs = ByteBuffer.allocateDirect(mNumVertices*VERT_SIZE).order(ByteOrder.nativeOrder()).asFloatBuffer();
497
     attribs.put(mVertAttribs).position(0);
498

    
499
     mVBO.setData(mNumVertices*VERT_SIZE, attribs);
500
     mTFO.setData(mNumVertices*TRAN_SIZE, null   );
501
     }
502

    
503
///////////////////////////////////////////////////////////////////////////////////////////////////
504
/**
505
 * Each mesh has its 'bounding box' - return half of its X-length.
506
 * <p>
507
 * In case of all 'simple' Meshes, the bounding box is always 1x1x1 (Sphere, Cubes) or 1x1x0
508
 * (Rectangles, Triangles, Quad - i.e. all 'flat' Meshes). But this can be something else in case of
509
 * MeshComponent.
510
 */
511
   public float getBoundingX()
512
    {
513
    return mBoundingX*mStretchX;
514
    }
515

    
516
///////////////////////////////////////////////////////////////////////////////////////////////////
517
/**
518
 * Each mesh has its 'bounding box' - return half of its Y-length.
519
 */
520
   public float getBoundingY()
521
    {
522
    return mBoundingY*mStretchY;
523
    }
524

    
525
///////////////////////////////////////////////////////////////////////////////////////////////////
526
/**
527
 * Each mesh has its 'bounding box' - return half of its Z-length.
528
 */
529
   public float getBoundingZ()
530
    {
531
    return mBoundingZ*mStretchZ;
532
    }
533

    
534
///////////////////////////////////////////////////////////////////////////////////////////////////
535
/**
536
 * Sometimes we want to display a Mesh on a rectangular screen. Then we need to stretch it by
537
 * different factors in x and y (or z) directions. If we also wanted do display some vertex effects
538
 * done on this mesh, let's say a bulge done by a Distort effect, and wanted the bulge to be round,
539
 * (i.e the same in x and y directions) then doing so without this method would be impossible.
540
 *
541
 * This sets 'stretch' factors in each 3 dimensions. All vertices of this Mesh will be premultiplied
542
 * by those factors in the very first line of the Vertex Shader, before any Effects are done on it.
543
 * Using this we can thus pre-stretch the mesh to aspect ratio equal to the surface we eventually
544
 * want to display the Mesh on, and this way we can achieve a round Distort bulge!
545
 *
546
 * This could also be used to pre-stretch a Rectangles Mesh to a size equal (in pixels) to the bitmap
547
 * this mesh is textured with - and this lets us work with all Effects in natural, pixel units.
548
 *
549
 * @param sx stretch factor in x.
550
 * @param sy stretch factor in y.
551
 * @param sz stretch factor in z.
552
 */
553
   public void setStretch(float sx, float sy, float sz)
554
     {
555
     mStretchX = sx;
556
     mStretchY = sy;
557
     mStretchZ = sz;
558
     }
559

    
560
///////////////////////////////////////////////////////////////////////////////////////////////////
561
/**
562
 * Returns the x-factor set by setStretch().
563
 */
564
   public float getStretchX()
565
     {
566
     return mStretchX;
567
     }
568

    
569
///////////////////////////////////////////////////////////////////////////////////////////////////
570
/**
571
 * Returns the y-factor set by setStretch().
572
 */
573
   public float getStretchY()
574
     {
575
     return mStretchY;
576
     }
577

    
578
///////////////////////////////////////////////////////////////////////////////////////////////////
579
/**
580
 * Returns the z-factor set by setStretch().
581
 */
582
   public float getStretchZ()
583
     {
584
     return mStretchZ;
585
     }
586
   }
587

    
588

    
589

    
(1-1/7)