Keyframer Classes

These Keyframer classes are used extensively in objects like Animation_Z, MaterialAnim_Z, Particles_Z, and Rtc_Z. They are not themselves found as objects in BigFiles.

Interpolation Techniques

Keyframer classes with Linear in the class name use Linear interpolation to interpolate values between keyframes. Classes without Linear in the name use Quadratic Bézier interpolation to interpolate values between keyframes.

Compressed

Classes with Comp (Compressed) in the name use std::int16_t values in place of float values to minimize the size of keyframes. To decompress the compressed Keyframer values, for quaternions divide the signed 16-bit integers by 2000, and for vectors divide by 4096. This yields normalized quaternions in the case of KeyframerRot_Z. For some reason, KeyframerVec4fLinearComp_Z is identical to KeyframerVec4fLinear_Z despite the former having Comp in its name.

Extended

Classes with Ext (Extended) in the name seem to refer to extended functionality at runtime rather than storing extra data. The only class that fits this description is KeyframerExtVec3f_Z.

Classes

The class names on this page were taken from the WALL-E Mac debug symbols.

Float Keyframers

struct KeyframerFloat_Z {
    std::uint16_t flags;
    PascalArray<struct {
        float time;
        float value;
        float tangentIn;
        float tangentOut;
     }> keyframes;
};

struct KeyframerFloatComp_Z {
    std::uint16_t flags;
    PascalArray<struct {
        float time;
        std::int16_t value;
        std::int16_t tangentIn;
        std::int16_t tangentOut;
        std::uint16_t padding;
    }> keyframes;
};

struct KeyframerFloatLinearComp_Z {
    std::uint16_t flags;
    PascalArray<struct {
        float time;
        std::int16_t value;
        std::uint16_t padding;
    }> keyframes;
};

Vec2f Keyframers

struct KeyframerVec2fLinear_Z {
    std::uint16_t flags;
    PascalArray<struct {
        float time;
        Vec2f data;
    }> keyframes;
};

struct KeyframerVec2fLinearComp_Z {
    std::uint16_t flags;
    PascalArray<struct {
        float time;
        Vec2i16 value;
    }> keyframes;
};

Vec3f Keyframers

struct KeyframerVec3fComp_Z {
    std::uint16_t flags;
    PascalArray<struct {
        float time;
        Vec3i16 value;
        Vec3i16 tangentIn;
        Vec3i16 tangentOut;
        std::uint16_t padding;
            // Always 0xFF
    }> keyframes;
};

struct KeyframerVec3fLinear_Z {
    std::uint16_t flags;
    PascalArray<struct {
        float time;
        Vec3f value;
    }> keyframes;
};

struct KeyframerExtVec3f_Z {
    std::uint16_t flags;
    PascalArray<struct {
        float time;
        Vec3f value;
        Vec3f tangentIn;
        Vec3f tangentOut;
    }> keyframes;
};

Vec4f Keyframers

struct KeyframerVec4fLinear_Z {
    std::uint16_t flags;
    PascalArray<struct {
        float time;
        Vec4f value;
    }> keyframes;
};

struct KeyframerVec4fLinearComp_Z {
    std::uint16_t flags;
    PascalArray<struct {
        float time;
        Vec4f value;
            // Even though this struct has Comp in the name
            // The value is not compressed. Strange.
    }> keyframes;
};

Rotation Keyframer

struct KeyframerRot_Z {
    PascalArray<struct {
        float time;
        Quati16 rotation;
    }> keyframes;
};
    // Linear and Compressed despite the name

Beszier Rotation Keyframer

struct KeyframerBezierRot_Z {
    PascalArray<struct {
        float time;
        Vec3f a;
        Vec3f b;
        Vec3f c;
    }> keyframes;
};

Handle Keyframer

struct KeyframerHdl_Z // KeyframerHandle
{
    PascalArray<struct {
        float time;
        crc32_t crc32;
    }> keyframes;
};
    // Not interpolated

Flag Keyframer

struct KeyframerFlag_Z {
    PascalArray<struct {
        float time;
        std::uint32_t flag;
    }> keyframes;
};
    // Not interpolated

Message Keyframer

Sends Message_Zs

struct KeyframerMessage_Z {
    PascalArray<struct {
        float time;
        PascalArray<struct {
            std::uint32_t messageClass;
                // Observed values:
                //   * 12
                //   * 13
                //   * 32
                //   * 36 - Sound_Z related
            crc32_t recieverCRC32;
                // 0
                // Sound_Z crc32s
            std::uint32_t c;
                // Observed values:
                //   * 0
                //   * 15
                //   * 792146210
                //   * 1162695237
                //   * 10295924
            float parameter;
            crc32_t messageID;
        }> messages;
    }> keyframes;
};
    // Not interpolated