Java tutorial
/* * Copyright 2009 Google Inc. * * Licensed under the Apache License, Version 2.0 (the "License"); you may not * use this file except in compliance with the License. You may obtain a copy of * the License at * * http://www.apache.org/licenses/LICENSE-2.0 * * Unless required by applicable law or agreed to in writing, software * distributed under the License is distributed on an "AS IS" BASIS, WITHOUT * WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied. See the * License for the specific language governing permissions and limitations under * the License. */ package com.google.android.apps.mytracks.fragments; import com.google.android.apps.mytracks.ChartView; import com.google.android.apps.mytracks.MyTracksApplication; import com.google.android.apps.mytracks.content.MyTracksLocation; import com.google.android.apps.mytracks.content.Sensor; import com.google.android.apps.mytracks.content.Sensor.SensorDataSet; import com.google.android.apps.mytracks.content.Track; import com.google.android.apps.mytracks.content.TrackDataHub; import com.google.android.apps.mytracks.content.TrackDataListener; import com.google.android.apps.mytracks.content.TrackDataType; import com.google.android.apps.mytracks.content.Waypoint; import com.google.android.apps.mytracks.stats.DoubleBuffer; import com.google.android.apps.mytracks.stats.TripStatisticsBuilder; import com.google.android.apps.mytracks.util.LocationUtils; import com.google.android.apps.mytracks.util.PreferencesUtils; import com.google.android.apps.mytracks.util.UnitConversions; import com.google.common.annotations.VisibleForTesting; import com.nogago.android.tracks.Constants; import com.nogago.android.tracks.R; import android.location.Location; import android.os.Bundle; import android.support.v4.app.Fragment; import android.view.LayoutInflater; import android.view.View; import android.view.ViewGroup; import android.view.ViewGroup.LayoutParams; import android.widget.ZoomControls; import java.util.ArrayList; import java.util.EnumSet; /** * A fragment to display track chart to the user. * * @author Sandor Dornbush * @author Rodrigo Damazio */ public class ChartFragment extends Fragment implements TrackDataListener { public static final String CHART_FRAGMENT_TAG = "chartFragment"; // Android reports 128 when the speed is invalid private static final int INVALID_SPEED = 128; private final DoubleBuffer elevationBuffer = new DoubleBuffer(Constants.ELEVATION_SMOOTHING_FACTOR); private final DoubleBuffer speedBuffer = new DoubleBuffer(Constants.SPEED_SMOOTHING_FACTOR); private final ArrayList<double[]> pendingPoints = new ArrayList<double[]>(); private TrackDataHub trackDataHub; // Stats gathered from the received data private double totalDistance = 0.0; private long startTime = -1L; private Location lastLocation = null; private double trackMaxSpeed = 0.0; // Modes of operation private boolean metricUnits = true; private boolean reportSpeed = true; private boolean chartByDistance = true; private boolean[] chartShow = new boolean[] { true, true, true, true, true, true }; // UI elements private ChartView chartView; private ZoomControls zoomControls; /** * A runnable that will enable/disable zoom controls and orange pointer as * appropriate and redraw. */ private final Runnable updateChart = new Runnable() { @Override public void run() { if (trackDataHub == null) { return; } zoomControls.setIsZoomInEnabled(chartView.canZoomIn()); zoomControls.setIsZoomOutEnabled(chartView.canZoomOut()); chartView.setShowPointer(isRecording()); chartView.invalidate(); } }; @Override public void onCreate(Bundle savedInstanceState) { super.onCreate(savedInstanceState); /* * Create a chartView here to store data thus won't need to reload all the * data on every onStart or onResume. */ chartView = new ChartView(getActivity()); }; @Override public View onCreateView(LayoutInflater inflater, ViewGroup container, Bundle savedInstanceState) { View view = inflater.inflate(R.layout.chart, container, false); zoomControls = (ZoomControls) view.findViewById(R.id.chart_zoom_controls); zoomControls.setOnZoomInClickListener(new View.OnClickListener() { @Override public void onClick(View v) { zoomIn(); } }); zoomControls.setOnZoomOutClickListener(new View.OnClickListener() { @Override public void onClick(View v) { zoomOut(); } }); return view; } @SuppressWarnings("deprecation") @Override public void onStart() { super.onStart(); ViewGroup layout = (ViewGroup) getActivity().findViewById(R.id.chart_view_layout); LayoutParams layoutParams = new LayoutParams(LayoutParams.FILL_PARENT, LayoutParams.FILL_PARENT); layout.addView(chartView, layoutParams); } @Override public void onResume() { super.onResume(); resumeTrackDataHub(); checkChartSettings(); getActivity().runOnUiThread(updateChart); } @Override public void onPause() { super.onPause(); pauseTrackDataHub(); } @Override public void onStop() { super.onStop(); ViewGroup layout = (ViewGroup) getActivity().findViewById(R.id.chart_view_layout); layout.removeView(chartView); } @Override public void onProviderStateChange(ProviderState state) { // We don't care. } @Override public void onCurrentLocationChanged(Location loc) { // We don't care. } @Override public void onCurrentHeadingChanged(double heading) { // We don't care. } @Override public void onSelectedTrackChanged(Track track, boolean isRecording) { // We don't care. } @Override public void onTrackUpdated(Track track) { if (track == null || track.getTripStatistics() == null) { trackMaxSpeed = 0.0; return; } trackMaxSpeed = track.getTripStatistics().getMaxSpeed(); } @Override public void clearTrackPoints() { totalDistance = 0.0; startTime = -1L; lastLocation = null; elevationBuffer.reset(); speedBuffer.reset(); pendingPoints.clear(); chartView.reset(); getActivity().runOnUiThread(new Runnable() { @Override public void run() { chartView.resetScroll(); } }); } @Override public void onNewTrackPoint(Location location) { if (LocationUtils.isValidLocation(location)) { double[] data = new double[ChartView.NUM_SERIES + 1]; fillDataPoint(location, data); pendingPoints.add(data); } } @Override public void onSampledOutTrackPoint(Location location) { if (LocationUtils.isValidLocation(location)) { // Still account for the point in the smoothing buffers. fillDataPoint(location, null); } } @Override public void onSegmentSplit() { // Do nothing. } @Override public void onNewTrackPointsDone() { chartView.addDataPoints(pendingPoints); pendingPoints.clear(); getActivity().runOnUiThread(updateChart); } @Override public void clearWaypoints() { chartView.clearWaypoints(); } @Override public void onNewWaypoint(Waypoint waypoint) { if (waypoint != null && LocationUtils.isValidLocation(waypoint.getLocation())) { chartView.addWaypoint(waypoint); } } @Override public void onNewWaypointsDone() { getActivity().runOnUiThread(updateChart); } @Override public boolean onUnitsChanged(boolean metric) { if (metricUnits == metric) { return false; } metricUnits = metric; chartView.setMetricUnits(metricUnits); getActivity().runOnUiThread(new Runnable() { @Override public void run() { chartView.requestLayout(); } }); return true; } @Override public boolean onReportSpeedChanged(boolean speed) { if (reportSpeed == speed) { return false; } reportSpeed = speed; chartView.setReportSpeed(reportSpeed); boolean chartShowSpeed = PreferencesUtils.getBoolean(getActivity(), R.string.chart_show_speed_key, PreferencesUtils.CHART_SHOW_SPEED_DEFAULT); setSeriesEnabled(ChartView.SPEED_SERIES, chartShowSpeed && reportSpeed); setSeriesEnabled(ChartView.PACE_SERIES, chartShowSpeed && !reportSpeed); getActivity().runOnUiThread(new Runnable() { @Override public void run() { chartView.requestLayout(); } }); return true; } /** * Checks the chart settings. */ private void checkChartSettings() { boolean needUpdate = false; if (chartByDistance != PreferencesUtils.getBoolean(getActivity(), R.string.chart_by_distance_key, PreferencesUtils.CHART_BY_DISTANCE_DEFAULT)) { chartByDistance = !chartByDistance; chartView.setChartByDistance(chartByDistance); reloadTrackDataHub(); needUpdate = true; } if (setSeriesEnabled(ChartView.ELEVATION_SERIES, PreferencesUtils.getBoolean(getActivity(), R.string.chart_show_elevation_key, PreferencesUtils.CHART_SHOW_ELEVATION_DEFAULT))) { needUpdate = true; } boolean chartShowSpeed = PreferencesUtils.getBoolean(getActivity(), R.string.chart_show_speed_key, PreferencesUtils.CHART_SHOW_SPEED_DEFAULT); if (setSeriesEnabled(ChartView.SPEED_SERIES, chartShowSpeed && reportSpeed)) { needUpdate = true; } if (setSeriesEnabled(ChartView.PACE_SERIES, chartShowSpeed && !reportSpeed)) { needUpdate = true; } if (setSeriesEnabled(ChartView.POWER_SERIES, PreferencesUtils.getBoolean(getActivity(), R.string.chart_show_power_key, PreferencesUtils.CHART_SHOW_POWER_DEFAULT))) { needUpdate = true; } if (setSeriesEnabled(ChartView.CADENCE_SERIES, PreferencesUtils.getBoolean(getActivity(), R.string.chart_show_cadence_key, PreferencesUtils.CHART_SHOW_CADENCE_DEFAULT))) { needUpdate = true; } if (setSeriesEnabled(ChartView.HEART_RATE_SERIES, PreferencesUtils.getBoolean(getActivity(), R.string.chart_show_heart_rate_key, PreferencesUtils.CHART_SHOW_HEART_RATE_DEFAULT))) { needUpdate = true; } if (needUpdate) { chartView.postInvalidate(); } } /** * Sets the series enabled value. * * @param index the series index * @param value the value * @return true if changed */ private boolean setSeriesEnabled(int index, boolean value) { if (chartShow[index] != value) { chartShow[index] = value; chartView.setChartValueSeriesEnabled(index, value); return true; } else { return false; } } /** * Resumes the trackDataHub. Needs to be synchronized because trackDataHub can be * accessed by multiple threads. */ private synchronized void resumeTrackDataHub() { trackDataHub = ((MyTracksApplication) getActivity().getApplication()).getTrackDataHub(); trackDataHub.registerTrackDataListener(this, EnumSet.of(TrackDataType.SELECTED_TRACK, TrackDataType.TRACKS_TABLE, TrackDataType.WAYPOINTS_TABLE, TrackDataType.TRACK_POINTS_TABLE, TrackDataType.SAMPLED_OUT_TRACK_POINTS, TrackDataType.PREFERENCE)); } /** * Pauses the trackDataHub. Needs to be synchronized because trackDataHub can * be accessed by multiple threads. */ private synchronized void pauseTrackDataHub() { trackDataHub.unregisterTrackDataListener(this); trackDataHub = null; } /** * Returns true if recording. Needs to be synchronized because trackDataHub * can be accessed by multiple threads. */ private synchronized boolean isRecording() { return trackDataHub != null && trackDataHub.isRecordingSelected(); } /** * Reloads the trackDataHub. Needs to be synchronized because trackDataHub can be * accessed by multiple threads. */ private synchronized void reloadTrackDataHub() { if (trackDataHub != null) { trackDataHub.reloadDataForListener(this); } } /** * To zoom in. */ private void zoomIn() { chartView.zoomIn(); zoomControls.setIsZoomInEnabled(chartView.canZoomIn()); zoomControls.setIsZoomOutEnabled(chartView.canZoomOut()); } /** * To zoom out. */ private void zoomOut() { chartView.zoomOut(); zoomControls.setIsZoomInEnabled(chartView.canZoomIn()); zoomControls.setIsZoomOutEnabled(chartView.canZoomOut()); } /** * Given a location, fill in a data point, an array of double[]. <br> * data[0] = time/distance <br> * data[1] = elevation <br> * data[2] = speed <br> * data[3] = pace <br> * data[4] = heart rate <br> * data[5] = cadence <br> * data[6] = power <br> * * @param location the location * @param data the data point to fill in, can be null */ @VisibleForTesting void fillDataPoint(Location location, double data[]) { double timeOrDistance = Double.NaN; double elevation = Double.NaN; double speed = Double.NaN; double pace = Double.NaN; double heartRate = Double.NaN; double cadence = Double.NaN; double power = Double.NaN; // TODO: Use TripStatisticsBuilder if (chartByDistance) { if (lastLocation != null) { double distance = lastLocation.distanceTo(location) * UnitConversions.M_TO_KM; if (metricUnits) { totalDistance += distance; } else { totalDistance += distance * UnitConversions.KM_TO_MI; } } timeOrDistance = totalDistance; } else { if (startTime == -1L) { startTime = location.getTime(); } timeOrDistance = location.getTime() - startTime; } elevationBuffer .setNext(metricUnits ? location.getAltitude() : location.getAltitude() * UnitConversions.M_TO_FT); elevation = elevationBuffer.getAverage(); if (lastLocation == null) { if (Math.abs(location.getSpeed() - INVALID_SPEED) > 1) { speedBuffer.setNext(location.getSpeed()); } } else if (TripStatisticsBuilder.isValidSpeed(location.getTime(), location.getSpeed(), lastLocation.getTime(), lastLocation.getSpeed(), speedBuffer) && (location.getSpeed() <= trackMaxSpeed)) { speedBuffer.setNext(location.getSpeed()); } speed = speedBuffer.getAverage() * UnitConversions.MS_TO_KMH; if (!metricUnits) { speed *= UnitConversions.KM_TO_MI; } pace = speed == 0 ? 0.0 : 60.0 / speed; if (location instanceof MyTracksLocation && ((MyTracksLocation) location).getSensorDataSet() != null) { SensorDataSet sensorDataSet = ((MyTracksLocation) location).getSensorDataSet(); if (sensorDataSet.hasHeartRate() && sensorDataSet.getHeartRate().getState() == Sensor.SensorState.SENDING && sensorDataSet.getHeartRate().hasValue()) { heartRate = sensorDataSet.getHeartRate().getValue(); } if (sensorDataSet.hasCadence() && sensorDataSet.getCadence().getState() == Sensor.SensorState.SENDING && sensorDataSet.getCadence().hasValue()) { cadence = sensorDataSet.getCadence().getValue(); } if (sensorDataSet.hasPower() && sensorDataSet.getPower().getState() == Sensor.SensorState.SENDING && sensorDataSet.getPower().hasValue()) { power = sensorDataSet.getPower().getValue(); } } if (data != null) { data[0] = timeOrDistance; data[1] = elevation; data[2] = speed; data[3] = pace; data[4] = heartRate; data[5] = cadence; data[6] = power; } lastLocation = location; } @VisibleForTesting ChartView getChartView() { return chartView; } @VisibleForTesting void setChartView(ChartView view) { chartView = view; } @VisibleForTesting void setTrackMaxSpeed(double value) { trackMaxSpeed = value; } @VisibleForTesting void setMetricUnits(boolean value) { metricUnits = value; } @VisibleForTesting void setReportSpeed(boolean value) { reportSpeed = value; } @VisibleForTesting void setChartByDistance(boolean value) { chartByDistance = value; } }