Detailed Description

This callback is used by the TSLKMLDataLayer in order to pass screen overlay elements to an application.

The application should inherit from this class, and call TSLKMLDataLayer::set ScreenOverlayCallback().

Public Member Functions
virtual void	callback (const char *filename, double imageAnchorX, double imageAnchorY, double screenAnchorX, TSLKMLUnitsEnum screenAnchorXUnits, double screenAnchorY, TSLKMLUnitsEnum screenAnchorYUnits, double rotationCenterX, double rotationCenterY, double rotationDegrees, double scaleX, double scaleY)=0


virtual	~TSLKMLScreenOverlayCallback ()=0

Constructor & Destructor Documentation

TSLKMLScreenOverlayCallback::~TSLKMLScreenOverlayCallback ( )

inlinepure virtual

virtual void TSLKMLScreenOverlayCallback::callback	(	const char *	filename,
		double	imageAnchorX,
		double	imageAnchorY,
		double	screenAnchorX,
		TSLKMLUnitsEnum	screenAnchorXUnits,
		double	screenAnchorY,
		TSLKMLUnitsEnum	screenAnchorYUnits,
		double	rotationCenterX,
		double	rotationCenterY,
		double	rotationDegrees,
		double	scaleX,
		double	scaleY )

pure virtual

This callback is called when a screen overlay element is encountered in kml, while the datalayer is loading.

It should be implemented by the application, and should use the provided information to display the screen overlays.

Parameters

filename	The name of the screen overlay image - This is an image stored in the TSLKMLDataLayer cache. It will always be in PNG format, but may not have a file extension.
imageAnchorX	The anchor point X value on the image - This is a fraction of the image width, from the left.
imageAnchorY	The anchor point Y value on the image - This is a fraction of the image height, from the bottom.
screenAnchorX	The anchor point X value on the screen - The units are specified by the screenAnchorXUnits parameter.
screenAnchorXUnits	The units of the screenAnchorX parameter.
screenAnchorY	The anchor point Y value on the screen - The units are specified by the screenAnchorYUnits parameter.
screenAnchorYUnits	The units of the screenAnchorY parameter.
rotationCenterX	The center of rotation X value: This is a fraction of the image width, from the left.
rotationCenterY	The center of rotation Y value: This is a fraction of the image height, from the bottom.
rotationDegrees	The rotation of the screen overlay in degrees counterclockwise.
scaleX	The horizontal scaling value: This is a fraction of the image width. A value of 0 indicates that the aspect ratio should be preserved, and the image scaled using the other scaling value.
scaleY	The vertical scaling value: This is a fraction of the image height. A value of 0 indicates that the aspect ratio should be preserved, and the image scaled using the other scaling value.