pcidsk_vectorsegment.h

/******************************************************************************
 *
 * Purpose:  PCIDSK Vector Segment public interface. Declaration.
 * 
 ******************************************************************************
 * Copyright (c) 2009
 * PCI Geomatics, 50 West Wilmot Street, Richmond Hill, Ont, Canada
 *
 * Permission is hereby granted, free of charge, to any person obtaining a
 * copy of this software and associated documentation files (the "Software"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 *
 * The above copyright notice and this permission notice shall be included
 * in all copies or substantial portions of the Software.
 *
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
 * DEALINGS IN THE SOFTWARE.
 ****************************************************************************/

#ifndef __INCLUDE_PCIDSK_VECTORSEGMENT_H
#define __INCLUDE_PCIDSK_VECTORSEGMENT_H

#include <string>
#include <vector>
#include <iterator>
#include "pcidsk_shape.h"

namespace PCIDSK
{
    class ShapeIterator;
    
/************************************************************************/
/*                         PCIDSKVectorSegment                          */
/************************************************************************/

    class PCIDSK_DLL PCIDSKVectorSegment
    {
    public:
        virtual ~PCIDSKVectorSegment() {}

        virtual std::string GetRst() = 0;


        virtual std::vector<double> GetProjection( std::string &geosys ) = 0;

        virtual int         GetFieldCount() = 0;

        virtual std::string GetFieldName(int field_index) = 0;

        virtual std::string GetFieldDescription(int field_index) = 0;

        virtual ShapeFieldType GetFieldType(int field_index) = 0;

        virtual std::string GetFieldFormat(int field_index) = 0;

        virtual ShapeField  GetFieldDefault(int field_index) = 0;

        virtual ShapeIterator begin() = 0;

        virtual ShapeIterator end() = 0;

        virtual ShapeId     FindFirst() = 0;

        virtual ShapeId     FindNext(ShapeId id) = 0;
        

        virtual int         GetShapeCount() = 0;

        virtual void        GetVertices( ShapeId id, 
                                         std::vector<ShapeVertex>& list ) = 0;

        virtual void        GetFields( ShapeId id, 
                                       std::vector<ShapeField>& list ) = 0;


        virtual void        SetProjection(std::string geosys,
                                          std::vector<double> parms ) = 0;

        virtual void        AddField( std::string name, ShapeFieldType type,
                                      std::string description,
                                      std::string format,
                                      ShapeField *default_value=NULL ) = 0;

        virtual ShapeId     CreateShape( ShapeId id = NullShapeId ) = 0;

        virtual void        DeleteShape( ShapeId id ) = 0;

        virtual void        SetVertices( ShapeId id, 
                                         const std::vector<ShapeVertex> &list ) = 0;


        virtual void        SetFields( ShapeId id, 
                                       const std::vector<ShapeField>& list) = 0;

// Methods needed 
        // DeleteField
    };

/************************************************************************/
/*                            ShapeIterator                             */
/************************************************************************/


    class ShapeIterator : public std::iterator<std::input_iterator_tag, ShapeId>
    {
        ShapeId id;
        PCIDSKVectorSegment *seg;
        
    public:
        ShapeIterator(PCIDSKVectorSegment *seg_in)
                : seg(seg_in)  { id = seg->FindFirst(); }
        ShapeIterator(PCIDSKVectorSegment *seg_in, ShapeId id_in )
                : id(id_in), seg(seg_in)  {}
        ShapeIterator(const ShapeIterator& mit) : id(mit.id), seg(mit.seg) {}
        ShapeIterator& operator++() { id=seg->FindNext(id); return *this;}
        ShapeIterator& operator++(int) { id=seg->FindNext(id); return *this;}
        bool operator==(const ShapeIterator& rhs) {return id == rhs.id;}
        bool operator!=(const ShapeIterator& rhs) {return id != rhs.id;}
        ShapeId& operator*() {return id;}
    };

} // end namespace PCIDSK

#endif // __INCLUDE_PCIDSK_VECTORSEGMENT_H

---