com.visioglobe.VisioSample.Blocks

Class VgMyNavigationHelper

java.lang.Object

com.visioglobe.VisioSample.Blocks.VgMyNavigationHelper

All Implemented Interfaces:

VgMyNavigationCreator

public class VgMyNavigationHelper
extends java.lang.Object
implements VgMyNavigationCreator

This class is a helper for natural navigation management. IMPLEMENTATION TIPS: Customize this class to internationalize your instructions text.

Field Summary

Fields

Modifier and Type	Field and Description
protected static java.lang.String[][]	cActionStringTable Action string table for localization
protected static java.lang.String[]	cLanguageStrings The language identifiers
protected static java.lang.String[][]	cNextActionStringTable Next action string table for localization (fr/en)
protected static int	cNumLanguages The number of supported languages
protected static java.lang.String[][]	cStringTable Link words string table for localization (fr/en)
protected static java.lang.String[][]	cTimeStringTable Time string table for localization (fr/en)

Constructor Summary

Constructors

Constructor and Description
VgMyNavigationHelper(Activity pActivity, VgSurfaceView pSurfaceView)

Method Summary

Methods

Modifier and Type	Method and Description
void	createNavigation(VgINavigationRequestParameters pParameters) This method requests that a navigation object is computed.
void	release() This method should be called when the activity dies to notify that we should release/unregister all VisioDevKit objects, and null out as much references on other objects as possible.
protected static java.lang.String	replaceTokens(java.lang.String pStringWithTokens, VgINavigationInstructionConstRefPtr pInstruction, VgINavigationInstructionConstRefPtr lNextInstr) Takes a language string with tokens, then replaces those tokens with contextual data.
static void	translateInstruction(VgINavigationInstructionConstRefPtr pInstruction, VgINavigationConstRefPtr mNavigation2, com.visioglobe.VisioSample.Blocks.VgMyNavigationHelper.VgTranslatedInstruction pTranslated, VgIMapModule pMapModule, int pLang) This static method is used to translate a navigation instruction into a detailed message, along with other instruction-related data.

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Detail

cLanguageStrings

protected static final java.lang.String[] cLanguageStrings

The language identifiers

cNumLanguages

protected static final int cNumLanguages

The number of supported languages

cActionStringTable

protected static final java.lang.String[][] cActionStringTable

Action string table for localization

cNextActionStringTable

protected static final java.lang.String[][] cNextActionStringTable

Next action string table for localization (fr/en)

cTimeStringTable

protected static final java.lang.String[][] cTimeStringTable

Time string table for localization (fr/en)

cStringTable

protected static java.lang.String[][] cStringTable

Link words string table for localization (fr/en)

Constructor Detail

VgMyNavigationHelper

public VgMyNavigationHelper(Activity pActivity,
                    VgSurfaceView pSurfaceView)

Method Detail

translateInstruction

public static void translateInstruction(VgINavigationInstructionConstRefPtr pInstruction,
                        VgINavigationConstRefPtr mNavigation2,
                        com.visioglobe.VisioSample.Blocks.VgMyNavigationHelper.VgTranslatedInstruction pTranslated,
                        VgIMapModule pMapModule,
                        int pLang)

This static method is used to translate a navigation instruction into a detailed message, along with other instruction-related data.

Parameters:

pInstruction - The instruction to translate.

mNavigation2 - The navigation object the instruction comes from.

pTranslated - A reference to the structure to feed with details.

pMapModule - The application's VgMapModule (needed for near places and floor heights).

pLang - The index of the language to use (see getLangId).

See Also:

VgMyNavigationHelper::getLangId

replaceTokens

protected static java.lang.String replaceTokens(java.lang.String pStringWithTokens,
                             VgINavigationInstructionConstRefPtr pInstruction,
                             VgINavigationInstructionConstRefPtr lNextInstr)

Takes a language string with tokens, then replaces those tokens with contextual data.

Parameters:

pStringWithTokens - The language string containing the tokens.

pInstruction - The current isntruction.

lNextInstr - The next instruction.

createNavigation

public void createNavigation(VgINavigationRequestParameters pParameters)

Description copied from interface: VgMyNavigationCreator

This method requests that a navigation object is computed.

Specified by:

createNavigation in interface VgMyNavigationCreator

Parameters:

pParameters - All the parameters required for the object to create a compute a VgINavigation.

release

public void release()

This method should be called when the activity dies to notify that we should release/unregister all VisioDevKit objects, and null out as much references on other objects as possible.

Specified by:

release in interface VgMyNavigationCreator