GNavigia und sein Hintergrund

COM-Server für Hintergrundbilder bereitstellen

  {353899B1-448D-4d3b-876D-5F6BBF59BBB6}

Anforderung der Hintergrundbilder

Initialisierung des Menüs

Eigenschaften der Hintergrundbilder

Die IGpsBackgroundProviderAsync Schnittstelle

[InterfaceType(ComInterfaceType.InterfaceIsIDispatch)]
[Guid("4435F26B-7F4D-4732-AB01-0D2F98B24CE5")]
interface IGpsBackgroundProviderAsync
{
    // <summary>
    // 
    // </summary>
    // <param name="xmlDocument"></param>
    // <param name="userdata"></param>
    // <param name="hwnd"></param>
    // <param name="canvasWidth"></param>
    // <param name="canvasHeight"></param>
    // <param name="utmNorth"></param>
    // <param name="utmWest"></param>
    // <param name="utmSouth"></param>
    // <param name="utmEast"></param>
    void GpsGetBitmapExactAsync(string xmlDocument, object userdata, int hwnd,
                                int canvasWidth, int canvasHeight,
                                double utmNorth, double utmWest,
                                double utmSouth, double utmEast);
    // <summary>
    // If GNavigia uses a callback named TheImageCallback, than the server has to
    // invoke a call to "TheImageCallback" with the parameters userdata from the
    // GpsGetBitmapExactAsync call, the .NET Bitmap Image and a string that offers
    // an XML document. This string may be NULL if no data is to be transfered. If
    // the user specifies a copyright string, it is transfered in this string.
    // The callback:
    //   void TheImageCallback(object userdata, Image image, string xmlDocument)
    // </summary>
    // <param name="theCaller"></param>
    // <param name="GpsImageCallbackName"></param>
    void GpsSetImageCallback(object theCaller, string GpsImageCallbackName);
}

Bildermittlung starten

HttpWebRequest httpWebRequest = (HttpWebRequest)WebRequest.Create(mapUrl);
if (httpWebRequest == null)
  ...; // handle error.
httpWebRequest.BeginGetResponse(new MyAsyncCallback(AsyncResult), httpWebRequest);

private void MyAsyncResult(IAsyncResult asyncResultI)
{
  if (asyncResultI.IsCompleted)
  {
    HttpWebRequest request = (HttpWebRequest)asyncResultI.AsyncState;
    WebResponse webResponse = request.EndGetResponse(asyncResultI);
    if (webResponse != null)
      try
      {
        Stream stream = webResponse.GetResponseStream();
        if (stream != null)
        { // ACHTUNG: Nicht auf den Stream zugreifen!
          // Diese Zeile crashed mit der Meldung:
          // "Dieser Stream unterstützt keine Suchvorgänge."
          // long streamLength = stream.Length;
          Image image = new Bitmap(stream);
          if (image != null)
            m_theCaller.GetType().InvokeMember(m_callersCallbackName,
                       BindingFlags.InvokeMethod, null, m_theCaller,
                       new object[] { image, m_theCallersData, m_xmlDocument });
          stream.Close(); // Resourcenschonend, unser Beitrag zum Kyoto-Protokoll!
        }
      }  catch (Exception ex) { ...; }
   }
}

Das XML-Dokument

• Result, 0: Erfolg, andere Werte signalisieren einen Fehler. Diese Fehlernummer wird in angezeigt.
  
• Copyright (mehrzeilig, getrennt im Beispielprogramm durch senkrechten Strich), hier erfolgt eine automatische Ersetzung von (C), (R) und (at) durch die entsprechenden Sonderzeichen.
  

<?xml version=\"1.0\" encoding=\"ISO-8859-1\"?>
<GNavigiaBackgroundProvider>
  <Result>0</Result>
  <Error>
    <line>Alles Bestens!</line>
    <line>Result ist 0, das erfreut das Herz!</line>
  <Error>
  <Copyright>
    <line>Bilddaten: (C) LVermGeo Rheinland-Pfalz</line>
    <line>Freie topographische Rasterdatendienste</line>
    <line>poststelle(at)lvermgeo.rlp.de</line>
  </Copyright>
</GNavigiaBackgroundProvider>"

Exceptions

  Utilities.dll 

Transparenz

Koordinaten und Transformationen

  Mathematics.dll   
  Utilities.dll 

public GpsDlgTransformationen()
{
    string l = "6.144386528";
    string b = "50.799758619";
    UTM utm = new UTM("WGS 84");
    utm.SetNotifyCaller = new UTM.NotifyCaller(Notification);
    // Rechne Länge/Breite in UTM um. Eingabe in Dezimalaltgrad.
    listBox.Items.Add("== UTM Transformation ==");
    listBox.Items.Add("l = " + l + "    b = " + b);
    utm.Transform(l, b);
    string fmt = "{0} - Y: {1,10}  X: {2,10}";
    double y = 298778.194;  // Sollwert Hoch/Nord
    double x = 5631445.022; // Sollwert Rechts/Ost
    listBox.Items.Add(String.Format(fmt, "Soll", 
        Str.ToString(y, 3), Str.ToString(x, 3)));
    listBox.Items.Add(String.Format(fmt, " Ist", 
        Str.ToString(utm.Y, 3), Str.ToString(utm.X, 3)));
    listBox.Items.Add("");
    // Rechne UTM in Länge/Breite um.
    listBox.Items.Add("== UTM Umkehrtransformation ==");
    listBox.Items.Add("Y = " + Str.ToString(y, 3) + "    X = " + Str.ToString(x, 3));
    double l1, b1;
    utm.Transform(32, y, x, out l1, out b1);
    listBox.Items.Add(String.Format("L = {0,11}   B = {1,11}", 
        Str.ToString(l1, 9), Str.ToString(b1, 9)));
    // Meridanbogenlänge ausgeben. Mittelmeridiane liegen bei 3°, 9°, 15° etc.
    listBox.Items.Add("");
    listBox.Items.Add("== Nebenrechnung: Meridianbogenlänge ==");
    l = "9.0";
    listBox.Items.Add("l = " + l + "    b = " + b);
    utm.Transform(l, b);
    listBox.Items.Add("Bogenlänge: " + Str.ToString(utm.X, 3));
}

Weltweit eindeutige Positionsangaben

• 32: UTM-Zone 32 mit dem Bezugsmeridian 9 Grad Ost. Die Zonen zählen von 1 (180°-174° West) in östlicher Richtung bis 60 (174°-180° Grad E).
• P: Teilbereich zwischen 8° Nord und 16° Nord. Den Teilbereichen von je 8° Grad sind Buchstaben zugeordnet, beginnend mit C (80° bis 72° Süd) bis X (72°-80° Nord) unter Auslassung der Buchstaben I und O. C bis M liegen auf der Südhalbkugel, N bis X nördlich des Äquators.
• 666666: Ost- oder Rechts-Wert des Ortes. Er liegt in diesem Beispiel rund 166666 Meter
  östlich des Bezugsmeridians, der den Ost-Wert 500000 Meter aufweist, um negative Koordinaten zu vermeiden. Für Orte östlich oder westlich davon wird der Abstand zum Offset (multipliziert mit dem Skalenfaktor 0,9996) hinzu addiert oder abgezogen (West: minus, Ost: plus).
• 1234567: Nord- oder Hochwert des Ortes in Meter. Für einen Ort auf dem Bezugsmeridian (und
  
nördlich des Äquators) ist das die Länge des Meridianbogens gemessen vom Äquator, multipliziert mit dem Skalenfaktor von 0,9996.