Black Trigram (흑괘) - Korean Martial Arts Combat Simulator API - v0.7.0
    Preparing search index...

    Function getAnimationsForStance

    • Get all animations for a stance with laterality support.

      Korean: 자세 애니메이션 가져오기

      Returns a complete collection of animations for the specified stance, including guard pose, attacks, defensive moves, and locomotion.

      Accepts either:

      • StanceWithSide (e.g., "geon_left", "tae_right") - 16 configurations
      • TrigramStance (e.g., "geon", "tae") - defaults to right laterality

      Performance:

      • Right laterality: Returns original animations (no transformation)
      • Left laterality: Applies on-demand transformation (<1ms per animation)

      Parameters

      • stanceOrSide:
            | TrigramStance
            | "geon_left"
            | "geon_right"
            | "tae_left"
            | "tae_right"
            | "li_left"
            | "li_right"
            | "jin_left"
            | "jin_right"
            | "son_left"
            | "son_right"
            | "gam_left"
            | "gam_right"
            | "gan_left"
            | "gan_right"
            | "gon_left"
            | "gon_right"

        Stance identifier with optional laterality

      • defaultLaterality: StanceLaterality = "right"

        Default laterality if not specified (default: "right")

      Returns StanceAnimationCollection | undefined

      Complete animation collection for the stance

      // With StanceWithSide
      const leftGeon = getAnimationsForStance("geon_left");
      // leftGeon.attacks are all left-handed versions

      // With TrigramStance (defaults to right)
      const geon = getAnimationsForStance("geon");
      // geon.attacks are right-handed versions

      // With explicit laterality
      const tae = getAnimationsForStance("tae", "left");
      // tae.attacks are left-handed versions

      자세애니메이션가져오기