ocmath_d_polygon_reorder

1 Description
2 Syntax
3 Parameters
4 Return
5 Examples
6 Remark
7 See Also
8 Header to Include
9 Reference

Description

This function test or reorder a polygon.

Syntax

int ocmath_d_polygon_reorder( UINT nSize, double * px, double * py, bool bCCW = true, bool bTest = false )

Parameters

nSize: [input] point number of the polygon
px: [input] x-coordinates of the polgyon, it might be modified if bTest=false
py: [input] y-coordinates of the polgyon, it might be modified if bTest=false
bCCW: [input](true) counter-clockwise or (false) clockwise
bTest: [input] (true) just determine the order or (false) try to order it into bCCW; default: false;

Return

if bTest is false, return 1 if reoder was done,

return 0 if not modified,

return -1 if failed.

if bTest is true, return 1 if bCCW is consistents with polygon,

return 0 if bCCW is inconsistent with polygon,

return -1 if unable to determine.

Examples

EX1

//This example is to check order(bTest is true)
#include <wks2mat.h>
int ocmath_d_polygon_reorder_ex1()
{
        //The polygon in this example is counter-clockwise(CCW)
        double dX[]={1,2,3,4,5,6,7,8};
        double dY[]={5,4,3,1,3,5,6,9};
        UINT nSize = 8;
        //nRet=0, because the polygon is inconsistent with bCCW = false, which means clockwise 
        int nRet = ocmath_d_polygon_reorder(nSize,dX,dY,false,true);      
        if(0 == nRet)
                out_str("This polygon is counter-clockwise");
        else if(1 == nRet)
                out_str("This polygon is clockwise");
        else
                return 0;
        
        return 1;
}

EX2

//This example is to reorder(bTest is false)
#include <wks2mat.h>
int ocmath_d_polygon_reorder_ex2()
{
        //The polygon in this example is counter-clockwise(CCW)
        double dX[]={1,2,3,4,5,6,7,8};
        double dY[]={5,4,3,1,3,5,6,9};
        UINT nSize = 8;

        // nRet = 1, and the polygon will be reordered to clockwise
        int nRet = ocmath_d_polygon_reorder(nSize,dX,dY,false);        if(0 == nRet)
                out_str("This polygon is not reordered");
        else if(1 == nRet)
        {
                out_str("This polygon is reordered");
                printf("The reordered polygon is : \n");
                for(int ii =0 ; ii< nSize; ii++)
                        printf("%f\t%f\n",dX[ii],dY[ii]);
        }
        else
                return 0;
        
        return 1;
}