| GPSTurbo Credits | |
| Programmed by Kevin Pickell Started: April 10, 2006, Current Build: Oct 6 2007 The Groundspeak Geocaching 4-box square logo is a registered Trademark of Groundspeak Inc. Used with Permission. All Rights Reserved. Cache icon graphics (c) 2005 Groundspeak Inc. Used with permission. Libraries/Code included in this program: kGUI: Build:Oct 6 2007 GPSBabel: 1.3.4-beta20070711 / Expat: expat_2.0.0 FreeType: 2.1.10 JpegLib: 6b PNGLib: 1.2.8 ZLIB: 1.2.3 Special thanks to: The GPSBabel team. John Mechalas for his Garmin IMG format documentation. Google Maps Center for Topographic Information Canada National Geophysical Data Center USA. geomagc 2005 Ed Williams, Great Circle Calculator Keld Helsgaun, LKH - traveling salesman heuristic. Clive, author of GSAK. |
| GPSTurbo | |
| GPSTurbo is a program for Geocachers that allows them to manage and plan their Geocaching outings. A quick overview of features include: Loading of Geocache waypoints from a GPX file, or any other file format supported by GPSBabel. Viewing Geocache Waypoints overlayed onto various maps Uploading and Downloading of waypoints and tracks to your GSPr Planning of Routes Printing of Maps and Waypoint lists Built in scripting language to automate repetitive tasks |
| Main Menu | |
|
| Filtered/Map | |
| Current Map This pulldown is used to select the desired map. Zoom This pull down can be used to quickly change the zoom level.. Zoom In / Zoom Out These buttons are used to zoom in and out of the current map. You can also use the keyboard CTRL + or Ctrl - to zoom in and out. Online This tickbox is used to tell GPSTurbo if you are currently online. When online, GPSTurbo will try and download map tiles for online maps if they are not already in the map tile cache. Map Position under Mouse This will show the current Lat / Lon position on the map under the mouse pointer. Current Filter / Current Database / Reverse / Search String These settings are used to select the filtered waypoints from the full waypoint list, which are then shown in the table below. To select using a filter, use the pull down menu to select the desired filter. To show all waypoints select the first entry in the filter pulldown (Show All) and make sure the Search String inputbox is empty. To only search in a particular database just use the Current Database pulldown to select the desired database. To show the Reverse results of any search just select the Reverse tickbox.To search the filtered results for a text string, just type the string to look for in the Search String box and press return. Filtered Results This shows the number of waypoints that match the current filter and the total number of waypoints in the full waypoint list. Current Center Position You can set a current center position by Right Clicking on the Map and select this entry from the popup menu. This box will then show that current center position. The Dist column in the table below will show the distance between the current center position and the position for each waypoint entry in the table. Near Distance You can set a near distance ( it is in the current map units that you can see in the bottom right corner of the map and if desired you can change it on the draw settings page ). The Near column in the table below will then show the number of waypoints ( in the filtered results ) that are within that distance of each waypoint. If desired you can then sort the filtered results table by the Near column and this can be helpful for finding areas with a large concentation of waypoints that are close to each other. GPS18 - Connect / Track / Position This is still under development, when selected GPSTurbo will connect to a Garmin GPS18 and track your current position. Selecting the first tickbox (Connect) will initialize communication with the GPS18 and when connected will show the current position in the Position boxes. Selecting the second tickbox (Track) will make the map follow the GPS18's current position. Filtered Waypoint Results Table This table shows the current filtered results from the full waypoint list. Double clicking on a label on the map will move the cursor on the filtered results table to that waypoint. Right click on the waypoint name for a options menu. Double click on the waypoint name to center the map at that position. You can adjust the column widths by clicking on the column headers and dragging left or right. You can change column width, hide and show columns and reorder them by right clicking on the top left table box and using the popup menu to make the desired changes. Right clicking on the column header will open a popup menu with the following options:
Drag Bar Click and move the Drag Bar up and down to adjust the relative sizes of the Table and Map. Map This is the area where the current map is displayed. Right Clicking on the map will bring up a popup menu. If there are multiple waypoint labels under the mouse pointer position, then a menu will appear showing all Waypoint names near the mouse pointer for you to select the desired one.
|
| Routes | |
| Up / Dn These buttons are for re-ordering the waypoints in the current route. Just click on the desired row to move, then press the Up or Down buttons to move it up or down in the list. Auto Order This button will re-order the route using a Traveling Salesman heuristic to calculate the shortest route that connects all points in the route. It starts at the first point in the list so you need to manually move the starting point to the top of the list if it is not already there. For long routes this function can take a minute or more. Currently the distances between waypoints are a straight line with no consequence for crossing water etc. In a future version this will use road routing to calculate the distances between waypoints. Current Route This pulldown is used to select the route to be viewed or edited. To make a new route just select the first entry (New Route) and then add Waypoints to it. If the current route has changes made to it then you will not be able to change this pull down to another route until you either saved the changes in the current route or cancelled ( using undo ) the changes. Save Route After adding Waypoints to a New Route click this button to assign a name to your newly created route. . Or press to save changes to an existing route. Undo Changes This will remove all changes to the current route since it was last saved. Delete Route This will delete the current route from the list of routes. Rename Route This will allow you to change the current route's name. Copy Route This will allow you to make a copy of the current route. |
| Tracks | |
| Up / Dn These buttons are for re-ordering the waypoints in the current track. Just click on the desired row to move, then press the Up or Down buttons to move it up or down in the list. Current Track This pulldown is used to select the track to be viewed or edited. To make a new track just select the first entry (New Track) and then add Waypoints to it. If the current track has changes made to it then you will not be able to change this pull down to another track until you either saved the changes in the current track or cancelled ( using undo ) the changes. Save Track After adding Waypoints to a New Track click this button to assign a name to your newly created track. Or press to save changes to an existing track. Undo Changes This will remove all changes to the current track since it was last saved. Delete Track This will delete the current track from the list of tracks. Rename Track This will allow you to change the current track's name. Copy Track This will allow you to make a copy of the current track. Simplify Track This will allow you to reduce the number of points in the track. A input box will appear, just type in the number of points you want the track reduced to and it will reduce it down to that many points as best it can. Draw Track This tickbox, when selected will show the track on the main map screen. Track Color This is the color that the track will be drawn with on the main map screen. Double Clicking Double clicking on either the Lat or Lon field in the track points table will center the map on that position and switch to the main map screen. Creating Areas You can also use the tracks to create Areas for use in filters. For example: If you have two islands very close by and want to have a filter that only shows wayponts on one of the islands then you can do the following. Right click on the map and select add point to track 'New Track' and do this over and over, creating a perimiter around one of the islands ( it will assume that the last point connects back to the first). When done, save the track and call it 'island1'. Then in your desired filter, add Position is inside island1 to the list of filter commands and the filter will now only return results inside the desired area. |
| Lines | |
| Lines are lists of primitves that you can use to draw lines, arcs and circles as overlays on the current map. The lines draw processor starts at the top of the list of primitives and works it's way down the list. Draw primitives like Line, Circle and Arc use previously defined values for their drawing, so things like distance and radius must be defined before them in the list. Up / Dn These buttons are for re-ordering the entries in the current lines table. Just click on the desired row to move, then press the Up or Down buttons to move it up or down in the list. Current Lines This pulldown is used to select the lines group to be viewed or edited. To make a new lines group just select the first entry (New Lines) and then add Waypoints to it. If the current lines group has changes made to it then you will not be able to change this pull down to another lines group until you either saved the changes in the current lines group or cancelled ( using undo ) the changes. Save Lines After adding entries to the lines table New Lines click this button to assign a name to your newly created lines group. Or press to save changes to an existing lines group. Undo Changes This will remove all changes to the current lines group since it was last saved. Delete Lines This will delete the current lines group from the list of lines. Rename Lines This will allow you to change the current lines group's name. Copy Lines This will allow you to make a copy of the current lines group. Draw Lines This tickbox, when selected will show the lines group on the main map screen. Line Table Primitives This table shows the entries in the current lines group. To add new entries just click on the * on the bottom row and then change the row values as desired. To delete a row just click on the selector on the left of the row and press the delete key. After adding an entry to the table, just change the type by using the combobox in the first column.
|
| Filters | |
| Current Filter This pulldown is used to select the filter to be viewed or edited. To make a new Filter just select the first entry (New Filter) and then add rows to it by clicking on the bottom row in the table. If the current filter has changes made to it then you will not be able to change this pull down to another filter until you either saved the changes in the current filter or cancelled ( using undo ) the changes. Save Filter After adding rows to a New Filter click this button to assign a name to your newly created Filter. Or press to save changes to an existing filter. Undo Changes This will remove all changes to the current Filter since it was last saved. Delete Filter This will delete the current Filter from the list of Filters. Rename Filter This will allow you to change the current Filter's name. Copy Filter This will allow you to make a copy of the current Filter. Filter Entries Table This table shows the entries in the current filter. To add new entries just click on the * on the bottom row and then change the row values as desired. To delete a row just click on the selector on the left of the row and press the delete key. Each row in the filter is logically and'ed so all entries need to be True for a Waypoint to be in the filtered results. |
| Draw Settings | |
| Up / Dn These buttons are for re-ordering the label colors in the table below. Just click on the desired row to move, then press the Up or Down buttons to move it up or down in the list. Label Color Table This table is used to assign different colors to the Waypoint Labels drawn on the Map. To add new entries just click on the * on the bottom row and then change the row values as desired. To delete a row just click on the selector on the left of the row and press the delete key. The first column will list the filter to use and the next column will contain the color to draw the label on the map. When assigning colors to the labels the program starts at the top of this list and uses the color for the first entry that matches the selected filter. The third column is just for informational purposes and shows the number of labels that match that filter at that point in the list. Map Paths This table is used to list the paths to maps to use. You can add multiple paths to the table. If you have any Garmin IMG maps installed then typically they are installed in the C:\Garmin\ directory so adding this path to the table would allow you to use these maps. You can manually edit the path fields in each table entry, or click on the ... Button and use a file requestor to select the map directory. Font Size for Waypoint Labels on Map This is the point size to use for drawing Labels on the map. Number of User Ticks to show beside Label on Map This is how many user tick boxes are drawn to the left of the Label. (The leftmost tickbox would be UserTick1, then UserTick2 etc.) Waypoint Name to use on Map This is where you define the Label format for what will appear on the Map for each Waypoint. This string can contain static text intermixed with text from the various columns from the waypoint table. To insert text from a particular column just place a period '.' followed immediately by the column name. Use the abbreviated spelling that is used on the comumn headers of the Filtered Results table. Show Labels for Additional Waypoints on Map When ticked, Child Waypoints ( typically Parking or Trailhead Coordinates ) are also drawn on the map. Move overlapping Labels When ticked, any Labels that overlap another Label are moved down to the next available space and a line is drawn to show where the Label should have been. Move overlapping Labels, Maximum number of pixels When Labels are moved, this is the maximum distance (in pixels) to move them before giving up and drawing them at their original (overlapping) position. Zoom level to start drawing Labels at The Map Zoom level starts at 1 for the highest zoomed out level and increases as the map is zoomed in. If the zoom level is less than the number in this inputbox then Labels are not drawn on the Map. Distance Units This is used to select which type of distance units are shown in the Filtered Waypoint Results table for the Dist (distance from centerpoint) column, it is also the units drawn on the bottom right of the Map. |
| GPSRs | |
| GPSr Table Use the table to define the various GPSr settings for the GPSrs that you have. Current GPSr Use this pulldown to select the GPSr to use when Uploading or Downloading. Upload Waypoints to GPSr Press to upload the filtered waypoints to the current GPSr. If the current filtered results contain more waypoints than the current GPSr can handle it will only upload the maximum number of waypoints starting at the top of the table. For example if your GPSr can only handle 500 waypoints and your filtered results have 2600 waypoints then only the first 500 in the table will be uploaded. To force a particular area of waypoints to be uploaded you can use the Set Center Point function ( from the main map screen ) to set a center point to the area you wish to upload and then sort the waypoint results based on the distance from that centerpoint. That way the waypoints nearest your centerpoint will be at the top of the filtered results table and will be uploaded first. Many GPSrs do not have any error reporting back to the computer if their waypoint tables are full. After uploading it will download the points from the GPSr to verify that the points were uploaded corectly. If any points were not found then it will list them in a popup window and you will need to manually delete old waypoints from your GPSr to free up space. Download Waypoints from GPSr Press to download waypoints from the current GPSr. Matching waypoints found in the full waypoints list will be skipped as they already exist, new waypoints will be added to the waypoints table as USER waypoints and named USER_XXX where XXX is a unique number. Upload Tracks to GPSr Press to upload Tracks to the current GPSr. A popup menu will appear showing all of the tracks, just tick the ones you want to upload. After uploading it will automatically download them from the GPSr to verify if they were uploaded correctly. Some GPSrs have a limit on the number of points allowed in a track so you might get an error message like Track 'xxx' only the first 500 of the 2600 points were uploaded. In this case you need to reduce the number of points in that track to the number that it reported. On the track page just use the Simplify Track button to reduce the number of points in that track. Download Tracks from GPSr Press to download Tracks from the current GPSr. A popup window will appear showing the tracks on the GPSr, just select the tickbox beside each track you wish to download. |
| Solver | |
|
| Stickers | |
| Stickers are sometimes used to place on geocache logbooks instead of signing them. Currently it only supports 1 label size and that is the Avery labels that are 80 stickers on a sheet ( 20 rows of 4 ), the stickers themselves are 1.75" x .5" You can use the primitives in the sticker table below to define your sticker art, or you can have your sticker made in advance (using your own art program like Photoshop), the size should be 350 pixels wide by 100 pixels tall and then just add one entry to the table to load the image file. Current Sticker This pulldown is used to select the Sticker to be viewed or edited. To make a new Sticker just select the first entry (New Sticker) and then add rows to it by clicking on the bottom row in the table. If the current Sticker has changes made to it then you will not be able to change this pull down to another Sticker until you either saved the changes in the current Sticker or cancelled ( using undo ) the changes. Save Sticker After adding rows to a New Sticker click this button to assign a name to your newly created Sticker. Or press to save changes to an existing sticker. Undo Changes This will remove all changes to the current Sticker since it was last saved. Delete Sticker This will delete the current Sticker from the list of Stickers. Rename Sticker This will allow you to change the current Sticker's name. Copy Sticker This will allow you to make a copy of the current Sticker. Print Sticker This will open a print preview screen showing the full page of stickers. You can then print it by clicking the print button. Sticker Entries Table This table shows the entries in the current Sticker. To add new entries just click on the * on the bottom row and then change the row values as desired. To delete a row just click on the selector on the left of the row and press the delete key. Each table entry is for a draw primitive object to be drawn on the label. For each table entry use the pull down menu in the first column to select the primitive type. For a text entry, select the color using the pull down, then the x & y pixel positions (w & h are not used) then the font size to use and finally the text to draw. For a image entry, set the x & y pixel positions (w & h are not used) then the size is a scale factor to resize the image then and finally the text box should contain the filename for the image. If you double click on the filename box you can use a file requestor to select the image. For a rectangle entry, select the color and then the x & y pixel positions and w & h pixels sizes for the rectangle. |
| Basic | |
| For scripting repetitive tasks you can write your own code using a variant of Basic called kBasic. The syntax and built-in commands are described further down in the instructions. Start Press this button to run a Basic Subroutine. When pressed, a popup menu will appear showing all Public Subroutines that don't take any parameters. Abort When a Basic program is running you may press Abort to stop execution. Source Code InputBox This input box is where you can write your own Basic Subroutines and Functions. |