Das Messfile-API ist eine Schnittstellen-Definition, welche es erlaubt, mit Messfile mitgelieferte oder anderweitig geschriebene AutoLISP-Routinen in Messfile zu integrieren. Durch diese an Messfile angehängten AutoLISP-Routinen bestehen sehr umfangreiche Möglichkeiten, auf die Messfile-internen Prozesse der Daten-Interpretation und der Messpunkt-Generierung Einfluss zu nehmen. Außerdem lassen sich über das Messfile-API völlig neue Funktionen realisieren, welche außerhalb der Möglichkeiten von Messfile liegen. Ein solcher, zusätzlicher Funktions-Umfang ist nur von den AutoLISP-Routinen selbst abhängig. Die API-Schnittstelle integriert sich vollständig in Messfile. Es bestehen alle Möglichkeiten, je nach Umfang und Arbeitsweise der API-Routinen, interaktiv auf die API- Routinen Einfluss zu nehmen und z.B. Einstellungen und Vorgaben am Bildschirm vorzunehmen. Die Messfile-Applikationen sind durch Betätigung der Schaltfläche API im Hauptdialog zugänglich.



Die Hauptdialogbox der Messfile-Erweiterungen verfügt über die folgenden Schaltflächen und Kontrollfelder:


  • HINZU - Diese Schaltfläche öffnet den bekannten Datei-Auswahldialog mit der Anzeige aller vorhandenen Messfile-Applikationen (*.MFA). Im Verzeichnis \SURVEY sind standardmäßig folgende Programmerweiterungen vorhanden:

 

  • P-NUMMER.MFA - Modifizierung von Punktnummern
  • P-FILTER.MFA  - Filterung von Messpunkten nach diversen Kriterien
  • P-EXPORT.MFA - Generierung von Exportdateien
  • P-LINIEN.MFA - Liniengenerierung aus externen Liniendateien

 

  • Nach der Auswahl wird automatisch dieses API-Programm in Messfile integriert und in die Messfile-interne Liste der geladenen Erweiterungen aufgenommen (Sie sehen diese Liste direkt im API-Dialog incl. eines Informations-Textes). Sie können mehrere API-Programme laden, es gibt keine Beschränkungen in dieser Hinsicht. Wählen Sie bei Bedarf die einzelnen Programme in der Anzeige-Liste an - Messfile analysiert daraufhin das gewählte Programm und zeigt mit einem oder mehreren Kotrollfeldern an, welche Schnittstelle durch dieses Programm belegt wird; mit den ggf. aktivierten Schaltflächen zeigt Messfile an, ob für die genutzten Schnittstellen auch Einstellungs-Dialoge existieren. 

Wenn ein API-Programm Einstellungen benötigt, Sie diese aber nicht vornehmen, so ist das nicht weiter tragisch. Vor dem Laden/Prüfen einer Koordinatendatei prüft Messfile automatisch alle geladenen API-Programme bezüglich fehlender Einstellungen ab; alle noch nicht initialisierten Module werden daraufhin automatisch und online gestartet.

  • RESET - Wenn Sie eine der aktivierten Messfile-Erweiterungen in der Anzeige-Box ausgewählt haben, können Sie danach das gewählte API-Programm reinitialisieren, indem Sie diese Schaltfläche betätigen. Dadurch wird diese Messfile-Applikation neu von der Festplatte geladen und initialisiert; dieser Vorgang ist identisch mit dem Entfernen der Applikation und einem nachfolgenden erneuten Hinzufügen. Die Notwendigkeit zur Re-Initialisierung kann dann entstehen, wenn in dem API-Programm bestimmte Einstellungen nicht rückgängig zu machen sind - dann bleibt nur das Neuladen, um diese Optionen zu löschen.
  • ENTFERNE - Diese Schaltfläche entfernt eine geladene, d. h. eine in der Anzeige-Box sichtbare Messfile-Erweiterungen wieder aus dem Speicher.
  • DOKUMENTATION - Diese Schaltfläche zeigt eine Dokumentation (*.DOC) zur gewählten Messfile-Erweiterungen an, welche Ihnen alle notwendigen Informationen zur Funktion und Bedienung der jeweiligen Messfile-Erweiterung vermittelt. 
  • MODIF.ZEILE - Diese Schnittstelle erlaubt es API-Programmen, eine aus der Koordinatendatei geladene Textzeile direkt und vor der Interpretation durch Messfile zu manipulieren und diese veränderte Zeile an Messfile zurückzugeben. 
  • MODIF.DATA - Diese Schnittstelle erlaubt es API-Programmen, die durch Messfile aus der Koordinatenzeile (entsprechend dem aktiven Datei-Format) herausgefilterten Messpunktdaten vor der Messpunkt/Grafikgenerierung durch Messfile zu manipulieren und diese veränderten Daten wieder an Messfile zur Messpunkt/Grafikgenerierung zurückzugeben. 
  • GENERIERUNG - Diese Schnittstelle erlaubt es API-Programmen, nach der durch Messfile realisierten Messpunkt/Grafikgenerierung, eine eigene Messpunkt/Grafikgenerierung für Messpunkte vorzunehmen.
  • EXPORT - Diese Schnittstelle erlaubt es API-Programmen, nach der durch Messfile realisierten Messpunkt/Grafikgenerierung und nach der ggf. durch weitere API-Programme durchgeführten zusätzlichen Grafikgenerierung, auch Daten für die Weiterverarbeitung außerhalb von Messfile zu erzeugen. 


Wenn Sie eine der aktivierten Messfile-Erweiterungen in der Anzeige-Box ausgewählt haben, und dieses API-Programm eine Schnittstelle belegt, erkennen Sie das an dem angekreuzten Kontrollfeld. Sollten die API-Programme auch einen zugehörigen Einstellungsdialog für die o.g. Schnittstellen besitzen, wird auch die jeweilige Schaltflächen zu den Kontrollfeldern selbst aktiviert; mit diesen können Sie dann den Einstellungs-Dialog aufrufen, um das API-Programm entsprechend Ihren Anforderungen einzustellen. Wenn Sie davon aber keinen Gebrauch machen, und das API-Programm jedoch diesen Einstellungs-Dialog benötigt, wird dieser Dialog automatisch durch Messfile bzw. durch das API-Programm selbst spätestens dann gestartet, wenn Sie eine Koordinatendatei Laden/Prüfen wollen.