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

    Function getGuardPoseForStance

    Animation catalog sub-package

    Curated collections of skeletal animations for attacks, defenses, locomotion, stances, and recovery-aware variants.

    • Get guard pose for a specific trigram stance with laterality support

      Korean: 자세 방어 포즈 가져오기

      Returns the appropriate guard pose for the given stance and laterality. Right laterality returns the base pose; left laterality returns a mirrored version. This supports authentic Korean martial arts stance differentiation:

      • 오른발서기 (Oreun Bal Seogi): Right foot forward - base pose
      • 왼발서기 (Oenbal Seogi): Left foot forward - mirrored pose

      Parameters

      • stance: TrigramStance

        Trigram stance identifier (e.g., "geon", "tae")

      • laterality: StanceLaterality = "right"

        Stance side: "left" or "right" (defaults to "right")

      Returns StanceGuardPose | undefined

      Guard pose configuration or undefined if not found

      // Get right Heaven stance (default)
      const rightGeon = getGuardPoseForStance("geon", "right");

      // Get left Heaven stance (mirrored)
      const leftGeon = getGuardPoseForStance("geon", "left");
      // leftGeon now has left foot forward, left hand lead

      자세방어포즈가져오기