Header to include: icont.h
Creates one new contour and initializes it to default values. Returns NULL if error.
Creates an array of size contours and initializes them to default values. Returns NULL if error.
Initializes cont to default values for an empty contour.
Copies the contour structure in from to to without copying any data. Returns -1 if error.
Creates a new contour containing the same point, size, and label data as cont. Returns NULL if error.
Deletes cont, freeing all data and the contour structure. Returns -1 if error (i.e., cont is NULL).
Frees all data in contour cont and sets its pointers to NULL. Returns -1 if error
Frees just the point data in contour cont and sets the pointer for point data to NULL and the point count to 0. Returns -1 if error.
Deletes an array of size contours in cont, freeing all data and the array itself. Returns -1 if error (i.e., cont is NULL).
Deletes contours from object obj, retaining keep. The contour data are freed and the contour array is reallocated to the new size. Returns -1 if error.
Assigns a new surface number to contour cont and adjusts the maximum surface number for obj, the object that it is in. Returns -1 if error.
Finds the first unused surface number in object obj, and returns this number or 0 for an error.
Sets the wild flag in contour cont (ICONT_FLAG in cont->flags) if Z is not the same for all points when rounded to the nearest integer.
Returns pointer to the label structure of inContour or NULL if no contour or label
Sets the label of inContour to inLabel
Returns the number of points in inContour
Returns pointer to the point array of inContour, or NULL if none
Sets the point array of inContour to inPoint and sets the number of points to inMax
Returns pointer to point inIndex of inContour or NULL for error
Returns the time value of inContour, or 0 if no contour
Sets the time value of inContour to inTime
Returns the surface number of inContour, or 0 if no contour
Sets the surface number of inContour to inSurface
Sets bit flags defined by inFlag in the flag element of inContour to the off if inState is 0 or on if inState is nonzero.
Returns the value of the bit flags defined by inFlag in the flag element of inContour
Returns pointer to name string of inContour, or to empty string if none
Returns area of contour cont in square pixels. The contour need not be COplanar. The area is computed as half the magnitude of the sum of cross-products of adjacent line segments.
Returns area of contour cont in the X/Y plane in square pixels, or 0 for an error. Area is measured by converting to a scan contour and summing the length of the scan lines. Used (only) by imodContourCircularity.
returns length of contour cont in pixels, including the distance from ending to starting point if closed is non-zero. Returns -1 for error.
Returns length of contour cont, excluding a connection between last and first points, or -1 if error.
Returns a moment of the contour cont relative to the origin, where the order of the moment is a in X and b in Y. It computes the sum x**a * y**b over all pixels within the contour. cont can be scan contour; if it is not, a temporary scan contour is generated. Returns 0 for error. Unused as of 12/7/17.
Computes the center of mass of contour cont and returns the result in rpt. The contour is assumed to lie in the X/Y plane. Returns 0 for success, -1 for an error, or 0 if the cont is NULL or has no points, in which case rpt is 0,0,0. cont can be a scan contour; if not, a temporary scan contour is made. Calls imodel_contour_centroid.
Computes components of the centroid of contour icont. If ICONT_TEMPUSE is not set in the flags element of icont, it treats the contour as coming from a closed contour object and assumes it is confined to the X/Y plane, and returns the sum of pixel locations inside the contour in rcp and the pixel sum, or area, in rtw. The input contour can be a scan contour; if not, a temporary scan contour is made. If ICONT_TEMPUSE is set, it treats it as coming from an open contour object and returns the sum of pixel locations along the contour in rcp and the contour length in rtw. In either case the centroid is rcp->x/rtw, rcp->y/rtw, rcp->z/rtw. Returns -1 for error.
Returns the moment of contour cont of order a in X and order b in Y, relative to the point org. Computes (x - org->x)**a * (y - org->y)**b over all pixels inside the contour. cont can already be a scan contour; if not, a temporary scan contour is generated. Returns 0 for error.
Computes an ellipse whose moments are the same as the area inside contour cont, which is assumed to be planar, and returns the center position in center, the a and b parameters for long and short axes in longAxis and shortAxis, and the orientation of the long axis, in degrees between 0 and 180, in angle. Returns 1 for error, including having a contour with less than 3 points. Although cont can already be a scan contour, accuracy will be higher if it is not, because a scan contour is created after scaling the contour up by a factor of 4.
Returns the circularity of a closed contour, based on perimeter squared to area. A perfect circle = 1.0, a square = 1.27. Returns 1000. for error or zero area contour.
Measures the angle at which the contour is most elongated, to the precision set by precision, in degrees. It simply rotates the contour, looking for the bounding box with the greatest ratio of height to width. Returns the angle to the long axis in radians, or 0 for an error. Returns the ratio of long to short axis in aspect, and the length of the long axis in longaxis.
Fits a plane to the contour cont, where points are scaled by scale. For a plane equation Ax + By + Cz + D = 0, the normal (A,B,C) is returned in norm, and D is returned in dval. The rotations (in radians) around the Y axis then the X axis that will make the plane be flat are returned in beta and alpha. Returns 1 if there are too few points in the contour or if the points are too close to colinear.
Calculates the full 3D bounding box of contour cont and returns the lower left, bottom coordinates in ll and the upper right, top coordinates in ur. Returns -1 if error.
Computes the mean Z value of a contour and rounds to nearest integer, or returns -1 if no contour or no points
Determines whether contour cont is clockwise or counter-clockwise and returns IMOD_CONTOUR_CLOCKWISE or IMOD_CONTOUR_COUNTER_CLOCKWISE, or 0 for an error an a contour with no area.
Returns non-zero if (x, y) is in point list of contour cont, or 0 if it is not. (unused 4/22/05)
Returns the index of the point in contour cont that is nearest in 3D to point pnt, or -1 for an error.
Returns the index of the point in contour cont that is nearest in X and Y to (x, y), or -1 for an error.
Returns 1 if contour inner is completely inside or touching contour outer, otherwise returns 0.
Joins two contours c1 and c2 by adding a connecting lines between them
and arranging points from the two contours into a single path.
If st1 and st2 are >=0 the contours will be joined at points st1 and st2; if either one is negative they will be joined at their nearest points.
If fill is 1 or -1, a point will be placed in the middle of the connector at 0.75 pixels up or down in Z, respectively. The fill point will be given the general storage properties of the preceding point in the contour.
If counterdir is nonzero the two contours will be made to go in opposite directions before being joined.
If fill is 0, then it will separate the two connecting lines to leave an open channel between the contours, moving them each back up to 1 pixel from being in the same position. Otherwise, the two connecting lines overlap. This is needed for `* meshing, which is why the fill value prevents the separation.
Returns a contour with points 0 to p1 from contour c1 and points from p2 to the end from contour c2.
Adds together two scan contours c1 and c2, returning all of their segments in order and combining segments where they overlap. Returns NULL for error.
Returns a contour containing points from p1 to p2, inclusive, from contour cont, and removes those points from cont. If p2 is < 0 all points from p1 to the end are transferred to the new contour. Returns NULL if error.
Sorts points in contour cont from index bgnpt through index endpt by their X coordinates; preserves sizes but not label indexes. Returns -1 for error. Used (only) by imodel_contour_scan.
Sorts points in contour cont from index bgnpt through index endpt by their Y coordinates; preserves sizes but not label indexes. Returns -1 for error. (Unused 4/22/05)
Sorts points in contour cont from index bgnpt through index endpt by their Z coordinates; preserves sizes but not label indexes. Returns -1 for error. Used in 3dmod.
Sorts points in contour cont by proximity, using the scale factors in scale to evaluate distances in 3D. Starting from the first point, it makes the closest point be the next point, then moves on to the next point and makes the closest among the remaining points be the next point. It then runs a second pass in the opposite direction. It preserves sizes but not label indexes. Returns -1 for error. Used by 3dmod.
Sorts points in contour cont by proximity in the X/Y plane, by calling imodContourSort3D with a scale of 1,1,0. Returns -1 for error. Maintained for consistency with previous behavior of this sort function.
Inverts the order of points in contour cont; preserves points sizes and labels. Returns -1 for error.
Reduces the points in contour cont by selecting a minimal subset of the points. Each of the original points will be within a tolerance tol of the segments defined by the remaining points.
Removes points from contour cont whose distance from both the previous and the next point is less than dist. Returns -1 for error. See imodContourReduce, which will preserve structure better.
Removes adjacent duplicate points from contour cont. Returns non-zero for error.
Removes points that are not needed in contour cont; specifically, if three sequential points are colinear it removes the middle one. Returns 0.
Rounds off X/Y point coordinates of contour cont to the nearest integer.
Sets the Z values of all points in the contour to the mean Z value rounded to the nearest integer
Scales all point values in contour cont by spoint. (Unused 4/22/05)
Rotates contour cont in the X/Y plane about the origin by angle rot in radians.
Sets the direction of the contour cont to the value of direction, either IMOD_CONTOUR_CLOCKWISE or IMOD_CONTOUR_COUNTER_CLOCKWISE.
Creates a scan contour from contour incont and returns pointer to it, or NULL for an error. A scan contour consists of pairs of points at the starts and ends of horizontal lines. The pairs are in order by increasing Y, and by increasing X at each Y level. Z coordinates are ignored, except that the Z coordinate of the first point on incont is transferred to the first point of the scan contour.
Returns 1 if contour c1 overlaps contour c2 when projected onto the X/Y plane. Returns 0 if not, or if an error occurs.
Returns 1 if scan contour c1 overlaps scan contour c2. Returns 0 if not, or for an error.
Returns 1 if there is overlap between the contours whose addresses are pointed to by cs1p and cs2p, and returns fractions of each contour's area that overlaps in frac1 and frac2. The bounding boxes of the contours must be provided in in pmin1, pmax1, pmin2, and pmax2. If the contours are already scan contours, they are unchanged. If they are not scan contours and their bounding boxes do not overlap, the contours are converted to scan contours and the address of the scan contour is placed into cs1p and/or cs2p. This allows scan conversions to be done only when needed. Returns 0 for no overlap or error.
Swaps the values in two contour structures c1 and c2 (Unused 4/22/05)
Makes tables for object obj of contour z values, number and contours at
each z value. Returns -1 if error.
incz = Z increment
clearFlag = a flag to clear in cont->flags
contzp = pointer to array for Z values
zlist = pointer to returned array for list of z values
numatzp = pointer to returned array for number of contours at each Z
contatzp = pointer to returned array of int pointers to list of contours at each Z
zminp, zmaxp = pointers for return values of minimum and maximum Z
zlsizep = pointer for return value of size of list of Z values
nummaxp = pointer for return value of maximum contours on any section
Frees the tables of contour Z values, number and contours at Z created by imodContourMakeZTables
Checks for one contour inside another and maintains nesting structures
co, eco = contour numbers, indexes into arrays
scancont = pointer to array of scan contours
pmin, pmax = arrays of minimum and maximum points (bounding boxes)
nests = pointer to array of nesting structures
nestind = array for index from contours to nests
numnests = pointer to number of nests found
numwarn = pointer to flag for warning on contour overlap: -1 for no warnings, 0 for warnings, becomes 1 after first warning
Frees the array of numnests nests in nests and their internal arrays
Analyzes inside and outside contours to determine level. nests is an array of numnests nesting structures, nestind is an array with indexes from contours to nests.