setAstStringSystem

Callable

• setAstStringSystem(astString: ASTSettingsString, system: CatalogSystemType | SystemType, overlayGlobalSettings: OverlayGlobalSettings): void

---

• Set the System on an AST settings string and add Equinox/Epoch for that system when applicable.

  Behavior:

  • For image/pixel systems (Image, Pixel0, Pixel1): only System is added, and no Equinox/Epoch are appended.
  • For other systems: System is added, and Equinox/Epoch are determined by the system and defaults.
  • If system equals the defaultSystem in overlayGlobalSettings:
    • FK4: use defaultEquinox and defaultEpoch from overlayGlobalSettings.
    • FK5/Ecliptic: use defaultEquinox and the epoch from the standard values for the system.
    • Others: use the standard values returned by getEquinoxEpochForSystem.
  • If system differs from defaultSystem: always use the standard values returned by getEquinoxEpochForSystem.

  ---

  Parameters

  • astString: ASTSettingsString

    The AST settings string to update

  • system: CatalogSystemType | SystemType

    The coordinate system to set and to use for Equinox/Epoch values

  • overlayGlobalSettings: OverlayGlobalSettings

    The overlay global settings containing defaults

  Returns void