root/lang/cpluspluscli/OpenCvSharp/trunk/OpenCvSharp/IplImage.h @ 26101

/**
 * (C) 2008 Schima
 * This code is licenced under the LGPL.
 */

#pragma once

#include "AllEnums.h"
#include "ICvArr.h"
#include "CvFont.h"
#include "CvPoint.h"
#include "CvRect.h"
#include "CvScalar.h"
#include "CvSize.h"
#include "CvTermCriteria.h"
#include "BitmapConverter.h"
#include "WriteableBitmapConverter.h"

typedef struct _IplImage __IplImage;

using namespace System;
using namespace System::Runtime::InteropServices;
namespace N = KwsmLab::OpenCvSharp;
namespace SD = System::Drawing;
namespace SDI = System::Drawing::Imaging;
#ifdef WPF_ENABLED
namespace SWM = System::Windows::Media;
namespace SWMI = System::Windows::Media::Imaging;
#endif

namespace KwsmLab {
namespace OpenCvSharp
{
        /// <summary>
        /// IPL 画像ヘッダ
        /// </summary>
        public ref class IplImage : public CvArr, public ICvArr<IplImage^>
        {
        private:

        internal:
                /// <summary>
                /// IPL画像ヘッダへのポインタ [ (__IplImage*)Ptr ]
                /// </summary>
                property __IplImage* ImagePtr{
                        __IplImage* get(void){ return (__IplImage*)this->Ptr; }
                }
                IplImage(__IplImage* ptr);
                IplImage(__IplImage* ptr, Boolean isEnabledDispose);
                virtual void Release( void ) override;  

        public:         
                IplImage( String^ filename);
                IplImage( String^ filename, LoadMode flags );
                IplImage( CvSize size, BitDepth depth, Int32 channels );
                IplImage( Int32 width, Int32 height, BitDepth depth, Int32 channels );
                static N::IplImage^ FromPtr( IntPtr ptr );
                static N::IplImage^ FromBitmap( SD::Bitmap^ bitmap );
#ifdef WPF_ENABLED
                static N::IplImage^ FromWriteableBitmap( SWMI::WriteableBitmap^ wb );
#endif
                static IplImage^ CreateHeader(CvSize size, BitDepth depth, Int32 channels);

                #pragma region プロパティ
                /// <summary>
                /// 元データポインタのバイトサイズ、
                /// すなわち sizeof(IplImage) を取得する.
                /// </summary>
                static property Int32 SizeOf{
                        Int32 get(void){ return sizeof(__IplImage); }
                }
                /// <summary>
                /// 画像の行のアライメント（4 あるいは 8）を取得する．
        /// OpenCV はこれを無視して，代わりに widthStep を使用する．
                /// </summary>
                [Obsolete]
                property int Align {
                        int get(){ return ImagePtr->align; }
                };
                /// <summary>
        /// OpenCVでは無視される．
                /// </summary>
                [Obsolete]
                property int AlphaChannel{
                        int get(){ return ImagePtr->alphaChannel; }
                }
                /// <summary>
        /// OpenCVでは無視される．
                /// </summary>
                [Obsolete]
                property IntPtr BorderMode{
                        IntPtr get(){ return IntPtr(ImagePtr->BorderMode); }
                }
                /// <summary>
        /// OpenCVでは無視される．
                /// </summary>
                [Obsolete]
                property IntPtr BorderConst{
                        IntPtr get(){ return IntPtr(ImagePtr->BorderConst); }
                }
                /// <summary>
        /// OpenCVでは無視される．
                /// </summary>
                [Obsolete]
                property IntPtr ColorModel{
                        IntPtr get(){ return IntPtr(ImagePtr->colorModel); }
                }
                /// <summary>
        /// OpenCVでは無視される．
                /// </summary>
                [Obsolete]
                property IntPtr ChannelSeq{
                        IntPtr get(){ return IntPtr(ImagePtr->channelSeq); }
                }
                /// <summary>
                /// 画像の COI（channel of interest）を取得・設定する
                /// </summary>
                property Int32 COI{
                        Int32 get(){ return GetCOI(); }
                        void set(Int32 value){ SetCOI(value); }
                }
                /// <summary>
                /// 0 - インタリーブカラーチャンネル, 1 - 分離カラーチャンネル，
        /// cvCreateImage が作成できるのは，インタリーブ画像のみ
                /// </summary>
                property int DataOrder{
                        int get(){ return ImagePtr->dataOrder; }
                }
                /// <summary>
                /// ピクセルの色深度のビット数を取得する
                /// </summary>
                property BitDepth Depth{
                        BitDepth get(){ return (BitDepth)(ImagePtr->depth); }
                }
                /// <summary>
                /// 画像のピクセル高さを取得する
                /// </summary>
                property int Height {
                        int get(){ return ImagePtr->height; }
                };
                /// <summary>
                /// バージョン (=0) を取得する
                /// </summary>
                property int ID{
                        int get(){ return ImagePtr->ID; }
                }
                /// <summary>
                /// アライメントが調整された画像データへのポインタを取得する. これを通してピクセルデータにアクセスできる。
                /// 利用する際は System::Byte* にキャストすべし。
                /// </summary>
                property IntPtr ImageData{
                        IntPtr get(){ return IntPtr(ImagePtr->imageData); }
                }
                /// <summary>
                /// アライメントが調整された画像データへのポインタを取得する. これを通してピクセルデータにアクセスできる。
                /// ImageDataプロパティでbyte*にキャストする手間を省くため定義されている。
                /// しかしプロパティ呼び出しによるオーバーヘッドがあるため、高速化のためにはbyte* p = image.ImageDataPtr; のように一旦変数へ移し替えるべし。
                /// </summary>
                property Byte* ImageDataPtr{
                        Byte* get(){ return (Byte*)ImagePtr->imageData; }
                }
                /// <summary>
                /// オリジナル画像データへのポインタを取得する
        ///（アライメントが調整されているとは限らない）- これは画像を正しく解放するために必要．
                /// </summary>
                property IntPtr ImageDataOrigin{
                        IntPtr get(){ return IntPtr(ImagePtr->imageDataOrigin); }
                }
                /// <summary>
                /// 画像データのバイトサイズを取得する
        /// (インタリーブデータの場合は，=image->height*image->widthStep）
                /// </summary>
                property int ImageSize{
                        int get(){ return ImagePtr->imageSize; }
                }
                /// <summary>
                /// OpenCVでは必ずNULL
                /// </summary>
                [Obsolete]
                property IntPtr MaskROI{
                        IntPtr get(){ return IntPtr(ImagePtr->maskROI); }
                }
                /// <summary>
                /// チャンネル数をを取得する. OpenCV のほとんどの関数が，1,2,3および4チャンネルをサポートする
                /// </summary>
                property int NChannels{
                        int get(){ return ImagePtr->nChannels; }
                }
                /// <summary>
                /// sizeof(IplImage)
                /// </summary>
                property int NSize {
                        int get(){ return ImagePtr->nSize; }
                };
                /// <summary>
                /// 画像の原点をを取得する. 
                /// 0 - 左上原点，1 - 左下原点（Windowsのビットマップ形式）
                /// </summary>
                property int Origin {
                        int get(){ return ImagePtr->origin; }
                };
                /// <summary>
                /// 画像 ROI の矩形を取得、設定する
                /// </summary>
                property N::CvRect ROI{
                        N::CvRect get(){ return GetROI(); }
                        void set(CvRect rect){ SetROI(rect); }
                }
                /// <summary>
                /// 画像のサイズを取得する(ROIのサイズではなく、元々のサイズ)
                /// </summary>
                property N::CvSize Size{
                        N::CvSize get(){ return N::CvSize(Width, Height); }
                }
                /// <summary>
                /// 画像のピクセル幅を取得する
                /// </summary>
                property int Width {
                        int get(){ return ImagePtr->width; }
                };
                /// <summary>
                /// アライメントが調整された画像の行のバイトサイズを取得する
                /// </summary>
                property int WidthStep {
                        int get(){ return ImagePtr->widthStep; }
                };
                #pragma endregion

                #pragma region ICvArrメソッド
                virtual N::IplImage^ Clone( void );     
                virtual array<N::IplImage^>^ Split( void );
                #pragma endregion

                #pragma region IplImage独自メソッド
                Int32 GetCOI( void );
                N::CvRect GetROI( void );
                N::IplImage^ InitHeader( N::CvSize size, BitDepth depth, Int32 channels );
                N::IplImage^ InitHeader( N::CvSize size, BitDepth depth, Int32 channels, ImageOrigin origin );
                N::IplImage^ InitHeader( N::CvSize size, BitDepth depth, Int32 channels, ImageOrigin origin, Int32 align );
                void PutText( String^ text, CvPoint org, N::CvFont^ font, CvColor color );
                void PyrSegmentation( N::IplImage^ dst, Int32 level, Double threshold1, Double threshold2 );
                void PyrSegmentation( N::IplImage^ dst, N::CvMemStorage^ storage, N::CvSeq^ comp, Int32 level, Double threshold1, Double threshold2 );
                void ReleaseHeader( void );
                void ResetROI( void );
                void SetCOI( Int32 coi );
                void SetROI( N::CvRect rect );
                void SnakeImage( array<N::CvPoint>^ points, Single alpha, Single beta, Single gamma, N::CvSize win, N::CvTermCriteria^ criteria );
                void SnakeImage( array<N::CvPoint>^ points, Single alpha, Single beta, Single gamma, N::CvSize win, N::CvTermCriteria^ criteria, Boolean calc_gradient );
                void SnakeImage( array<N::CvPoint>^ points, array<Single>^ alpha, array<Single>^ beta, array<Single>^ gamma, N::CvSize win, N::CvTermCriteria^ criteria );
                void SnakeImage( array<N::CvPoint>^ points, array<Single>^ alpha, array<Single>^ beta, array<Single>^ gamma, N::CvSize win, N::CvTermCriteria^ criteria, Boolean calc_gradient );
                SD::Bitmap^ ToBitmap( void );
                SD::Bitmap^ ToBitmap( SDI::PixelFormat pf );
#ifdef WPF_ENABLED
                SWMI::WriteableBitmap^ ToWriteableBitmap( SWM::PixelFormat pf );
                SWMI::WriteableBitmap^ ToWriteableBitmap( Double dpiX, Double dpiY, SWM::PixelFormat pf, SWMI::BitmapPalette^ bp );
#endif
                #pragma endregion
        };

}
}