class CMyRaster  
{
public:
    static WCHAR* ToWChar(char * str); // 在GDI+中，有关字符的参数类型全部都是WCHAR类型，该函数是将传统字符串进行转换
    static int DisconnectSDE(SE_CONNECTION *connection); // 断开与SDE的连接
    static int ConnectSDE(char *SDE_servername, char *SDE_service, char *SDE_instance, char *SDE_user, char *SDE_password, SE_CONNECTION *connection); // 连接SDE
//    这里应该提供一个ConnectSDE的重载版本用于连接SQLServer服务器
    int GetRaster(const SE_CONNECTION connection, const _ConnectionPtr ADOConn, double left, double right, double top, double bottom, long userScale, CString filename); // 提取影像数据并生成图片的核心方法
    CMyRaster();
    virtual ~CMyRaster();

private:
    int m_QueryRasterRight; // 与查询范围相交的图幅序列的格网索引范围
    int m_QueryRasterLeft;
    int m_QueryRasterTop;
    int m_QueryRasterBottom;
    RASTER_METADATA *m_RastersMetadata; // 图幅元数据数组，核心变量    
    char strTableName[SE_QUALIFIED_TABLE_NAME]; // Raster Catalog的表名    
    char strColName[SE_MAX_COLUMN_LEN]; // 数据的列名，一般就是"IMAGE"    
    int    m_QueryPyramidLevel; // 查询所在的金字塔级别    
    SE_INTERPOLATION_TYPE m_Interpolation; // 插值的方法    
    long *m_ScaleByLevel; // 金字塔该级别上的比例尺    
    long m_NumOfBands; // 波段数
    long m_PyramidHeight; // 金字塔高度
    IMAGE_EXTENT m_DefaultTileSize; // tile大小的预设值    
    SE_ENVELOPE m_WholeExtent; // 最大的全图范围
    int m_UserMapWidth; // 用户地图区的宽度
    int m_UserMapHeight; // 用户地图区的高度

    int Get_RasterMetadata_by_BBox(const SE_CONNECTION connection, const _ConnectionPtr ADOConn, double left, double right, double top, double bottom, long userScale); // 获取SDE中raster图层的元数据
int Get_RasterData_from_SDE(const SE_CONNECTION connection, const _ConnectionPtr ADOConn); // 从数据源中提取影像数据
int Write_to_BMP_file(double left, double right, double top, double bottom, CString filename); // 将影像数据恢复成位图文件
LONG GetScale(LFLOAT ras_xLength, LONG rasWidth, BOOL isBigFont); // 计算比例尺
    int Get_RasterMetadata_by_GridIndex(int rasrownbr, int rascolnbr, int *rasIndex); // 根据格网索引取图幅
    int GetImageCLSID(const WCHAR* format, CLSID* pCLSID); // 得到格式为format的图像文件的编码值，访问该格式图像的COM组件的GUID值保存在pCLSID中
    int Get_PyramidLevel_by_scale(long userScale, int *pyramidLevel); // 根据比例尺获取金字塔索引的级别
int Get_Result_extent(SE_ENVELOPE *resultExtent); // 获取结果位图的地理范围
};

typedef struct raster_metadata
{
    // 下面是每个raster对应的唯一属性
    int    m_RasterID;    // Raster_ID
    int    m_RasterRowNum;    // 图幅格网索引行标号
    int    m_RasterColNum;    // 图幅格网索引列标号
    int    m_QueryTileLeft; // 查询范围对应的tile最左一列的列号    
    int    m_QueryTileRight; // 查询范围对应的tile最右一列的列号    
    int    m_QueryTileTop; // 查询范围对应的tile最上一行的行号    
    int    m_QueryTileBottom; // 查询范围对应的tile最下一行的行号    
    SE_ENVELOPE    m_RasterExtent; // 全图的地理坐标范围    
    IMAGE_EXTENT m_ImageSize; // 全图的像素范围    
    IMAGE_EXTENT m_QueryImageSize; // 与查询范围相交的像素范围    
    IMAGE_EXTENT *m_QueryTilesSize; // 查询范围对应的每个tile的大小（不带零）
    
    // 下面是每个raster中每级金字塔对应的属性，均为数组，其大小在运行时才能确定    
    IMAGE_EXTENT *m_ImageSizeByLevel; // 金字塔该级别上像素范围    
    IMAGE_EXTENT *m_ZerosSizeByLevel; // 金字塔该级别上补零部分的宽与高    
    SE_ENVELOPE    *m_RasterExtentByLevel; // 金字塔该级别上的地理坐标范围    
    int    *m_TotalTileColByLevel; // 金字塔该级别上以tile为单位的列数    
    int    *m_TotalTileRowByLevel; // 金字塔该级别上以tile为单位的行数
}RASTER_METADATA;

// 通过查询范围获取与查询范围相交的全部图幅的元数据
    int ret = Get_RasterMetadata_by_BBox(connection, ADOConn, left, right, top, bottom, scale);
    if (ret != SE_SUCCESS)
        return -1;
    
    // 获取上面求出的图幅序列的像素数据
    ret = Get_RasterData_from_SDE(connection, ADOConn);
    if (ret != SE_SUCCESS)
        return -1;

    // 将存储在临时文件中的像素数据还原成位图
    ret = Write_to_BMP_file(left, right, top, bottom, filename);
    if (ret != SE_SUCCESS)
        return -1;

// 通过查询范围获取与查询范围相交的全部图幅的元数据
    int ret = Get_RasterMetadata_by_BBox(connection, ADOConn, left, right, top, bottom, scale);
    if (ret != SE_SUCCESS)
        return -1;

// 获取上面求出的图幅序列的像素数据
    ret = Get_RasterData_from_SDE(connection, ADOConn);
    if (ret != SE_SUCCESS)
        return -1;

// 将存储在临时文件中的像素数据还原成位图
    ret = Write_to_BMP_file(left, right, top, bottom, filename);
    if (ret != SE_SUCCESS)
        return -1;