Initialize an instance of MEMapViewController and the MEMapView it controls and add the MEMapView as a child to the specified parent UIView.

Initialize an instance of MEMapViewController and ‘attach’ it to an existing MEMapView. This is for applications that require fine-grained control over view hierarchies and need to create the MEMapView object independently of MEMapViewController initialization.

Initialize the mapping engine. This function allocates resources for thread management, data caching, and map loading. Should be called after the cooresponding MEMapView is loaded.

Free resources related to rendering. Should be called before deallocating mapping engine views.

Returns the MEMapView this view controller manages. This is the same as the view property simply cast to MEMapView* and primarily provided as a convenience.

Adds a map layer whose type and properties are specified by a MEMapInfo object.

Instructs the mapping engine to reload a map.

Instructs the mapping engine to reload the specified portion of a map.

Add an Altus map package.

Adds a raster map generated from raw double data

Sets the base map (zOrder of 0) layer to be a tiled map of the specified image.

Sets the base map layer to be a tiled map of the specified cached image.

Adds an MBTiles raster map. Generally, these maps are produced with TileMill from MapBox. The map is added using an internal native tile provider path. Map bounds and maximum zoom level are read from the MBTiles database. Internally, the mapping engine will use a completely native tile provider to load tiles from the MBTiles database and no extra image memory copies are ever created. This is the fastest way possible to load an MBTiles map using the mapping engine.

Removes all maps currently displayed and optionally flushes the cache.

Remove a map layer from the current view and optionally clear the internal caches. If caches are not cleared, and you re-enable the same map at a future point, cached data ‘may’ be used to draw the map. If you choose to clear the cache, the engine will re-request all map data if you later re-add that map. Whether or not you want to flush the cache depends on your useage scenario. For example, if your application has downloaded an updated map, you would want to remove the existing one and clear its data from the cache. If the user is just toggling a map on and off, you would not want to clear it data from the cache the cache.

Intended for virtual tile providers, when called, tells the mapping engine to re-request all tiles for the specified map. This could be use, for example, for displaying weather where the map changes over time.

Returns an array me MEMapInfo objects, each specifiying information about a map currently loaded.

Returns whether or not the specified map is currently enabled.

Set the priority of a map layer.

Get the current priority vof a map layer.

Set the distance to search up the tree for tiles. For example, imagine you have added a map package that only has up to level 6 tiles, but the user has zoomed into to level 18. If you want to over-zoom the level 6 tiles at the level 18 zoom level, you would set the tile search depth to at least 12.

Adds a raster map layer comprised of downloadable spherical mercator raster tiles.

Adds a raster map layer comprised of downloadable spherical mercator raster tiles as well as polar map tiles in the proper projection (generally created with AltusRaster).

This function is provided for applications that desire to manage timing and updates themselves. If you are not managing your own CADisplayLink timer, there is no need to ever call this function. If you desire to use this function, you should first call stopDisplayLink, then create your own CADisplayLink timer, start it, and when it fires call this function passing the CADisplayLink timestamp value each time you want the mapping engine to update and draw.

Enables or disables multithreaded resource loading. The default is YES.

Indicates whether or not this instance of the view controller is initialized.

If set to YES, prior to calling initialize, Altus will use its first-gen thread management system.

Returns true if the engine has been initialize, false otherwise. The view controller may still be in a paused state if the engine is running, but no frames will be presented.

The core in-memory cache size in bytes. Defaults to 60 MB on single-core devices, and 90 MB on dual-core devices. You should adjust this setting before calling the initialize function.

Controls the maximum number of tiles in flight per frame. Defaults to 3 on single-core devices, and 10 on dual-core devices. You should adjust this setting before calling the intialize function.

Controls the maximum number of tiles that will be loaded per frame that are supplied by asynchronous tile providers. This is especially helpful for animated tile providers that may be returning a large numbers of frames at once and do not with to cause a frame-rate hitch. The default is 1 tile per frame. This only applies to tiles that supply image data. Tile provider responses that indicate no loading is neccessary (not available or inivisible) are all handled every frame.

Controls the the number of levels up that parent tiles will be searched in virtual maps that are supplied tiles by tiler providers. The defaul is 5. Reducing this number can potentially save bandwidth in the case of internet-based tile providers, but at the cost of the user potentially not seeing map data if they zoom or pan quickly as tiles are downloading.

Controls the target frames per second to render when current run loop is in UITrackingRunLoopMode. This occurs, for example, when a table view is being scrolled. The default is 10.

When set to YES, the mapping engine will attempt to reduce the framerate when possible.

The frame rate to render at when in green mode, resources are not loading, there are no animations, the camera is not moving, and the user is not interacting with the map. Defaults to 1 fps.

The frame rate to render at when an animation is occurring, resources are loading, or the camera is moving. Defaults to 12.

The frame rate to render at when the user is interacting with the map. Defaults to 30 fps.

Vertical field of view in degrees when in portrait mode.

Vertical field of view in degrees when in landscape mode.

Used to notify the view controller that a user interaction (panning/zoomin) or code-based panning/zooming has occured. This is primarily for green-mode support so that gesture recognizers can notify the view controller to increase the frame rate in response to user touches. This function may be made private in a future release.

When set to YES, UIImages provided for markers are scaled by the map view content scale factor, and not by their UIImage scale. In other words, an @3x marker image will render so that it is the correct apparent size to the user on an iPhone 6 Plus running at the default scale of 2.6 (unzoomed), 2.8 (zoomed), or 3.0 (simulator).

Toggles star field visibilty. Defaults to YES.

Toggles sun texture visibilty. Defaults to YES.

Controls the type of lighting.

Controls the transparency of the atmosphere.

Set the virtual position of the sun. The position can be absolute or relative to the current camera position.

Change the image used to represent the sun.

Controls atmospheric lighting colors.

Controls atmospheric lighting parameters.

If you have set the METrackUp rendering mode, you can set the trackup-forward distance with this function.

Returns the current track up forward distance.

If you have set the METrackUp rendering mode, you can set the trackup-forward distance with this function.

Set the alpha value of a map layer.

Get the alpha value of a map layer.

Sets whether or not a loaded map is visible or not visible. This is not the same as setting the alpha to 0.0. When alpha is set to 0.0, the engine will still draw the map ‘invisibly’ going through all drawing logic. When the map is not visible, all loading logic for a map occurs, but the drawing logic is skipped. This can be used, for example, if you want to add a map, set it to invisible, wait for the engine to load it, then when your delegate is notified that loading is complete, to set visibilty to true to have the map instantly appear without the user seeing loading.

Returns whether or not a map is visible.

Set the zorder value of a map layer.

Get the current zorder value of a map layer.

Sets per-map lighting parameters

Updates the terrain color bar. When updated, the base map layer derived from terrain will be colored using the new color bar. 3D terrain will also use these colors. If not set, the mapping engine will use a default terrain color bar. You should set this value before beginning animation, otherwise cached tiles may not inherit the new colors.

Returns the current terrain color bar.

Updates the terrain avoidance and warning system (TAWS) color bar. If not set, the mapping engine will use a default TAWS color bar. You can set the color bar at any time.

Returns the current terrain avoidance and warning system (TAWS) color bar.

Updates the altitude that is used to draw the TAWS layer (if enabled).

Add a dynamic marker to a dynamic marker map.

Sets a height color bar for the specified marker map. Once set you can call setMarkerMapColorBarEnabled to turn use of the color bar on and off.

Sets where or not a color bar is applied when rendering markers.

Returns an array of MEMarker objects for markers that are visible for a given marker map layer. This function should only be called form the main thread, not from a background thread.

Adds a polygon to a vector map.

Adds a polygon to a vector map with the specified style. If you have many polygons of the same style, it is more efficient (less draw calls) to use the other funciton which takes a featureId instead of a style.

Adds a polygon to a vector map and applies a previously added style based featureId. If you have many polygons with the same style, this is the most efficient way to add them.

Updates a style previously set for a polygon in a vector map.

Adds a style to a feature in a vector map.

Adds a style to a feature in a vector map.

Updates a style previously set for a feature in a vector map.

Adds a scale-dependent style to a feature in a vector map.

Adds a line to a vector map.

Adds a line to a vector map.

Adds a dynamic line to a dynamic vector map.

Adds a dynamic line to a dynamic vector map.

Adds a dynamic 3d line to a dynamic vector map.

Adds a dynamic 3d line to a dynamic vector map.

Adds a dynamic 3d line skirt to a dynamic vector map.

Adds a dynamic polygon to a dynamic vector map.

Adds a dynamic 3d polygon to a dynamic vector map.

Adds a dynamic 3d polygon extruded using the top and bottom altitude

Adds an ESRI shape file to an in-memory vector map.

Clears all dynamic lines and polygons from a vector map.

Used to exagerate the altitude of 3d lines and polygons

Returns an object if there is vector geometry present at the screen point. Use this for detecting when the user has touched vector geometry. Returns nil if nothing is pressed. If the vectorDelegate is set, also calls hitdetection methods of the delegate.

Sets tesselation threshold for lines in nautical miles.

Force all lines to use 3d line rendering path.

Allow one map to clip another map. Anywhere the clip map would draw is not be drawn by the target map.

Called when a tile has been loaded through a virtual layer. Should only be called on the main thread, otherwise, a syncrhonous lock is used to ensure internal data structure integrity. Places the complete tile request back in the loading queue. See maxAsyncTileLoadsPerFrame.

Called when a tile has been loaded through a virtual layer. If loadImmediate is NO, places the tile request in the loading queue (see maxAsyncTileLoadsPerFrame), otherwise the loading is immediate. NOTE: if loadImmediate is YES you must only make the call from the main thread, otherwise you risk corrupting internal data structure. Warning: immediate loading too many tiles can cause frame hitching.

Called by vector tile providers to supply geometry for a requested tile.

Called by vector tile providers to supply geometry for a requested tile.

Called by vector tile providers to supply binary geometry for a requested tile.

Called by terrain tile providers to supply terrain height data.

Returns whether or not the engine considers the tile represented by meTileRequest to be required to satisfy the current view for any non-animated virtual map. This call will dispatched to the main queue if it is not made on the main queue.

Adds an animated vector circle. This can be used for pulsating location beacons.

Update the position of an animated vector circle.

Removes an animated vector circle.

Adds an animated reticle to mark locations.

Update the position of an animated reticle.

Removes an animated reticle.

Adds an image that will stay cached until it is removed using removeCachedImage. Cached images are identified by their name and may be specified as the default tile for certain maps types or returned by tile providers that have no specific tile to return for a given tile request. Generally this should be a fully opaque 256x256 or 512x512 pixel image.

Checks if a cached image exists for the given name

Adds a marker image that will stay cached until it is removed using removeCachedImage. The intent is for the image to be used as a marker image. Cached marker images are identified by their name and may be specified as the image to be used for a marker when a marker is added. To changed the cached image, call the function again with the same image name, but a different image.

Removes a cached image or cached marker image that was previously added with the addCachedImage or addCachedMarkerImage function.

Returns an angle relative to the verticle edge of the view that represents the rotation you would apply to a screen-aligned object so that it points to the given heading. You would use this function, for example, if you wanted to display an 2D arrow that points in at heading. If you desire for an object to do this and always be up to date and smoothly animated, you should use a marker layer with a marker whose rotation type is kMarkerRotationTrueNorthAligned, then the mapping engine will manage the rotation of the object.

Returns an angle relative to the verticle edge of the view that represents the rotation you would apply to a screen-aligned object so that it points to the given heading releative to the current geographic point at the center of the view. You would use this function, for example, if you wanted to display an 2D arrow that points in at heading. If you desire for an object to do this and always be up to date and smoothly animated, you should use a marker layer with a marker whose rotation type is kMarkerRotationTrueNorthAligned, then the mapping engine will manage the rotation of the object.

Activate your license and disable the BA3 watermark. NOTE: Altus Developer Network members should use alternative setLicenseKey function which takes 2 parameters. Should be called after initialize has been called:

Activate your license and disable the BA3 watermark for members of the Altus Developer Network. Should be called after initialize has been called:

Returns the version tag for this build of Altus.

Returns the internal version hash for this build of Altus. You will be asked to provide this value for certain types of support requests.

Contains information about the current state of the mapping engine.

When set to YES, tells the mapping engine to display verbose messages about state changes and activity.

Semi-internal display list testing config. Should not be used except for testing display list against super slow but accurate method.

Very expensive but useful for stress testing or logging tile counts for different camera settings.

Used to get larger and smaller tiles based on the tile slope to the screen. The default value is 1.4. Increase this value to reduce the number of tiles, or decrease this value to increase the number of tiles.

Adds a custom 3D model to a DynamicModel3D layer using raw vertices to specify points and indices into those vertices to specify points that make up each face (triangle) of the mesh for the model.

Adds a 3D model to a DynamicModel3D layer using a JSON file that contains the model’s mesh data. Model files can be generated using the AltusModel program (a component of AltusServer) to convert a variety of 3D model formats to JSON that can be loaded. Or you can create your own model JSON files. Refer to the AltusDemo program for some examples (i.e. Hexagon.json).

Adds a 3D model to a DynamicModel3D layer using a string in JSON format. JSON model data can be generated using the AltusModel program (a component of AltusServer) to convert a variety of 3D model formats to JSON that can be loaded. Or you can create your own model JSON data. Refer to the AltusDemo program for some examples (i.e. Hexagon.json).

Adds a 3D cone to a DynamicModel3D layer.

Adds a 3D cube to a DynamicModel3D layer.

Adds a 3D cylinder to a DynamicModel3D layer.

Adds a 3D sphere to a DynamicModel3D layer.

Sets the placement and scale of a 3D model instance.

Updates the model texture

Forces linker to link this file via NIB-only interfaces.

The EAGLContext in use by this view controller and its view.

Tells the engine when the application receives a memory warning from the system.

Forward this call from your AppDelegate so the mapping engine can manage internal state.

Forward this call from your AppDelegate so the mapping engine can manage internal state.

Forward this call from your AppDelegate so the mapping engine can manage internal state.

Forward this call from your AppDelegate so the mapping engine can manage internal state.

Forward this call from your AppDelegate so the mapping engine can manage internal state.

Stops and invalidates the CADisplayLink timer that is used to drive updates. Provided for applications that desire to mananage timing and updates themselves. When stopped, the mapping engine will no longer update / draw and your application will be responsible for calling the updateWithTimestamp function in order to ensure updates occur.

Creates and starts a CADisplayLink timer that is used to drive updates. This function is provided for applications that desire to manage timing and updates themsevles. When started, you should discontinue calling updateWithTimestamp.