1 /* 2 ** 3 ** Copyright 2007, The Android Open Source Project 4 ** 5 ** Licensed under the Apache License, Version 2.0 (the "License"); 6 ** you may not use this file except in compliance with the License. 7 ** You may obtain a copy of the License at 8 ** 9 ** http://www.apache.org/licenses/LICENSE-2.0 10 ** 11 ** Unless required by applicable law or agreed to in writing, software 12 ** distributed under the License is distributed on an "AS IS" BASIS, 13 ** WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. 14 ** See the License for the specific language governing permissions and 15 ** limitations under the License. 16 */ 17 18 /* 19 * Generic Convex Polygon Scan Conversion and Clipping 20 * by Paul Heckbert 21 * from "Graphics Gems", Academic Press, 1990 22 */ 23 24 /* Based on the public domain code: 25 * poly_clip.c: homogeneous 3-D convex polygon clipper 26 * 27 * Paul Heckbert 1985, Dec 1989 28 */ 29 30 #include "poly.h" 31 #include "string.h" 32 33 #define LOG_TAG "StreetView" 34 #include <utils/Log.h> 35 36 namespace android { 37 38 #define SWAP(a, b, temp) {(temp) = a; (a) = b; (b) = temp;} 39 #define COORD(vert, i) ((float *)(vert))[i] 40 41 #define CLIP_AND_SWAP(elem, sign, k, p, q, r) { \ 42 poly_clip_to_halfspace(p, q, &v->elem-(float *)v, sign, (sign)*(k)); \ 43 if ((q)->n==0) {p1->n = 0; return POLY_CLIP_OUT;} \ 44 SWAP(p, q, r); \ 45 } 46 47 /* 48 * poly_clip_to_halfspace: clip convex polygon p against a plane, 49 * copying the portion satisfying sign*s[index] < k*sw into q, 50 * where s is a Poly_vert* cast as a float*. 51 * index is an index into the array of floats at each vertex, such that 52 * s[index] is sx, sy, or sz (screen space x, y, or z). 53 * Thus, to clip against xmin, use 54 * poly_clip_to_halfspace(p, q, XINDEX, -1., -xmin); 55 * and to clip against xmax, use 56 * poly_clip_to_halfspace(p, q, XINDEX, 1., xmax); 57 */ 58 59 void poly_clip_to_halfspace(Poly* p, Poly* q, int index, float sign, float k) 60 { 61 float *up, *vp, *wp; 62 Poly_vert *v; 63 int i; 64 Poly_vert *u; 65 float t, tu, tv; 66 67 q->n = 0; 68 69 /* start with u=vert[n-1], v=vert[0] */ 70 u = &p->vert[p->n-1]; 71 tu = sign*COORD(u, index) - u->sw*k; 72 for (v= &p->vert[0], i=p->n; i>0; i--, u=v, tu=tv, v++) { 73 /* on old polygon (p), u is previous vertex, v is current vertex */ 74 /* tv is negative if vertex v is in */ 75 tv = sign*COORD(v, index) - v->sw*k; 76 if ((tu <= 0.0f) ^ (tv <= 0.0f)) { 77 /* edge crosses plane; add intersection point to q */ 78 t = tu/(tu-tv); 79 up = (float *)u; 80 vp = (float *)v; 81 wp = (float *)&q->vert[q->n].sx; 82 for(int i = 0; i < 4; i++, wp++, up++, vp++) { 83 *wp = *up+t*(*vp-*up); 84 } 85 q->n++; 86 } 87 if (tv<=0.0f) /* vertex v is in, copy it to q */ 88 q->vert[q->n++] = *v; 89 } 90 } 91 92 /* 93 * poly_clip_to_frustum: Clip the convex polygon p1 to the screen space frustum 94 * using the homogeneous screen coordinates (sx, sy, sz, sw) of each vertex, 95 * testing if v->sx/v->sw > box->x0 and v->sx/v->sw < box->x1, 96 * and similar tests for y and z, for each vertex v of the polygon. 97 * If polygon is entirely inside box, then POLY_CLIP_IN is returned. 98 * If polygon is entirely outside box, then POLY_CLIP_OUT is returned. 99 * Otherwise, if the polygon is cut by the box, p1 is modified and 100 * POLY_CLIP_PARTIAL is returned. 101 * 102 * Given an n-gon as input, clipping against 6 planes could generate an 103 * (n+6)gon, so POLY_NMAX in poly.h must be big enough to allow that. 104 */ 105 106 int poly_clip_to_frustum(Poly *p1) 107 { 108 int x0out = 0, x1out = 0, y0out = 0, y1out = 0, z0out = 0, z1out = 0; 109 int i; 110 Poly_vert *v; 111 Poly p2, *p, *q, *r; 112 113 /* count vertices "outside" with respect to each of the six planes */ 114 for (v=p1->vert, i=p1->n; i>0; i--, v++) { 115 float sw = v->sw; 116 if (v->sx < -sw) x0out++; /* out on left */ 117 if (v->sx > sw) x1out++; /* out on right */ 118 if (v->sy < -sw) y0out++; /* out on top */ 119 if (v->sy > sw) y1out++; /* out on bottom */ 120 if (v->sz < -sw) z0out++; /* out on near */ 121 if (v->sz > sw) z1out++; /* out on far */ 122 } 123 124 /* check if all vertices inside */ 125 if (x0out+x1out+y0out+y1out+z0out+z1out == 0) 126 return POLY_CLIP_IN; 127 128 /* check if all vertices are "outside" any of the six planes */ 129 if (x0out==p1->n || x1out==p1->n || y0out==p1->n || 130 y1out==p1->n || z0out==p1->n || z1out==p1->n) { 131 p1->n = 0; 132 return POLY_CLIP_OUT; 133 } 134 135 /* 136 * now clip against each of the planes that might cut the polygon, 137 * at each step toggling between polygons p1 and p2 138 */ 139 p = p1; 140 q = &p2; 141 if (x0out) CLIP_AND_SWAP(sx, -1.0f, -1.0f, p, q, r); 142 if (x1out) CLIP_AND_SWAP(sx, 1.0f, 1.0f, p, q, r); 143 if (y0out) CLIP_AND_SWAP(sy, -1.0f, -1.0f, p, q, r); 144 if (y1out) CLIP_AND_SWAP(sy, 1.0f, 1.0f, p, q, r); 145 if (z0out) CLIP_AND_SWAP(sz, -1.0f, -1.0f, p, q, r); 146 if (z1out) CLIP_AND_SWAP(sz, 1.0f, 1.0f, p, q, r); 147 148 /* if result ended up in p2 then copy it to p1 */ 149 if (p==&p2) 150 memcpy(p1, &p2, sizeof(Poly)-(POLY_NMAX-p2.n)*sizeof(Poly_vert)); 151 return POLY_CLIP_PARTIAL; 152 } 153 154 } // namespace android 155