HERE iOS SDK Developer's Guide

NMAMapLocalModel

Class Summary

class NMAMapLocalModel

Derived from: NMAMapModelObject

Displays a custom 3D model at a fixed geographical location on a map.

Include: NMAKit.framework/headers/NMAMapLocalModel.h

Inheritance Diagrams

Figure 1. Public inheritance diagram for NMAMapLocalModel

[For complete information, see the section Class Details]

Public Property Summary

Table 1. Public Properties
Public Properties

[readable, writable, assign] BOOL  autoscaled

Enables autoscaling, which causes the mesh to be rendered at roughly the same size regardless of map zoom level

[readable, writable, assign] NMAGeoCoordinates coordinates

The geographical location of the mesh origin

[readable, writable, assign] float  pitch

The east-west axis rotation of the mesh

[readable, writable, assign] float  roll

The north-south axis rotation of the mesh

[readable, writable, assign] float  scale

A factor controlling the size of the mesh; a value of 0 will render the mesh at its true size

[readable, writable, assign] float  yaw

The up-down axis rotation of the mesh

Instance Method Summary

Table 2. Instance Methods
Instance Method Summary

-(nonnull instancetype) initWithMesh:(nonnull NMAFloatMesh *) mesh

Initializes an instance of NMAMapLocalModel with the specified NMAFloatMesh

Class Details

Displays a custom 3D model at a fixed geographical location on a map.

The NMAMapLocalModel is used to display custom 3D content on an instance of NMAMapView. The 3D model is defined using an instance of NMAFloatMesh, with the unit mesh unit representing one meter in world space. The mesh origin is located on a map using NMAMapLocalModel's coordinates property.

The orientation of the mesh may be controlled by modifying its pitch, yaw, and roll. These values may range from 0 to 360 degrees. The size of the mesh can be adjusted manually using the scale property, or automatically adjusted by setting the autoscaled property to YES.

As a subclass of NMAMapObject, instances of NMAMapLocalModel may be selected, hidden, placed inside an NMAMapContainer, or any other operation that can be applied to map objects.

Public Property Details

[readable, writable, assign] BOOL autoscaled

Enables autoscaling, which causes the mesh to be rendered at roughly the same size regardless of map zoom level.

[readable, writable, assign] NMAGeoCoordinatescoordinates

The geographical location of the mesh origin.

[readable, writable, assign] float pitch

The east-west axis rotation of the mesh.

[readable, writable, assign] float roll

The north-south axis rotation of the mesh.

[readable, writable, assign] float scale

A factor controlling the size of the mesh; a value of 0 will render the mesh at its true size.

Note:

The effect of scale on the model size varies significantly depending on whether or not autoscaling is enabled and the magnitude of the model vertices. Therefore, depending on these factors you may have to tweak the scale (by orders of magnitude perhaps) to get a model of the same relative size as another.

[readable, writable, assign] float yaw

The up-down axis rotation of the mesh.

Instance Method Details

-(nonnull instancetype) initWithMesh:(nonnull NMAFloatMesh *) mesh

Initializes an instance of NMAMapLocalModel with the specified NMAFloatMesh.

Note:

The mesh parameter cannot be nil.