wx_bgi_3d.h

Go to the documentation of this file.

#pragma once
 
#include "bgi_types.h"
 
// =============================================================================
// Camera type constants (pass to wxbgi_cam_create)
// =============================================================================
 
#define WXBGI_CAM_ORTHO        0
#define WXBGI_CAM_PERSPECTIVE  1
 
// =============================================================================
// Camera lifecycle
// =============================================================================
 
BGI_API int BGI_CALL wxbgi_cam_create(const char *name, int type);
 
BGI_API void BGI_CALL wxbgi_cam_destroy(const char *name);
 
BGI_API void BGI_CALL wxbgi_cam_set_active(const char *name);
 
BGI_API const char *BGI_CALL wxbgi_cam_get_active(void);
 
// =============================================================================
// 3-D camera: eye / target / up
// =============================================================================
 
BGI_API void BGI_CALL wxbgi_cam_set_eye(const char *name,
                                         float x, float y, float z);
 
BGI_API void BGI_CALL wxbgi_cam_set_target(const char *name,
                                            float x, float y, float z);
 
BGI_API void BGI_CALL wxbgi_cam_set_up(const char *name,
                                        float x, float y, float z);
 
BGI_API void BGI_CALL wxbgi_cam_get_eye(const char *name,
                                         float *x, float *y, float *z);
 
BGI_API void BGI_CALL wxbgi_cam_get_target(const char *name,
                                            float *x, float *y, float *z);
 
BGI_API void BGI_CALL wxbgi_cam_get_up(const char *name,
                                        float *x, float *y, float *z);
 
// =============================================================================
// Projection
// =============================================================================
 
BGI_API void BGI_CALL wxbgi_cam_set_perspective(const char *name,
                                                 float fovYDeg,
                                                 float nearPlane,
                                                 float farPlane);
 
BGI_API void BGI_CALL wxbgi_cam_set_ortho(const char *name,
                                           float left, float right,
                                           float bottom, float top,
                                           float nearPlane, float farPlane);
 
BGI_API void BGI_CALL wxbgi_cam_set_ortho_auto(const char *name,
                                                float worldUnitsHigh,
                                                float nearPlane,
                                                float farPlane);
 
// =============================================================================
// Screen viewport mapping
// =============================================================================
 
BGI_API void BGI_CALL wxbgi_cam_set_screen_viewport(const char *name,
                                                     int x, int y,
                                                     int w, int h);
 
// =============================================================================
// Matrix access (column-major float[16], same layout as OpenGL)
// =============================================================================
 
BGI_API void BGI_CALL wxbgi_cam_get_view_matrix(const char *name, float *out16);
 
BGI_API void BGI_CALL wxbgi_cam_get_proj_matrix(const char *name, float *out16);
 
BGI_API void BGI_CALL wxbgi_cam_get_vp_matrix(const char *name, float *out16);
 
// =============================================================================
// Coordinate utilities
// =============================================================================
 
BGI_API int BGI_CALL wxbgi_cam_world_to_screen(const char *name,
                                                float wx, float wy, float wz,
                                                float *screenX, float *screenY);
 
BGI_API void BGI_CALL wxbgi_cam_screen_to_ray(const char *name,
                                               float screenX, float screenY,
                                               float *rayOx, float *rayOy, float *rayOz,
                                               float *rayDx, float *rayDy, float *rayDz);
 
BGI_API int BGI_CALL wxbgi_cam2d_create(const char *name);
 
BGI_API void BGI_CALL wxbgi_cam2d_set_pan(const char *name, float x, float y);
 
BGI_API void BGI_CALL wxbgi_cam2d_pan_by(const char *name, float dx, float dy);
 
BGI_API void BGI_CALL wxbgi_cam2d_set_zoom(const char *name, float zoom);
 
BGI_API void BGI_CALL wxbgi_cam2d_zoom_at(const char *name,
                                           float factor,
                                           float pivotX, float pivotY);
 
BGI_API void BGI_CALL wxbgi_cam2d_set_rotation(const char *name, float angleDeg);
 
BGI_API void BGI_CALL wxbgi_cam2d_get_pan(const char *name,
                                           float *x, float *y);
 
BGI_API void BGI_CALL wxbgi_cam2d_get_zoom(const char *name, float *zoom);
 
BGI_API void BGI_CALL wxbgi_cam2d_get_rotation(const char *name, float *angleDeg);
 
BGI_API void BGI_CALL wxbgi_cam2d_set_world_height(const char *name,
                                                    float worldUnitsHigh);
 
// =============================================================================
// Phase 2 — User Coordinate System (UCS) API
// =============================================================================
 
BGI_API int BGI_CALL wxbgi_ucs_create(const char *name);
 
BGI_API void BGI_CALL wxbgi_ucs_destroy(const char *name);
 
BGI_API void BGI_CALL wxbgi_ucs_set_active(const char *name);
 
BGI_API const char *BGI_CALL wxbgi_ucs_get_active(void);
 
BGI_API void BGI_CALL wxbgi_ucs_set_origin(const char *name,
                                            float ox, float oy, float oz);
 
BGI_API void BGI_CALL wxbgi_ucs_get_origin(const char *name,
                                            float *ox, float *oy, float *oz);
 
BGI_API void BGI_CALL wxbgi_ucs_set_axes(const char *name,
                                          float xx, float xy, float xz,
                                          float yx, float yy, float yz,
                                          float zx, float zy, float zz);
 
BGI_API void BGI_CALL wxbgi_ucs_get_axes(const char *name,
                                          float *xx, float *xy, float *xz,
                                          float *yx, float *yy, float *yz,
                                          float *zx, float *zy, float *zz);
 
BGI_API void BGI_CALL wxbgi_ucs_align_to_plane(const char *name,
                                                float nx, float ny, float nz,
                                                float ox, float oy, float oz);
 
BGI_API void BGI_CALL wxbgi_ucs_get_local_to_world_matrix(const char *name,
                                                           float *out16);
 
BGI_API void BGI_CALL wxbgi_ucs_get_world_to_local_matrix(const char *name,
                                                           float *out16);
 
BGI_API void BGI_CALL wxbgi_ucs_world_to_local(const char *name,
                                                float wx, float wy, float wz,
                                                float *lx, float *ly, float *lz);
 
BGI_API void BGI_CALL wxbgi_ucs_local_to_world(const char *name,
                                                float lx, float ly, float lz,
                                                float *wx, float *wy, float *wz);
 
// =============================================================================
// Phase 2 — World Extents API
// =============================================================================
 
BGI_API void BGI_CALL wxbgi_set_world_extents(float minX, float minY, float minZ,
                                               float maxX, float maxY, float maxZ);
 
BGI_API int BGI_CALL wxbgi_get_world_extents(float *minX, float *minY, float *minZ,
                                              float *maxX, float *maxY, float *maxZ);
 
BGI_API void BGI_CALL wxbgi_expand_world_extents(float x, float y, float z);
 
BGI_API void BGI_CALL wxbgi_reset_world_extents(void);
 
BGI_API int BGI_CALL wxbgi_cam_fit_to_extents(const char *camName);
 
// =============================================================================
// Phase 3: UCS-to-screen projection + world-coordinate drawing wrappers
// =============================================================================
 
BGI_API int BGI_CALL wxbgi_ucs_to_screen(const char *ucsName, const char *camName,
                                          float ux, float uy, float uz,
                                          float *screenX, float *screenY);
 
// --- World-space drawing (uses the active camera) ----------------------------
 
BGI_API void BGI_CALL wxbgi_world_point(float x, float y, float z, int color);
 
BGI_API void BGI_CALL wxbgi_world_line(float x1, float y1, float z1,
                                        float x2, float y2, float z2);
 
BGI_API void BGI_CALL wxbgi_world_circle(float cx, float cy, float cz, float radius);
 
BGI_API void BGI_CALL wxbgi_world_ellipse(float cx, float cy, float cz,
                                           float rx, float ry,
                                           int startAngle, int endAngle);
 
BGI_API void BGI_CALL wxbgi_world_rectangle(float x1, float y1, float z1,
                                             float x2, float y2, float z2);
 
BGI_API void BGI_CALL wxbgi_world_polyline(const float *xyzTriplets, int pointCount);
 
BGI_API void BGI_CALL wxbgi_world_fillpoly(const float *xyzTriplets, int pointCount);
 
BGI_API void BGI_CALL wxbgi_world_outtextxy(float x, float y, float z, const char *text);
 
// --- UCS-local drawing (transform through named UCS, then project) -----------
 
BGI_API void BGI_CALL wxbgi_ucs_point(const char *ucsName,
                                       float ux, float uy, float uz, int color);
 
BGI_API void BGI_CALL wxbgi_ucs_line(const char *ucsName,
                                      float ux1, float uy1, float uz1,
                                      float ux2, float uy2, float uz2);
 
BGI_API void BGI_CALL wxbgi_ucs_circle(const char *ucsName,
                                        float cx, float cy, float cz, float radius);
 
BGI_API void BGI_CALL wxbgi_ucs_polyline(const char *ucsName,
                                          const float *xyzTriplets, int pointCount);
 
BGI_API void BGI_CALL wxbgi_ucs_outtextxy(const char *ucsName,
                                           float ux, float uy, float uz,
                                           const char *text);