This function can be used to set the view orientation for the MapView camera when in 3D mode.



bool fsMapViewSet3DViewOrientation(
    FsContext ctx,
    FsTextureId id,
    FsMapView3DOrientation eOrientation



Parameters Description
ctx A value of type FsContext provided as an argument of the gauge callback.
id The MapView render ID as returned by the function fsMapViewCreate.
eOrientation Sets the orientation for the 3D camera based on one of the supplied values. See the Remarks for more information.



Return Values

Returns false if:

  • no texture matches the given MapView ID
  • the ctx is invalid
  • if the eOrientation value is not one of the ones permitted

Otherwise it will return true.




The table below shows the available references for the MapView 3D orientation:

eOrientation Description
FS_MAP_VIEW_3D_ORIENTATION_FRONTVIEW Sets the 3D view to a static front view camera.
FS_MAP_VIEW_3D_ORIENTATION_TOPVIEW Sets the 3D view to a static top view camera.
FS_MAP_VIEW_3D_ORIENTATION_CUSTOM Sets the 3D view to use the custom view setup using the function fsMapViewSet3DCustomViewOrientationInRadians.


This function is only valid when fsMapViewSet3D is set to true (ie: 3D is enabled).



See Also