Amebis/wxWidgets
1
0
Fork 0
Code Issues Pull Requests Actions Packages Projects Releases Wiki Activity

Make wxDC::Blit() and StretchBlit() documentation more useful.

Browse Source 
Enumerating the list of parameters in the method description is not especially
helpful, don't do it. Explain the functions relationship instead.

Also don't say that StretchBlit() is not implemented in wxGTK because it does
work there (using the generic implementation using wxDC scale).

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@71027 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
This commit is contained in:
Vadim Zeitlin
2012-03-27 12:28:01 +00:00
parent 90761420ee
commit 825842b411
1 changed files with 15 additions and 10 deletions
Download Patch File Download Diff File Expand all files Collapse all files

25
interface/wx/dc.h
View File

@@ -1118,10 +1118,12 @@ public:
//@{ //@{
/** /**
Copy from a source DC to this DC, specifying the destination Copy from a source DC to this DC.
coordinates, size of area to copy, source DC, source coordinates,
logical function, whether to use a bitmap mask, and mask source With this method you can specify the destination coordinates and the
position. size of area to copy which will be the same for both the source and
target DCs. If you need to apply scaling while copying, use
StretchBlit().
@param xdest @param xdest
Destination device context x position. Destination device context x position.
@@ -1185,10 +1187,15 @@ public:
wxCoord xsrcMask = wxDefaultCoord, wxCoord ysrcMask = wxDefaultCoord); wxCoord xsrcMask = wxDefaultCoord, wxCoord ysrcMask = wxDefaultCoord);
/** /**
Copy from a source DC to this DC, specifying the destination Copy from a source DC to this DC possibly changing the scale.
coordinates, destination size, source DC, source coordinates, size of
source area to copy, logical function, whether to use a bitmap mask, Unlike Blit(), this method allows to specify different source and
and mask source position. destination region sizes, meaning that it can stretch or shrink it
while copying. The same can be achieved by changing the scale of the
source or target DC but calling this method is simpler and can also be
more efficient if the platform provides a native implementation of it.
The meaning of its other parameters is the same as with Blit().
@param xdest @param xdest
Destination device context x position. Destination device context x position.
@@ -1248,8 +1255,6 @@ public:
There is partial support for Blit() in wxPostScriptDC, under X. There is partial support for Blit() in wxPostScriptDC, under X.
StretchBlit() is only implemented under wxMAC and wxMSW.
See wxMemoryDC for typical usage. See wxMemoryDC for typical usage.
@since 2.9.0 @since 2.9.0