QGIS API Documentation  2.10.1-Pisa
 All Classes Namespaces Files Functions Variables Typedefs Enumerations Enumerator Properties Friends Macros Groups Pages
Public Member Functions | List of all members
QgsMapToPixel Class Reference

Perform transforms between map coordinates and device coordinates. More...

#include <qgsmaptopixel.h>

Public Member Functions

Q_DECL_DEPRECATED QgsMapToPixel (double mapUnitsPerPixel, double height, double ymin=0, double xmin=0)
 Constructor. More...
 
 QgsMapToPixel (double mapUnitsPerPixel, double xc, double yc, int width, int height, double rotation)
 Constructor. More...
 
 QgsMapToPixel (double mapUnitsPerPixel)
 Constructor. More...
 
 QgsMapToPixel ()
 Constructor. More...
 
 ~QgsMapToPixel ()
 destructor More...
 
int mapHeight () const
 Return current map height in pixels. More...
 
double mapRotation () const
 Return current map rotation in degrees. More...
 
double mapUnitsPerPixel () const
 Return current map units per pixel. More...
 
int mapWidth () const
 Return current map width in pixels The information is only known if setRotation was used. More...
 
void setMapRotation (double degrees, double cx, double cy)
 Set map rotation in degrees (clockwise) More...
 
void setMapUnitsPerPixel (double mapUnitsPerPixel)
 Set map units per pixel. More...
 
Q_DECL_DEPRECATED void setParameters (double mapUnitsPerPixel, double xmin, double ymin, double height)
 Set parameters for use in transforming coordinates. More...
 
void setParameters (double mapUnitsPerPixel, double xc, double yc, int width, int height, double rotation)
 Set parameters for use in transforming coordinates. More...
 
Q_DECL_DEPRECATED void setXMinimum (double xmin)
 set minimum x value More...
 
Q_DECL_DEPRECATED void setYMaximum (double yMax)
 Set maximum y value. More...
 
Q_DECL_DEPRECATED void setYMinimum (double ymin)
 Set minimum y value. More...
 
QString showParameters () const
 String representation of the parameters used in the transform. More...
 
QgsPoint toMapCoordinates (int x, int y) const
 
QgsPoint toMapCoordinates (QPoint p) const
 Transform device coordinates to map (world) coordinates. More...
 
QgsPoint toMapCoordinatesF (double x, double y) const
 Transform device coordinates to map (world) coordinates. More...
 
QgsPoint toMapPoint (qreal x, qreal y) const
 
QgsPoint transform (const QgsPoint &p) const
 Transform the point from map (world) coordinates to device coordinates. More...
 
void transform (QgsPoint *p) const
 
QgsPoint transform (qreal x, qreal y) const
 Transform the point specified by x,y from map (world) coordinates to device coordinates. More...
 
QTransform transform () const
 
void transformInPlace (qreal &x, qreal &y) const
 Transform device coordinates to map (world) coordinates. More...
 
template<class T >
void transformInPlace (QVector< T > &x, QVector< T > &y) const
 Transform device coordinates to map coordinates. More...
 

Detailed Description

Perform transforms between map coordinates and device coordinates.

This class can convert device coordinates to map coordinates and vice versa.

Definition at line 34 of file qgsmaptopixel.h.

Constructor & Destructor Documentation

QgsMapToPixel::QgsMapToPixel ( double  mapUnitsPerPixel,
double  height,
double  ymin = 0,
double  xmin = 0 
)

Constructor.

Parameters
mapUnitsPerPixelMap units per pixel
heightMap canvas height, in pixels
yminMinimum y value of the map canvas
xminMinimum x value of the map canvas
Deprecated:
in 2.8, use version with all parameters

Definition at line 72 of file qgsmaptopixel.cpp.

QgsMapToPixel::QgsMapToPixel ( double  mapUnitsPerPixel,
double  xc,
double  yc,
int  width,
int  height,
double  rotation 
)

Constructor.

Parameters
mapUnitsPerPixelMap units per pixel
xcX ordinate of map center, in geographical units
ycY ordinate of map center, in geographical units
widthOutput width, in pixels
heightOutput height, in pixels
rotationclockwise rotation in degrees
Note
added in 2.8

Definition at line 26 of file qgsmaptopixel.cpp.

QgsMapToPixel::QgsMapToPixel ( double  mapUnitsPerPixel)

Constructor.

Parameters
mapUnitsPerPixelMap units per pixel

Definition at line 45 of file qgsmaptopixel.cpp.

QgsMapToPixel::QgsMapToPixel ( )

Constructor.

Use setParameters to fill

Definition at line 58 of file qgsmaptopixel.cpp.

QgsMapToPixel::~QgsMapToPixel ( )

destructor

Definition at line 88 of file qgsmaptopixel.cpp.

Member Function Documentation

int QgsMapToPixel::mapHeight ( ) const

Return current map height in pixels.

Note
added in 2.8

Definition at line 92 of file qgsmaptopixel.cpp.

double QgsMapToPixel::mapRotation ( ) const

Return current map rotation in degrees.

Note
added in 2.8

Definition at line 181 of file qgsmaptopixel.cpp.

double QgsMapToPixel::mapUnitsPerPixel ( ) const

Return current map units per pixel.

Definition at line 151 of file qgsmaptopixel.cpp.

int QgsMapToPixel::mapWidth ( ) const

Return current map width in pixels The information is only known if setRotation was used.

Note
added in 2.8

Definition at line 97 of file qgsmaptopixel.cpp.

void QgsMapToPixel::setMapRotation ( double  degrees,
double  cx,
double  cy 
)

Set map rotation in degrees (clockwise)

Parameters
degreesclockwise rotation in degrees
cxX ordinate of map center in geographical units
cyY ordinate of map center in geographical units
Note
added in 2.8

Definition at line 156 of file qgsmaptopixel.cpp.

void QgsMapToPixel::setMapUnitsPerPixel ( double  mapUnitsPerPixel)

Set map units per pixel.

Parameters
mapUnitsPerPixelMap units per pixel

Definition at line 141 of file qgsmaptopixel.cpp.

void QgsMapToPixel::setParameters ( double  mapUnitsPerPixel,
double  xmin,
double  ymin,
double  height 
)

Set parameters for use in transforming coordinates.

Parameters
mapUnitsPerPixelMap units per pixel
xminMinimum x value
yminMinimum y value
heightMap height, in pixels
Deprecated:
in 2.8, use the version with full parameters

Definition at line 218 of file qgsmaptopixel.cpp.

void QgsMapToPixel::setParameters ( double  mapUnitsPerPixel,
double  xc,
double  yc,
int  width,
int  height,
double  rotation 
)

Set parameters for use in transforming coordinates.

Parameters
mapUnitsPerPixelMap units per pixel
xcX ordinate of map center, in geographical units
ycY ordinate of map center, in geographical units
widthOutput width, in pixels
heightOutput height, in pixels
rotationclockwise rotation in degrees
Note
added in 2.8

Definition at line 248 of file qgsmaptopixel.cpp.

void QgsMapToPixel::setXMinimum ( double  xmin)

set minimum x value

Deprecated:
in 2.8, use setParameters

Definition at line 202 of file qgsmaptopixel.cpp.

Q_DECL_DEPRECATED void QgsMapToPixel::setYMaximum ( double  yMax)
inline

Set maximum y value.

Deprecated:
in 2.8, use setParameters
Note
this really sets the viewport height, not ymax

Definition at line 177 of file qgsmaptopixel.h.

void QgsMapToPixel::setYMinimum ( double  ymin)

Set minimum y value.

Deprecated:
in 2.8, use setParameters

Definition at line 187 of file qgsmaptopixel.cpp.

QString QgsMapToPixel::showParameters ( ) const

String representation of the parameters used in the transform.

Definition at line 286 of file qgsmaptopixel.cpp.

QgsPoint QgsMapToPixel::toMapCoordinates ( int  x,
int  y 
) const

Definition at line 131 of file qgsmaptopixel.cpp.

QgsPoint QgsMapToPixel::toMapCoordinates ( QPoint  p) const

Transform device coordinates to map (world) coordinates.

Parameters
pPoint to be converted to map cooordinates
Returns
QgsPoint in map coorndiates

Definition at line 125 of file qgsmaptopixel.cpp.

QgsPoint QgsMapToPixel::toMapCoordinatesF ( double  x,
double  y 
) const

Transform device coordinates to map (world) coordinates.

Definition at line 136 of file qgsmaptopixel.cpp.

QgsPoint QgsMapToPixel::toMapPoint ( qreal  x,
qreal  y 
) const

Definition at line 114 of file qgsmaptopixel.cpp.

QgsPoint QgsMapToPixel::transform ( const QgsPoint p) const

Transform the point from map (world) coordinates to device coordinates.

Parameters
pPoint to transform
Returns
QgsPoint in device coordinates

Definition at line 302 of file qgsmaptopixel.cpp.

void QgsMapToPixel::transform ( QgsPoint p) const

Definition at line 310 of file qgsmaptopixel.cpp.

QgsPoint QgsMapToPixel::transform ( qreal  x,
qreal  y 
) const

Transform the point specified by x,y from map (world) coordinates to device coordinates.

Parameters
xx cordinate o point to transform
yy coordinate of point to transform
Returns
QgsPoint in device coordinates

Definition at line 296 of file qgsmaptopixel.cpp.

QTransform QgsMapToPixel::transform ( ) const

Definition at line 327 of file qgsmaptopixel.cpp.

void QgsMapToPixel::transformInPlace ( qreal &  x,
qreal &  y 
) const

Transform device coordinates to map (world) coordinates.

Parameters
xx coordinate of point to be converted to map cooordinates
yy coordinate of point to be converted to map cooordinates
Returns
QgsPoint in map coordinates Transform device coordinates to map coordinates. Modifies the given coordinates in place. Intended as a fast way to do the transform.

Definition at line 318 of file qgsmaptopixel.cpp.

template<class T >
void QgsMapToPixel::transformInPlace ( QVector< T > &  x,
QVector< T > &  y 
) const
inline

Transform device coordinates to map coordinates.

Modifies the given coordinates in place. Intended as a fast way to do the transform.

Note
not available in python bindings

Definition at line 114 of file qgsmaptopixel.h.


The documentation for this class was generated from the following files: