Image position

Functions
double	Image.GetOriginal_dX ()
	Gets or sets the number of map units per image pixel for x axis.
double	Image.GetOriginal_dY ()
	Gets or sets the number of map units per image pixel for y axis.
int	Image.GetOriginalHeight ()
	Returns the height of the image.
int	Image.GetOriginalWidth ()
	Returns the width of the image.
double	Image.GetOriginalXllCenter ()
	Returns the x coordinate of center of the lower left corner of the images.
double	Image.GetOriginalYllCenter ()
	Returns the y coordinate of the center of lower left corner of the images.
string	Image.GetProjection ()
	Retrieves projection string from the associated .prj file.
void	Image.ImageToProjection (int ImageX, int ImageY, out double projX, out double projY)
	Converts coordinates of image's pixel to the screen coordinates.
void	Image.ProjectionToBuffer (double projX, double projY, out int BufferX, out int BufferY)
	Returns the coodinates of pixel in image buffer which correspond to the given point on the map.
void	Image.ProjectionToImage (double projX, double projY, out int ImageX, out int ImageY)
	Returns the coodinates of image pixel which correspond to the given point on the map.
bool	Image.SetProjection (string Proj4)
	Sets projection string for the image.
Properties
double	Image.dX [get, set]
	Gets or sets the number of map units per pixel of image buffer for x axis.
double	Image.dY [get, set]
	Gets or sets the number of map units per pixel of image buffer for y axis.
Extents	Image.Extents [get]
	Returns the extents of the image.
int	Image.Height [get]
	Gets the height of the image in pixels.
double	Image.OriginalDX [get, set]
	Gets or sets the number of map units per image pixel for x axis.
double	Image.OriginalDY [get, set]
	Gets or sets the number of map units per image pixel for y axis.
int	Image.OriginalHeight [get]
	Gets the height of the image.
int	Image.OriginalWidth [get]
	Gets the width of the image.
double	Image.OriginalXllCenter [get, set]
	Gets or sets the x coordinate of the center of lower left pixel of the image in map units.
double	Image.OriginalYllCenter [get, set]
	Gets or sets the y coordinate of the center of lower left pixel of the image in map units.
int	Image.Width [get]
	Gets the width of the image in pixels.
double	Image.XllCenter [get, set]
	Gets or sets the x coordinate of the center of the lower-left pixel in the image.
double	Image.YllCenter [get, set]
	Gets or sets the y coordinate of the center of the lower-left pixel in the image.

---

Detailed Description

Here is a list of methods and properties which affect position and scale of image, conversion between map units and image coordinates. The properties and methods described here belong to Image class.

Graph description

---

Function Documentation

double Image.GetOriginal_dX

(

)

Gets or sets the number of map units per image pixel for x axis.

The changes of this value will result in scaling of the image horizontally.

Deprecated:

v 4.8. Use Image.Original_dX instead.

double Image.GetOriginal_dY

(

)

Gets or sets the number of map units per image pixel for y axis.

The changes of this value will result in scaling of the image vertically.

Deprecated:

v 4.8. Use Image.Original_dY instead.

int Image.GetOriginalHeight

(

)

Returns the height of the image.

Returns:

The height of the image.

Deprecated:

v 4.8. Use Image.OriginalHeight instead.

int Image.GetOriginalWidth

(

)

Returns the width of the image.

Returns:

The width of the image.

Deprecated:

v 4.8. Use Image.OriginalWidth instead.

double Image.GetOriginalXllCenter

(

)

Returns the x coordinate of center of the lower left corner of the images.

Returns:

Y coordinate of the corner.

Deprecated:

v 4.8. Use Image.OriginalXllCenter instead.

double Image.GetOriginalYllCenter

(

)

Returns the y coordinate of the center of lower left corner of the images.

Returns:

X coordinate of the corner.

Deprecated:

v 4.8. Use Image.OriginalYllCenter instead.

string Image.GetProjection

(

)

Retrieves projection string from the associated .prj file.

Returns:

Projection string or empty string on it's absense.

void Image.ImageToProjection	(	int	ImageX,
		int	ImageY,
		out double	projX,
		out double	projY
	)

Converts coordinates of image's pixel to the screen coordinates.

Parameters:

ImageX	The x coordinate of the image.
ImageY	The y coordinate of the image.
projX	The resulting x coordinate of the map.
projY	The resulting y coordinate of the map.

New API 4.8:

Added in version 4.8

void Image.ProjectionToBuffer	(	double	projX,
		double	projY,
		out int	BufferX,
		out int	BufferY
	)

Returns the coodinates of pixel in image buffer which correspond to the given point on the map.

Parameters:

projX	X coordinate of the point in map units.
projY	Y coordinate of the point in map units.
BufferX	The resulting x coordinate of pixel in the image buffer.
BufferY	The resulting y coordinate of pixel in the image buffer.

New API 4.8:

Added in version 4.8

void Image.ProjectionToImage	(	double	projX,
		double	projY,
		out int	ImageX,
		out int	ImageY
	)

Returns the coodinates of image pixel which correspond to the given point on the map.

Parameters:

projX	X coordinate of the point in map units.
projY	Y coordinate of the point in map units.
ImageX	The resulting x coordinate of image pixel.
ImageY	The resulting y coordinate of image pixel.

New API 4.8:

Added in version 4.8

bool Image.SetProjection

(

string

Proj4

)

Sets projection string for the image.

The string will be saved to .prj file with the same name as image.

Parameters:

Proj4

The projection string.

Returns:

True on sucess and false otherwise.

---

Properties

double Image.dX [get, set]

Gets or sets the number of map units per pixel of image buffer for x axis.

The set part of the property is not applicable for GDAL images.

double Image.dY [get, set]

Gets or sets the number of map units per pixel of image buffer for y axis.

The set part of the property is not applicable for GDAL images.

Extents Image.Extents [get]

Returns the extents of the image.

Examples:

ImageLabels.cs.

int Image.Height [get]

Gets the height of the image in pixels.

double Image.OriginalDX [get, set]

Gets or sets the number of map units per image pixel for x axis.

The changes of this value will result in scaling of the image horizontally.

New API 4.8:

Added in version 4.8

double Image.OriginalDY [get, set]

Gets or sets the number of map units per image pixel for y axis.

The changes of this value will result in scaling of the image vertically.

New API 4.8:

Added in version 4.8

int Image.OriginalHeight [get]

Gets the height of the image.

This property should be used to return the total height of the image, as compared to the height of the image buffer.

Returns:

The height of the image in pixels.

New API 4.8:

Added in version 4.8

int Image.OriginalWidth [get]

Gets the width of the image.

This property should be used to return the total width of the image, as compared to the width of the image buffer.

Returns:

The width of the image in pixels.

New API 4.8:

Added in version 4.8

double Image.OriginalXllCenter [get, set]

Gets or sets the x coordinate of the center of lower left pixel of the image in map units.

New API 4.8:

Added in version 4.8

double Image.OriginalYllCenter [get, set]

Gets or sets the y coordinate of the center of lower left pixel of the image in map units.

New API 4.8:

Added in version 4.8

int Image.Width [get]

Gets the width of the image in pixels.

double Image.XllCenter [get, set]

Gets or sets the x coordinate of the center of the lower-left pixel in the image.

double Image.YllCenter [get, set]

Gets or sets the y coordinate of the center of the lower-left pixel in the image.