AGSMutableEnvelope Class Reference

Description

A mutable version of AGSEnvelope.

Defined in:
AGSEnvelope.h ( ArcGIS library)
Since:
1.0
Inheritance diagram for AGSMutableEnvelope:
AGSEnvelope AGSGeometry <AGSCoding>

List of all members.

Public Member Functions

(void) - centerAtPoint:
(BOOL) - containsEnvelope:
(BOOL) - containsPoint:
(void) - decodeWithJSON:
(NSDictionary *) - encodeToJSON
(void) - expandByFactor:
(void) - expandByFactor:withAnchorPoint:
(id) - initWithJSON:
(id) - initWithJSON:spatialReference:
(id) - initWithSpatialReference:
(id) - initWithXmin:ymin:xmax:ymax:spatialReference:
(AGSEnvelope *) - intersectionWithEnvelope:
(BOOL) - intersectsWithEnvelope:
(BOOL) - isEmpty
(BOOL) - isEqualToEnvelope:
(BOOL) - isValid
(void) - normalize
(void) - normalizeToEnvelope:
(void) - offsetByX:y:
(void) - reaspect:
(NSString *) - simpleRepresentation
(void) - unionWithEnvelope:
(void) - updateWithXmin:ymin:xmax:ymax:

Static Public Member Functions

(id) + envelopeWithXmin:ymin:xmax:ymax:spatialReference:

Properties

AGSPoint * center
CGRect cgRect
AGSEnvelope * envelope
double height
CGPathRef path
AGSSpatialReference * spatialReference
double width
double xmax
double xmin
double ymax
double ymin

Protected Attributes

struct BORGEnvelope * _borg

Member Function Documentation

- (void) centerAtPoint: (AGSPoint *)  point  

Recenter envelope at point. The point and the envelope must have the same spatial reference.

Parameters:
point The new center point.
Since:
1.0
- (BOOL) containsEnvelope: (AGSEnvelope *)  env  

Returns true if envelope fully contains the argument env. Both envelopes must have the same spatial reference.

Parameters:
env The envelope to test containment.
Returns:
true if envelope is contained.
Since:
1.0
- (BOOL) containsPoint: (AGSPoint *)  point  

Returns true if argument point is contained within or intersects the envelope. The point and the envelope must have the same spatial reference.

Parameters:
point The point to test containment.
Returns:
true if point is contained within envelope.
Since:
1.0
- (void) decodeWithJSON: (NSDictionary *)  json   [optional, inherited]

Decode object from JSON representation.

Parameters:
json The JSON representation of the object to be decoded.
Since:
1.0
- (NSDictionary *) encodeToJSON   [optional, inherited]

Encode and return JSON representation for object.

Returns:
JSON representation of object.
Since:
1.0
+ (id) envelopeWithXmin: (double)  xmin
ymin: (double)  ymin
xmax: (double)  xmax
ymax: (double)  ymax
spatialReference: (AGSSpatialReference *)  spatialReference 

Initialize an autoreleased envelope object.

Parameters:
xmin The bottom-left x-coordinate in map units.
ymin The bottom-left y-coordinate in map units.
xmax The top-right x-coordinate in map units.
ymax The top-right y-coordinate in map units.
spatialReference The spatial reference of envelope.
Returns:
A new, autoreleased, envelope object.
Since:
1.0
See also:
- initWithXmin:ymin:xmax:ymax:spatialReference:
- (void) expandByFactor: (double)  factor  

Expand envelope by scale factor. A factor < 1.0 to zoom in and > 1.0 to zoom out.

Parameters:
factor The factor to expand envelope by.
Since:
1.0
- (void) expandByFactor: (double)  factor
withAnchorPoint: (AGSPoint *)  anchorPoint 

Expand envelope by scale factor. A factor < 1.0 shrinks the envelope and > 1.0 expands it. The anchorPoint and the envelope must have the same spatial reference.

Parameters:
factor The factor to scale envelope by.
anchorPoint A point within the envelope to expand from.
Since:
1.0
- (id) initWithJSON: (NSDictionary *)  json   [optional, inherited]

Initialize and return object from JSON representation.

Parameters:
json The JSON representation of the object to be created.
Returns:
Object decoded from JSON representation.
Since:
1.0
- (id) initWithJSON: (NSDictionary *)  json
spatialReference: (AGSSpatialReference*)  sr 

Initialize geometry object with json and a spatial reference.

Parameters:
json The JSON to initialize an AGSGeometry with.
sr The spatial reference of geometry represented in json.
Returns:
A new geometry object.
Since:
1.0
- (id) initWithSpatialReference: (AGSSpatialReference *)  spatialReference  

Initialize geometry object with spatial reference.

Parameters:
spatialReference The spatial referenc of geometry.
Returns:
A new geometry object.
Since:
1.0
- (id) initWithXmin: (double)  xmin
ymin: (double)  ymin
xmax: (double)  xmax
ymax: (double)  ymax
spatialReference: (AGSSpatialReference *)  spatialReference 

Initialize a new envelope object.

Parameters:
xmin The bottom-left x-coordinate in map units.
ymin The bottom-left y-coordinate in map units.
xmax The top-right x-coordinate in map units.
ymax The top-right y-coordinate in map units.
spatialReference The spatial reference of envelope.
Returns:
A new envelope object.
Since:
1.0
- (AGSEnvelope *) intersectionWithEnvelope: (AGSEnvelope *)  envelope  

Returns the intersection between this envelope and the argument envelope. Both envelopes must have the same spatial reference.

Parameters:
envelope The envelope to test intersection relation.
Returns:
Intersecting envelope else nil.
Since:
1.0
- (BOOL) intersectsWithEnvelope: (AGSEnvelope *)  envelope  

Returns true if argument envelope intersects this envelope. Both envelopes must have the same spatial reference.

Parameters:
envelope The envelope to test intersection relation.
Returns:
true if envelopes intersects.
Since:
1.0

Reimplemented from AGSGeometry.

- (BOOL) isEmpty  

Returns true if envelope width and height are 0.

Since:
1.0

Reimplemented from AGSGeometry.

- (BOOL) isEqualToEnvelope: (AGSEnvelope*)  other  

Returns whether another envelope is equal to this envelope.

Parameters:
other The other envelope.
Returns:
Whether the other envelope is equal to this envelope.
Since:
1.8
- (BOOL) isValid  

Returns whether or not the geometry is valid.

Since:
1.8
- (void) normalize  
Since:
1.8
- (void) normalizeToEnvelope: (AGSEnvelope*)  env  
Since:
1.8
- (void) offsetByX: (double)  offsetX
y: (double)  offsetY 

Offset envelope in x and y direction.

Parameters:
offsetX The offset distance in x direction.
offsetY The offset distance in y direction.
Since:
1.0
- (void) reaspect: (CGSize)  size  

Reaspect envelope to match aspect ratio of size.

Parameters:
size The size to reaspect the envelope.
Since:
1.0
- (NSString *) simpleRepresentation  

Simple string representation of envelope.

Returns:
Simple representation.
Since:
1.0
- (void) unionWithEnvelope: (AGSEnvelope *)  envelope  

Update envelope by unioning with envelope. Both envelopes must have the same spatial reference.

Parameters:
envelope The envelope to union with.
Since:
1.0
- (void) updateWithXmin: (double)  xmin
ymin: (double)  ymin
xmax: (double)  xmax
ymax: (double)  ymax 

Update envelope with argument lower-left and upper-right coordinates.

Parameters:
xmin The lower-left x-coordinate in map units.
ymin The lower-left y-coordinate in map units.
xmax The upper-right x-coordinate in map units.
ymax The upper-right y-coordinate in map units.
Since:
1.0

Property Documentation

- (AGSPoint*) center [read, retain, inherited]

Center point of envelope.

Since:
1.0
- (AGSEnvelope*) envelope [read, retain, inherited]

Smallest, rectangular bounding-box that covers the geometry.

Since:
1.0
- (double) height [read, write, assign, inherited]

Height of the envelope.

Since:
1.0
- (AGSSpatialReference*) spatialReference [read, write, retain]

Geometry's spatial reference.

Since:
1.0

Reimplemented from AGSGeometry.

- (double) width [read, write, assign, inherited]

Width of the envelope.

Since:
1.0
- (double) xmax [read, assign, inherited]

X-coordinate of upper-right corner.

Since:
1.0
- (double) xmin [read, assign, inherited]

X-coordinate of lower-left corner.

Since:
1.0
- (double) ymax [read, assign, inherited]

Y-cooridnate of upper-right corner.

Since:
1.0
- (double) ymin [read, assign, inherited]

Y-coordinate of lower-left corner.

Since:
1.0
Copyright © 1995-2010 Esri. All rights reserved.