ENEXEN   

Equivalent PK functions: PK_EDGE_find_extreme
PK_FACE_find_extreme

ENEXEN ( entity, dir1, dir2, dir3, posn, ext, ifail )
=====================================================

  Enquire extreme point of entity

Receives:
  KI_tag_topology          *entity         --- face or edge
  KI_vec_direction          dir1           --- first direction
  KI_vec_direction          dir2           --- second direction
  KI_vec_direction          dir3           --- third direction

Returns:
  KI_vec_position           posn           --- position of extreme point
  KI_tag_topology          *ext            --- face, edge or vertex on
                                           --- which extreme lies
  KI_cod_error             *ifail          --- failure indicator

Specific errors:
  KI_cant_find_extreme      failure
  KI_missing_geom           entity has missing geometry
  KI_wrong_entity           entity is not a face or an edge
  KI_coplanar               directions are coplanar

Description:
  The entity must be a face or an edge.

  The extreme point on the face or edge which is furthest in the direction
  'dir1' is returned, unless there is more than one such point, in which case
  'dir2' and 'dir3' are used successively to reduce the number of extreme
  points to one.

  If the extreme point lies on a vertex or an edge, this is returned in 'ext'.
  Otherwise the face is returned.

  The entity must not have missing geometry.

  The three directions must not be coplanar.