linkraster.h

openmap java写的开源数字地图程序. 用applet实现,可以像google map 那样放大缩小地图.

/* **********************************************************************
 * 
 * <copyright>
 * 
 *  BBN Technologies, a Verizon Company
 *  10 Moulton Street
 *  Cambridge, MA 02138
 *  [phone]
 * 
 *  Copyright (C) BBNT Solutions LLC. All rights reserved.
 * 
 * </copyright>
 * **********************************************************************
 * 
 * $Source: /cvs/distapps/openmap/src/cserver/link/include/LinkRaster.h,v $
 * $RCSfile: LinkRaster.h,v $
 * $Revision: 1.2 $
 * $Date: 2004/01/26 19:07:09 $
 * $Author: dietrick $
 * 
 * **********************************************************************
 */

#ifndef LINKRASTER_H
#define LINKRASTER_H

#include "LinkSocket.h"
#include "LinkImage.h"
#include "Request.h"
#include "LinkArgs.h"

/* Prototypes for writing Direct model images */

/**
 * Writes a direct model image to the link socket.
 *
 * @param *linkSocket The link socket.
 * @param lat The latitude of the image location (upper left corner), in decimal degrees.
 * @param lon The longitude of the image location (upper left corner), in decimal degrees.
 * @param width The width of the image, in pixels.
 * @param height The height of the image, in pixels.
 * @param *directimage The image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there is a memory allocation error.
 */

int WriteLinkRasterDirectLatLon(LinkSocket *linkSocket,
                                double lat, double lon, 
                                int width, int height,
                                DirectImage *directimage,
                                LinkArgs *linkArgs);

/**
 * Writes a buffered direct model image to the link socket. <b>DEPRECATED</b>
 *
 * <b>Deprecated</b>: Use WriteLinkRasterDirectLatLon().
 *
 * @param *linkSocket The link socket.
 * @param lat The latitude of the image location (upper left corner), in decimal degrees.
 * @param lon The longitude of the image location (upper left corner), in decimal degrees.
 * @param width The width of the image, in pixels.
 * @param height The height of the image, in pixels.
 * @param *directimage The image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int BufferedWriteLinkRasterDirectLatLon(LinkSocket *linkSocket,
                                        double lat, double lon, 
                                        int width, int height,
                                        DirectImage *directimage,
                                        LinkArgs *linkArgs);


/**
 * Writes a direct model image in X-Y space to the link socket.
 *
 * @param *linkSocket The link socket.
 * @param x The X coordinate of the image location from the left side of the canvas, in pixels.
 * @param y The Y coordinate of the image location from the top of the canvas, in pixels.
 * @param width The width of the image, in pixels.
 * @param height The height of the image, in pixels.
 * @param *directimage The image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there is a memory allocation error.
 */

int WriteLinkRasterDirectXY(LinkSocket *linkSocket,
                            int x, int y, 
                            int width, int height,
                            DirectImage *directimage,
                            LinkArgs *linkArgs);

/**
 * Writes a buffered direct model image in X-Y space to the link socket.
 * <b>DEPRECATED</b>
 *
 * <b>Deprecated</b>: Use WriteLinkRasterDirectXY().
 *
 * @param *linkSocket The link socket.
 * @param x The X coordinate of the image location from the left side of the canvas, in pixels.
 * @param y The Y coordinate of the image location from the top of the canvas, in pixels.
 * @param width The width of the image, in pixels.
 * @param height The height of the image, in pixels.
 * @param *directimage The image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int BufferedWriteLinkRasterDirectXY(LinkSocket *linkSocket,
                                    int x, int y, 
                                    int width, int height,
                                    DirectImage *directimage,
                                    LinkArgs *linkArgs);

/** 
 * Writes a direct model image with an offset to the link socket.
 *
 * @param *linkSocket The link socket.
 * @param lat The latitude of the anchor point (upper left corner), in decimal degrees.
 * @param lon The longitude of the anchor point (upper left corner), in decimal degrees.
 * @param x The X coordinate of the image location, offset from the anchor point, in pixels.
 * @param y The Y coordinate of the image location, offset from the anchor point, in pixels.
 * @param width The width of the image, in pixels.
 * @param height The height of the image, in pixels.
 * @param *directimage The image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there is a memory allocation error.
 */

int WriteLinkRasterDirectOffset(LinkSocket *linkSocket,
                                double lat, double lon, 
                                int x, int y, 
                                int width, int height,
                                DirectImage *directimage,
                                LinkArgs *linkArgs);

/**
 * Writes a buffered direct model image with an offset to the link socket.
 * <b>DEPRECATED</b>
 *
 * <b>Deprecated</b>: Use WriteLinkRasterDirectOffset().
 *
 * @param *linkSocket The link socket.
 * @param lat The latitude of the anchor point (upper left corner), in decimal degrees.
 * @param lon The longitude of the anchor point (upper left corner), in decimal degrees.
 * @param x The X coordinate of the image location, offset from the anchor point, in pixels.
 * @param y The Y coordinate of the image location, offset from the anchor point, in pixels.
 * @param width The width of the image, in pixels.
 * @param height The height of the image, in pixels.
 * @param *directimage The image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int BufferedWriteLinkRasterDirectOffset(LinkSocket *linkSocket,
                                        double lat, double lon, 
                                        int x, int y, 
                                        int width, int height,
                                        DirectImage *directimage,
                                        LinkArgs *linkArgs);

/*-----------------------------------------------------------*/
/*Prototypes for writing Indexed model images */

/**
 * Writes an indexed model image to the link socket.
 *
 * @param *linkSocket The link socket
 * @param lat The latitude of the image location (upper left corner), in decimal degrees.
 * @param lon The longitude of the image location (upper left corner), in decimal degrees.
 * @param width The width of the image.
 * @param height The height of the image.
 * @param transparency The transparency of the image, in a range of 0-255.  A transparency of 255 means an opaque image.
 * @param *indeximage The indexed image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int WriteLinkRasterIndexedLatLon(LinkSocket *linkSocket,
                                 double lat, double lon, 
                                 int width, int height,
                                 int transparency,
                                 IndexedImage *indeximage,               
                                 LinkArgs *linkArgs);

/**
 * Writes a buffered indexed model image to the link socket. <b>DEPRECATED</b>
 *
 * <b>Deprecated</b>: Use WriteLinkRasterIndexedLatLon().
 *
 * @param *linkSocket The link socket
 * @param lat The latitude of the image location (upper left corner), in decimal degrees.
 * @param lon The longitude of the image location (upper left corner), in decimal degrees.
 * @param width The width of the image.
 * @param height The height of the image.
 * @param transparency The transparency of the image, in a range of 0-255.  A transparency of 255 means an opaque image.
 * @param *indeximage The indexed image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int BufferedWriteLinkRasterIndexedLatLon(LinkSocket *linkSocket,
                                         double lat, double lon, 
                                         int width, int height, 
                                         int transparency,
                                         IndexedImage *indeximage,               
                                         LinkArgs *linkArgs);


/**
 * Writes an indexed model image in X-Y space to the link socket.