ArcGIS Runtime SDK for iOS
100.15
|
Analysis of viewshed for a specified geo-element.
Instances of this class represent an analysis object that renders a viewshed for a specified geo-element. The viewshed determines visible and non-visible areas in a scene view for an observer defined by the geo-element. The viewshed will be updated as the geo-element's location changes.
Instance Methods | |
(instancetype) | - initWithGeoElement:horizontalAngle:verticalAngle:minDistance:maxDistance:headingOffset:pitchOffset: |
Class Methods | |
(AGSColor *) | + frustumOutlineColor |
(instancetype) | + geoElementViewshedWithGeoElement:horizontalAngle:verticalAngle:minDistance:maxDistance:headingOffset:pitchOffset: |
(AGSColor *) | + obstructedColor |
(void) | + setFrustumOutlineColor: |
(void) | + setObstructedColor: |
(void) | + setVisibleColor: |
(AGSColor *) | + visibleColor |
Properties | |
BOOL | frustumOutlineVisible |
id< AGSGeoElement > | geoElement |
double | headingOffset |
double | horizontalAngle |
double | maxDistance |
double | minDistance |
double | offsetX |
double | offsetY |
double | offsetZ |
double | pitchOffset |
double | verticalAngle |
BOOL | visible |
+ (AGSColor *) frustumOutlineColor |
The color used to render the frustum outline. This setting is applied to all viewshed analyses in the view.
+ (instancetype) geoElementViewshedWithGeoElement: | (id< AGSGeoElement >) | geoElement | |
horizontalAngle: | (double) | horizontalAngle | |
verticalAngle: | (double) | verticalAngle | |
minDistance: | (double) | minDistance | |
maxDistance: | (double) | maxDistance | |
headingOffset: | (double) | headingOffset | |
pitchOffset: | (double) | pitchOffset | |
Initialize a viewshed analysis object whose observer is defined by the provided geo-element, view angles, and heading/pitch offsets. The provided distance range defines the analysis frustum over which visibility is calculated from the camera/observer location. Terrain and other obstacles between the observer and the minimum distance are excluded from the analysis, as are areas beyond the maximum distance.
geoElement | from which the position and orientation of the observer will be determined |
horizontalAngle | The horizontal angle of the observer's view. Must be greater than zero and less than or equal to 360. |
verticalAngle | The vertical angle of the observer's view. Must be greater than zero and less than or equal to 360. |
minDistance | The minimum distance from the observer at which visibility will be evaluated. |
maxDistance | The maximum distance from the observer at which visibility will be evaluated. |
headingOffset | An angle offset relative to the heading of the geo-element to determine the direction of the observer's view. |
pitchOffset | An angle offset relative to the pitch of the geo-element to determine the vertical angle of the observer's view. Valid values range from 0 to 180 degrees. |
- (instancetype) initWithGeoElement: | (id< AGSGeoElement >) | geoElement | |
horizontalAngle: | (double) | horizontalAngle | |
verticalAngle: | (double) | verticalAngle | |
minDistance: | (double) | minDistance | |
maxDistance: | (double) | maxDistance | |
headingOffset: | (double) | headingOffset | |
pitchOffset: | (double) | pitchOffset | |
Initialize a viewshed analysis object whose observer is defined by the provided geo-element, view angles, and heading/pitch offsets. The provided distance range defines the analysis frustum over which visibility is calculated from the camera/observer location. Terrain and other obstacles between the observer and the minimum distance are excluded from the analysis, as are areas beyond the maximum distance.
geoElement | from which the position and orientation of the observer will be determined |
horizontalAngle | The horizontal angle of the observer's view. Must be greater than zero and less than or equal to 360. |
verticalAngle | The vertical angle of the observer's view. Must be greater than zero and less than or equal to 360. |
minDistance | The minimum distance from the observer at which visibility will be evaluated. |
maxDistance | The maximum distance from the observer at which visibility will be evaluated. |
headingOffset | An angle offset relative to the heading of the geo-element to determine the direction of the observer's view. |
pitchOffset | An angle offset relative to the pitch of the geo-element to determine the vertical angle of the observer's view. Valid values range from 0 to 180 degrees. |
+ (AGSColor *) obstructedColor |
The color with which non-visible areas of all viewsheds will be rendered. This setting is applied to all viewshed analyses in the view.
+ (void) setFrustumOutlineColor: | (AGSColor *) | frustumOutlineColor |
Sets the color used to render the frustum outline. This setting is applied to all viewshed analyses in the view.
frustumOutlineColor | color of the viewshed frustum's outline |
+ (void) setObstructedColor: | (AGSColor *) | obstructedColor |
Sets the color with which non-visible areas of all viewsheds will be rendered. This setting is applied to all viewshed analyses in the view.
obstructedColor | used to render areas that are not visible |
+ (void) setVisibleColor: | (AGSColor *) | visibleColor |
Sets the color with which visible areas of all viewsheds will be rendered. This setting is applied to all viewshed analyses in the view.
visibleColor | used to render areas that are visible |
+ (AGSColor *) visibleColor |
The color with which visible areas of all viewsheds will be rendered. This setting is applied to all viewshed analyses in the view.
|
readwritenonatomicassigninherited |
Indicates whether or not the viewshed frustum should be visible
|
readnonatomicstrong |
Geo-element that represents the observer for the viewshed analysis. The observer's location, heading, and pitch are determined by the location and orientation of this geo-element.
|
readwritenonatomicassign |
The offset angle applied to the heading of the geo-element. The observer heading is determined by the geo-element heading plus the heading offset.
|
readwritenonatomicassigninherited |
The horizontal angle (in degrees) of the observer's field of vision.
|
readwritenonatomicassigninherited |
The maximum distance (in meters) from the observer at which visibility will be evaluated. This can be used to model factors that restrict the visible distance.
|
readwritenonatomicassigninherited |
The minimum distance (in meters) from the observer at which visibility will be evaluated. This allows you to exclude obstacles close to the observer (the corner of a building, for example). Since terrain and other obstacles between the observer and the specified minimum distance are completely excluded from the analysis, this value should be relatively small.
|
readwritenonatomicassign |
The location offset in the X direction that defines the observer relative to the geo-element.
The observer location is determined by the geo-element location plus the offset X,Y,Z values. Any rotations applied to the geo-element will also be applied to the X,Y,Z offsets. This allows the observer to be positioned relative to the geo-element and maintain the relative position even when the geo-element moves and rotates.
|
readwritenonatomicassign |
The location offset in the Y direction that defines the observer relative to the geo-element.
The observer location is determined by the geo-element location plus the offset X,Y,Z values. Any rotations applied to the geo-element will also be applied to the X,Y,Z offsets. This allows the observer to be positioned relative to the geo-element and maintain the relative position even when the geo-element moves and rotates.
|
readwritenonatomicassign |
The location offset in the X direction that defines the observer relative to the geo-element.
The observer location is determined by the geo-element location plus the offset X,Y,Z values. Any rotations applied to the geo-element will also be applied to the X,Y,Z offsets. This allows the observer to be positioned relative to the geo-element and maintain the relative position even when the geo-element moves and rotates.
|
readwritenonatomicassign |
The offset angle applied to the pitch of the geo-element. The observer pitch is determined by the geo-element pitch plus the pitch offset. Valid values range from 0 to 180 degrees.
|
readwritenonatomicassigninherited |
The vertical angle (in degrees) of the observer's field of vision.
|
readwritenonatomicassigninherited |
Indicates whether the results of this analysis should be visible or not. Visibility can be controlled for individual analyses as well as for the analysis overlay that contains them.