Dokument
libsren · Verwendung
Vorbemerkung
Die Implementierung von libsren stützt sich auf die in libageo deklarierten Geometrieelemente, die zur Benutzung von libsren ebenfalls vorhanden sein muß.
Verzeichnisstruktur
Nach Installation von libsren und libageo sollten sich auf Ihrem Rechner folgende Dateien befinden:
include-path /




libageo
libsren
libageo.h
libageodll.h
libsren.h
libsrendll.h
library-path /




libageo.lib
libageodll.dll
libageodll.lib
libsren.lib
libsrendll.dll
libsrendll.lib
help-path /


libageo
libsren
libageo.html
libsren.html
Die Pfadangaben für include-path, library-path und help-path haben Sie während der Installation festgelegt. In den Verzeichnissen können sich auch Dateien weiterer Bibliotheken befinden.
Beschreibung
Wenn Sie libsren in Ihrem Projekt verwenden wollen, können Sie zwischen zwei Möglichkeiten wählen:
· Verwenden von libsren als statisch verlinkte Bibliothek
Hierzu müssen Sie die Datei libsren.h inkludieren, die alle Klassen und Methoden von libsren in Ihrem Projekt bekannt macht. Dies geschieht im einfachsten Fall durch Einfügen der Präprozessordirektive #include mit voll qualifiziertem Dateinamen, beispielsweise

#include "c:/Programme/Gemeinsame Dateien/farster/inc/libsren.h"

falls Sie c:/Programme/Gemeinsame Dateien/farster/inc während der Installation als Bibliothekspfad übernommen haben (der voreingestellte Installationspfad ist der Systemordner für "Gemeinsame Dateien").
Portabler ist, das Verzeichnis mit den benötigten Header-Dateien in den Include-Suchpfad des Compilers aufzunehmen

VS 2008/Eigenschaftenseiten/Konfigurationseigenschaften/C/C++/Allgemein


und lediglich den Namen zu inkludieren

#include <libsren.h>

Jetzt müssen Sie den Linker noch anweisen libsren.lib und libageo.lib hinzu zu binden

VS 2008/Eigenschaftenseiten/Konfigurationseigenschaften/Linker/Eingabe


Durch das statische linken mit libsren.lib und libageo.lib wird Ihre Anwendung geringfügig größer, benötigt zur Laufzeit aber keine weiteren Dateien.

· Verwenden von libsren als dynamisch hinzugeladene Bibliothek
Wie zuvor müssen Sie die Klassen und Methoden von libsren in Ihrem Projekt bekannt machen. Verwenden Sie jetzt libsrendll.h anstelle von libsren.h. Der einzige Unterschied zwischen den beiden Header-Dateien besteht in der unterschiedlichen Definition des Präprozessor-Makros libsren_API (tatsächlich wird libsren.h von libsrendll.h verwendet)

#include <libsrendll.h>

Den Linker müssen Sie anweisen libsrendll.lib statt libsren.lib und libageodll.lib statt libageo.lib zu verwenden.
Zur Laufzeit greift Ihre Anwendung dann auf libsrendll.dll und libageodll.dll zu, die Sie gegebenenfalls mit ausliefern müssen. Verwenden Sie dynamisches Linken, wenn Sie libsren in einer Vielzahl von Anwendungen benutzen wollen und die Größe der Anwendungen kritisch ist.
Siehe auch
Inhaltsverzeichnis, Stichwortverzeichnis.