← Back to branch summary

~opensatnav-admins/opensatnav/nice-package-rename

« back to all changes in this revision

Viewing changes to src/org/opensatnav/contribute/content/TrackBuffer.java

Merge store-tracks-to-database branch into main

Show diffs side-by-side

added added

removed removed

Lines of Context:
src/org/opensatnav/contribute/content/TrackBuffer.java
 
1
/*
 
2
 * Copyright 2009 Google Inc.
 
3
 * 
 
4
 * Licensed under the Apache License, Version 2.0 (the "License"); you may not
 
5
 * use this file except in compliance with the License. You may obtain a copy of
 
6
 * the License at
 
7
 * 
 
8
 * http://www.apache.org/licenses/LICENSE-2.0
 
9
 * 
 
10
 * Unless required by applicable law or agreed to in writing, software
 
11
 * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT
 
12
 * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the
 
13
 * License for the specific language governing permissions and limitations under
 
14
 * the License.
 
15
 */
 
16
package org.opensatnav.contribute.content;
 
17
 
 
18
 
 
19
 
 
20
import org.opensatnav.contribute.content.OSNProvider;
 
21
import org.opensatnav.contribute.util.MyTracksUtils;
 
22
 
 
23
import android.location.Location;
 
24
 
 
25
/**
 
26
 * A buffer of Locations from a track.
 
27
 * This class contains some additional information about the loaded points.
 
28
 *
 
29
 * @author Sandor Dornbush
 
30
 */
 
31
public class TrackBuffer {
 
32
 
 
33
  /**
 
34
   * An array of location objects that are part of a track.
 
35
   */
 
36
  private final Location[] buffer;
 
37
 
 
38
  /**
 
39
   * The id of the last location read from the track.
 
40
   */
 
41
  private long lastLocationRead = 0;
 
42
 
 
43
  /**
 
44
   * The number of locations loaded into the buffer.
 
45
   */
 
46
  private int locationsLoaded = 0;
 
47
 
 
48
  /**
 
49
   * Create a TrackBuffer with size elements.
 
50
   *
 
51
   * @param size The size of the buffer
 
52
   */
 
53
  public TrackBuffer(int size) {
 
54
    buffer = new Location[size];
 
55
  }
 
56
 
 
57
  /**
 
58
   * Reset the track to a state with no locations.
 
59
   */
 
60
  public void reset() {
 
61
    resetAt(0);
 
62
  }
 
63
 
 
64
  /**
 
65
   * Reset the track at the given starting location id.
 
66
   */
 
67
  public void resetAt(long lastLocation) {
 
68
    lastLocationRead = lastLocation;
 
69
    locationsLoaded = 0;
 
70
  }
 
71
 
 
72
  public void setInvalid() {
 
73
    lastLocationRead = Integer.MAX_VALUE;
 
74
  }
 
75
 
 
76
  /**
 
77
   * @return The number of locations that can be stored in this buffer
 
78
   */
 
79
  public int getSize() {
 
80
    return buffer.length;
 
81
  }
 
82
 
 
83
  /**
 
84
   * @param index The index of the location to fetch
 
85
   * @return The location for the given index
 
86
   */
 
87
  public Location get(int index) {
 
88
    return buffer[index];
 
89
  }
 
90
 
 
91
  /**
 
92
   * Adds a location to the end of the buffer.
 
93
   * @param location The location to add.
 
94
   * @param id The id of the location to be added.
 
95
   */
 
96
  public void add(Location location, long id) {
 
97
    buffer[locationsLoaded++] = location;
 
98
    lastLocationRead = Math.max(lastLocationRead, id);
 
99
  }
 
100
 
 
101
  /**
 
102
   * @return The id of the last location loaded into the buffer
 
103
   */
 
104
  public long getLastLocationRead() {
 
105
    return lastLocationRead;
 
106
  }
 
107
 
 
108
  /**
 
109
   * @return The number of locations loaded into the buffer.
 
110
   */
 
111
  public int getLocationsLoaded() {
 
112
    return locationsLoaded;
 
113
  }
 
114
 
 
115
  /**
 
116
   * Finds the start location, i.e. the one which is the first point of a
 
117
   * segment with at least two points.
 
118
   *
 
119
   * @return the start location
 
120
   */
 
121
  public Location findStartLocation() {
 
122
    int numValidLocations = 0;
 
123
    for (int i = 0; i < getLocationsLoaded(); i++) {
 
124
      Location location = buffer[i];
 
125
      if (MyTracksUtils.isValidLocation(location)) {
 
126
        numValidLocations++;
 
127
        if (numValidLocations == 2) {
 
128
          return buffer[i - 1];
 
129
        }
 
130
      } else {
 
131
        numValidLocations = 0;
 
132
      }
 
133
    }
 
134
    return null;
 
135
  }
 
136
}