From 8efb290702e37f49e61a5917e9d59f41bceb1927 Mon Sep 17 00:00:00 2001
From: =?utf8?q?W=C5=82odzimierz=20Skiba?= <abx@abx.art.pl>
Date: Mon, 24 Jul 2006 08:26:38 +0000
Subject: [PATCH] [ 1518434 ] wxSize::Scale with wxScale and wxPoint operators
 documented

git-svn-id: https://svn.wxwidgets.org/svn/wx/wxWidgets/trunk@40257 c3d73ce0-8a6f-49c7-b76d-6d57e0e08775
---
 docs/latex/wx/point.tex | 39 +++++++++++++++++++++++++++-----
 docs/latex/wx/size.tex  | 50 ++++++++++++++++++++++++++++++++++++++---
 include/wx/gdicmn.h     |  3 +++
 3 files changed, 84 insertions(+), 8 deletions(-)

diff --git a/docs/latex/wx/point.tex b/docs/latex/wx/point.tex
index 1d6f9042a5..6ac766216e 100644
--- a/docs/latex/wx/point.tex
+++ b/docs/latex/wx/point.tex
@@ -1,3 +1,13 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Name:        point.tex
+%% Purpose:     wxPoint documentation
+%% Author:      wxTeam
+%% Created:
+%% RCS-ID:      $Id$
+%% Copyright:   (c) wxTeam
+%% License:     wxWindows license
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
 \section{\class{wxPoint}}\label{wxpoint}
 
 A {\bf wxPoint} is a useful data structure for graphics operations.
@@ -39,16 +49,35 @@ x member.
 
 y member.
 
-\membersection{wxPoint::operator $==$}\label{wxpointequal}
+\membersection{Operators}\label{wxpointoperators}
 
-\func{bool}{operator $==$}{\param{const wxPoint\& }{pt}}
+\func{void}{operator $=$}{\param{const wxPoint\& }{pt}}
 
-Equality operator: returns \true if two points are the same.
+Assignment operator.
 
 
-\membersection{wxPoint::operator $!=$}\label{wxpointnotequal}
+\func{bool}{operator $==$}{\param{const wxPoint\& }{pt}}
 
 \func{bool}{operator $!=$}{\param{const wxPoint\& }{pt}}
 
-Inequality operator: returns \true if two points are different.
+\func{wxPoint}{operator $+$}{\param{const wxPoint\& }{pt}}
+
+\func{wxPoint}{operator $-$}{\param{const wxPoint\& }{pt}}
+
+\func{wxPoint\&}{operator $+=$}{\param{const wxPoint\& }{pt}}
+
+\func{wxPoint\&}{operator $-=$}{\param{const wxPoint\& }{pt}}
+
+Operators for comparison, sum and subtraction between \helpref{wxPoint}{wxpoint} objects.
+
+
+\func{wxPoint}{operator $+$}{\param{const wxSize\& }{sz}}
+
+\func{wxPoint}{operator $-$}{\param{const wxSize\& }{sz}}
+
+\func{wxPoint\&}{operator $+=$}{\param{const wxSize\& }{sz}}
 
+\func{wxPoint\&}{operator $-=$}{\param{const wxSize\& }{sz}}
+ 
+Operators for sum and subtraction between a \helpref{wxPoint}{wxpoint} object and a
+\helpref{wxSize}{wxsize} object.
diff --git a/docs/latex/wx/size.tex b/docs/latex/wx/size.tex
index b1376b4f21..cbffe75fd1 100644
--- a/docs/latex/wx/size.tex
+++ b/docs/latex/wx/size.tex
@@ -1,3 +1,13 @@
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+%% Name:        size.tex
+%% Purpose:     wxSize documentation
+%% Author:      wxTeam
+%% Created:
+%% RCS-ID:      $Id$
+%% Copyright:   (c) wxTeam
+%% License:     wxWindows license
+%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%%
+
 \section{\class{wxSize}}\label{wxsize}
 
 A {\bf wxSize} is a useful data structure for graphics operations.
@@ -54,10 +64,10 @@ corresponding dimensions of the \arg{size}.
 \constfunc{bool}{IsFullySpecified}{\void}
 
 Returns \true if neither of the size object components is equal to $-1$, which
-is used as default for the size values in wxWidgets (hence the predefined 
+is used as default for the size values in wxWidgets (hence the predefined
 \texttt{wxDefaultSize} has both of its components equal to $-1$).
 
-This method is typically used before calling 
+This method is typically used before calling
 \helpref{SetDefaults}{wxsizesetdefaults}.
 
 
@@ -89,6 +99,16 @@ corresponding dimensions of the \arg{size}.
 
 
 
+\membersection{wxSize::Scale}\label{wxsizescale}
+
+\func{void}{Scale}{\param{float}{ xscale}, \param{float}{ yscale}}
+
+Scales the dimensions of this object by the given factors.
+If you want to scale both dimensions by the same factor you can also use
+the \helpref{operator *=}{wxsizeoperators}
+
+
+
 \membersection{wxSize::Set}\label{wxsizeset}
 
 \func{void}{Set}{\param{int}{ width}, \param{int}{ height}}
@@ -129,10 +149,34 @@ Sets the height.
 Sets the width.
 
 
-\membersection{wxSize::operator $=$}\label{wxsizeassign}
+\membersection{Operators}\label{wxsizeoperators}
 
 \func{void}{operator $=$}{\param{const wxSize\& }{sz}}
 
 Assignment operator.
 
 
+\func{bool}{operator $==$}{\param{const wxSize\& }{sz}}
+
+\func{bool}{operator $!=$}{\param{const wxSize\& }{sz}}
+
+\func{wxSize}{operator $+$}{\param{const wxSize\& }{sz}}
+
+\func{wxSize}{operator $-$}{\param{const wxSize\& }{sz}}
+
+\func{wxSize\&}{operator $+=$}{\param{const wxSize\& }{sz}}
+
+\func{wxSize\&}{operator $-=$}{\param{const wxSize\& }{sz}}
+
+Operators for comparison, sum and subtraction between \helpref{wxSize}{wxsize} objects.
+
+
+\func{wxSize}{operator $/$}{\param{int }{factor}}
+
+\func{wxSize}{operator $*$}{\param{int }{factor}}
+
+\func{wxSize\&}{operator $/=$}{\param{int }{factor}}
+
+\func{wxSize\&}{operator $*=$}{\param{int }{factor}}
+
+Operators for division and multiplication between a \helpref{wxSize}{wxsize} object and an integer.
diff --git a/include/wx/gdicmn.h b/include/wx/gdicmn.h
index 16888e6ae5..bc7cd6d114 100644
--- a/include/wx/gdicmn.h
+++ b/include/wx/gdicmn.h
@@ -229,6 +229,9 @@ public:
     void DecTo(const wxSize& sz)
         { if ( sz.x < x ) x = sz.x; if ( sz.y < y ) y = sz.y; }
 
+    void Scale(float xscale, float yscale)
+        { x = (int)(x*xscale); y = (int)(y*yscale); }
+
     // accessors
     void Set(int xx, int yy) { x = xx; y = yy; }
     void SetWidth(int w) { x = w; }
-- 
2.45.2