Description

A builder to build envelope geometries.

Instances of this class represent a builder that can build envelope geometries. Envelope geometries are immutable, they cannot be modified after they are created. Use builders to create new geometries either from scratch, or by using an existing geometry as a starting off point. Modifications made through the builder affect only its own internal copy of the geometry. They do not affect the original geometry.

Since: 100

See also: AGSSketchEditor to construct or modify geometries interactively by sketching on a map

Inheritance diagram for AGSEnvelopeBuilder:

Instance Methods
(instancetype)	- centerAtPoint:

(instancetype)	- changeAspectRatio:

(instancetype)	- expandByFactor:

(instancetype)	- expandByFactor:withAnchorPoint:

(instancetype)	- initWithCenter:width:height:

(instancetype)	- initWithCenter:width:height:depth:

(instancetype)	- initWithEnvelope:

(instancetype)	- initWithSpatialReference:

(BOOL)	- isEmpty

(instancetype)	- offsetByX:y:

(instancetype)	- replaceGeometry:

(instancetype)	- replaceGeometry:

(instancetype)	- setMMin:mMax:

(instancetype)	- setXMin:yMin:xMax:yMax:

(instancetype)	- setZMin:zMax:

(AGSEnvelope *)	- toGeometry

(instancetype)	- unionWithEnvelope:

(instancetype)	- unionWithPoint:

(instancetype)	- unionWithX:y:

Class Methods
(AGSGeometryBuilder *)	+ builderWithGeometry:

(AGSGeometryBuilder *)	+ builderWithGeometryType:spatialReference:

(instancetype)	+ envelopeBuilderWithCenter:width:height:

(instancetype)	+ envelopeBuilderWithCenter:width:height:depth:

(instancetype)	+ envelopeBuilderWithEnvelope:

(instancetype)	+ envelopeBuilderWithSpatialReference:

Properties
AGSPoint *	center

double	depth

AGSEnvelope *	extent

AGSGeometryType	geometryType

BOOL	hasM

BOOL	hasZ

double	height

double	mMax

double	mMin

AGSSpatialReference *	spatialReference

double	width

double	xMax

double	xMin

double	yMax

double	yMin

double	zMax

double	zMin

Method Documentation

§ builderWithGeometry:()

+ (AGSGeometryBuilder*) builderWithGeometry: (nullable AGSGeometry *) geometry

Factory method to create a geometry builder from a geometry.

Parameters

geometry The geometry to be used as the starting point for further modifications

Since: 100

§ builderWithGeometryType:spatialReference:()

+ (AGSGeometryBuilder*) builderWithGeometryType:	(AGSGeometryType)	geometryType
spatialReference:	(nullable AGSSpatialReference *)	sr

Factory method to create a geometry builder from a geometry type and spatial reference.

Parameters

geometryType	The type of geometry to be constructed
sr	The spatial reference for the geometry to be constructed

Since: 100

§ centerAtPoint:()

- (instancetype) centerAtPoint: (AGSPoint *) point

Re-centers the builder's envelope geometry at the specified location. The point's spatial reference must be the same as the builder's.

Parameters

point to center at

Returns: the builder so you can easily chain method calls

Since: 100

§ changeAspectRatio:()

- (instancetype) changeAspectRatio: (CGSize) size

Reaspect the builder's envelope geometry to match the given aspect ratio. The envelope's center remains unchanged, but its corners change.

Parameters

size	to reaspect the envelope.

Returns: the builder so you can easily chain method calls

Since: 100

§ envelopeBuilderWithCenter:width:height:()

+ (instancetype) envelopeBuilderWithCenter:	(AGSPoint *)	center
width:	(double)	width
height:	(double)	height

Initializes an envelope builder with the provided center and dimensions.

Parameters

center	The coorinates of the envelope's center
width	of the envelope (in units specified by the center's spatial reference)
height	of the envelope (in units specified by the center's spatial reference)

Returns: An initialized envelope builder

Since: 100.1

§ envelopeBuilderWithCenter:width:height:depth:()

+ (instancetype) envelopeBuilderWithCenter:	(AGSPoint *)	center
width:	(double)	width
height:	(double)	height
depth:	(double)	depth

Initializes an envelope builder with the provided center and dimensions.

Parameters

center	The coorinates of the envelope's center
width	of the envelope (in units specified by the center's spatial reference)
height	of the envelope (in units specified by the center's spatial reference)
depth	of the envelope (in meters)

Returns: An initialized envelope builder

Since: 100.1

§ envelopeBuilderWithEnvelope:()

+ (instancetype) envelopeBuilderWithEnvelope: (nullable AGSEnvelope *) envelope

Initializes an envelope builder with the provided envelope.

Parameters

envelope The geometry to be used as the starting point for further modifications. Can be nil.

Returns: An initialized envelope builder

Since: 100

§ envelopeBuilderWithSpatialReference:()

+ (instancetype) envelopeBuilderWithSpatialReference: (nullable AGSSpatialReference *) sr

Initializes an empty envelope builder.

Parameters

sr	The spatial reference for the geometry to be constructed

Returns: An initialized envelope builder

Since: 100

§ expandByFactor:()

- (instancetype) expandByFactor: (double) factor

Expands the builder's envelope geometry. A factor < 1.0 shrinks the envelope and > 1.0 expands it. The envelope's center remains unchanged, but its corners change. This is the same as calling expandByFactor:withAnchorPoint: with the envelope's center.

Parameters

factor The factor to scale envelope by.

Returns: the builder so you can easily chain method calls

Since: 100

§ expandByFactor:withAnchorPoint:()

- (instancetype) expandByFactor:	(double)	factor
withAnchorPoint:	(AGSPoint *)	anchorPoint

Expands the builder's envelope geometry. A factor < 1.0 shrinks the envelope and > 1.0 expands it. The specified anchor point of the envelope remains unchanged, but the envelope's corners change.

Parameters

factor	The factor to scale envelope by.
anchorPoint	A point within the envelope to expand from.

Returns: the builder so you can easily chain method calls

Since: 100

§ initWithCenter:width:height:()

- (instancetype) initWithCenter:	(AGSPoint *)	center
width:	(double)	width
height:	(double)	height

Initializes an envelope builder with the provided center and dimensions.

Parameters

center	The coorinates of the envelope's center
width	of the envelope (in units specified by the center's spatial reference)
height	of the envelope (in units specified by the center's spatial reference)

Returns: An initialized envelope builder

Since: 100.1

§ initWithCenter:width:height:depth:()

- (instancetype) initWithCenter:	(AGSPoint *)	center
width:	(double)	width
height:	(double)	height
depth:	(double)	depth

Initializes an envelope builder with the provided center and dimensions.

Parameters

center	The coorinates of the envelope's center
width	of the envelope (in units specified by the center's spatial reference)
height	of the envelope (in units specified by the center's spatial reference)
depth	of the envelope (in meters)

Returns: An initialized envelope builder

Since: 100.1

§ initWithEnvelope:()

- (instancetype) initWithEnvelope: (nullable AGSEnvelope *) envelope

Initializes an envelope builder with the provided envelope.

Parameters

envelope The geometry to be used as the starting point for further modifications. Can be nil.

Returns: An initialized envelope builder

Since: 100

§ initWithSpatialReference:()

- (instancetype) initWithSpatialReference: (nullable AGSSpatialReference *) sr

Initializes an empty envelope builder.

Parameters

sr	The spatial reference for the geometry to be constructed

Returns: An initialized envelope builder

Since: 100

§ isEmpty()

- (BOOL) isEmpty

Indicates whether the builder's geometry is empty.

Returns: YES if the geometry is empty

Since: 100

See also: AGSGeometry::isEmpty

§ offsetByX:y:()

- (instancetype) offsetByX:	(double)	offsetX
y:	(double)	offsetY

Move the builder's envelope geometry.

Parameters

offsetX	offset along x-axis (negative value moves the envelope east)
offsetY	offset along y-axis (negative value moves the envelope south)

Returns: the builder so you can easily chain method calls

Since: 100

§ replaceGeometry:() [1/2]

- (instancetype) replaceGeometry: (nullable AGSGeometry *) geometry

Replaces the builder's geometry with the provided one.

Parameters

geometry to replace with

Returns: the builder so you can easily chain method calls

Since: 100

§ replaceGeometry:() [2/2]

- (instancetype) replaceGeometry: (nullable AGSEnvelope *) geometry

Replaces the builder's geometry with the provided one.

Parameters

geometry to replace with

Returns: the builder so you can easily chain method calls

Since: 100

§ setMMin:mMax:()

- (instancetype) setMMin:	(double)	mMin
mMax:	(double)	mMax

Updates the builder's envelope geometry with given coordinates.

Parameters

mMin	The min measure value
mMax	The max measure value

Returns: the builder so you can easily chain method calls

Since: 100

§ setXMin:yMin:xMax:yMax:()

- (instancetype) setXMin:	(double)	xMin
yMin:	(double)	yMin
xMax:	(double)	xMax
yMax:	(double)	yMax

Updates the builder's envelope geometry with given coordinates.

Parameters

xMin	The min coordinate along x-axis (lower left corner)
yMin	The min coordinate along y-axis (lower left corner)
xMax	The max coordinate along x-axis (upper right corner)
yMax	The max coordinate along y-axis (upper right corner)

Returns: the builder so you can easily chain method calls

Since: 100

§ setZMin:zMax:()

- (instancetype) setZMin:	(double)	zMin
zMax:	(double)	zMax

Updates the builder's envelope geometry with given coordinates.

Parameters

zMin	The min coordinate along z-axis
zMax	The max coordinate along z-axis

Returns: the builder so you can easily chain method calls

Since: 100

§ toGeometry()

- (AGSEnvelope*) toGeometry

Returns the envelope geometry this builder is constructing or modifying.

Returns: geometry

Since: 100

Implements AGSGeometryBuilder.

§ unionWithEnvelope:()

- (instancetype) unionWithEnvelope: (AGSEnvelope *) envelope

Unions the builder's envelope with the given envelope. The envelope's spatial reference must be the same as the builder's.

Parameters

envelope to union with

Returns: the builder so you can easily chain method calls

Since: 100

§ unionWithPoint:()

- (instancetype) unionWithPoint: (AGSPoint *) point

Unions the builder's envelope geometry with the given point. The point's spatial reference must be the same as the builder's.

Parameters

point to union with

Returns: the builder so you can easily chain method calls

Since: 100

§ unionWithX:y:()

- (instancetype) unionWithX:	(double)	x
y:	(double)	y

Unions the builder's envelope geometry with the given X and Y coordinates. The coordinates are assumed to be in the same spatial reference as the builder's.

Since: 100.5

Property Documentation

§ center

- (AGSPoint*) center

readnonatomicstrong

The geographic center of the builder's envelope.

Since: 100

§ depth

- (double) depth

readnonatomicassign

§ extent

- (AGSEnvelope*) extent

readnonatomicstronginherited

Smallest, rectangular bounding-box that covers the builder's geometry.

Since: 100

See also: AGSGeometry::extent

§ geometryType

- (AGSGeometryType) geometryType

readnonatomicassigninherited

The type of geometry the builder will construct or modify.

Since: 100

§ hasM

- (BOOL) hasM

readnonatomicassigninherited

Indicates whether the builder's geometry contains m (measure) values.

Since: 100

See also: AGSGeometry::hasM

§ hasZ

- (BOOL) hasZ

readnonatomicassigninherited

Indicates whether the builder's geometry contains z coordinate values.

Since: 100

See also: AGSGeometry::hasZ

§ height

- (double) height

readnonatomicassign

The height of the builder's envelope (along y-axis)

Since: 100

§ mMax

- (double) mMax

readwritenonatomicassign

The max measure value of the builder's envelope geometry.

Since: 100

§ mMin

- (double) mMin

readwritenonatomicassign

The min measure value of the builder's envelope geometry.

Since: 100

§ spatialReference

- (AGSSpatialReference*) spatialReference

readnonatomicstronginherited

The spatial reference associated with the builder's gometry. It specifies the coordinate system for the geometry's x, y, and z coordinate values.

Since: 100

Note: Geometries that represent geographic locations should always have a spatial reference. Otherwise the coordinates of the geometry are meaningless.

See also: AGSGeometry::spatialReference

§ width

- (double) width

readnonatomicassign

The width of the builder's envelope (along x-axis).

Since: 100

§ xMax

- (double) xMax

readwritenonatomicassign

The max coordinate of the builder's envelope geometry along x-axis (upper right corner)

Since: 100

§ xMin

- (double) xMin

readwritenonatomicassign

The min coordinate of the builder's envelope geometry along x-axis (lower left corner)

Since: 100

§ yMax

- (double) yMax

readwritenonatomicassign

The max coordinate of the builder's envelope geometry along y-axis (upper right corner)

Since: 100

§ yMin

- (double) yMin

readwritenonatomicassign

The min coordinate of the builder's envelope geometry along y-axis (lower left corner)

Since: 100

§ zMax

- (double) zMax

readwritenonatomicassign

The max coordinate of the builder's envelope geometry along z-axis. Only applicable for 3D envelope geometries.

Since: 100

§ zMin

- (double) zMin

readwritenonatomicassign

The min coordinate of the builder's envelope geometry along z-axis. Only applicable for 3D envelope geometries.

Since: 100

Description

Instance Methods

Class Methods

Properties

Method Documentation

§ builderWithGeometry:()

§ builderWithGeometryType:spatialReference:()

§ centerAtPoint:()

§ changeAspectRatio:()

§ envelopeBuilderWithCenter:width:height:()

§ envelopeBuilderWithCenter:width:height:depth:()

§ envelopeBuilderWithEnvelope:()

§ envelopeBuilderWithSpatialReference:()

§ expandByFactor:()

§ expandByFactor:withAnchorPoint:()

§ initWithCenter:width:height:()

§ initWithCenter:width:height:depth:()

§ initWithEnvelope:()

§ initWithSpatialReference:()

§ isEmpty()

§ offsetByX:y:()

§ replaceGeometry:() [1/2]

§ replaceGeometry:() [2/2]

§ setMMin:mMax:()

§ setXMin:yMin:xMax:yMax:()

§ setZMin:zMax:()

§ toGeometry()

§ unionWithEnvelope:()

§ unionWithPoint:()

§ unionWithX:y:()

Property Documentation

§ center

§ depth

§ extent

§ geometryType

§ hasM

§ hasZ

§ height

§ mMax

§ mMin

§ spatialReference

§ width

§ xMax

§ xMin

§ yMax

§ yMin

§ zMax

§ zMin