Changing Metadata

Documentation | Changing Metadata

TatukGIS Developer Kernel Metadata changes baseline Developer Kernel behavior. Use it to change core Developer Kernel rules, e.g. how the map scale is computed or how progressive painting behaves. Metadata is a global string key/value store exposed as a TGIS_StringList.

• Getter: GisMetadata() → returns global TGIS_StringList.
• Readers: GisMetadataAsString/Integer/Float/Boolean(name, default) for safe lookups.
• Scope: global for the process. Affects all DK components that consult the specific key.

Keys are class‑scoped. The full key name starts with the declaring class, for example:

• TGIS_Viewer.ScaleAtCsOrigin
• TGIS_ViewerWnd.Paint.Progressive.Transparency

Where to find them:

1. Open the class page in the API docs.
2. Look for the Available metadata keys or Metadata section on that page.

Notes:

1. Not every class defines metadata keys.
2. The list is documentation‑driven. There is no runtime API to enumerate all possible keys; you can only read what you have set or what components have set during initialization.

uses GisUtils;
 
procedure TMainForm.FormCreate(Sender: TObject);
begin
  TGIS_Utils.GisMetadata.Values['TGIS_Viewer.ScaleAtCsOrigin'] := 'TRUE';
end;

Read back if needed:

var L: string;
L := TGIS_Utils.GisMetadataAsString('TGIS_Viewer.ScaleAtCsOrigin', 'FALSE');

using TatukGIS.NDK;
 
public partial class MainWindow // or Form
{
    public MainWindow()
    {
        InitializeComponent();
 
        TGIS_Utils.GisMetadata().set_Values("TGIS_Viewer.ScaleAtCsOrigin", "TRUE");
    }
}

Read back:

string v = TGIS_Utils.GisMetadataAsString("TGIS_Viewer.ScaleAtCsOrigin", "FALSE");

import tatukgis.jdk.*;
 
public final class App {
  public static void main(String[] args) {
    // 1) Change scale calculation rule
    TGIS_Utils.GisMetadata().setValues("TGIS_Viewer.ScaleAtCsOrigin", "TRUE");
  }
}

Read back:

String v = TGIS_Utils.GisMetadataAsString("TGIS_Viewer.ScaleAtCsOrigin", "FALSE");

Imports TatukGIS_XDK11
 
  Private Sub Form1_Load(ByVal eventSender As System.Object, ByVal eventArgs As System.EventArgs) Handles MyBase.Load
    Dim GisUtils As New TGIS_Utils()
    GisUtils.GisMetadata().Values("TGIS_Viewer.ScaleAtCsOrigin") = "TRUE"
  End Sub

Read back:

Dim v As String
v = GisUtils.GisMetadataAsString("TGIS_Viewer.ScaleAtCsOrigin", "FALSE")

from tatukgis_pdk import TGIS_Utils
 
TGIS_Utils.GisMetadata().Values('TGIS_Viewer.ScaleAtCsOrigin', 'true')

Read back:

val = TGIS_Utils.GisMetadataAsString('TGIS_Viewer.ScaleAtCsOrigin', 'FALSE')