aboutsummaryrefslogtreecommitdiffstats
path: root/src/classes/com/sun/opengl/impl/nurbs/Knotvector.java
blob: c7c3d4578942491cfd7ec41cad1e41766aae8c61 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156
157
158
159
160
161
162
163
164
165
166
167
168
169
170
171
172
173
174
175
176
177
178
179
package com.sun.opengl.impl.glu.nurbs;

/*
 ** License Applicability. Except to the extent portions of this file are
 ** made subject to an alternative license as permitted in the SGI Free
 ** Software License B, Version 1.1 (the "License"), the contents of this
 ** file are subject only to the provisions of the License. You may not use
 ** this file except in compliance with the License. You may obtain a copy
 ** of the License at Silicon Graphics, Inc., attn: Legal Services, 1600
 ** Amphitheatre Parkway, Mountain View, CA 94043-1351, or at:
 **
 ** http://oss.sgi.com/projects/FreeB
 **
 ** Note that, as provided in the License, the Software is distributed on an
 ** "AS IS" basis, with ALL EXPRESS AND IMPLIED WARRANTIES AND CONDITIONS
 ** DISCLAIMED, INCLUDING, WITHOUT LIMITATION, ANY IMPLIED WARRANTIES AND
 ** CONDITIONS OF MERCHANTABILITY, SATISFACTORY QUALITY, FITNESS FOR A
 ** PARTICULAR PURPOSE, AND NON-INFRINGEMENT.
 **
 ** Original Code. The Original Code is: OpenGL Sample Implementation,
 ** Version 1.2.1, released January 26, 2000, developed by Silicon Graphics,
 ** Inc. The Original Code is Copyright (c) 1991-2000 Silicon Graphics, Inc.
 ** Copyright in any portions created by third parties is as indicated
 ** elsewhere herein. All Rights Reserved.
 **
 ** Additional Notice Provisions: The application programming interfaces
 ** established by SGI in conjunction with the Original Code are The
 ** OpenGL(R) Graphics System: A Specification (Version 1.2.1), released
 ** April 1, 1999; The OpenGL(R) Graphics System Utility Library (Version
 ** 1.3), released November 4, 1998; and OpenGL(R) Graphics with the X
 ** Window System(R) (Version 1.3), released October 19, 1998. This software
 ** was created using the OpenGL(R) version 1.2.1 Sample Implementation
 ** published by SGI, but has not been independently verified as being
 ** compliant with the OpenGL(R) version 1.2.1 Specification.
 */

/**
 * Knot vector used in curve specification
 * 
 * @author Tomas Hrasky
 * 
 */
public class Knotvector {

  /**
   * Tolerance used when comparing knots - when difference is smaller, knots
   * are considered equal
   */
  public static final float TOLERANCE = 1.0e-5f;

  /**
   * Maximum curve order
   */
  private static final int MAXORDER = 24;

  /**
   * Number of knots
   */
  int knotcount;

  /**
   * Number of control points' coordinates
   */
  int stride;

  /**
   * Curve order
   */
  int order;

  /**
   * Knots
   */
  float[] knotlist;

  /**
   * Makes new knotvector
   * 
   * @param nknots
   *            number of knots
   * @param stride
   *            number of ctrl points' corrdinates
   * @param order
   *            curve order
   * @param knot
   *            knots
   */
  public Knotvector(int nknots, int stride, int order, float[] knot) {
    // DONE
    init(nknots, stride, order, knot);
  }

  /**
   * Initializes knotvector
   * 
   * @param nknots
   *            number of knots
   * @param stride
   *            number of ctrl points' corrdinates
   * @param order
   *            curve order
   * @param knot
   *            knots
   */
  public void init(int nknots, int stride, int order, float[] knot) {
    // DONE
    this.knotcount = nknots;
    this.stride = stride;
    this.order = order;
    this.knotlist = new float[nknots];
    for (int i = 0; i < nknots; i++) {
      this.knotlist[i] = knot[i];
    }

  }

  /**
   * Validates knot vector parameters
   * 
   * @return knot vector validity
   */
  public int validate() {
    int kindex = knotcount - 1;
    if (order < 1 || order > MAXORDER) {
      return 1;
    }
    if (knotcount < 2 * order) {
      return 2;
    }
    if (identical(knotlist[kindex - (order - 1)], knotlist[order - 1])) {
      return 3;
    }
    for (int i = 0; i < kindex; i++) {
      if (knotlist[i] > knotlist[i + 1])
        return 4;
    }
    int multi = 1;
    for (; kindex >= 1; kindex--) {
      if (knotlist[kindex] - knotlist[kindex - 1] < TOLERANCE) {
        multi++;
        continue;
      }
      if (multi > order) {
        return 5;
      }
      multi = 1;
    }
    if (multi > order) {
      return 5;
    }

    return 0;
  }

  /**
   * Show specified message
   * 
   * @param msg
   *            message to be shown
   */
  public void show(String msg) {
    // TODO Auto-generated method stub
    //			System.out.println("TODO knotvector.show");

  }

  /**
   * Compares two knots for equality
   * 
   * @param a
   *            first knot
   * @param b
   *            second knot
   * @return knots are/are not equal
   */
  public static boolean identical(float a, float b) {
    return ((a - b) < TOLERANCE) ? true : false;
  }
}