This is pick.h in view mode; [Download] [Up]
/* Copyright (c) 1992 The Geometry Center; University of Minnesota
1300 South Second Street; Minneapolis, MN 55454, USA;
This file is part of geomview/OOGL. geomview/OOGL is free software;
you can redistribute it and/or modify it only under the terms given in
the file COPYING, which you should have received along with this file.
This and other related software may be obtained via anonymous ftp from
geom.umn.edu; email: software@geom.umn.edu. */
/* Authors: Charlie Gunn, Stuart Levy, Tamara Munzner, Mark Phillips */
#ifndef PICKDEF
#define PICKDEF
/*
* Public definitions for Geom Picking.
*/
typedef struct Pick Pick;
/* Things to look for while picking
* Specify PW_VERT|PW_EDGE|PW_FACE for all,
* or a subset for more specific picks.
* PW_VISIBLE checks Appearance to see what's
* actually visible.
*/
#define PW_VERT 1
#define PW_EDGE 2
#define PW_FACE 4
#define PW_VISIBLE 8
#define PA_END 100
#define PA_THRESH 101 /* float; x/y threshold (in projected space) */
#define PA_POINT 102 /* Point3 *; Picked 3D point (in object space) */
#define PA_DEPTH 103 /* float; depth (== PA_POINT's screen z component) */
/*
* The following attributes are read-only
*/
#define PA_GPRIM 104 /* Geom *; geometric primitive picked if any */
#define PA_TPRIM 105 /* Transform; proj xform applying to PA_GPRIM */
#define PA_WANT 106 /* int; bitmask of desirable values */
#define PA_VERT 107 /* Point3 *; picked vertex, if any */
#define PA_EDGE 108 /* Point3 e[2]; endpoints of picked
edge, if any */
#define PA_FACE 109 /* Point3 *; array of vertices of picked face,
if any */
#define PA_FACEN 110 /* number of elements in PA_FACE array; NOTE:
when setting PA_FACE you must also set
PA_FACEN. */
extern Pick *PickSet( Pick *, int attr, ... );
extern int PickGet( Pick *, int attr, void *attrp );
extern void PickDelete( Pick * );
/*
* Geometric Picking routines.
* GeomMousePick() is intended for normal use by application programs.
* g is the root of the Geom tree
* p is the Pick structure created by PickSet(), etc., or NULL for default;
* If p!=NULL, it is modified in place, so results of the pick can be
* retrieved by later PickGet() calls.
* ap is the Appearance in effect when g is drawn, used to determine
* visibility of features if PW_VISIBLE is set;
* Tproj is the complete object-to-screen projection matrix;
* it normally maps world coordinates in g's space to
* the unit cube -1 <= {x, y, z} <= 1,
* with z = -1 at the near and z = +1 at the far clipping plane,
* x = y = 0 at the center of the screen;
* xpick and ypick are the relative (-1 <= {x,y} <= 1) window
* coordinates of the pick.
*/
extern Geom *GeomMousePick( Geom *g, Pick *p, Appearance *ap, Transform Tproj,
double xpick, double ypick );
/*
* GeomPick() is an internal routine:
* g, p, ap are as above for GeomMousePick.
* T is adapted for convenience in pick calculations;
* it is translated such that the pick goes through (x,y) = (0,0).
*/
extern Geom *GeomPick( Geom *g, Pick *p, Appearance *ap, Transform T );
#endif /*PICKDEF*/
These are the contents of the former NiCE NeXT User Group NeXTSTEP/OpenStep software archive, currently hosted by Netfuture.ch.