View Javadoc
1   /*
2    * Licensed to the Apache Software Foundation (ASF) under one or more
3    * contributor license agreements.  See the NOTICE file distributed with
4    * this work for additional information regarding copyright ownership.
5    * The ASF licenses this file to You under the Apache License, Version 2.0
6    * (the "License"); you may not use this file except in compliance with
7    * the License.  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  package org.apache.commons.geometry.euclidean.threed;
18  
19  import java.util.Iterator;
20  import java.util.stream.Stream;
21  
22  
23  /** Class used to construct {@link Bounds3D} instances representing the min and
24   * max points present in a {@link BoundarySource3D}. The implementation examines
25   * the vertices of each boundary in turn. Null is returned if any boundaries are
26   * infinite or no vertices are present.
27   */
28  final class BoundarySourceBoundsBuilder3D {
29  
30      /** Get a {@link Bounds3D} instance containing all vertices in the given boundary source.
31       * Null is returned if any encountered boundaries were not finite or no vertices were found.
32       * @param src the boundary source to compute the bounds of
33       * @return the bounds of the argument or null if no valid bounds could be determined
34       */
35      public Bounds3D getBounds(final BoundarySource3D src) {
36          final Bounds3D.Builder builder = Bounds3D.builder();
37  
38          try (Stream<PlaneConvexSubset> stream = src.boundaryStream()) {
39              final Iterator<PlaneConvexSubset> it = stream.iterator();
40  
41              PlaneConvexSubset boundary;
42              while (it.hasNext()) {
43                  boundary = it.next();
44  
45                  if (!boundary.isFinite()) {
46                      return null;
47                  }
48  
49                  builder.addAll(boundary.getVertices());
50              }
51          }
52  
53          return builder.hasBounds() ?
54                  builder.build() :
55                  null;
56      }
57  }