occtl_surfaces.h

Go to the documentation of this file.

// Copyright (c) 2026 Capgemini Engineering Research and Development.
//
// This file is part of OCCT-Light software library.
//
// This library is free software; you can redistribute it and/or modify it under
// the terms of the GNU Affero General Public License version 3 as published
// by the Free Software Foundation, with an option to use any later version.
// Consult the file LICENSE_AGPL_30.txt included in OCCT-Light distribution
// for complete text of the license and disclaimer of any warranty.
//
// Alternatively, this file may be used under the terms of a commercial
// license or contractual agreement.
//
// SPDX-License-Identifier: AGPL-3.0-or-later
 
#ifndef OCCTL_SURFACES_H
#define OCCTL_SURFACES_H
 
#include <stddef.h>
#include <stdint.h>
 
#include "occtl_core.h"
#include "occtl_geom.h"
 
#ifdef __cplusplus
extern "C"
{
#endif
 
typedef struct occtl_graph occtl_graph_t;
 
typedef enum occtl_surface_kind
{
  OCCTL_SURFACE_KIND_PLANE       = 0, 
  OCCTL_SURFACE_KIND_CYLINDRICAL = 1, 
  OCCTL_SURFACE_KIND_CONICAL     = 2, 
  OCCTL_SURFACE_KIND_SPHERICAL   = 3, 
  OCCTL_SURFACE_KIND_TOROIDAL    = 4, 
  OCCTL_SURFACE_KIND_BSPLINE     = 5, 
  OCCTL_SURFACE_KIND_BEZIER      = 6, 
  OCCTL_SURFACE_KIND_REVOLUTION  = 7, 
  OCCTL_SURFACE_KIND_EXTRUSION   = 8, 
  OCCTL_SURFACE_KIND_RECTANGULAR_TRIMMED =
    9, 
  OCCTL_SURFACE_KIND_OFFSET          = 10, 
  OCCTL_SURFACE_KIND_UNDEFINED       = 11, 
  OCCTL_SURFACE_KIND_RESERVED_FUTURE = 0x7fffffff
} occtl_surface_kind_t;
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_create_plane(occtl_graph_t*     graph,
                                                               occtl_rep_id_t*    out_id,
                                                               occtl_geom_plane_t plane);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_cylinder(occtl_graph_t*                   graph,
                                occtl_rep_id_t*                  out_id,
                                occtl_geom_cylindrical_surface_t cylinder);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_create_cone(occtl_graph_t*               graph,
                                                              occtl_rep_id_t*              out_id,
                                                              occtl_geom_conical_surface_t cone);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_sphere(occtl_graph_t*                 graph,
                              occtl_rep_id_t*                out_id,
                              occtl_geom_spherical_surface_t sphere);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_create_torus(occtl_graph_t*                graph,
                                                               occtl_rep_id_t*               out_id,
                                                               occtl_geom_toroidal_surface_t torus);
 
typedef struct occtl_surface_revolution_create_info
{
  uint32_t       struct_version; 
  const void*    p_next;
  occtl_rep_id_t basis;         
  occtl_axis1_placement_t axis; 
} occtl_surface_revolution_create_info_t;
 
#define OCCTL_SURFACE_REVOLUTION_CREATE_INFO_VERSION_1 1u
 
#define OCCTL_SURFACE_REVOLUTION_CREATE_INFO_INIT                                                  \
  {                                                                                                \
    OCCTL_SURFACE_REVOLUTION_CREATE_INFO_VERSION_1, NULL, OCCTL_REP_ID_INVALID,                    \
    {                                                                                              \
      {0, 0, 0}, {0, 0, 1}                                                                         \
    }                                                                                              \
  }
 
OCCTL_API void OCCTL_CALL
  occtl_surface_revolution_create_info_init(occtl_surface_revolution_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_revolution(occtl_graph_t*                                graph,
                                  occtl_rep_id_t*                               out_id,
                                  const occtl_surface_revolution_create_info_t* info);
 
typedef struct occtl_surface_extrusion_create_info
{
  uint32_t        struct_version; 
  const void*     p_next;
  occtl_rep_id_t  basis;     
  occtl_vector3_t direction; 
} occtl_surface_extrusion_create_info_t;
 
#define OCCTL_SURFACE_EXTRUSION_CREATE_INFO_VERSION_1 1u
 
#define OCCTL_SURFACE_EXTRUSION_CREATE_INFO_INIT                                                   \
  {OCCTL_SURFACE_EXTRUSION_CREATE_INFO_VERSION_1, NULL, OCCTL_REP_ID_INVALID, {0.0, 0.0, 1.0}}
 
OCCTL_API void OCCTL_CALL
  occtl_surface_extrusion_create_info_init(occtl_surface_extrusion_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_extrusion(occtl_graph_t*                               graph,
                                 occtl_rep_id_t*                              out_id,
                                 const occtl_surface_extrusion_create_info_t* info);
 
typedef struct occtl_surface_rectangular_trimmed_create_info
{
  uint32_t struct_version; 
  const void*    p_next;   
  occtl_rep_id_t basis;    
  double         u_first;
  double         u_last;
  double         v_first;
  double         v_last;
  int32_t        u_sense; 
  int32_t        v_sense; 
} occtl_surface_rectangular_trimmed_create_info_t;
 
#define OCCTL_SURFACE_RECTANGULAR_TRIMMED_CREATE_INFO_VERSION_1 1u
 
#define OCCTL_SURFACE_RECTANGULAR_TRIMMED_CREATE_INFO_INIT                                         \
  {OCCTL_SURFACE_RECTANGULAR_TRIMMED_CREATE_INFO_VERSION_1,                                        \
   NULL,                                                                                           \
   OCCTL_REP_ID_INVALID,                                                                           \
   0.0,                                                                                            \
   1.0,                                                                                            \
   0.0,                                                                                            \
   1.0,                                                                                            \
   1,                                                                                              \
   1}
 
OCCTL_API void OCCTL_CALL occtl_surface_rectangular_trimmed_create_info_init(
  occtl_surface_rectangular_trimmed_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_create_rectangular_trimmed(
  occtl_graph_t*                                         graph,
  occtl_rep_id_t*                                        out_id,
  const occtl_surface_rectangular_trimmed_create_info_t* info);
 
typedef struct occtl_surface_offset_create_info
{
  uint32_t       struct_version; 
  const void*    p_next;         
  occtl_rep_id_t basis;          
  double         offset;         
} occtl_surface_offset_create_info_t;
 
#define OCCTL_SURFACE_OFFSET_CREATE_INFO_VERSION_1 1u
 
#define OCCTL_SURFACE_OFFSET_CREATE_INFO_INIT                                                      \
  {OCCTL_SURFACE_OFFSET_CREATE_INFO_VERSION_1, NULL, OCCTL_REP_ID_INVALID, 0.0}
 
OCCTL_API void OCCTL_CALL
  occtl_surface_offset_create_info_init(occtl_surface_offset_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_offset(occtl_graph_t*                            graph,
                              occtl_rep_id_t*                           out_id,
                              const occtl_surface_offset_create_info_t* info);
 
typedef struct occtl_surface_bspline_create_info
{
  uint32_t    struct_version;  
  const void* p_next;          
  const occtl_point3_t* poles; 
  size_t                u_pole_count; 
  size_t                v_pole_count; 
  const double*         weights; 
  const double*         u_knots; 
  const int32_t*        u_multiplicities; 
  size_t                u_knot_count;
  const double*         v_knots;          
  const int32_t*        v_multiplicities; 
  size_t                v_knot_count;
  int32_t               u_degree;
  int32_t               v_degree;
  int32_t               is_u_periodic; 
  int32_t               is_v_periodic; 
} occtl_surface_bspline_create_info_t;
 
#define OCCTL_SURFACE_BSPLINE_CREATE_INFO_VERSION_1 1u
 
#define OCCTL_SURFACE_BSPLINE_CREATE_INFO_INIT                                                     \
  {OCCTL_SURFACE_BSPLINE_CREATE_INFO_VERSION_1,                                                    \
   NULL,                                                                                           \
   NULL,                                                                                           \
   0,                                                                                              \
   0,                                                                                              \
   NULL,                                                                                           \
   NULL,                                                                                           \
   NULL,                                                                                           \
   0,                                                                                              \
   NULL,                                                                                           \
   NULL,                                                                                           \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   0}
 
OCCTL_API void OCCTL_CALL
  occtl_surface_bspline_create_info_init(occtl_surface_bspline_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_bspline(occtl_graph_t*                             graph,
                               occtl_rep_id_t*                            out_id,
                               const occtl_surface_bspline_create_info_t* info);
 
typedef struct occtl_surface_bezier_create_info
{
  uint32_t              struct_version; 
  const void*           p_next;         
  const occtl_point3_t* poles; 
  size_t                u_pole_count; 
  size_t                v_pole_count; 
  const double*         weights; 
} occtl_surface_bezier_create_info_t;
 
#define OCCTL_SURFACE_BEZIER_CREATE_INFO_VERSION_1 1u
 
#define OCCTL_SURFACE_BEZIER_CREATE_INFO_INIT                                                      \
  {OCCTL_SURFACE_BEZIER_CREATE_INFO_VERSION_1, NULL, NULL, 0, 0, NULL}
 
OCCTL_API void OCCTL_CALL
  occtl_surface_bezier_create_info_init(occtl_surface_bezier_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_bezier(occtl_graph_t*                            graph,
                              occtl_rep_id_t*                           out_id,
                              const occtl_surface_bezier_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_bezier_grid(occtl_graph_t*                            graph,
                                   occtl_rep_id_t*                           out_id,
                                   const occtl_surface_bezier_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_reverse(occtl_graph_t*  graph,
                                                          occtl_rep_id_t  surface_id,
                                                          occtl_rep_id_t* out_id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_transformed(occtl_graph_t*    graph,
                                                              occtl_rep_id_t    surface_id,
                                                              occtl_transform_t transform,
                                                              occtl_rep_id_t*   out_id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_translated(occtl_graph_t*  graph,
                                                             occtl_rep_id_t  surface_id,
                                                             occtl_vector3_t delta,
                                                             occtl_rep_id_t* out_id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_rotated(occtl_graph_t*          graph,
                                                          occtl_rep_id_t          surface_id,
                                                          occtl_axis1_placement_t axis,
                                                          double                  angle,
                                                          occtl_rep_id_t*         out_id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_scaled(occtl_graph_t*  graph,
                                                         occtl_rep_id_t  surface_id,
                                                         occtl_point3_t  origin,
                                                         double          factor,
                                                         occtl_rep_id_t* out_id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_area(const occtl_graph_t* graph,
                                                       occtl_rep_id_t       surface_id,
                                                       double*              out_area);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_project_point(const occtl_graph_t* graph,
                                                                occtl_rep_id_t       surface_id,
                                                                occtl_point3_t       point,
                                                                double*              out_u,
                                                                double*              out_v,
                                                                double*              out_distance);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_uv_of_point(const occtl_graph_t* graph,
                                                              occtl_rep_id_t       surface_id,
                                                              occtl_point3_t       point,
                                                              double*              out_u,
                                                              double*              out_v);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_kind(const occtl_graph_t*  graph,
                                                       occtl_rep_id_t        surface_id,
                                                       occtl_surface_kind_t* out_kind);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_is_u_periodic(const occtl_graph_t* graph,
                                                                occtl_rep_id_t       surface_id,
                                                                int32_t* out_is_periodic);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_is_v_periodic(const occtl_graph_t* graph,
                                                                occtl_rep_id_t       surface_id,
                                                                int32_t* out_is_periodic);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_is_closed(const occtl_graph_t* graph,
                                                            occtl_rep_id_t       surface_id,
                                                            int32_t*             out_is_closed);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_is_periodic(const occtl_graph_t* graph,
                                                              occtl_rep_id_t       surface_id,
                                                              int32_t*             out_is_periodic);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_continuity(occtl_graph_t*           graph,
                           occtl_rep_id_t           surface_id,
                           occtl_geom_continuity_t* out_continuity);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_parameter_range(const occtl_graph_t* graph,
                                                                  occtl_rep_id_t       surface_id,
                                                                  double*              out_u_min,
                                                                  double*              out_u_max,
                                                                  double*              out_v_min,
                                                                  double*              out_v_max);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_as_plane(const occtl_graph_t* graph,
                                                           occtl_rep_id_t       surface_id,
                                                           occtl_geom_plane_t*  out_plane);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_as_cylinder(occtl_graph_t*                    graph,
                            occtl_rep_id_t                    surface_id,
                            occtl_geom_cylindrical_surface_t* out_cylinder);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_as_cone(const occtl_graph_t*          graph,
                                                          occtl_rep_id_t                surface_id,
                                                          occtl_geom_conical_surface_t* out_cone);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_as_sphere(occtl_graph_t*                  graph,
                          occtl_rep_id_t                  surface_id,
                          occtl_geom_spherical_surface_t* out_sphere);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_as_torus(const occtl_graph_t*           graph,
                         occtl_rep_id_t                 surface_id,
                         occtl_geom_toroidal_surface_t* out_torus);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_as_revolution(const occtl_graph_t*     graph,
                                                                occtl_rep_id_t           surface_id,
                                                                occtl_axis1_placement_t* out_axis);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_as_extrusion(const occtl_graph_t* graph,
                                                               occtl_rep_id_t       surface_id,
                                                               occtl_vector3_t*     out_direction);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_as_rectangular_trimmed(const occtl_graph_t* graph,
                                                                         occtl_rep_id_t surface_id,
                                                                         double*        out_u_first,
                                                                         double*        out_u_last,
                                                                         double*        out_v_first,
                                                                         double*        out_v_last);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_as_offset(const occtl_graph_t* graph,
                                                            occtl_rep_id_t       surface_id,
                                                            double*              out_offset);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_u_degree(const occtl_graph_t* graph,
                                                                   occtl_rep_id_t       surface_id,
                                                                   int32_t*             out_degree);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_v_degree(const occtl_graph_t* graph,
                                                                   occtl_rep_id_t       surface_id,
                                                                   int32_t*             out_degree);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_u_pole_count(const occtl_graph_t* graph,
                                                                       occtl_rep_id_t surface_id,
                                                                       size_t*        out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_v_pole_count(const occtl_graph_t* graph,
                                                                       occtl_rep_id_t surface_id,
                                                                       size_t*        out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_is_rational(const occtl_graph_t* graph,
                                                                      occtl_rep_id_t surface_id,
                                                                      int32_t* out_is_rational);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_u_knot_count(const occtl_graph_t* graph,
                                                                       occtl_rep_id_t surface_id,
                                                                       size_t*        out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_v_knot_count(const occtl_graph_t* graph,
                                                                       occtl_rep_id_t surface_id,
                                                                       size_t*        out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bezier_u_degree(const occtl_graph_t* graph,
                                                                  occtl_rep_id_t       surface_id,
                                                                  int32_t*             out_degree);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bezier_v_degree(const occtl_graph_t* graph,
                                                                  occtl_rep_id_t       surface_id,
                                                                  int32_t*             out_degree);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bezier_u_pole_count(const occtl_graph_t* graph,
                                                                      occtl_rep_id_t surface_id,
                                                                      size_t*        out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bezier_v_pole_count(const occtl_graph_t* graph,
                                                                      occtl_rep_id_t surface_id,
                                                                      size_t*        out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bezier_is_rational(const occtl_graph_t* graph,
                                                                     occtl_rep_id_t surface_id,
                                                                     int32_t* out_is_rational);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_poles(const occtl_graph_t* graph,
                                                                occtl_rep_id_t       surface_id,
                                                                occtl_point3_t*      out_buf,
                                                                size_t               capacity,
                                                                size_t*              out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_u_knots(const occtl_graph_t* graph,
                                                                  occtl_rep_id_t       surface_id,
                                                                  double*              out_buf,
                                                                  size_t               capacity,
                                                                  size_t*              out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_v_knots(const occtl_graph_t* graph,
                                                                  occtl_rep_id_t       surface_id,
                                                                  double*              out_buf,
                                                                  size_t               capacity,
                                                                  size_t*              out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_bspline_u_multiplicities(occtl_graph_t* graph,
                                         occtl_rep_id_t surface_id,
                                         int32_t*       out_buf,
                                         size_t         capacity,
                                         size_t*        out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_bspline_v_multiplicities(occtl_graph_t* graph,
                                         occtl_rep_id_t surface_id,
                                         int32_t*       out_buf,
                                         size_t         capacity,
                                         size_t*        out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_weights(const occtl_graph_t* graph,
                                                                  occtl_rep_id_t       surface_id,
                                                                  double*              out_buf,
                                                                  size_t               capacity,
                                                                  size_t*              out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_u_flat_knots(const occtl_graph_t* graph,
                                                                       occtl_rep_id_t surface_id,
                                                                       double*        out_buf,
                                                                       size_t         capacity,
                                                                       size_t*        out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_bspline_v_flat_knots(const occtl_graph_t* graph,
                                                                       occtl_rep_id_t surface_id,
                                                                       double*        out_buf,
                                                                       size_t         capacity,
                                                                       size_t*        out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_bspline_poles_view(occtl_graph_t*         graph,
                                   occtl_rep_id_t         surface_id,
                                   const occtl_point3_t** out_data,
                                   size_t*                out_u_count,
                                   size_t*                out_v_count);
 
typedef struct occtl_surface_bspline
{
  uint32_t    struct_version; 
  const void* p_next;         
  int32_t u_degree;          
  int32_t v_degree;          
  int32_t is_rational;       
  int32_t is_u_periodic;     
  int32_t is_v_periodic;     
  size_t  u_pole_count;      
  size_t  v_pole_count;      
  size_t  u_knot_count;      
  size_t  v_knot_count;      
  size_t  u_flat_knot_count; 
  size_t  v_flat_knot_count; 
  const occtl_point3_t* poles;     
  const double* weights;           
  const double*  u_knots;          
  const double*  v_knots;          
  const int32_t* u_multiplicities; 
  const int32_t* v_multiplicities; 
  const double*  u_flat_knots;     
  const double*  v_flat_knots;     
} occtl_surface_bspline_t;
 
#define OCCTL_SURFACE_BSPLINE_VERSION_1 1u
 
#define OCCTL_SURFACE_BSPLINE_INIT                                                                 \
  {OCCTL_SURFACE_BSPLINE_VERSION_1,                                                                \
   NULL,                                                                                           \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   0,                                                                                              \
   NULL,                                                                                           \
   NULL,                                                                                           \
   NULL,                                                                                           \
   NULL,                                                                                           \
   NULL,                                                                                           \
   NULL,                                                                                           \
   NULL,                                                                                           \
   NULL}
 
OCCTL_API void OCCTL_CALL occtl_surface_bspline_init(occtl_surface_bspline_t* out);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_as_bspline(const occtl_graph_t*     graph,
                                                             occtl_rep_id_t           surface_id,
                                                             occtl_surface_bspline_t* out);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_eval_d0(const occtl_graph_t* graph,
                                                          occtl_rep_id_t       surface_id,
                                                          double               u,
                                                          double               v,
                                                          occtl_point3_t*      out_point);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_eval_d1(const occtl_graph_t* graph,
                                                          occtl_rep_id_t       surface_id,
                                                          double               u,
                                                          double               v,
                                                          occtl_point3_t*      out_point,
                                                          occtl_vector3_t*     out_d1u,
                                                          occtl_vector3_t*     out_d1v);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_eval_d2(const occtl_graph_t* graph,
                                                          occtl_rep_id_t       surface_id,
                                                          double               u,
                                                          double               v,
                                                          occtl_point3_t*      out_point,
                                                          occtl_vector3_t*     out_d1u,
                                                          occtl_vector3_t*     out_d1v,
                                                          occtl_vector3_t*     out_d2u,
                                                          occtl_vector3_t*     out_d2v,
                                                          occtl_vector3_t*     out_d2uv);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_eval_d3(const occtl_graph_t* graph,
                                                          occtl_rep_id_t       surface_id,
                                                          double               u,
                                                          double               v,
                                                          occtl_point3_t*      out_point,
                                                          occtl_vector3_t*     out_d1u,
                                                          occtl_vector3_t*     out_d1v,
                                                          occtl_vector3_t*     out_d2u,
                                                          occtl_vector3_t*     out_d2v,
                                                          occtl_vector3_t*     out_d2uv,
                                                          occtl_vector3_t*     out_d3u,
                                                          occtl_vector3_t*     out_d3v,
                                                          occtl_vector3_t*     out_d3uuv,
                                                          occtl_vector3_t*     out_d3uvv);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_eval_dn(const occtl_graph_t* graph,
                                                          occtl_rep_id_t       surface_id,
                                                          double               u,
                                                          double               v,
                                                          int32_t              nu,
                                                          int32_t              nv,
                                                          occtl_vector3_t*     out_derivative);
 
typedef struct occtl_surface_interpolated_info
{
  uint32_t              struct_version; 
  const void*           p_next;         
  const occtl_point3_t* points;         
  size_t  u_point_count;                
  size_t  v_point_count;                
  int32_t is_u_periodic;                
} occtl_surface_interpolated_info_t;
 
#define OCCTL_SURFACE_INTERPOLATED_INFO_VERSION_1 1u
#define OCCTL_SURFACE_INTERPOLATED_INFO_INIT                                                       \
  {OCCTL_SURFACE_INTERPOLATED_INFO_VERSION_1, NULL, NULL, 0, 0, 0}
 
OCCTL_API void OCCTL_CALL
  occtl_surface_interpolated_info_init(occtl_surface_interpolated_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_interpolated(occtl_graph_t*                           graph,
                                    const occtl_surface_interpolated_info_t* info,
                                    occtl_rep_id_t*                          out_id);
 
typedef struct occtl_surface_approximated_info
{
  uint32_t              struct_version; 
  const void*           p_next;         
  const occtl_point3_t* points;         
  size_t                u_point_count;  
  size_t                v_point_count;  
  int32_t               degree_min;     
  int32_t               degree_max;     
  double                tolerance;      
} occtl_surface_approximated_info_t;
 
#define OCCTL_SURFACE_APPROXIMATED_INFO_VERSION_1 1u
#define OCCTL_SURFACE_APPROXIMATED_INFO_INIT                                                       \
  {OCCTL_SURFACE_APPROXIMATED_INFO_VERSION_1, NULL, NULL, 0, 0, 1, 3, 1e-3}
 
OCCTL_API void OCCTL_CALL
  occtl_surface_approximated_info_init(occtl_surface_approximated_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_approximated(occtl_graph_t*                           graph,
                                    const occtl_surface_approximated_info_t* info,
                                    occtl_rep_id_t*                          out_id);
 
typedef enum occtl_surface_point_grid_mode
{
  OCCTL_SURFACE_POINT_GRID_MODE_APPROXIMATE     = 0, 
  OCCTL_SURFACE_POINT_GRID_MODE_INTERPOLATE     = 1, 
  OCCTL_SURFACE_POINT_GRID_MODE_RESERVED_FUTURE = 0x7fffffff
} occtl_surface_point_grid_mode_t;
 
typedef struct occtl_surface_point_grid_create_info
{
  uint32_t    struct_version;   
  const void* p_next;           
  const occtl_point3_t* points; 
  size_t                          u_point_count; 
  size_t                          v_point_count; 
  occtl_surface_point_grid_mode_t mode;          
  int32_t                         degree_min;    
  int32_t                         degree_max;    
  int32_t                         is_u_periodic; 
  double                          tolerance;     
} occtl_surface_point_grid_create_info_t;
 
#define OCCTL_SURFACE_POINT_GRID_CREATE_INFO_VERSION_1 1u
#define OCCTL_SURFACE_POINT_GRID_CREATE_INFO_INIT                                                  \
  {OCCTL_SURFACE_POINT_GRID_CREATE_INFO_VERSION_1,                                                 \
   NULL,                                                                                           \
   NULL,                                                                                           \
   0,                                                                                              \
   0,                                                                                              \
   OCCTL_SURFACE_POINT_GRID_MODE_APPROXIMATE,                                                      \
   1,                                                                                              \
   3,                                                                                              \
   0,                                                                                              \
   1e-3}
 
OCCTL_API void OCCTL_CALL
  occtl_surface_point_grid_create_info_init(occtl_surface_point_grid_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_from_point_grid(occtl_graph_t*                                graph,
                                       occtl_rep_id_t*                               out_id,
                                       const occtl_surface_point_grid_create_info_t* info);
 
typedef enum occtl_surface_filling_style
{
  OCCTL_SURFACE_FILLING_STRETCH         = 0, 
  OCCTL_SURFACE_FILLING_COONS           = 1, 
  OCCTL_SURFACE_FILLING_CURVED          = 2, 
  OCCTL_SURFACE_FILLING_RESERVED_FUTURE = 0x7fffffff
} occtl_surface_filling_style_t;
 
typedef struct occtl_surface_boundary_curves_create_info
{
  uint32_t    struct_version; 
  const void* p_next;         
  const occtl_rep_id_t*         curves;      
  size_t                        curve_count; 
  occtl_surface_filling_style_t style;       
} occtl_surface_boundary_curves_create_info_t;
 
#define OCCTL_SURFACE_BOUNDARY_CURVES_CREATE_INFO_VERSION_1 1u
#define OCCTL_SURFACE_BOUNDARY_CURVES_CREATE_INFO_INIT                                             \
  {OCCTL_SURFACE_BOUNDARY_CURVES_CREATE_INFO_VERSION_1,                                            \
   NULL,                                                                                           \
   NULL,                                                                                           \
   0,                                                                                              \
   OCCTL_SURFACE_FILLING_STRETCH}
 
OCCTL_API void OCCTL_CALL
  occtl_surface_boundary_curves_create_info_init(occtl_surface_boundary_curves_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_create_from_boundary_curves(
  occtl_graph_t*                                     graph,
  occtl_rep_id_t*                                    out_id,
  const occtl_surface_boundary_curves_create_info_t* info);
 
typedef struct occtl_surface_gordon_create_info
{
  uint32_t              struct_version; 
  const void*           p_next;         
  const occtl_rep_id_t* profiles;       
  size_t                profile_count;  
  const occtl_rep_id_t* guides;         
  size_t                guide_count;    
  double                tolerance;      
  int32_t               parallel;       
} occtl_surface_gordon_create_info_t;
 
#define OCCTL_SURFACE_GORDON_CREATE_INFO_VERSION_1 1u
#define OCCTL_SURFACE_GORDON_CREATE_INFO_INIT                                                      \
  {OCCTL_SURFACE_GORDON_CREATE_INFO_VERSION_1, NULL, NULL, 0, NULL, 0, 1.0e-7, 0}
 
OCCTL_API void OCCTL_CALL
  occtl_surface_gordon_create_info_init(occtl_surface_gordon_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_gordon(occtl_graph_t*                            graph,
                              occtl_rep_id_t*                           out_id,
                              const occtl_surface_gordon_create_info_t* info);
 
typedef struct occtl_surface_curve_grid_create_info
{
  uint32_t    struct_version;     
  const void* p_next;             
  const occtl_rep_id_t* u_curves; 
  size_t                u_curve_count; 
  const occtl_rep_id_t* v_curves;      
  size_t                v_curve_count; 
  double                tolerance;     
  int32_t               parallel;      
} occtl_surface_curve_grid_create_info_t;
 
#define OCCTL_SURFACE_CURVE_GRID_CREATE_INFO_VERSION_1 1u
#define OCCTL_SURFACE_CURVE_GRID_CREATE_INFO_INIT                                                  \
  {OCCTL_SURFACE_CURVE_GRID_CREATE_INFO_VERSION_1, NULL, NULL, 0, NULL, 0, 1.0e-7, 0}
 
OCCTL_API void OCCTL_CALL
  occtl_surface_curve_grid_create_info_init(occtl_surface_curve_grid_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_surface_create_from_curve_grid(occtl_graph_t*                                graph,
                                       occtl_rep_id_t*                               out_id,
                                       const occtl_surface_curve_grid_create_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_intersect_curve(const occtl_graph_t* graph,
                                                                  occtl_rep_id_t       surface_id,
                                                                  occtl_rep_id_t       curve_id,
                                                                  occtl_point3_t*      out_buf,
                                                                  size_t               capacity,
                                                                  size_t*              out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_surface_surface_intersect(occtl_graph_t*   graph,
                                                                    occtl_rep_id_t   surface_a,
                                                                    occtl_rep_id_t   surface_b,
                                                                    double           tolerance,
                                                                    occtl_rep_id_t** out_ids,
                                                                    size_t*          out_count);
 
#ifdef __cplusplus
} /* extern "C" */
#endif
 
#endif /* OCCTL_SURFACES_H */