vde_capi.h

浏览该文件的文档.

#pragma once
#include <stddef.h>
#include <stdint.h>
 
#ifdef __cplusplus
extern "C" {
#endif
 
// ═══════════════════════════════════════════════════════════
//  不透明句柄类型（在 vde.h 中已有前向声明）
// ═══════════════════════════════════════════════════════════
 
#ifndef VDE_HANDLE_DEFINED
typedef struct VdeContext* VdeHandle;
#endif
 
#ifndef VDE_MESH_HANDLE_DEFINED
typedef struct VdeMesh* VdeMeshHandle;
#endif
 
#ifndef VDE_CURVE_HANDLE_DEFINED
typedef struct VdeCurve* VdeCurveHandle;
#endif
 
#ifndef VDE_SOLVER_HANDLE_DEFINED
typedef struct VdeSolver* VdeSolverHandle;
#endif
 
#ifndef VDE_BODY_HANDLE_DEFINED
typedef struct VdeBody* VdeBodyHandle;
#endif
 
// ═══════════════════════════════════════════════════════════
//  引擎生命周期
// ═══════════════════════════════════════════════════════════
 
VdeHandle vde_create(void);
 
void vde_destroy(VdeHandle ctx);
 
const char* vde_version(void);
 
const char* vde_last_error(VdeHandle ctx);
 
// ═══════════════════════════════════════════════════════════
//  网格 I/O
// ═══════════════════════════════════════════════════════════
 
VdeMeshHandle vde_load_mesh(VdeHandle ctx, const char* path);
 
int vde_save_mesh(VdeHandle ctx, VdeMeshHandle mesh, const char* path, const char* format);
 
// ═══════════════════════════════════════════════════════════
//  网格查询
// ═══════════════════════════════════════════════════════════
 
size_t vde_mesh_num_vertices(VdeMeshHandle mesh);
 
size_t vde_mesh_num_faces(VdeMeshHandle mesh);
 
void vde_mesh_get_vertex(VdeMeshHandle mesh, size_t idx,
                         double* out_x, double* out_y, double* out_z);
 
void vde_mesh_get_bounds(VdeMeshHandle mesh,
                         double* out_min_x, double* out_min_y, double* out_min_z,
                         double* out_max_x, double* out_max_y, double* out_max_z);
 
void vde_mesh_free(VdeMeshHandle mesh);
 
// ═══════════════════════════════════════════════════════════
//  网格处理
// ═══════════════════════════════════════════════════════════
 
VdeMeshHandle vde_mesh_simplify(VdeHandle ctx, VdeMeshHandle mesh, double target_ratio);
 
VdeMeshHandle vde_mesh_smooth(VdeHandle ctx, VdeMeshHandle mesh, int iterations);
 
VdeMeshHandle vde_mesh_boolean(VdeHandle ctx, VdeMeshHandle a, VdeMeshHandle b, int operation);
 
// ═══════════════════════════════════════════════════════════
//  曲线
// ═══════════════════════════════════════════════════════════
 
VdeCurveHandle vde_curve_create_bezier(VdeHandle ctx, const double* control_points,
                                       int num_points, int dim);
 
void vde_curve_evaluate(VdeCurveHandle curve, double t,
                        double* out_x, double* out_y, double* out_z);
 
int vde_curve_degree(VdeCurveHandle curve);
 
void vde_curve_free(VdeCurveHandle curve);
 
// ═══════════════════════════════════════════════════════════
//  碰撞检测
// ═══════════════════════════════════════════════════════════
 
int vde_collision_gjk_spheres(VdeHandle ctx,
                              double cx1, double cy1, double cz1, double r1,
                              double cx2, double cy2, double cz2, double r2);
 
int vde_collision_ray_mesh(VdeHandle ctx, VdeMeshHandle mesh,
                           double ox, double oy, double oz,
                           double dx, double dy, double dz,
                           double* out_t, double* out_x, double* out_y, double* out_z);
 
// ═══════════════════════════════════════════════════════════
//  约束求解器（二维草图）
// ═══════════════════════════════════════════════════════════
 
VdeSolverHandle vde_solver_create(void);
 
int vde_solver_add_point(VdeSolverHandle solver, double x, double y, int fixed);
 
int vde_solver_add_line(VdeSolverHandle solver, int p0, int p1);
 
void vde_solver_add_distance_constraint(VdeSolverHandle solver, int p0, int p1, double d);
 
void vde_solver_add_horizontal(VdeSolverHandle solver, int line_id);
 
void vde_solver_add_vertical(VdeSolverHandle solver, int line_id);
 
int vde_solver_solve(VdeSolverHandle solver, int max_iter, double tol);
 
void vde_solver_get_point(VdeSolverHandle solver, int idx, double* out_x, double* out_y);
 
void vde_solver_free(VdeSolverHandle solver);
 
// ═══════════════════════════════════════════════════════════
//  B-Rep 建模
// ═══════════════════════════════════════════════════════════
 
VdeBodyHandle vde_body_create_box(VdeHandle ctx, double w, double h, double d);
 
VdeBodyHandle vde_body_create_cylinder(VdeHandle ctx, double r, double h, int segs);
 
VdeBodyHandle vde_body_create_sphere(VdeHandle ctx, double r, int su, int sv);
 
VdeMeshHandle vde_body_to_mesh(VdeHandle ctx, VdeBodyHandle body, double deflection);
 
void vde_body_free(VdeBodyHandle body);
 
// ═══════════════════════════════════════════════════════════
//  序列化
// ═══════════════════════════════════════════════════════════
 
size_t vde_serialize_mesh(VdeHandle ctx, VdeMeshHandle mesh, uint8_t** out_data);
 
VdeMeshHandle vde_deserialize_mesh(VdeHandle ctx, const uint8_t* data, size_t len);
 
void vde_free_buffer(uint8_t* ptr);
 
#ifdef __cplusplus
}
#endif