====== calc_AM_GetIDfromColour ======

<note important>
This function has been removed from the core API, and is now available via the 'calc.AM.GetIDfromColour' zeofunc.
</note>

===== Description =====

Get the 16-bit ID of a land type in the [[l3dt:reference:maps:AM|attributes map]], as represented by an [[zeolite:core:types:AttributesPixel]] structure, that corresponds to a given [[l3dt:algorithms:cli:land_type:dispcol|display colour]].

===== Function prototype =====

<code>AttributesPixel CExtAPI::calc_AM_GetIDfromColour(COLORREF col);</code>

===== Arguments =====

^ Name ^ Type ^ Comment ^
| col | COLORREF | A [[http://msdn.microsoft.com/library/en-us/gdi/colors_9xiq.asp?frame=true|Windows COLORREF]] structure containing the (supposed) display colour of a land type, the ID of which is to be determined. |

===== Return value =====

Zero if the given colour does not match the display colour of a known land type, and non-zero otherwise.


===== Comments =====

This function is used when loading the attributes map from a colour-mapped image file.