occtl_topo_build.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_TOPO_BUILD_H
#define OCCTL_TOPO_BUILD_H
 
#include <stddef.h>
#include <stdint.h>
 
#include "occtl_core.h"
#include "occtl_curves.h"
#include "occtl_geom.h"
#include "occtl_surfaces.h"
#include "occtl_topo_relation.h"
#include "occtl_topo_types.h"
 
#ifdef __cplusplus
extern "C"
{
#endif
 
#define OCCTL_TOPO_MAKE_VERTEX_INFO_VERSION_1 1u
 
typedef struct occtl_topo_make_vertex_info
{
  uint32_t       struct_version; 
  const void*    p_next;         
  occtl_point3_t point;          
  double         tolerance;      
} occtl_topo_make_vertex_info_t;
 
#define OCCTL_TOPO_MAKE_VERTEX_INFO_INIT                                                           \
  {OCCTL_TOPO_MAKE_VERTEX_INFO_VERSION_1, NULL, {0.0, 0.0, 0.0}, 0.0}
 
OCCTL_API void OCCTL_CALL occtl_topo_make_vertex_info_init(occtl_topo_make_vertex_info_t* info);
 
#define OCCTL_TOPO_MAKE_EDGE_INFO_VERSION_1 1u
 
typedef struct occtl_topo_make_edge_info
{
  uint32_t        struct_version; 
  const void*     p_next;         
  occtl_node_id_t start_vertex;   
  occtl_node_id_t end_vertex;     
  occtl_rep_id_t
         curve; 
  double first; 
  double last;  
  double tolerance; 
} occtl_topo_make_edge_info_t;
 
#define OCCTL_TOPO_MAKE_EDGE_INFO_INIT                                                             \
  {OCCTL_TOPO_MAKE_EDGE_INFO_VERSION_1,                                                            \
   NULL,                                                                                           \
   OCCTL_NODE_ID_INVALID,                                                                          \
   OCCTL_NODE_ID_INVALID,                                                                          \
   OCCTL_REP_ID_INVALID,                                                                           \
   0.0,                                                                                            \
   0.0,                                                                                            \
   0.0}
 
OCCTL_API void OCCTL_CALL occtl_topo_make_edge_info_init(occtl_topo_make_edge_info_t* info);
 
#define OCCTL_TOPO_MAKE_WIRE_INFO_VERSION_1 1u
 
typedef struct occtl_topo_make_wire_info
{
  uint32_t                     struct_version; 
  const void*                  p_next;         
  const occtl_oriented_node_t* edges; 
  size_t                       edge_count; 
} occtl_topo_make_wire_info_t;
 
#define OCCTL_TOPO_MAKE_WIRE_INFO_INIT {OCCTL_TOPO_MAKE_WIRE_INFO_VERSION_1, NULL, NULL, 0}
 
OCCTL_API void OCCTL_CALL occtl_topo_make_wire_info_init(occtl_topo_make_wire_info_t* info);
 
#define OCCTL_TOPO_EDGES_TO_WIRES_OPTIONS_VERSION_1 1u
 
typedef struct occtl_topo_edges_to_wires_options
{
  uint32_t    struct_version;        
  const void* p_next;                
  const occtl_node_id_t* edges;      
  size_t                 edge_count; 
  double  tolerance;  
  int32_t allow_open; 
} occtl_topo_edges_to_wires_options_t;
 
#define OCCTL_TOPO_EDGES_TO_WIRES_OPTIONS_INIT                                                     \
  {OCCTL_TOPO_EDGES_TO_WIRES_OPTIONS_VERSION_1, NULL, NULL, 0, 0.0, 1}
 
OCCTL_API void OCCTL_CALL
  occtl_topo_edges_to_wires_options_init(occtl_topo_edges_to_wires_options_t* options);
 
#define OCCTL_TOPO_WIRE_OFFSET_2D_OPTIONS_VERSION_1 1u
 
typedef enum occtl_topo_wire_offset_2d_join
{
  OCCTL_TOPO_WIRE_OFFSET_2D_JOIN_ARC     = 0, 
  OCCTL_TOPO_WIRE_OFFSET_2D_JOIN_TANGENT = 1, 
  OCCTL_TOPO_WIRE_OFFSET_2D_JOIN_INTERSECTION =
    2, 
  OCCTL_TOPO_WIRE_OFFSET_2D_JOIN_RESERVED_FUTURE = 0x7fffffff
} occtl_topo_wire_offset_2d_join_t;
 
typedef enum occtl_offset_join_type
{
  OCCTL_OFFSET_JOIN_ARC             = 0, 
  OCCTL_OFFSET_JOIN_TANGENT         = 1, 
  OCCTL_OFFSET_JOIN_INTERSECTION    = 2, 
  OCCTL_OFFSET_JOIN_RESERVED_FUTURE = 0x7fffffff
} occtl_offset_join_type_t;
 
typedef struct occtl_topo_wire_offset_2d_options
{
  uint32_t        struct_version; 
  const void*     p_next;         
  occtl_node_id_t wire;           
  double          distance;       
  occtl_topo_wire_offset_2d_join_t join;        
  int32_t                          open_result; 
  int32_t approximate; 
} occtl_topo_wire_offset_2d_options_t;
 
#define OCCTL_TOPO_WIRE_OFFSET_2D_OPTIONS_INIT                                                     \
  {OCCTL_TOPO_WIRE_OFFSET_2D_OPTIONS_VERSION_1,                                                    \
   NULL,                                                                                           \
   OCCTL_NODE_ID_INVALID,                                                                          \
   1.0,                                                                                            \
   OCCTL_TOPO_WIRE_OFFSET_2D_JOIN_ARC,                                                             \
   0,                                                                                              \
   0}
 
OCCTL_API void OCCTL_CALL
  occtl_topo_wire_offset_2d_options_init(occtl_topo_wire_offset_2d_options_t* options);
 
#define OCCTL_TOPO_WIRE_FIX_DEGENERATE_EDGES_OPTIONS_VERSION_1 1u
 
typedef struct occtl_topo_wire_fix_degenerate_edges_options
{
  uint32_t struct_version; 
  const void*     p_next;  
  occtl_node_id_t wire;    
  double          min_length; 
} occtl_topo_wire_fix_degenerate_edges_options_t;
 
#define OCCTL_TOPO_WIRE_FIX_DEGENERATE_EDGES_OPTIONS_INIT                                          \
  {OCCTL_TOPO_WIRE_FIX_DEGENERATE_EDGES_OPTIONS_VERSION_1, NULL, OCCTL_NODE_ID_INVALID, 1.0e-9}
 
OCCTL_API void OCCTL_CALL occtl_topo_wire_fix_degenerate_options_init(
  occtl_topo_wire_fix_degenerate_edges_options_t* options);
 
#define OCCTL_TOPO_FACE_CHAMFER_2D_OPTIONS_VERSION_1 1u
 
typedef struct occtl_topo_face_chamfer_2d_options
{
  uint32_t        struct_version;  
  const void*     p_next;          
  occtl_node_id_t face;            
  const occtl_node_id_t* vertices; 
  size_t                 vertex_count; 
  double                 distance1;    
  double                 distance2;    
} occtl_topo_face_chamfer_2d_options_t;
 
#define OCCTL_TOPO_FACE_CHAMFER_2D_OPTIONS_INIT                                                    \
  {OCCTL_TOPO_FACE_CHAMFER_2D_OPTIONS_VERSION_1, NULL, OCCTL_NODE_ID_INVALID, NULL, 0, 1.0, 1.0}
 
#define OCCTL_TOPO_WIRE_CHAMFER_2D_OPTIONS_VERSION_1 1u
 
typedef struct occtl_topo_wire_chamfer_2d_options
{
  uint32_t        struct_version;  
  const void*     p_next;          
  occtl_node_id_t wire;            
  const occtl_node_id_t* vertices; 
  size_t                 vertex_count; 
  double                 distance1;    
  double                 distance2;    
} occtl_topo_wire_chamfer_2d_options_t;
 
#define OCCTL_TOPO_WIRE_CHAMFER_2D_OPTIONS_INIT                                                    \
  {OCCTL_TOPO_WIRE_CHAMFER_2D_OPTIONS_VERSION_1, NULL, OCCTL_NODE_ID_INVALID, NULL, 0, 1.0, 1.0}
 
OCCTL_API void OCCTL_CALL
  occtl_topo_face_chamfer_2d_options_init(occtl_topo_face_chamfer_2d_options_t* options);
 
OCCTL_API void OCCTL_CALL
  occtl_topo_wire_chamfer_2d_options_init(occtl_topo_wire_chamfer_2d_options_t* options);
 
#define OCCTL_TOPO_MAKE_FACE_INFO_VERSION_1 1u
 
typedef struct occtl_topo_make_face_info
{
  uint32_t    struct_version; 
  const void* p_next;         
  occtl_rep_id_t
    surface; 
  occtl_node_id_t        outer_wire;       
  const occtl_node_id_t* inner_wires;      
  size_t                 inner_wire_count; 
  double                 tolerance;        
} occtl_topo_make_face_info_t;
 
#define OCCTL_TOPO_MAKE_FACE_INFO_INIT                                                             \
  {OCCTL_TOPO_MAKE_FACE_INFO_VERSION_1,                                                            \
   NULL,                                                                                           \
   OCCTL_REP_ID_INVALID,                                                                           \
   OCCTL_NODE_ID_INVALID,                                                                          \
   NULL,                                                                                           \
   0,                                                                                              \
   0.0}
 
OCCTL_API void OCCTL_CALL occtl_topo_make_face_info_init(occtl_topo_make_face_info_t* info);
 
#define OCCTL_TOPO_MAKE_FACE_FROM_WIRES_AUTO_OPTIONS_VERSION_1 1u
 
typedef struct occtl_topo_make_face_from_wires_auto_options
{
  uint32_t struct_version; 
  const void* p_next;      
  occtl_rep_id_t
    surface; 
  const occtl_node_id_t* wires;      
  size_t                 wire_count; 
  double                 tolerance;  
  double area_tolerance;             
} occtl_topo_make_face_from_wires_auto_options_t;
 
#define OCCTL_TOPO_MAKE_FACE_FROM_WIRES_AUTO_OPTIONS_INIT                                          \
  {OCCTL_TOPO_MAKE_FACE_FROM_WIRES_AUTO_OPTIONS_VERSION_1,                                         \
   NULL,                                                                                           \
   OCCTL_REP_ID_INVALID,                                                                           \
   NULL,                                                                                           \
   0,                                                                                              \
   0.0,                                                                                            \
   1.0e-9}
 
OCCTL_API void OCCTL_CALL occtl_topo_make_face_from_wires_auto_options_init(
  occtl_topo_make_face_from_wires_auto_options_t* options);
 
#define OCCTL_TOPO_MAKE_SHELL_INFO_VERSION_1 1u
 
typedef struct occtl_topo_make_shell_info
{
  uint32_t    struct_version;         
  const void* p_next;                 
  const occtl_oriented_node_t* faces; 
  size_t                       face_count; 
  int32_t                      is_closed;  
} occtl_topo_make_shell_info_t;
 
#define OCCTL_TOPO_MAKE_SHELL_INFO_INIT {OCCTL_TOPO_MAKE_SHELL_INFO_VERSION_1, NULL, NULL, 0, 0}
 
OCCTL_API void OCCTL_CALL occtl_topo_make_shell_info_init(occtl_topo_make_shell_info_t* info);
 
#define OCCTL_TOPO_MAKE_SOLID_INFO_VERSION_1 1u
 
typedef struct occtl_topo_make_solid_info
{
  uint32_t    struct_version; 
  const void* p_next;         
  const occtl_oriented_node_t*
         shells;      
  size_t shell_count; 
} occtl_topo_make_solid_info_t;
 
#define OCCTL_TOPO_MAKE_SOLID_INFO_INIT {OCCTL_TOPO_MAKE_SOLID_INFO_VERSION_1, NULL, NULL, 0}
 
OCCTL_API void OCCTL_CALL occtl_topo_make_solid_info_init(occtl_topo_make_solid_info_t* info);
 
#define OCCTL_TOPO_MAKE_COMPOUND_INFO_VERSION_1 1u
 
typedef struct occtl_topo_make_compound_info
{
  uint32_t    struct_version; 
  const void* p_next;         
  const occtl_oriented_node_t*
         children;    
  size_t child_count; 
} occtl_topo_make_compound_info_t;
 
#define OCCTL_TOPO_MAKE_COMPOUND_INFO_INIT {OCCTL_TOPO_MAKE_COMPOUND_INFO_VERSION_1, NULL, NULL, 0}
 
OCCTL_API void OCCTL_CALL occtl_topo_make_compound_info_init(occtl_topo_make_compound_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_make_vertex(occtl_graph_t*                       graph,
                         const occtl_topo_make_vertex_info_t* info,
                         occtl_node_id_t*                     out_vertex);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_make_edge(occtl_graph_t*                     graph,
                                                         const occtl_topo_make_edge_info_t* info,
                                                         occtl_node_id_t* out_edge);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_make_wire(occtl_graph_t*                     graph,
                                                         const occtl_topo_make_wire_info_t* info,
                                                         occtl_node_id_t* out_wire);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_edges_to_wires(occtl_graph_t*                             graph,
                            const occtl_topo_edges_to_wires_options_t* options,
                            occtl_node_id_t*                           out_wires,
                            size_t                                     cap,
                            size_t*                                    out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_wire_offset_2d(occtl_graph_t*                             graph,
                            const occtl_topo_wire_offset_2d_options_t* options,
                            occtl_node_id_t*                           out_wire);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_curves_to_wire(occtl_graph_t*        graph,
                                                              const occtl_rep_id_t* curve_ids,
                                                              size_t                count,
                                                              occtl_node_id_t*      out_wire);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_wire_fix_degenerate(occtl_graph_t*                                        graph,
                                 const occtl_topo_wire_fix_degenerate_edges_options_t* options,
                                 size_t*                                               out_removed);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_face_chamfer_2d(occtl_graph_t*                              graph,
                             const occtl_topo_face_chamfer_2d_options_t* options,
                             occtl_node_id_t*                            out_face);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_wire_chamfer_2d(occtl_graph_t*                              graph,
                             const occtl_topo_wire_chamfer_2d_options_t* options,
                             occtl_node_id_t*                            out_wire);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_make_face(occtl_graph_t*                     graph,
                                                         const occtl_topo_make_face_info_t* info,
                                                         occtl_node_id_t* out_face);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_make_face_from_wires_auto(
  occtl_graph_t*                                        graph,
  const occtl_topo_make_face_from_wires_auto_options_t* options,
  occtl_node_id_t*                                      out_face);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_make_shell(occtl_graph_t*                      graph,
                                                          const occtl_topo_make_shell_info_t* info,
                                                          occtl_node_id_t* out_shell);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_make_solid(occtl_graph_t*                      graph,
                                                          const occtl_topo_make_solid_info_t* info,
                                                          occtl_node_id_t* out_solid);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_make_compound(occtl_graph_t*                         graph,
                           const occtl_topo_make_compound_info_t* info,
                           occtl_node_id_t*                       out_compound);
 
#define OCCTL_TOPO_MAKE_COMPSOLID_INFO_VERSION_1 1u
 
typedef struct occtl_topo_make_compsolid_info
{
  uint32_t    struct_version; 
  const void* p_next;         
  const occtl_oriented_node_t*
         solids;      
  size_t solid_count; 
} occtl_topo_make_compsolid_info_t;
 
#define OCCTL_TOPO_MAKE_COMPSOLID_INFO_INIT                                                        \
  {OCCTL_TOPO_MAKE_COMPSOLID_INFO_VERSION_1, NULL, NULL, 0}
 
OCCTL_API void OCCTL_CALL
  occtl_topo_make_compsolid_info_init(occtl_topo_make_compsolid_info_t* info);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_make_compsolid(occtl_graph_t*                          graph,
                            const occtl_topo_make_compsolid_info_t* info,
                            occtl_node_id_t*                        out_compsolid);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_remove(occtl_graph_t* graph, occtl_node_id_t id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_remove_subgraph(occtl_graph_t*  graph,
                                                               occtl_node_id_t id);
 
typedef struct occtl_batch occtl_batch_t;
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_begin_batch(occtl_graph_t*  graph,
                                                            occtl_batch_t** out_batch);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_batch_commit(occtl_batch_t* batch);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_batch_abort(occtl_batch_t* batch);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_replace_edge_curve(occtl_graph_t*  graph,
                                                                  occtl_node_id_t edge,
                                                                  occtl_rep_id_t  curve_id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_replace_face_surface(occtl_graph_t*  graph,
                                                                    occtl_node_id_t face,
                                                                    occtl_rep_id_t  surface_id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_replace_coedge_pcurve(occtl_graph_t*  graph,
                                                                     occtl_node_id_t coedge,
                                                                     occtl_rep_id_t  pcurve_id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_add_pcurve(occtl_graph_t*      graph,
                                                          occtl_node_id_t     edge,
                                                          occtl_node_id_t     face,
                                                          occtl_rep_id_t      pcurve_id,
                                                          double              first,
                                                          double              last,
                                                          occtl_orientation_t orientation);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_shell_add_face(occtl_graph_t*      graph,
                                                              occtl_node_id_t     shell,
                                                              occtl_node_id_t     face,
                                                              occtl_orientation_t orientation);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_shell_remove_face(occtl_graph_t*  graph,
                                                                 occtl_node_id_t shell,
                                                                 occtl_node_id_t face);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_face_add_holes(occtl_graph_t*         graph,
                                                              occtl_node_id_t        face,
                                                              const occtl_node_id_t* holes,
                                                              size_t                 hole_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_face_remove_holes(occtl_graph_t*         graph,
                                                                 occtl_node_id_t        face,
                                                                 const occtl_node_id_t* holes,
                                                                 size_t                 hole_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_solid_add_shell(occtl_graph_t*      graph,
                                                               occtl_node_id_t     solid,
                                                               occtl_node_id_t     shell,
                                                               occtl_orientation_t orientation);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_solid_remove_shell(occtl_graph_t*  graph,
                                                                  occtl_node_id_t solid,
                                                                  occtl_node_id_t shell);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_compound_add_child(occtl_graph_t*      graph,
                                                                  occtl_node_id_t     compound,
                                                                  occtl_node_id_t     child,
                                                                  occtl_orientation_t orientation);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_compound_remove_child(occtl_graph_t*  graph,
                                                                     occtl_node_id_t compound,
                                                                     occtl_node_id_t child);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_edge_split(occtl_graph_t*   graph,
                                                          occtl_node_id_t  edge,
                                                          double           parameter,
                                                          occtl_node_id_t* out_edge1,
                                                          occtl_node_id_t* out_edge2);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_edge_add_internal_vertex(occtl_graph_t*  graph,
                                                                        occtl_node_id_t edge,
                                                                        occtl_node_id_t vertex);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_edge_remove_vertex(occtl_graph_t*  graph,
                                                                  occtl_node_id_t edge,
                                                                  occtl_node_id_t vertex);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_edge_continuity(const occtl_graph_t* const      graph,
                             occtl_node_id_t                 edge,
                             occtl_node_id_t                 faceA,
                             occtl_node_id_t                 faceB,
                             occtl_shape_continuity_t* const out_continuity);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_edge_has_continuity(const occtl_graph_t* const graph,
                                 occtl_node_id_t            edge,
                                 occtl_node_id_t            faceA,
                                 occtl_node_id_t            faceB,
                                 int32_t* const             out_has_continuity);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_edge_max_continuity(const occtl_graph_t* const      graph,
                                 occtl_node_id_t                 edge,
                                 occtl_shape_continuity_t* const out_continuity);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_coedge_orientation(const occtl_graph_t* const graph,
                                occtl_node_id_t            coedge,
                                occtl_orientation_t* const out_orientation);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_edge_find_coedge_on_face(const occtl_graph_t* const graph,
                                      occtl_node_id_t            edge,
                                      occtl_node_id_t            face,
                                      occtl_node_id_t* const     out_coedge);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_edge_find_coedge_on_face_oriented(const occtl_graph_t* const graph,
                                               occtl_node_id_t            edge,
                                               occtl_node_id_t            face,
                                               occtl_orientation_t        orientation,
                                               occtl_node_id_t* const     out_coedge);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_vertex_point_in_usage(const occtl_graph_t* const graph,
                                   occtl_node_id_t            vertex,
                                   occtl_node_id_t            parent,
                                   occtl_point3_t* const      out_point);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_vertex_pcurve_parameter(const occtl_graph_t* const graph,
                                     occtl_node_id_t            vertex,
                                     occtl_node_id_t            coedge,
                                     double* const              out_u);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_edge_has_polygon3d(const occtl_graph_t* const graph,
                                                                  occtl_node_id_t            edge,
                                                                  int32_t* const out_has_polygon3d);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_coedge_has_polygon_on_surface(const occtl_graph_t* const graph,
                                           occtl_node_id_t            coedge,
                                           int32_t* const             out_has_polygon_on_surface);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_topo_face_uv_bounds_restricted(const occtl_graph_t* const graph,
                                       occtl_node_id_t            face,
                                       double                     umin,
                                       double                     umax,
                                       double                     vmin,
                                       double                     vmax,
                                       double                     u,
                                       double                     v,
                                       occtl_point3_t* const      out_point,
                                       occtl_vector3_t* const     out_d1u,
                                       occtl_vector3_t* const     out_d1v);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_vertex_point(occtl_graph_t*  graph,
                                                                occtl_node_id_t vertex,
                                                                occtl_point3_t  point);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_vertex_tolerance(occtl_graph_t*  graph,
                                                                    occtl_node_id_t vertex,
                                                                    double          tol);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_edge_tolerance(occtl_graph_t*  graph,
                                                                  occtl_node_id_t edge,
                                                                  double          tol);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_face_tolerance(occtl_graph_t*  graph,
                                                                  occtl_node_id_t face,
                                                                  double          tol);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_edge_param_range(occtl_graph_t*  graph,
                                                                    occtl_node_id_t edge,
                                                                    double          first,
                                                                    double          last);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_edge_same_parameter(occtl_graph_t*  graph,
                                                                       occtl_node_id_t edge,
                                                                       int32_t         flag);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_edge_same_range(occtl_graph_t*  graph,
                                                                   occtl_node_id_t edge,
                                                                   int32_t         flag);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_edge_is_degenerate(occtl_graph_t*  graph,
                                                                      occtl_node_id_t edge,
                                                                      int32_t         flag);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_edge_is_closed(occtl_graph_t*  graph,
                                                                  occtl_node_id_t edge,
                                                                  int32_t         flag);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_wire_is_closed(occtl_graph_t*  graph,
                                                                  occtl_node_id_t wire,
                                                                  int32_t         flag);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_shell_is_closed(occtl_graph_t*  graph,
                                                                   occtl_node_id_t shell,
                                                                   int32_t         flag);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_face_natural_restriction(occtl_graph_t*  graph,
                                                                            occtl_node_id_t face,
                                                                            int32_t         flag);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_coedge_param_range(occtl_graph_t*  graph,
                                                                      occtl_node_id_t coedge,
                                                                      double          first,
                                                                      double          last);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_coedge_uv_box(occtl_graph_t*  graph,
                                                                 occtl_node_id_t coedge,
                                                                 occtl_point2_t  uv_lo,
                                                                 occtl_point2_t  uv_hi);
 
typedef struct occtl_color_rgba
{
  float r; 
  float g; 
  float b; 
  float a; 
} occtl_color_rgba_t;
 
#define OCCTL_MATERIAL_INFO_VERSION_1 1u
 
typedef struct occtl_material_info
{
  uint32_t           struct_version;    
  const void*        p_next;            
  const char*        name;              
  size_t             name_len;          
  int32_t            has_density;       
  double             density;           
  int32_t            has_diffuse_color; 
  occtl_color_rgba_t diffuse_color;     
  occtl_uid_t        metadata_uid;      
} occtl_material_info_t;
 
#define OCCTL_MATERIAL_INFO_INIT                                                                   \
  {OCCTL_MATERIAL_INFO_VERSION_1,                                                                  \
   NULL,                                                                                           \
   NULL,                                                                                           \
   0,                                                                                              \
   0,                                                                                              \
   0.0,                                                                                            \
   0,                                                                                              \
   {1.0f, 1.0f, 1.0f, 1.0f},                                                                       \
   OCCTL_UID_INVALID}
 
typedef enum occtl_joint_kind
{
  OCCTL_JOINT_RIGID           = 0, 
  OCCTL_JOINT_REVOLUTE        = 1, 
  OCCTL_JOINT_LINEAR          = 2, 
  OCCTL_JOINT_CYLINDRICAL     = 3, 
  OCCTL_JOINT_BALL            = 4, 
  OCCTL_JOINT_RESERVED_FUTURE = 0x7fffffff
} occtl_joint_kind_t;
 
#define OCCTL_JOINT_INFO_VERSION_1 1u
 
typedef struct occtl_joint_info
{
  uint32_t           struct_version; 
  const void*        p_next;         
  occtl_joint_id_t   id;             
  occtl_joint_kind_t kind;           
  occtl_node_id_t    node_a;         
  occtl_node_id_t    node_b;         
  occtl_transform_t  frame_a;        
  occtl_transform_t  frame_b;        
  int32_t            has_limit_min;  
  double             limit_min;      
  int32_t            has_limit_max;  
  double             limit_max;      
  occtl_uid_t        metadata_uid;   
} occtl_joint_info_t;
 
#define OCCTL_JOINT_INFO_INIT                                                                      \
  {OCCTL_JOINT_INFO_VERSION_1,                                                                     \
   NULL,                                                                                           \
   OCCTL_JOINT_ID_INVALID,                                                                         \
   OCCTL_JOINT_RIGID,                                                                              \
   OCCTL_NODE_ID_INVALID,                                                                          \
   OCCTL_NODE_ID_INVALID,                                                                          \
   {{1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0}},                                 \
   {{1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0, 0.0, 0.0, 0.0, 1.0, 0.0}},                                 \
   0,                                                                                              \
   0.0,                                                                                            \
   0,                                                                                              \
   0.0,                                                                                            \
   OCCTL_UID_INVALID}
 
typedef struct occtl_metadata_key_view
{
  const char* key;     
  size_t      key_len; 
} occtl_metadata_key_view_t;
 
typedef struct occtl_tag_view
{
  const char* tag;     
  size_t      tag_len; 
} occtl_tag_view_t;
 
typedef struct occtl_select_iter occtl_select_iter_t;
 
typedef struct occtl_select_group_iter occtl_select_group_iter_t;
 
typedef struct occtl_select_bbox
{
  occtl_point3_t min; 
  occtl_point3_t max; 
} occtl_select_bbox_t;
 
typedef struct occtl_graph_obb
{
  occtl_point3_t     center;      
  occtl_direction3_t x_direction; 
  occtl_direction3_t y_direction; 
  occtl_direction3_t z_direction; 
  double             x_half_size; 
  double             y_half_size; 
  double             z_half_size; 
} occtl_graph_obb_t;
 
typedef struct occtl_graph_uv_bounds
{
  double  u_min;                  
  double  u_max;                  
  double  v_min;                  
  double  v_max;                  
  int32_t is_natural_restriction; 
} occtl_graph_uv_bounds_t;
 
typedef struct occtl_graph_mass_properties
{
  double         linear_length;  
  double         surface_area;   
  double         volume;         
  double         mass;           
  occtl_point3_t centre_of_mass; 
  double         inertia[9];     
} occtl_graph_mass_properties_t;
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_clear_cached(occtl_graph_t*  graph,
                                                             occtl_node_id_t node,
                                                             occtl_ref_id_t  ref);
 
typedef enum occtl_select_bbox_mode
{
  OCCTL_SELECT_BBOX_INTERSECTS           = 0, 
  OCCTL_SELECT_BBOX_INSIDE               = 1, 
  OCCTL_SELECT_BBOX_CONTAINS_CENTER      = 2, 
  OCCTL_SELECT_BBOX_MODE_RESERVED_FUTURE = 0x7fffffff
} occtl_select_bbox_mode_t;
 
typedef enum occtl_select_axis
{
  OCCTL_SELECT_AXIS_X               = 0, 
  OCCTL_SELECT_AXIS_Y               = 1, 
  OCCTL_SELECT_AXIS_Z               = 2, 
  OCCTL_SELECT_AXIS_RESERVED_FUTURE = 0x7fffffff
} occtl_select_axis_t;
 
typedef enum occtl_select_axis_position
{
  OCCTL_SELECT_AXIS_POSITION_MIN    = 0, 
  OCCTL_SELECT_AXIS_POSITION_MAX    = 1, 
  OCCTL_SELECT_AXIS_POSITION_CENTER = 2, 
  OCCTL_SELECT_AXIS_POSITION_RESERVED_FUTURE = 0x7fffffff
} occtl_select_axis_position_t;
 
typedef enum occtl_select_normal_mode
{
  OCCTL_SELECT_NORMAL_PARALLEL             = 0, 
  OCCTL_SELECT_NORMAL_ANTIPARALLEL         = 1, 
  OCCTL_SELECT_NORMAL_EITHER               = 2, 
  OCCTL_SELECT_NORMAL_MODE_RESERVED_FUTURE = 0x7fffffff
} occtl_select_normal_mode_t;
 
typedef enum occtl_select_measure_kind
{
  OCCTL_SELECT_MEASURE_EDGE_LENGTH          = 0, 
  OCCTL_SELECT_MEASURE_WIRE_LENGTH          = 1, 
  OCCTL_SELECT_MEASURE_FACE_AREA            = 2, 
  OCCTL_SELECT_MEASURE_SURFACE_AREA         = 3, 
  OCCTL_SELECT_MEASURE_VOLUME               = 4, 
  OCCTL_SELECT_MEASURE_KIND_RESERVED_FUTURE = 0x7fffffff
} occtl_select_measure_kind_t;
 
typedef enum occtl_select_sort_key
{
  OCCTL_SELECT_SORT_NONE            = 0, 
  OCCTL_SELECT_SORT_AXIS_COORDINATE = 1, 
  OCCTL_SELECT_SORT_MEASURE         = 2, 
  OCCTL_SELECT_SORT_DISTANCE_TO_POINT =
    3, 
  OCCTL_SELECT_SORT_NAME             = 4, 
  OCCTL_SELECT_SORT_UID              = 5, 
  OCCTL_SELECT_SORT_DISTANCE_TO_NODE = 6, 
  OCCTL_SELECT_SORT_KEY_RESERVED_FUTURE = 0x7fffffff
} occtl_select_sort_key_t;
 
typedef enum occtl_select_sort_direction
{
  OCCTL_SELECT_SORT_ASCENDING                 = 0, 
  OCCTL_SELECT_SORT_DESCENDING                = 1, 
  OCCTL_SELECT_SORT_DIRECTION_RESERVED_FUTURE = 0x7fffffff
} occtl_select_sort_direction_t;
 
typedef enum occtl_select_group_key
{
  OCCTL_SELECT_GROUP_KIND                = 0, 
  OCCTL_SELECT_GROUP_AXIS_COORDINATE     = 1, 
  OCCTL_SELECT_GROUP_CURVE_KIND          = 2, 
  OCCTL_SELECT_GROUP_SURFACE_KIND        = 3, 
  OCCTL_SELECT_GROUP_NAME                = 4, 
  OCCTL_SELECT_GROUP_COLOR               = 5, 
  OCCTL_SELECT_GROUP_KEY_RESERVED_FUTURE = 0x7fffffff
} occtl_select_group_key_t;
 
#define OCCTL_SELECT_OPTIONS_VERSION_1 1u
#define OCCTL_SELECT_METADATA_FILTER_VERSION_1 1u
#define OCCTL_SELECT_DISTANCE_TO_NODE_SORT_VERSION_1 1u
#define OCCTL_SELECT_GROUP_OPTIONS_VERSION_1 1u
#define OCCTL_SELECT_GROUP_VIEW_VERSION_1 1u
 
typedef struct occtl_select_options
{
  uint32_t                 struct_version; 
  const void*              p_next;         
  occtl_node_id_t          root;      
  uint64_t                 kind_mask; 
  int32_t                  include_root;     
  const char*              name;             
  size_t                   name_len;         
  int32_t                  use_color;        
  occtl_color_rgba_t       color;            
  float                    color_tolerance;  
  int32_t                  use_bbox;         
  occtl_select_bbox_t      bbox;             
  occtl_select_bbox_mode_t bbox_mode;        
  int32_t                  use_curve_kind;   
  occtl_curve_kind_t       curve_kind;       
  int32_t                  use_surface_kind; 
  occtl_surface_kind_t     surface_kind; 
  int32_t             use_axis_position; 
  occtl_select_axis_t axis;              
  occtl_select_axis_position_t axis_position; 
  double  axis_tolerance; 
  int32_t use_normal;     
  occtl_direction3_t            normal; 
  occtl_select_normal_mode_t    normal_mode;            
  double                        normal_angle_tolerance; 
  int32_t                       use_measure;            
  occtl_select_measure_kind_t   measure_kind;           
  double                        measure_min;            
  double                        measure_max;            
  occtl_select_sort_key_t       sort_key; 
  occtl_select_sort_direction_t sort_direction; 
  occtl_select_axis_t           sort_axis; 
  occtl_select_measure_kind_t   sort_measure_kind; 
  occtl_point3_t sort_point; 
} occtl_select_options_t;
 
#define OCCTL_SELECT_OPTIONS_INIT                                                                  \
  {OCCTL_SELECT_OPTIONS_VERSION_1,                                                                 \
   NULL,                                                                                           \
   OCCTL_NODE_ID_INVALID,                                                                          \
   0u,                                                                                             \
   0,                                                                                              \
   NULL,                                                                                           \
   0u,                                                                                             \
   0,                                                                                              \
   {0.0f, 0.0f, 0.0f, 1.0f},                                                                       \
   0.0f,                                                                                           \
   0,                                                                                              \
   {{0.0, 0.0, 0.0}, {0.0, 0.0, 0.0}},                                                             \
   OCCTL_SELECT_BBOX_INTERSECTS,                                                                   \
   0,                                                                                              \
   OCCTL_CURVE_KIND_UNDEFINED,                                                                     \
   0,                                                                                              \
   OCCTL_SURFACE_KIND_UNDEFINED,                                                                   \
   0,                                                                                              \
   OCCTL_SELECT_AXIS_Z,                                                                            \
   OCCTL_SELECT_AXIS_POSITION_MAX,                                                                 \
   1.0e-7,                                                                                         \
   0,                                                                                              \
   {0.0, 0.0, 1.0},                                                                                \
   OCCTL_SELECT_NORMAL_PARALLEL,                                                                   \
   1.0e-7,                                                                                         \
   0,                                                                                              \
   OCCTL_SELECT_MEASURE_FACE_AREA,                                                                 \
   0.0,                                                                                            \
   0.0,                                                                                            \
   OCCTL_SELECT_SORT_NONE,                                                                         \
   OCCTL_SELECT_SORT_ASCENDING,                                                                    \
   OCCTL_SELECT_AXIS_Z,                                                                            \
   OCCTL_SELECT_MEASURE_FACE_AREA,                                                                 \
   {0.0, 0.0, 0.0}}
 
typedef struct occtl_select_metadata_filter
{
  uint32_t    struct_version; 
  const void* p_next;         
  const char* key;            
  size_t      key_len;        
  const char* value;          
  size_t      value_len;      
  int32_t     match_value;    
} occtl_select_metadata_filter_t;
 
#define OCCTL_SELECT_METADATA_FILTER_INIT                                                          \
  {OCCTL_SELECT_METADATA_FILTER_VERSION_1, NULL, NULL, 0u, NULL, 0u, 0}
 
typedef struct occtl_select_distance_to_node_sort
{
  uint32_t        struct_version; 
  const void*     p_next;         
  occtl_node_id_t target;         
} occtl_select_distance_to_node_sort_t;
 
#define OCCTL_SELECT_DISTANCE_TO_NODE_SORT_INIT                                                    \
  {OCCTL_SELECT_DISTANCE_TO_NODE_SORT_VERSION_1, NULL, OCCTL_NODE_ID_INVALID}
 
typedef struct occtl_select_group_options
{
  uint32_t                 struct_version;  
  const void*              p_next;          
  occtl_select_group_key_t key;             
  occtl_select_axis_t      axis;            
  double                   tolerance;       
  float                    color_tolerance; 
  int32_t include_missing; 
} occtl_select_group_options_t;
 
#define OCCTL_SELECT_GROUP_OPTIONS_INIT                                                            \
  {OCCTL_SELECT_GROUP_OPTIONS_VERSION_1,                                                           \
   NULL,                                                                                           \
   OCCTL_SELECT_GROUP_KIND,                                                                        \
   OCCTL_SELECT_AXIS_Z,                                                                            \
   1.0e-7,                                                                                         \
   0.0f,                                                                                           \
   0}
 
typedef struct occtl_select_group_view
{
  uint32_t                 struct_version; 
  const void*              p_next;         
  occtl_select_group_key_t key;            
  occtl_node_kind_t        node_kind;      
  occtl_curve_kind_t       curve_kind;     
  occtl_surface_kind_t     surface_kind;   
  double                 numeric_key; 
  const char*            name;        
  size_t                 name_len;    
  int32_t                has_color;   
  occtl_color_rgba_t     color;       
  const occtl_node_id_t* nodes;       
  size_t                 node_count;  
} occtl_select_group_view_t;
 
#define OCCTL_SELECT_GROUP_VIEW_INIT                                                               \
  {OCCTL_SELECT_GROUP_VIEW_VERSION_1,                                                              \
   NULL,                                                                                           \
   OCCTL_SELECT_GROUP_KIND,                                                                        \
   OCCTL_KIND_INVALID,                                                                             \
   OCCTL_CURVE_KIND_UNDEFINED,                                                                     \
   OCCTL_SURFACE_KIND_UNDEFINED,                                                                   \
   0.0,                                                                                            \
   NULL,                                                                                           \
   0,                                                                                              \
   0,                                                                                              \
   {0.0f, 0.0f, 0.0f, 0.0f},                                                                       \
   NULL,                                                                                           \
   0}
 
OCCTL_API void OCCTL_CALL occtl_select_options_init(occtl_select_options_t* options);
 
OCCTL_API void OCCTL_CALL occtl_select_group_options_init(occtl_select_group_options_t* options);
 
OCCTL_API void OCCTL_CALL occtl_select_group_view_init(occtl_select_group_view_t* view);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_bbox_get(occtl_graph_t*       graph,
                                                         occtl_node_id_t      node,
                                                         occtl_select_bbox_t* out_bbox);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_obb_get(occtl_graph_t*     graph,
                                                        occtl_node_id_t    node,
                                                        occtl_graph_obb_t* out_obb);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_graph_face_uv_bounds_get(occtl_graph_t*           graph,
                                 occtl_node_id_t          face,
                                 occtl_graph_uv_bounds_t* out_uv_bounds);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_measure_get(occtl_graph_t*              graph,
                                                            occtl_node_id_t             node,
                                                            occtl_select_measure_kind_t kind,
                                                            double*                     out_value);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_graph_mass_properties_get(occtl_graph_t*                 graph,
                                  occtl_node_id_t                node,
                                  occtl_graph_mass_properties_t* out_properties);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_edge_curve_kind_get(occtl_graph_t*      graph,
                                                                    occtl_node_id_t     edge,
                                                                    occtl_curve_kind_t* out_kind);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_graph_face_surface_kind_get(occtl_graph_t*        graph,
                                    occtl_node_id_t       face,
                                    occtl_surface_kind_t* out_kind);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_descendant_vertices_get(occtl_graph_t*   graph,
                                                                        occtl_node_id_t  node,
                                                                        occtl_node_id_t* out_buf,
                                                                        size_t           cap,
                                                                        size_t*          out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_descendant_edges_get(occtl_graph_t*   graph,
                                                                     occtl_node_id_t  node,
                                                                     occtl_node_id_t* out_buf,
                                                                     size_t           cap,
                                                                     size_t*          out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_descendant_faces_get(occtl_graph_t*   graph,
                                                                     occtl_node_id_t  node,
                                                                     occtl_node_id_t* out_buf,
                                                                     size_t           cap,
                                                                     size_t*          out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_descendants_get(occtl_graph_t*    graph,
                                                                occtl_node_id_t   node,
                                                                occtl_node_kind_t descendant_kind,
                                                                occtl_node_id_t*  out_buf,
                                                                size_t            cap,
                                                                size_t*           out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_adjacent_faces_get(occtl_graph_t*   graph,
                                                                   occtl_node_id_t  face,
                                                                   occtl_node_id_t* out_buf,
                                                                   size_t           cap,
                                                                   size_t*          out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_adjacent_edges_get(occtl_graph_t*   graph,
                                                                   occtl_node_id_t  edge,
                                                                   occtl_node_id_t* out_buf,
                                                                   size_t           cap,
                                                                   size_t*          out_count);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_pair_distance_get(occtl_graph_t*  graph,
                                                                  occtl_node_id_t first,
                                                                  occtl_node_id_t second,
                                                                  double*         out_distance);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_select_iter_create(occtl_graph_t*                graph,
                                                             const occtl_select_options_t* options,
                                                             occtl_select_iter_t** out_iter);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_select_tagged_iter_create(occtl_graph_t*                graph,
                                  const occtl_select_options_t* options,
                                  const char*                   tag,
                                  size_t                        tagLen,
                                  occtl_select_iter_t**         out_iter);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_select_iter_next(occtl_select_iter_t* iter,
                                                           occtl_node_id_t*     out_node);
 
OCCTL_API void OCCTL_CALL occtl_select_iter_free(occtl_select_iter_t* iter);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_select_group_iter_create(occtl_graph_t*                      graph,
                                 const occtl_select_options_t*       select_options,
                                 const occtl_select_group_options_t* group_options,
                                 occtl_select_group_iter_t**         out_iter);
 
OCCTL_API occtl_status_t OCCTL_CALL
  occtl_select_group_iter_next(occtl_select_group_iter_t* iter,
                               occtl_select_group_view_t* out_view);
 
OCCTL_API void OCCTL_CALL occtl_select_group_iter_free(occtl_select_group_iter_t* iter);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_clone(const occtl_graph_t* source,
                                                      occtl_graph_t**      out_graph);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_graph_compact(occtl_graph_t* graph);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_remove_with_replacement(occtl_graph_t*  graph,
                                                                       occtl_node_id_t node,
                                                                       occtl_node_id_t replacement);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_remove_ref(occtl_graph_t* graph,
                                                          occtl_ref_id_t ref_id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_remove_rep(occtl_graph_t* graph,
                                                          occtl_rep_id_t rep_id);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_cleanup_removed_refs(occtl_graph_t* graph);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_edge_start_vertex(occtl_graph_t*  graph,
                                                                     occtl_node_id_t edge,
                                                                     occtl_node_id_t vertex);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_edge_end_vertex(occtl_graph_t*  graph,
                                                                   occtl_node_id_t edge,
                                                                   occtl_node_id_t vertex);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_ref_orientation(occtl_graph_t*      graph,
                                                                   occtl_ref_id_t      ref_id,
                                                                   occtl_orientation_t orientation);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_ref_location(occtl_graph_t*    graph,
                                                                occtl_ref_id_t    ref_id,
                                                                occtl_transform_t transform);
 
OCCTL_API occtl_status_t OCCTL_CALL occtl_topo_set_wire_ref_is_outer(occtl_graph_t* graph,
                                                                     occtl_ref_id_t ref_id,
                                                                     int32_t        flag);
 
#ifdef __cplusplus
} /* extern "C" */
#endif
 
#endif /* OCCTL_TOPO_BUILD_H */