Материал из Wiki.crossplatform.ru

Внимание: Актуальная версия перевода документации находится здесь

__NOTOC__

[править] QPaintEngine Class Reference
^{[модуль QtGui ]}

The QPaintEngine class provides an abstract definition of how QPainter draws to a given device on a given platform. Далее...

 #include <QPaintEngine>

Inherited by QRasterPaintEngine.

• Список всех членов, включая унаследованные

[править] Открытые типы

• enum DirtyFlag { DirtyPen, DirtyBrush, DirtyBrushOrigin, DirtyFont, ..., AllDirty }
• flags DirtyFlags
• enum PaintEngineFeature { AlphaBlend, Antialiasing, BlendModes, BrushStroke, ..., AllFeatures }
• flags PaintEngineFeatures
• enum PolygonDrawMode { OddEvenMode, WindingMode, ConvexMode, PolylineMode }
• enum Type { X11, Windows, MacPrinter, CoreGraphics, ..., MaxUser }

[править] Открытые функции

• QPaintEngine ( PaintEngineFeatures caps = 0 )
• virtual ~QPaintEngine ()
• virtual bool begin ( QPaintDevice * pdev ) = 0
• virtual void drawEllipse ( const QRectF & rect )
• virtual void drawEllipse ( const QRect & rect )
• virtual void drawImage ( const QRectF & rectangle, const QImage & image, const QRectF & sr, Qt::ImageConversionFlags flags = Qt::AutoColor )
• virtual void drawLines ( const QLineF * lines, int lineCount )
• virtual void drawLines ( const QLine * lines, int lineCount )
• virtual void drawPath ( const QPainterPath & path )
• virtual void drawPixmap ( const QRectF & r, const QPixmap & pm, const QRectF & sr ) = 0
• virtual void drawPoints ( const QPointF * points, int pointCount )
• virtual void drawPoints ( const QPoint * points, int pointCount )
• virtual void drawPolygon ( const QPointF * points, int pointCount, PolygonDrawMode mode )
• virtual void drawPolygon ( const QPoint * points, int pointCount, PolygonDrawMode mode )
• virtual void drawRects ( const QRectF * rects, int rectCount )
• virtual void drawRects ( const QRect * rects, int rectCount )
• virtual void drawTextItem ( const QPointF & p, const QTextItem & textItem )
• virtual void drawTiledPixmap ( const QRectF & rect, const QPixmap & pixmap, const QPointF & p )
• virtual bool end () = 0
• bool hasFeature ( PaintEngineFeatures feature ) const
• bool isActive () const
• QPaintDevice * paintDevice () const
• QPainter * painter () const
• void setActive ( bool state )
• virtual Type type () const = 0
• virtual void updateState ( const QPaintEngineState & state ) = 0

[править] Подробное описание

The QPaintEngine class provides an abstract definition of how QPainter draws to a given device on a given platform.

Qt 4.0 provides several premade implementations of QPaintEngine for the different painter backends we support. We provide one paint engine for each window system and painting framework we support. This includes X11 on Unix/Linux and CoreGraphics on Mac OS X. In addition we provide QPaintEngine implementations for OpenGL (accessible through QGLWidget) and PostScript (accessible through QPSPrinter on X11). Additionally there is a raster-based paint engine that is a fallback for when an engine does not support a certain capability.

If one wants to use QPainter to draw to a different backend, one must subclass QPaintEngine and reimplement all its virtual functions. The QPaintEngine implementation is then made available by subclassing QPaintDevice and reimplementing the virtual function QPaintDevice::paintEngine().

QPaintEngine is created and owned by the QPaintDevice that created it.

The big advantage of the QPaintEngine approach opposed to Qt 3's QPainter/QPaintDevice::cmd() approach is that it is now possible to adapt to multiple technologies on each platform and take advantage of each to the fullest.

See also QPainter, QPaintDevice::paintEngine(), and The Paint System.

[править] Описание типов

[править]

enum QPaintEngine::DirtyFlag
flags QPaintEngine::DirtyFlags

These types are used by QPainter to trigger lazy updates of the various states in the QPaintEngine using QPaintEngine::updateState().

A paint engine must update every dirty state.

The DirtyFlags type is a typedef for QFlags<DirtyFlag>. It stores an OR combination of DirtyFlag values.

[править]

enum QPaintEngine::PaintEngineFeature
flags QPaintEngine::PaintEngineFeatures

This enum is used to describe the features or capabilities that the paint engine has. If a feature is not supported by the engine, QPainter will do a best effort to emulate that feature through other means and pass on an alpha blended QImage to the engine with the emulated results. Some features cannot be emulated: AlphaBlend and PorterDuff.

The PaintEngineFeatures type is a typedef for QFlags<PaintEngineFeature>. It stores an OR combination of PaintEngineFeature values.

[править]

enum QPaintEngine::PolygonDrawMode

[править]

enum QPaintEngine::Type

[править] Описание функций-членов

[править]

QPaintEngine::QPaintEngine ( PaintEngineFeatures caps = 0 )

Creates a paint engine with the featureset specified by caps.

[править]

QPaintEngine::~QPaintEngine () [virtual]

Destroys the paint engine.

[править]

bool QPaintEngine::begin ( QPaintDevice * pdev ) [pure virtual]

Reimplement this function to initialise your paint engine when painting is to start on the paint device pdev. Return true if the initialization was successful; otherwise return false.

See also end() and isActive().

[править]

void QPaintEngine::drawEllipse ( const QRectF & rect ) [virtual]

Reimplement this function to draw the largest ellipse that can be contained within rectangle rect.

The default implementation calls drawPolygon().

[править]

void QPaintEngine::drawEllipse ( const QRect & rect ) [virtual]

Эта перегруженная функция предоставлена для удобства.

The default implementation of this function calls the floating point version of this function

[править]

void QPaintEngine::drawImage ( const QRectF & rectangle, const QImage & image, const QRectF & sr, Qt::ImageConversionFlags flags = Qt::AutoColor ) [virtual]

Reimplement this function to draw the part of the image specified by the sr rectangle in the given rectangle using the given conversion flags flags, to convert it to a pixmap.

[править]

void QPaintEngine::drawLines ( const QLineF * lines, int lineCount ) [virtual]

The default implementation splits the list of lines in lines into lineCount separate calls to drawPath() or drawPolygon() depending on the feature set of the paint engine.

[править]

void QPaintEngine::drawLines ( const QLine * lines, int lineCount ) [virtual]

Эта перегруженная функция предоставлена для удобства.

The default implementation converts the first lineCount lines in lines to a QLineF and calls the floating point version of this function.

[править]

void QPaintEngine::drawPath ( const QPainterPath & path ) [virtual]

The default implementation ignores the path and does nothing.

[править]

void QPaintEngine::drawPixmap ( const QRectF & r, const QPixmap & pm, const QRectF & sr ) [pure virtual]

Reimplement this function to draw the part of the pm specified by the sr rectangle in the given r.

[править]

void QPaintEngine::drawPoints ( const QPointF * points, int pointCount ) [virtual]

Draws the first pointCount points in the buffer points

[править]

void QPaintEngine::drawPoints ( const QPoint * points, int pointCount ) [virtual]

Эта перегруженная функция предоставлена для удобства.

Draws the first pointCount points in the buffer points

The default implementation converts the first pointCount QPoints in points to QPointFs and calls the floating point version of drawPoints.

[править]

void QPaintEngine::drawPolygon ( const QPointF * points, int pointCount, PolygonDrawMode mode ) [virtual]

Reimplement this virtual function to draw the polygon defined by the pointCount first points in points, using mode mode.

The default implementation of this function will try to use drawPath if the engine supports the feature QPaintEngine::PainterPaths or try the float based drawPolygon() implementation if not.

[править]

void QPaintEngine::drawPolygon ( const QPoint * points, int pointCount, PolygonDrawMode mode ) [virtual]

Эта перегруженная функция предоставлена для удобства.

Reimplement this virtual function to draw the polygon defined by the pointCount first points in points, using mode mode.

The default implementation of this function will try to use drawPath() if the engine supports the feature QPaintEngine::PainterPaths or try the int based drawPolygon() implementation if not.

[править]

void QPaintEngine::drawRects ( const QRectF * rects, int rectCount ) [virtual]

Draws the first rectCount rectangles in the buffer rects. The default implementation of this function calls drawPath() or drawPolygon() depending on the feature set of the paint engine.

[править]

void QPaintEngine::drawRects ( const QRect * rects, int rectCount ) [virtual]

Эта перегруженная функция предоставлена для удобства.

The default implementation converts the first rectCount rectangles in the buffer rects to a QRectF and calls the floating point version of this function.

[править]

void QPaintEngine::drawTextItem ( const QPointF & p, const QTextItem & textItem ) [virtual]

This function draws the text item textItem at position p. The default implementation of this function converts the text to a QPainterPath and paints the resulting path.

[править]

void QPaintEngine::drawTiledPixmap ( const QRectF & rect, const QPixmap & pixmap, const QPointF & p ) [virtual]

Reimplement this function to draw the pixmap in the given rect, starting at the given p. The pixmap will be drawn repeatedly until the rect is filled.

[править]

bool QPaintEngine::end () [pure virtual]

Reimplement this function to finish painting on the current paint device. Return true if painting was finished successfully; otherwise return false.

See also begin() and isActive().

[править]

bool QPaintEngine::hasFeature ( PaintEngineFeatures feature ) const

Returns true if the paint engine supports the specified feature; otherwise returns false.

[править]

bool QPaintEngine::isActive () const

Returns true if the paint engine is actively drawing; otherwise returns false.

See also setActive().

[править]

QPaintDevice * QPaintEngine::paintDevice () const

Returns the device that this engine is painting on, if painting is active; otherwise returns 0.

[править]

QPainter * QPaintEngine::painter () const

Returns the paint engine's painter.

[править]

void QPaintEngine::setActive ( bool state )

Sets the active state of the paint engine to state.

See also isActive().

[править]

Type QPaintEngine::type () const [pure virtual]

Reimplement this function to return the paint engine Type.

[править]

void QPaintEngine::updateState ( const QPaintEngineState & state ) [pure virtual]

Reimplement this function to update the state of a paint engine.

When implemented, this function is responsible for checking the paint engine's current state and update the properties that are changed. Use the QPaintEngineState::state() function to find out which properties that must be updated, then use the corresponding get function to retrieve the current values for the given properties.

See also QPaintEngineState.