PlotInit
This command initializes the plot points on a map so that an end user can see a start and destination points on an image such as a map.
Group: Device Extensions
Syntax Device.PlotInit(BSTR MapSource, double Geo1Lat, double Geo1Lng, int Geo1X, int Geo1Y, double Geo2Lat, double Geo2Lng, int Geo2X, int Geo2Y, int MapEdgePixels, BSTR MapPrompt, BSTR userPin, enAlign UserAlign, BSTR TargetPin, enAlign TargetAlign)
| Parameter | Description |
|---|---|
| Geo1Lat, Geo1Lng | The latitude and longitude of the first reference point on the map image.This is used to calibrate the longitude and latitude geo coordinates to X and Y pixel coordinates of the map image. |
| Geo1X, Geo1Y | The X and Y pixel values of where 1st reference point is on the map image. |
| Geo2Lat, Geo2Lng | The latitude and longitude of the 2nd reference point on the map image. |
| Geo2X, Geo2Y | The X and Y pixel values of where the 2nd reference point is on the map image. |
| MapEdgePixels |
How many pixels to add as padding so that when the user’s pin icon is close to the edge there is this many pixels spacing the pin from the edge. A value of 0 means that as the user moves to the edge of the zoomed-in map, they are able to be right against the edge of the map with nothing past them being displayed. A value of 15 means that there will be 15px of extra map space displayed past the user up until they go off the entire full map. |
| MapPrompt | The name of the image control being used for this map image. |
| MapSource | The image name of the map being loaded into the image control on the form. This accepts both the name of an Image from RFImages as well as an absolute path to an image locally such as “%APPDATA%\MapImages\Map.png”. |
| TargetAlign | The alignment property for where the user pin should remain in respect to the map area. |
| TargetPin | The name of the image control being used as the pin for the target’s location. |
| UserAlign | The alignment property of the target pin. |
| UserPin | The name of the image control being used as the pin for the user’s location. |
Example Under construction.
Versions Supported: …RFgen 5.2.4.6 and newer.