com.mousebird.maply

Class GlobeMapFragment

java.lang.Object

androidx.fragment.app.Fragment

com.mousebird.maply.GlobeMapFragment

All Implemented Interfaces:

android.content.ComponentCallbacks, android.view.View.OnCreateContextMenuListener, androidx.lifecycle.LifecycleOwner, androidx.lifecycle.ViewModelStoreOwner, GlobeController.GestureDelegate, MapController.GestureDelegate

public class GlobeMapFragment
extends androidx.fragment.app.Fragment
implements MapController.GestureDelegate, GlobeController.GestureDelegate

A fragment that instantiates either a map or a globe. You subclass this and fill in the various stubs to implement your own map or globe.

Nested Class Summary

Nested Classes

Modifier and Type	Class and Description
static class	GlobeMapFragment.MapDisplayType

Nested classes/interfaces inherited from class androidx.fragment.app.Fragment

androidx.fragment.app.Fragment.InstantiationException, androidx.fragment.app.Fragment.SavedState

Field Summary

Fields

Modifier and Type	Field and Description
protected BaseController	baseControl
protected GlobeController	globeControl
protected GlobeController.Settings	globeSettings
protected MapController	mapControl
protected GlobeMapFragment.MapDisplayType	mapDisplayType
protected MapController.Settings	mapSettings

Constructor Summary

Constructors

Constructor and Description
GlobeMapFragment()

Method Summary

Modifier and Type	Method and Description
protected GlobeMapFragment.MapDisplayType	chooseDisplayType() Override this to tell the fragment you want either a map or a globe.
protected void	controlHasStarted() Override this to be called when the control is up and running.
void	globeDidMove(GlobeController globeControl, Point3d[] corners, boolean userMotion) Called for every single visible frame of movement.
void	globeDidStartMoving(GlobeController globeControl, boolean userMotion) Called when the globe first starts moving.
void	globeDidStopMoving(GlobeController globeControl, Point3d[] corners, boolean userMotion) Called when the globe stops moving.
java.lang.String	loadLibraryName() Override this if you've got a different name for the core WG-Maply library.
void	mapDidMove(MapController mapControl, Point3d[] corners, boolean userMotion) Called for every single visible frame of movement.
void	mapDidStartMoving(MapController mapControl, boolean userMotion) Called when the map first starts moving.
void	mapDidStopMoving(MapController mapControl, Point3d[] corners, boolean userMotion) Called when the map stops moving.
android.view.View	onCreateView(android.view.LayoutInflater inflater, android.view.ViewGroup container, android.os.Bundle inState) This is the standard onCreateView() for the fragment.
void	onDestroy()
void	onDestroyView() This is the standard fragment onDestroyView().
void	onPause()
void	onResume()
void	onSaveInstanceState(android.os.Bundle outState) The standard fragment onSaveInstanceState().
void	onViewStateRestored(android.os.Bundle inState) The standard fragment onRestoreInstanceState().
protected void	preControlCreated() Override this to be called right before the map or globe is created.
void	userDidLongPress(GlobeController globeControl, SelectedObject[] selObjs, Point2d loc, Point2d screenLoc) The user did long press somewhere, there might be an object
void	userDidLongPress(MapController mapController, SelectedObject[] selObjs, Point2d loc, Point2d screenLoc) The user long pressed somewhere, either on a selectable object or nor
void	userDidSelect(GlobeController globeControl, SelectedObject[] selObjs, Point2d loc, Point2d screenLoc) The user selected the given object.
void	userDidSelect(MapController mapControl, SelectedObject[] selObjs, Point2d loc, Point2d screenLoc) The user selected the given object.
void	userDidTap(GlobeController globeControl, Point2d loc, Point2d screenLoc) The user tapped somewhere, but not on a selectable object.
void	userDidTap(MapController mapControl, Point2d loc, Point2d screenLoc) The user tapped somewhere, but not on a selectable object.
void	userDidTapOutside(GlobeController globeControl, Point2d screenLoc) The user tapped outside the globe.

Methods inherited from class androidx.fragment.app.Fragment

dump, equals, getActivity, getAllowEnterTransitionOverlap, getAllowReturnTransitionOverlap, getArguments, getChildFragmentManager, getContext, getEnterTransition, getExitTransition, getFragmentManager, getHost, getId, getLayoutInflater, getLayoutInflater, getLifecycle, getLoaderManager, getParentFragment, getReenterTransition, getResources, getRetainInstance, getReturnTransition, getSharedElementEnterTransition, getSharedElementReturnTransition, getString, getString, getTag, getTargetFragment, getTargetRequestCode, getText, getUserVisibleHint, getView, getViewLifecycleOwner, getViewLifecycleOwnerLiveData, getViewModelStore, hashCode, hasOptionsMenu, instantiate, instantiate, isAdded, isDetached, isHidden, isInLayout, isMenuVisible, isRemoving, isResumed, isStateSaved, isVisible, onActivityCreated, onActivityResult, onAttach, onAttach, onAttachFragment, onConfigurationChanged, onContextItemSelected, onCreate, onCreateAnimation, onCreateAnimator, onCreateContextMenu, onCreateOptionsMenu, onDestroyOptionsMenu, onDetach, onGetLayoutInflater, onHiddenChanged, onInflate, onInflate, onLowMemory, onMultiWindowModeChanged, onOptionsItemSelected, onOptionsMenuClosed, onPictureInPictureModeChanged, onPrepareOptionsMenu, onRequestPermissionsResult, onStart, onStop, onViewCreated, postponeEnterTransition, registerForContextMenu, requestPermissions, requireActivity, requireContext, requireFragmentManager, requireHost, setAllowEnterTransitionOverlap, setAllowReturnTransitionOverlap, setArguments, setEnterSharedElementCallback, setEnterTransition, setExitSharedElementCallback, setExitTransition, setHasOptionsMenu, setInitialSavedState, setMenuVisibility, setReenterTransition, setRetainInstance, setReturnTransition, setSharedElementEnterTransition, setSharedElementReturnTransition, setTargetFragment, setUserVisibleHint, shouldShowRequestPermissionRationale, startActivity, startActivity, startActivityForResult, startActivityForResult, startIntentSenderForResult, startPostponedEnterTransition, toString, unregisterForContextMenu

Methods inherited from class java.lang.Object

clone, finalize, getClass, notify, notifyAll, wait, wait, wait

Field Detail

mapControl

protected MapController mapControl

globeControl

protected GlobeController globeControl

baseControl

protected BaseController baseControl

mapDisplayType

protected GlobeMapFragment.MapDisplayType mapDisplayType

globeSettings

protected GlobeController.Settings globeSettings

mapSettings

protected MapController.Settings mapSettings

Constructor Detail

GlobeMapFragment

public GlobeMapFragment()

Method Detail

chooseDisplayType

protected GlobeMapFragment.MapDisplayType chooseDisplayType()

Override this to tell the fragment you want either a map or a globe.

loadLibraryName

public java.lang.String loadLibraryName()

Override this if you've got a different name for the core WG-Maply library.

preControlCreated

protected void preControlCreated()

Override this to be called right before the map or globe is created. This is where you can mess with the globe or map settings.

controlHasStarted

protected void controlHasStarted()

Override this to be called when the control is up and running. There are many calls to the map or globe controller you shouldn't make until it has its OpenGL surface set up. This is where you make those calls. This will be on the main thread.

onCreateView

public android.view.View onCreateView(android.view.LayoutInflater inflater,
                                      android.view.ViewGroup container,
                                      android.os.Bundle inState)

This is the standard onCreateView() for the fragment. If you override it, be sure to call this one too. It does all the setup for the globe or map.

Overrides:

onCreateView in class androidx.fragment.app.Fragment

onSaveInstanceState

public void onSaveInstanceState(android.os.Bundle outState)

The standard fragment onSaveInstanceState(). The GlobeMapFragment is doing nothing at this point.

Overrides:

onSaveInstanceState in class androidx.fragment.app.Fragment

onViewStateRestored

public void onViewStateRestored(android.os.Bundle inState)

The standard fragment onRestoreInstanceState(). The GlobeMapFragment is doing nothing at this point.

Overrides:

onViewStateRestored in class androidx.fragment.app.Fragment

Parameters:

inState -

onPause

public void onPause()

Overrides:

onPause in class androidx.fragment.app.Fragment

onResume

public void onResume()

Overrides:

onResume in class androidx.fragment.app.Fragment

onDestroyView

public void onDestroyView()

This is the standard fragment onDestroyView(). The GlobeMapFragment calls the controller shutdown here, so be sure to call it if you override this.

Overrides:

onDestroyView in class androidx.fragment.app.Fragment

onDestroy

public void onDestroy()

Overrides:

onDestroy in class androidx.fragment.app.Fragment

userDidSelect

public void userDidSelect(MapController mapControl,
                          SelectedObject[] selObjs,
                          Point2d loc,
                          Point2d screenLoc)

The user selected the given object. Up to you to figure out what it is.

Specified by:

userDidSelect in interface MapController.GestureDelegate

Parameters:

mapControl - The maply controller this is associated with.

selObjs - The objects the user selected (e.g. MaplyScreenMarker).

loc - The location they tapped on. This is in radians.

screenLoc - The location on the OpenGL surface.

userDidTap

public void userDidTap(MapController mapControl,
                       Point2d loc,
                       Point2d screenLoc)

The user tapped somewhere, but not on a selectable object.

Specified by:

userDidTap in interface MapController.GestureDelegate

Parameters:

mapControl - The maply controller this is associated with.

loc - The location they tapped on. This is in radians.

screenLoc - The location on the OpenGL surface.

userDidLongPress

public void userDidLongPress(MapController mapController,
                             SelectedObject[] selObjs,
                             Point2d loc,
                             Point2d screenLoc)

The user long pressed somewhere, either on a selectable object or nor

Specified by:

userDidLongPress in interface MapController.GestureDelegate

Parameters:

mapController - The maply controller this is associated with.

selObjs - The objects (e.g. MaplyScreenMarker) that the user long pressed or null if there was none

loc - The location they tapped on. This is in radians.

screenLoc - The location on the OpenGL surface.

mapDidStartMoving

public void mapDidStartMoving(MapController mapControl,
                              boolean userMotion)

Called when the map first starts moving.

Specified by:

mapDidStartMoving in interface MapController.GestureDelegate

Parameters:

mapControl - The map controller this is associated with.

userMotion - Set if the motion was caused by a gesture.

mapDidStopMoving

public void mapDidStopMoving(MapController mapControl,
                             Point3d[] corners,
                             boolean userMotion)

Called when the map stops moving.

Specified by:

mapDidStopMoving in interface MapController.GestureDelegate

Parameters:

mapControl - The map controller this is associated with.

corners - Corners of the viewport. If one of them is null, that means it doesn't land anywhere valid.

userMotion - Set if the motion was caused by a gesture.

mapDidMove

public void mapDidMove(MapController mapControl,
                       Point3d[] corners,
                       boolean userMotion)

Called for every single visible frame of movement. Be careful what you do in here.

Specified by:

mapDidMove in interface MapController.GestureDelegate

Parameters:

mapControl - The map controller this is associated with.

corners - Corners of the viewport. If one of them is null, that means it doesn't land anywhere valid.

userMotion - Set if the motion was caused by a gesture.

userDidSelect

public void userDidSelect(GlobeController globeControl,
                          SelectedObject[] selObjs,
                          Point2d loc,
                          Point2d screenLoc)

The user selected the given object. Up to you to figure out what it is.

Specified by:

userDidSelect in interface GlobeController.GestureDelegate

Parameters:

globeControl - The maply controller this is associated with.

selObjs - The objects the user selected (e.g. MaplyScreenMarker).

loc - The location they tapped on. This is in radians.

screenLoc - The location on the OpenGL surface.

userDidTap

public void userDidTap(GlobeController globeControl,
                       Point2d loc,
                       Point2d screenLoc)

The user tapped somewhere, but not on a selectable object.

Specified by:

userDidTap in interface GlobeController.GestureDelegate

Parameters:

globeControl - The maply controller this is associated with.

loc - The location they tapped on. This is in radians. If null, then the user tapped outside the globe.

screenLoc - The location on the OpenGL surface.

userDidTapOutside

public void userDidTapOutside(GlobeController globeControl,
                              Point2d screenLoc)

The user tapped outside the globe.

Specified by:

userDidTapOutside in interface GlobeController.GestureDelegate

Parameters:

globeControl - The maply controller this is associated with.

screenLoc - The location on the OpenGL surface.

userDidLongPress

public void userDidLongPress(GlobeController globeControl,
                             SelectedObject[] selObjs,
                             Point2d loc,
                             Point2d screenLoc)

The user did long press somewhere, there might be an object

Specified by:

userDidLongPress in interface GlobeController.GestureDelegate

Parameters:

globeControl - The maply controller this is associated with.

selObjs - The objects the user selected (e.g. MaplyScreenMarker) or null if there was no object.

loc - The location they tapped on. This is in radians. If null, then the user tapped outside the globe.

screenLoc - The location on the OpenGL surface.

globeDidStartMoving

public void globeDidStartMoving(GlobeController globeControl,
                                boolean userMotion)

Called when the globe first starts moving.

Specified by:

globeDidStartMoving in interface GlobeController.GestureDelegate

Parameters:

globeControl - The globe controller this is associated with.

userMotion - Set if the motion was caused by a gesture.

globeDidStopMoving

public void globeDidStopMoving(GlobeController globeControl,
                               Point3d[] corners,
                               boolean userMotion)

Called when the globe stops moving.

Specified by:

globeDidStopMoving in interface GlobeController.GestureDelegate

Parameters:

globeControl - The globe controller this is associated with.

corners - Corners of the viewport. If one of them is null, that means it doesn't land on the globe.

userMotion - Set if the motion was caused by a gesture.

globeDidMove

public void globeDidMove(GlobeController globeControl,
                         Point3d[] corners,
                         boolean userMotion)

Called for every single visible frame of movement. Be careful what you do in here.

Specified by:

globeDidMove in interface GlobeController.GestureDelegate

Parameters:

globeControl - The globe controller this is associated with.

corners - Corners of the viewport. If one of them is null, that means it doesn't land on the globe.

userMotion - Set if the motion was caused by a gesture.