linkraster.h

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

 *
 * @param *linkSocket The link socket.
 * @param x The X coordinate of the image location (upper left corner), offset from the top left corner of the canvas, in pixels.
 * @param y The Y coordinate of the image location, offset from the top left corner of the canvas, in pixels.
 * @param width The width of the image, in pixels.
 * @param height The height of the image, in pixels.
 * @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 WriteLinkRasterIndexedXY(LinkSocket *linkSocket,
                             int x, int y, 
                             int width, int height, 
                             int transparency,
                             IndexedImage *indeximage,
                             LinkArgs *linkArgs);

/**
 * Writes a buffered indexed model image in X-Y space to the link socket.
 * <b>DEPRECATED</b>
 *
 * <b>Deprecated</b>: Use WriteLinkRasterIndexedXY().
 *
 * @param *linkSocket The link socket.
 * @param x The X coordinate of the image location (upper left corner), offset from the top left corner of the canvas, in pixels.
 * @param y The Y coordinate of the image location, offset from the top left corner of the canvas, in pixels.
 * @param width The width of the image, in pixels.
 * @param height The height of the image, in pixels.
 * @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 BufferedWriteLinkRasterIndexedXY(LinkSocket *linkSocket,
                                     int x, int y,
                                     int width, int height, 
                                     int transparency,
                                     IndexedImage *indeximage,
                                     LinkArgs *linkArgs);

/**
 * Writes an indexed model image with an offset to the link socket.
 *
 * @param *linkSocket The link socket.
 * @param lat The latitude of the anchor point, in decimal degrees.
 * @param lon The longitude of the anchor point, in decimal degrees.
 * @param x The X coordinate of the image location (upper left corner), offset from the anchor point, in pixels.
 * @param y The Y coordinate of the image location (upper left corner), 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 *indeximage The indexed image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there's a memory allocation error.
 */

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

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

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

/*--------------------------------------------------------*/

/*Prototypes for writing Images that are refered as a URL*/

/**
 * Writes an image that is referred as a URL 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 *url URL of the image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */


int WriteLinkRasterImageURLLatLon(LinkSocket *linkSocket,
                                  double lat, double lon,
                                  char *url,
                                  LinkArgs *linkArgs);

/**
 * Writes a buffered image that is referred as a URL to the link socket.
 * <b>DEPRECATED</b>
 *
 * <b>Deprecated</b>: Use WriteLinkRasterImageURLLatLon().
 *
 * @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 *url URL of the image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int BufferedWriteLinkRasterImageURLLatLon(LinkSocket *linkSocket,
                                          double lat, double lon,
                                          char *url,
                                          LinkArgs *linkArgs);

/**
 * Writes an image in X-Y space that is referred as a URL, to the link socket.
 *
 * @param *linkSocket The link socket.
 * @param x The X coordinate of the image location (upper left corner), offset from the upper left corner of the canvas, in pixels.
 * @param y The Y coordinate of the image location, offset from the upper left corner of the canvas, in pixels.
 * @param *url The URL of the image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int WriteLinkRasterImageURLXY(LinkSocket *linkSocket,
                              int x, int y,
                              char *url,
                              LinkArgs *linkArgs);

/**
 * Writes a buffered image in X-Y space that is referred as a URL, to the 
 * link socket. <b>DEPRECATED</b>
 *
 * <b>Deprecated</b>: Use WriteLinkRasterImageURLXY().
 *
 * @param *linkSocket The link socket.
 * @param x The X coordinate of the image location (upper left corner), offset from the upper left corner of the canvas, in pixels.
 * @param y The Y coordinate of the image location, offset from the upper left corner of the canvas, in pixels.
 * @param *url The URL of the image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int BufferedWriteLinkRasterImageURLXY(LinkSocket *linkSocket,
                                      int x, int y,
                                      char *url,
                                      LinkArgs *linkArgs);
/**
 * Writes an image with an offset that is referred as a URL, to
 * the link socket.
 *
 * @param *linkSocket The link socket.
 * @param lat The latitude of the anchor point, in decimal degrees.
 * @param lon The longitude of the anchor point, in decimal degrees.
 * @param x The X coordinate of the image location (upper left corner), offset from the anchor point, in pixels.
 * @param y The Y coordinate of the image location, offset from the anchor point, in pixels.
 * @param *url The URL of the image.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int WriteLinkRasterImageURLOffset(LinkSocket *linkSocket,
                                  double lat, double lon, 
                                  int x, int y,
                                  char *url,
                                  LinkArgs *linkArgs);

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

int BufferedWriteLinkRasterImageURLOffset(LinkSocket *linkSocket,
                                          double lat, double lon, 
                                          int x, int y,
                                          char *url,
                                          LinkArgs *linkArgs);

#endif