From: Vadim Zeitlin <vadim@wxwidgets.org>
Date: Tue, 16 Apr 2013 19:44:08 +0000 (+0000)
Subject: Document that wxPoint(wxRealPoint) ctor truncates, not rounds.
X-Git-Url: https://git.saurik.com/wxWidgets.git/commitdiff_plain/4c20f3d26bf2ae6e3af074f0f9fcdaefbd115028

Document that wxPoint(wxRealPoint) ctor truncates, not rounds.

Also give an example showing how to do rounding instead.

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@73816 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---

diff --git a/interface/wx/gdicmn.h b/interface/wx/gdicmn.h
index aa07a2ced8..ec06e76c6f 100644
--- a/interface/wx/gdicmn.h
+++ b/interface/wx/gdicmn.h
@@ -605,6 +605,16 @@ public:
     /**
         Converts the given wxRealPoint (with floating point coordinates) to a
         wxPoint instance.
+
+        Notice that this truncates the floating point values of @a pt
+        components, if you want to round them instead you need to do it
+        manually, e.g.
+        @code
+            #include <wx/math.h>    // for wxRound()
+
+            wxRealPoint rp = ...;
+            wxPoint p(wxRound(rp.x), wxRound(rp.y));
+        @endcode
     */
     wxPoint(const wxRealPoint& pt);