I have done several "radars" which are basically "maps" .
According to the guide, the range (zoom) is the biggest circle that can be drawn within the boundaries of the map.
The above quote is a simplification that applies to only one situation .
Pixels scale remains constant in either vertical or horizontal display directions , do not change due to rotation .
Range (zoom) is based on the vertical map display height , if you have a square map display that has a range of 40 nm from top to bottom of the display ,
and that instrument is in a pop up window that can be re sized .
If you now stretch the vertical height of the display to twice it's original height it will still be 40 nm top to bottom .
If on the other hand you stretched the display only in the horizontal to twice it's width it would be 80 nm left to right .
In these maps the vertical height sets the range .
Generally in maps the zoom is set to nm (Nautical Miles) by multiplying the zoom factor by 1852.0 .
These maps can be any shape , a square , horizontal rectangle , vertical rectangle , a circle , or a fan shaped cone in the direction of the aircraft , therefore
you can see that drawing a circle does not always represent the range .
The following represent the map aspects within "Custom Draw" ,
(1) Map display size .
(2) Map center , this is a little misleading as it is really the map focal point .
Code:
<CustomDrawParam id="CenterX" Name="CenterX">
<Value>@MapWidth 2 / </Value>
</CustomDrawParam>
<CustomDrawParam id="CenterY" Name="CenterY">
<Value>260</Value>
</CustomDrawParam>
As you can see the Center Y is at 260 pixals down out of the 350 height , thus the focal point has been moved down towards the lower region on the display .
Center X and Center Y are used to position the " Focal Point " where ever you wish to place it on the display .
The "Focal point" is the center of rotation of the display , also all features shown on the map are relative to that point , ie ; airports , VOR , NDB , Intersections ,
flight plan lines , terrain , AI aircraft .
You would position the Focal point to serve the function of the map that you desire ,
* ATC radar focal Pt at center of display .
* Aircraft radar focal Pt at bottom of display .
* Rear facing aircraft radar focal Pt at top of display .
* SLAR (sideways looking radar focal Pt at either left or right of display .
(3) Zoom (range selection .
Code:
<CustomDrawParam id="Zoom" Name="Zoom">
<Value>(L:map_ZoomFactor, number) 1852.0 *</Value>
</CustomDrawParam>
(4) Physical location of map or focal point .
Code:
<CustomDrawParam id="Latitude" Name="Latitude">
<Value>(A:PLANE LATITUDE,Radians)</Value>
</CustomDrawParam>
<CustomDrawParam id="Longitude" Name="Longitude">
<Value>(A:PLANE LONGITUDE,Radians)</Value>
</CustomDrawParam>
This example is at the user aircraft , however it can be positioned at other locations , I use a generic Lat/Long in one radar mode to enable the display
to be projected to any location on earth by forcing a location into the generic Lat/Long .
Cheers
Karol
PS ;
If you are interested in Zoom settings to achieve absolute scalar distance precision , and placement of focal point on map display ,
I detailed a calculation method that I use at page 2 of the following link ,
http://www.fsdeveloper.com/forum/threads/need-help-with-radar-gauge.428217/