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

    Interface StanceGuardPose

    Fighting stance guard pose configuration

    Defines complete body positioning for authentic Korean martial arts stances. Includes arms, torso, legs, and pelvis rotations based on traditional Taekwondo/Hapkido.

    Each stance corresponds to a real martial arts position with unique leg positioning. Used for stance-specific idle animations at 60fps.

    자세방어포즈

    interface StanceGuardPose {
        breathingRange: { max: number; min: number };
        leftArm: { elbow: Euler; shoulder: Euler; wrist: Euler };
        leftLeg: { ankle: Euler; hip: Euler; knee: Euler };
        pelvis: Euler;
        pelvisHeight?: number;
        rightArm: { elbow: Euler; shoulder: Euler; wrist: Euler };
        rightLeg: { ankle: Euler; hip: Euler; knee: Euler };
        stanceDepth?: number;
        stanceWidth: number;
        torso: Euler;
        weight: "forward" | "neutral" | "back";
    }
    Index

    Properties

    breathingRange: { max: number; min: number }

    Breathing animation range (min/max for chest movement)

    호흡범위

    leftArm: { elbow: Euler; shoulder: Euler; wrist: Euler }

    Left arm bone rotations (shoulder, elbow, wrist)

    왼팔

    leftLeg: { ankle: Euler; hip: Euler; knee: Euler }

    Left leg bone rotations (hip, knee, ankle) NEW: For authentic Taekwondo stance positioning

    왼다리

    pelvis: Euler

    Pelvis rotation (hip tilt and rotation) NEW: For proper stance base

    골반회전

    pelvisHeight?: number

    Pelvis height offset (vertical drop in meters) Optional: Defaults to 0 for normal standing height

    For deep stances (Juchum Seogi, Joong Ha Seogi): negative value (~-0.15 to -0.3m) This lowers the center of gravity for power and stability.

    골반높이

    rightArm: { elbow: Euler; shoulder: Euler; wrist: Euler }

    Right arm bone rotations (shoulder, elbow, wrist)

    오른팔

    rightLeg: { ankle: Euler; hip: Euler; knee: Euler }

    Right leg bone rotations (hip, knee, ankle) NEW: For authentic Taekwondo stance positioning

    오른다리

    stanceDepth?: number

    Stance depth (front-to-back foot spacing in meters) Optional: Defaults to 0 for parallel stances (Juchum Seogi, Narani Seogi)

    For forward stances (Ap Koobi Seogi): positive value (~0.6-0.9m) For back stances (Dwi Seogi): negative value (~-0.3m with back foot forward)

    Left foot gets -depth/2, right foot gets +depth/2 on Z-axis. Combined with stanceWidth, this defines the full 2D foot placement.

    자세깊이

    stanceWidth: number

    Stance width (foot spacing in meters) NEW: Defines lateral distance between feet Range: 0.3 (narrow) to 1.5 (wide horse stance)

    This value describes the intended lateral spacing between the feet for this stance configuration. Consumers (e.g. animation systems or positioning overlays) may use it to drive foot placement, validation, or visualization as needed.

    자세너비

    torso: Euler

    Torso rotation (spine upper bone)

    몸통회전

    weight: "forward" | "neutral" | "back"

    Weight distribution (forward/neutral/back)

    무게중심