                          TinyLocator 3.1 FOR WINDOWS
                         -----------------------------
                  By ON6MU, Guy Roels, (c)2001-2020 ON6MU
                               Aalst/Belgium

                    homepage: http://www.qsl.net/on6mu

                                FreeWare
		Beta-Testers: Frank K4FEG, 
                              Mary ON2DHT,
                                  v2.x
                              Nigel G4DCQ


SOME LEGAL STUFF...
-------------------
TinyLocator version 3.x is NOT public domain, but it is for free!!! 
There is no registration and no payment. The author keeps the copyright 
and all other rights. 
Permission to sell TinyLocator for profit is prohibited. Please contact the 
author for permission. 
Any support you can provide for UISS-projects and modules are greatly appreciated! 
If you decide to make a contribution for the UISS or MapView Project then please 
use my PayPal account at my website http://www.qsl.net/on6mu/ (or in About box)


It is not allowed to: 
--------------------- 
 - Modify or patch the program, or in any way disassemble or change anything. 
 - Distribute the program without all the matching files. 
 - Distribute the program under another name other than TINYLOCATOR*.* 
   only the extension (*.ARJ, *.LZH, *.ZIP and others) may vary. 
 - Ask for money other than the real costs of transport or postage. 
 - Asking for money for the program, part program, or copy of the program is 
   strictly forbidden, under this concept; the 5-dollar-a-disk principle IS 
   allowed. 


It is permitted to: 
------------------- 
 - Use this program freely 
 - Make as many copies as you like and give them away, if complete with: 
   TINYLOCATOR.EXE 
   TINYLOCATOR.INI 
   README.TXT 


AND UNALTERED! 
By using the program you accept these conditions. 
NO GUARANTEE ! 
It is your responsibility not to take any action that might breach any 
local regulations, regarding the purpose for which you use this program. 


HARDWARE/SOFTWARE REQUIREMENTS 
------------------------------ 
 * IBM compatible AT/PC 
 * 2 MB Ram 
 * Windows 95, 98, NT, 2000, Me, XP, windows 7/8/10



VERSIONS 
-------- 
 Version 3.1.1 = Bug fix release: 
                 when erasing the entire home and target list the visible entry wasn't cleared: fixed
                 the locator was added to the history list even when the locator was invalid: fixed
                 Google maps showed the wrong location when coordinates were negative and smaller than 1: fixed

 Version 3.1.0 = Show APRS compressed format
                 Tab's order fixed
                 pressing enter in home locator showed error when target locator was empty: fixed
                 some minor bugs fixed

 Version 3.0.1 = Default Home or Targetlocator was not saved when hitting Default-button:
                 fixed (Thanks Steve NM5SD)

 Version 3.0   = New: Converting locators now compatible with the extended 
                 Maidenhead locator (up to 10 digits)! 
                 New: Show location on Google Maps!
                 New: Degrees/minutes/seconds now have also the compass heading 
                 (NS/EW).
                 New: decimal coordinates now use negatives for West and South 
                 locations.
                 New: Calculate distance/direction: now shows latitude and longitude.
                 of the home-locator.
                 New: delete one item from the history lists
                 Distance calculation is no longer executed in the converter window.
                 Arrow keys allows you to move from home to target field & visa versa.
                 fix: enter key in home locator field does not go to target field (use
                 down arrow key instead): advantage for multiple home locators 
                 entries.
                 Focus remains in the home or target field respectively.
                 Bug in right-click option 'paste here' of the Maidenhead locator did
                 not work (pasted a 0). Fixed
                 Bug: some copy to clipboard functions did not work or copied the 
                 correct data properly: fixed
                 Remember screen position (optional to change in TiniLocator.ini and 
                 other parameters please read manual).
                 Some tooltips clarified and some added
                 Now users can Search through the manual.
                 Cosmetic changes
                 Several minor bug fixes and improvements

 Version 2.2   = Bug fix in calculation negative Degrees of longtitude/latitude
                 conversions.
                 Improved accuracy and minor bug fix in converting APRS string 
                 to longitudes/latitudes.
                 Extra right-click functions of the IARU Locator input field

 Version 2.1   = Spaces in IRAU locators are removed to prevent wrong locator
                 Some Copy-buttons did not copy the correct contents to the 
                 clipboard. 
                 Certain IARU locators in the entry of the target locator gave
                 wrong calculations (thanks Graham G3TCT for informing me)

 Version 2.0.1 = When home and target locator had 4 characters "1.#QNAN degrees"
                 was calculated instead of none

 Version 2.0   = Almost completely re-written from scratch 
                 Convert from and to: 
                 Decimal coordinates 
                 World coordinates (DMS) 
                 IARU-locator (Maidenhead) 
                 UI-View format coordinates (GPS) 
                 Optional 'Stay on Top' 
                 Stores history of home and target locators 
                 Copys each type of converted coordinates 
                 Clear ALL history's
                 Several bugs related to 1.2 solved 
                 Main .exe file renamed to Tinylocator.exe
 
 Version 1.2   = Includes a latitude/longitude to Maidenhead converter (and 
                 vice versa). 
                 Shows Klms and Miles in distance 
                 Optional parameters when parsing locators in batch (commandline) 

 Version 1.1   = Known as DHT-Locator: 
                 32-bit version 
                 Target locator gets the focus 

 Version 1.0   = Known as DHT-Locator: 
                 Main version in 16-bit (compatible with Windows 3.1) 


WHAT DOES THIS PROGRAM DO? 
-------------------------- 
 * It calculates the distance, azimuth, latitude and longitude 
   between two Maidenhead locators. 
 * Converts latitude/longitude coordinates to Maidenhead locator,UI-View & DMS 
 * Converts Maidenhead locator to latitude/longitude coordinates,UI-view & DMS 
 * Converts Decimal to DMS World coordinates, UI-View & Maidenhead coordinates 
 * Converts UI-View formats to DMS, decimal & Maidenhead locator 
 * Use it to paste coordinates on the clipboard by using commandline arguments 


RUNNING THE PROGRAM 
------------------- 
Click on 'TinyLocator.EXE' or on the TinyLocator Icon... 


THE LOCATOR 
----------- 
It allows you to calculate the direction and distance between two 
locators. SOUTH latitude and EAST longitude shown as negative numbers. 

This locator program calculates the distance, direction, azimuth, 
latitude and longitude between two Maidenhead locators used by Radio Hams'. 
A typical Maidenhead locator consists of 6 characters, example: JO20AW, JN11...
Type your (or any other) home locator in the locator box and type 
a target locator in the target box. Click on 'Calculate' or press 'ENTER' 
to see the direction and distance. 
The locator's you type in are stored temporarily in the drop-down boxes. 

DEFAULT = To save your 'Home'locator click on the 'DEFAULT' button and 
          the locator typed in the home box will be stored as your default. 

COPY =    The 'COPY 'button copies the 'Output window' to the clipboard. 


Maidenhead Locator 
------------------ 
The Maidenhead Grid Square system is a method of identifying any position 
on the globe.  The full 6-character grid square takes the form of two 
letters, two numbers, and two more letters (i.e. EM02DK, which is the same 
as latitude 3225'N, longitude 9941'W).  A grid square co-ordinate is 
obviously shorter and easier to state than latitude and longitude. 
Tinylocator also supports the 10 character grid identifier system.

A 6 character grid square co-ordinate is accurate to 1/12th of a 
degree (005') of longitude BY 1/24th of a degree (002'30") of latitude, 
which works out to 2.5 nautical miles North-to-South BY 5.0 nautical 
miles East-to-West at the equator.  A 4-character grid square is 
accurate to 1 degree of longitude BY 2 degrees of latitude, and a 
2-character grid square is accurate to 10 degrees of longitude BY 20 degrees 
of latitude.  The origin of the grid square co-ordinate system is 
the South Pole (latitude 90S, longitude indeterminate). 
Example: 
JO20AW 

As of version 3.0 TinyLocator also supports the extended Maindenhead locator
which can consist up to 10 digits, but only in "Convert Locator".
Example: JO20AW55AA

Note: TinyLocator will convert 10-digit Maidenhead locators to latitude and
longitude, but not visa versa!


World coordinates 
----------------- 
The latitude and longitude system is probably the best known way to 
designate geographic coordinates. It presents a location as two numbers. 
Latitude is the angle from the centre of the Earth to some east-west line 
on the Earth's surface. 
Longitude is the angle from the centre of the Earth to a north-south line 
on the Earth's surface. 
Latitude and longitude may be expressed as decimal degrees (DD) or 
as degrees, minutes, and seconds (DMS); the latter gives numbers in a 
format such as 4930'00"S & 1230'00"E. This is the format typically used 
in GPS devices (Global Positioning System). 

DMS = DegreesMinutes'Seconds 
--- 
Example: 
 Lat : 5056'15 
 Long:  42'30 

DD = Decimal Degrees 
-- 
Example: 
 Lat : 50.93N 
 Long:  4.041E 


UI-View Format 
-------------- 
Also based on the GPS system and on the World coordinates. 

APRS: Automatic Position Reporting System 
APRS is a system developed by Bob Bruninga, WB4APR, which uses amateur radio 
to transmit position reports, weather reports, and messages between users. 

Latitude - input your station latitude. The format is dd.mm.nn <N or S> 
Where "dd" is two digits for degrees, "mm" is two digits for minutes, and "nn" 
is two digits for decimal minutes. NOTE - decimal minutes, NOT seconds. 
Add an "N" (or S) for either North or South. 
Example of Latitude - 52.58.23N 

Longitude - input your station longitude. The format is ddd.mm.nn <E or W>. 
Where "ddd" is three digits for degrees, "mm" is two digits for minutes and "nn" 
is two digits for decimal minutes. NOTE - decimal minutes, NOT seconds. 
Add an "E" (or W) for either East or West. 
Example of Longitude - 000.02.77W 

Examples of a Lat/Long' expression in an APRS string: 
=5056.17N/00402.67E 
5056.17N/00402.67E 

The UI-View calculator accepts an APRS string with OR without a leading character,  =5056.17N/00402.67E or 5056.17N/00402.67E will both work fine. 

Mic-e format:
The Compressed format is shown using the default Home icon and no speed or direction.


PASTING FROM A RECEIVED BEACON TEXT 
----------------------------------- 
You can copy co-ordinates from a separate packet receiving program and 
paste them in to the 'UI-View Format box' for TinyLocator to calculate. 

Example: Must be a UI-View / UISS compatible beacon text. 

Fm G4DCQ-2 To CQ Via PCSAT-1* <UI pid=F0 Len=57 >[14:13:35] 
=5255.81N/00117.76EL...Hello Guy (Boss) de Nigel  {UISS52} 

Copy the "=5255.81N/00117.76E" part from a full beacon text and paste 
it in to the UI-View box in TinyLocator, click 'OK' 
The locator will calculate the IARU QRA Locator of the other station PLUS 
His or Her distance and bearing from your station, in an instant !!! 

Here again either "=5255.81N/00117.76E" OR "5255.81N/00117.76E" will work.


COMMANDLINE ARGUMENTS (batch) 
--------------------- 
To use the program as a batch-tool you can run the program with 
commandline arguments. It will paste the data on to the clipboard. 
The program will calculate the locators and paste those results on 
to the clipboard, when parsing the following commands: 
 TINYLOCATOR -c JO20AW 
 TINYLOCATOR JO20AW IO10BB 

When using commandline options the program won't 'display' itself. 

Examples: 
To paste the latitude and longitude from a Maidenhead locator on to 
the clipboard: 
TINYLOCATOR -c JO20AW 

 Result on clipboard: 
 JO20AW 
 Latitude:50.9375N 
 Longitude:4.041667E 
 World Latitude:5056'15 
 World Longitude:42'30 


To paste the distance, latitude and longitude, azimuth from 
home and target Maidenhead locators on to the clipboard: 
TINYLOCATOR JO20AW IO10BB 

 Result on clipboard: 
 Home locator:JO20AW 
 Target Locator:IO10BB 
 Distance: 1546 Km 
         : 965 Miles 
 Azimuth : 274 degrees 
 Latitude: 50.0625N 
 Longitude: 17.875W 


TINYLOCATOR.INI
---------------
This is an ASCI file that contains all program settings. 
If everything fails you can always delete the file and TinyLocator will use
the default settings.

There are a few settings you can change:
[RememberPosition]
 1 = to allow the program to remember its last position on the screen.
 0 =  disable (use Windows default position)
example:
[RememberPosition]
1

You can add your call or whatever to the title bar of the program:
Add your text behind the ';' character on the second line in the ini-file.
Example:
;MYCALL


AT LAST...THE END 
----------------- 
For the latest version please visit my homepage: 
http://www.qsl.net/on6mu 


Many greetings and God Bless! 

Guy, de ON6MU 




