linkcircle.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/LinkCircle.h,v $
 * $RCSfile: LinkCircle.h,v $
 * $Revision: 1.2 $
 * $Date: 2004/01/26 19:07:09 $
 * $Author: dietrick $
 * 
 * **********************************************************************
 */

#ifndef LINKCIRCLE_H
#define LINKCIRCLE_H

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

/*Prototypes for Writing Circle Object*/

/*
  Buffered objects write everything to a chunk of memory and 
  write the entire memory to socket at one short
*/

/**
 * Writes a circle to the link socket.
 *
 * @param *link The link socket.
 * @param lat The latitude of the center of the circle, in decimal degrees.
 * @param lon The longitude of the center of the circle, in decimal degrees.
 * @param radius The radius of the circle.
 * @param unit The units of the radius of the circle, (KM, MILES, or NMILES).  See Graphics.h.
 * @param nvertices The number of vertices that should be used to approximate the circle.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int WriteLinkCircleLatLon(LinkSocket *link, 
                          double lat, double lon, 
                          double radius, int unit,
                          int nvertices,
                          LinkArgs *linkArgs);

/**
 * Writes a circle to the link socket in X-Y space.  The X and Y coordinates
 * are offset from the upper left corner of the canvas.
 *
 * @param *link The link socket.
 * @param x The X coordinate of the center of the circle, in pixels.
 * @param y the Y coordinate of the center of the circle, in pixels.
 * @param width The width of the bounding rectangle of the circle, in pixels.
 * @param height The height of the bounding rectangle of the circle, in pixels.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int WriteLinkCircleXY(LinkSocket *link,  
                      int x, int y,
                      int width, int height,                   
                      LinkArgs *linkArgs);

/**
 * Writes a circle with an offset to the link socket.  The X and Y points are
 * offset from the lat-long anchor point.
 *
 * @param *link 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 center of the circle, offset from the anchor point, in pixels.
 * @param y The Y coordinate of the center of the circle, offset from the anchor point, in pixels.
 * @param width The width of the bounding rectangle of the circle, in pixels.
 * @param height The height of the bounding rectangle of the circle, in pixels.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */


int WriteLinkCircleOffset(LinkSocket *link,
                          double lat, double lon,
                          int x, int y,                    
                          int width, int height,                           
                          LinkArgs *linkArgs);

/**
 * Writes a buffered circle to the link socket. <b>DEPRECATED</b>
 *
 * <b>Deprecated</b>: Use WriteLinkCircleLatLon().
 *
 * @param *link The link socket.
 * @param lat The latitude of the center of the circle, in decimal degrees.
 * @param lon The longitude of the center of the circle, in decimal degrees.
 * @param radius The radius of the circle.
 * @param unit The units of the radius of the circle, (KM, MILES, or NMILES).  See Graphics.h.
 * @param nvertices The number of vertices that should be used to approximate the circle.
 * @param *linkArgs The link arguments.
 * @returns -1 if there is a memory allocation error.
 */

int BufferedWriteLinkCircleLatLon(LinkSocket *link, 
                                  double lat, double lon, 
                                  double radius, int unit,
                                  int nvertices,
                                  LinkArgs *linkArgs);

/**
 * Writes a buffered circle to the link socket in X-Y space.  The X and Y 
 * coordinates are offset from the upper left corner of the canvas.
 * <b>DEPRECATED</b>
 *
 * <b>Deprecated</b>: Use WriteLinkCircleXY().
 *
 * @param *link The link socket.
 * @param x The X coordinate of the center of the circle, in pixels.
 * @param y the Y coordinate of the center of the circle, in pixels.
 * @param width The width of the bounding rectangle of the circle, in pixels.
 * @param height The height of the bounding rectangle of the circle, in pixels.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */

int BufferedWriteLinkCircleXY(LinkSocket *link,
                              int x, int y,
                              int width, int height,                   
                              LinkArgs *linkArgs);

/**
 * Writes a buffered circle with an offset to the link socket.  The X and Y 
 * points are offset from the lat-long anchor point. <b>DEPRECATED</b>
 *
 * <b>Deprecated</b>: Use WriteLinkCircleOffset().
 *
 * @param *link 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 center of the circle, offset from the anchor point, in pixels.
 * @param y The Y coordinate of the center of the circle, offset from the anchor point, in pixels.
 * @param width The width of the bounding rectangle of the circle, in pixels.
 * @param height The height of the bounding rectangle of the circle, in pixels.
 * @param *linkArgs The link arguments.
 * @returns -1 if there was a memory allocation error.
 */


int BufferedWriteLinkCircleOffset(LinkSocket *link,
                                  double lat, double lon,
                                  int x, int y,                    
                                  int width, int height,                           
                                  LinkArgs *linkArgs);

#endif