User Tools

Site Tools


jvs:cigal:manual:chapter3:findvec

CIGAL Reference Manual, Chapter 3 (Functions): findvec

Findvec -- Find the vector nearest a specified position

usage: vecnum = findvec(flag,firstvec,vlist,[x,y,z])
or: vecnum = findvec(flag,firstvec,vlist,[vref])

FINDVEC searches the list of graphics vectors in VLIST to find the stored vector nearest the coordinate position specified by X,Y,Z or the vector, VREF. If the coordinate position (X,Y,Z or VREF) is omitted FINDVEC waits for a coordinate position to be entered with the cursor. If the vector list to search (VLIST) is omitted, FINDVEC will search the default table of stored graphics vectors, VECS. FIRSTVEC is the number of the first vector in VLIST to search (by default, FIRSTVEC is 0).

The FLAG argument tells FINDVEC how to go about the search. The default search (FLAG = 0) is to search through the list of stored vectors, find the first vector end point that is within 3 pixels of the reference point or the closest vector if none are within 3 pixels, move the cursor to the coordinates of the found vector, and return the number of the found vector. Specifying the following values for FLAG can modify this default search by:

   Value     Meaning
     1       Check only the end points of lists of connected vectors,
             otherwise all vector positions (MOVE, DRAW, POINT) are checked
     2       Find nearest point along drawn vectors by interpolating between
             end points (cursor is placed at nearest point, and the returned
             value is the vector number of the end point)
     4       Don't stop search at the first vector within 3 pixels of the
             reference point, check all and return the closest
     8       Place the cursor at the coordinate of the found vector
    16       Don't search, just place the cursor at the coordinates of stored
              vector number FIRSTVEC
   Note:  FLAG values 4 or 8 can be combined with either 1 or 2 by addition.

See Also:
SKETCH(2), VARIABLES(1), VECS(4), VECTORS(1)

CIGAL Home, CIGAL Manual, Functions List, Manual Help

jvs/cigal/manual/chapter3/findvec.txt · Last modified: 2014/08/04 16:03 (external edit)