motion_bridge.h

Go to the documentation of this file.

// motion_bridge.h — C ABI for the Android JNI motion bridge.
//
// Declares the `pulp_motion_*` C entry points implemented in
// `core/view/platform/android/jni_motion.cpp`. The Kotlin facade in
// `com.pulp.motion.PulpMotionNative` reaches these via `external fun`
// (through the matching `Java_com_pulp_motion_PulpMotionNative_*` JNI
// shims). The C symbols are also reachable directly from C/C++ tests
// (`test/test_motion_android_bridge.cpp`) so we can exercise the
// bridge logic without an NDK build.
//
// The signatures intentionally mirror `apple/Sources/PulpSwift/PulpBridge.h`
// — same shapes, same order, no timestamp argument. See the file-level
// comment in `jni_motion.cpp` for the deadlock-safety rationale on
// register/detach.
 
#pragma once
 
#include <stdbool.h>
 
#ifdef __cplusplus
extern "C" {
#endif

bool pulp_motion_tracing_enabled(void);

void pulp_motion_publish_value(const char* view,
                               const char* metric,
                               double value,
                               double epsilon,
                               int precision);

void pulp_motion_publish_components(const char* view,
                                    const char* metric,
                                    const char* const* keys,
                                    const double* values,
                                    int count,
                                    double epsilon,
                                    int precision);

void pulp_motion_set_ambient_provenance(const char* kind,
                                        const char* id,
                                        const char* file,
                                        int line);

void pulp_motion_clear_ambient_provenance(void);

int pulp_motion_register_geometry_trace(const char* view_name, int fps);

void pulp_motion_update_geometry(int trace_id,
                                 const char* metric_name,
                                 double minX,
                                 double minY,
                                 double width,
                                 double height);

void pulp_motion_detach_trace(int trace_id);
 
#ifdef __cplusplus
}
#endif