Odnośnik do formatu klucza opisu

Właściwość formatu klucza opisu służy do generowania pełnego opisu dla punktu dopasowanego do klucza opisu.

Poniżej znajdują się przykładowe formaty klucza opisu:

Opis wstępny punktu, który jest zawsze przechowywany z punktem, często odpowiada opisowi punktu wprowadzonemu przez geodetę/mierniczego w terenie. Zdarza się, na przykład podczas nadawania etykiety punktowi na rysunku, że opis wstępny punktu zawiera informacje w niewłaściwym formacie. Można użyć właściwości formatu, aby utworzyć opis pełny, zawierający bardziej czytelny opis punktu.

Proste metody tworzenia opisów pełnych

Standardowy opis pełny dla punktów dopasowanych do klucza opisu można utworzyć poprzez podanie żądanego opisu we właściwości formatu. Na przykład jeśli wszystkie punkty dopasowane do danego klucza opisu mają mieć opis pełny ZABYTEK, należy wprowadzić wartość ZABYTEK jako właściwość formatu. Dzięki temu wszystkie punkty dopasowane do tego klucza opisu będą miały opis pełny ZABYTEK.

Aby opis pełny wszystkich punktów dopasowanych do danego klucza opisu był taki sam jak ich opis wstępny, wprowadź $* jako format.

Używanie parametrów do konwertowania opisu wstępnego na opis pełny

Czytelny opis pełny można utworzyć na dwa sposoby: zmieniając kolejność elementów w opisie wstępnym lub poprzez dodanie tekstu opisowego. W tym celu należy zdefiniować format konwertujący opis wstępny na opis pełny.

Opis wstępny punktu składa się z listy elementów oddzielonych spacjami, np. TREE OAK 7. Aby zmienić kolejność elementów opisu wstępnego, należy odwoływać się do poszczególnych elementów. Podczas tworzenia formatu odniesienia do elementu wiodącego tworzy się przy użyciu symbolu $0. Odniesienia do pozostałych elementów, nazywanych parametrami, tworzy się przy użyciu znaku $ i dołączonej do niego liczby (1–9), wskazującej pozycję określonego parametru w opisie wstępnym.

Na przykład w opisie wstępnym TREE OAK 7 do elementu wiodącego TREE istnieją odnośniki utworzone za pomocą symbolu $0. Do pierwszego parametru, OAK, tworzone są odnośniki przy użyciu symbolu $1. Do drugiego parametru, 7, odnośniki tworzone są przy użyciu symbolu $2.

Po dopasowaniu klucza opisu opis wstępny jest konwertowany na opis pełny przy użyciu formatu, który odnosi się do elementów opisu wstępnego.

Uwaga: Element wiodący nie jest w odniesieniach traktowany jako parametr. Określenie „parametr” odnosi się do poszczególnych elementów występujących po elemencie wiodącym w opisie wstępnym.

Przykład

Tworzony jest punkt, dla którego podano opis wstępny TREE OAK 7. Jeden ze zestawów kluczy opisu zawiera klucz opisu z kodem TREE oraz formatem „$2 inch $1 tree”.

Element wiodący TREE w opisie wstępnym dopasowuje kod w kluczu opisu, który ma taką samą wartość — TREE. Format „$2 inch $1 tree” określony w kluczu opisu jest używany w celu przekonwertowania opisu wstępnego na opis pełny.

Symbol $2 odnosi się do drugiego parametru w opisie wstępnym, czyli do wartości 7. Symbol $1 odnosi się do pierwszego parametru w opisie wstępnym, czyli OAK. Opis pełny jest tworzony poprzez podstawienie 7 za symbol $2 oraz OAK za symbol $1 w formacie „$2 inch $1 tree”. Tekst w formacie („inch” oraz „tree”) jest pozostawiany bez zmian. Po dokonaniu podstawień przekonwertowany opis pełny ma postać „7 inch OAK tree”.

W poniższej tabeli zestawiono kody podstawień parametrów kluczy opisu, w tym kod używany w przypadku, gdy opis wstępny ma być używany jako opisu pełny:

Użyj kodu	Aby w formacie	Przykład
$0	Odwołać się do elementu wiodącego w opisie wstępnym.	TREE Oak 7
$1	Odwołać się do pierwszego parametru w opisie wstępnym.	TREE Oak 7
$2	Odwołać się do drugiego parametru w opisie wstępnym.	TREE Oak 7
$3	Odwołać się do trzeciego parametru w opisie wstępnym.	TREE Oak 7 24
$4, $5, ..., $9	Odwołać się do parametru czwartego, piątego, ..., dziewiątego w opisie wstępnym.
$+	Odwołać się do wszystkich parametrów w opisie wstępnym występujących po elemencie wiodącym.	TREE Oak 7
$*	Odwołać się do wszystkich parametrów w opisie wstępnym oraz do elementu wiodącego.	TREE Oak 7
$$	Wstawić pojedynczy znak $ do opisu.	Jeśli jako część formatu użyta została wartość $$200.00, to ta część w przekonwertowanym opisie pełnym będzie miała wartość $200.00.
$*	Użyć opisu wstępnego jako opisu pełnego.	Jeśli jako opisy wstępne podane zostały wartości UP-1, UP-2 i UP-3, to aby użyć tych opisów dla opisu pełnego, użyj $* jako formatu.