You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.

198 lines
5.8 KiB

  1. /* /////////////////////////////////////////////////////////////////////////
  2. * File: winstl/window/scale_functions.h
  3. *
  4. * Purpose: Contains scale functions.
  5. *
  6. * Created: 7th February 2002
  7. * Updated: 10th August 2009
  8. *
  9. * Home: http://stlsoft.org/
  10. *
  11. * Copyright (c) 2002-2009, Matthew Wilson and Synesis Software
  12. * All rights reserved.
  13. *
  14. * Redistribution and use in source and binary forms, with or without
  15. * modification, are permitted provided that the following conditions are met:
  16. *
  17. * - Redistributions of source code must retain the above copyright notice, this
  18. * list of conditions and the following disclaimer.
  19. * - Redistributions in binary form must reproduce the above copyright notice,
  20. * this list of conditions and the following disclaimer in the documentation
  21. * and/or other materials provided with the distribution.
  22. * - Neither the name(s) of Matthew Wilson and Synesis Software nor the names of
  23. * any contributors may be used to endorse or promote products derived from
  24. * this software without specific prior written permission.
  25. *
  26. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
  27. * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  28. * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  29. * ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR CONTRIBUTORS BE
  30. * LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR
  31. * CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF
  32. * SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS
  33. * INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN
  34. * CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE)
  35. * ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  36. * POSSIBILITY OF SUCH DAMAGE.
  37. *
  38. * ////////////////////////////////////////////////////////////////////// */
  39. /** \file winstl/window/scale_functions.h
  40. *
  41. * \brief [C, C++] Scale functions
  42. * (\ref group__library__windows_window "Windows Window" Library).
  43. */
  44. #ifndef WINSTL_INCL_WINSTL_WINDOW_H_SCALE_FUNCTIONS
  45. #define WINSTL_INCL_WINSTL_WINDOW_H_SCALE_FUNCTIONS
  46. #ifndef STLSOFT_DOCUMENTATION_SKIP_SECTION
  47. # define WINSTL_VER_WINSTL_WINDOW_H_SCALE_FUNCTIONS_MAJOR 4
  48. # define WINSTL_VER_WINSTL_WINDOW_H_SCALE_FUNCTIONS_MINOR 0
  49. # define WINSTL_VER_WINSTL_WINDOW_H_SCALE_FUNCTIONS_REVISION 1
  50. # define WINSTL_VER_WINSTL_WINDOW_H_SCALE_FUNCTIONS_EDIT 44
  51. #endif /* !STLSOFT_DOCUMENTATION_SKIP_SECTION */
  52. /* /////////////////////////////////////////////////////////////////////////
  53. * Includes
  54. */
  55. #ifndef WINSTL_INCL_WINSTL_H_WINSTL
  56. # include <winstl/winstl.h>
  57. #endif /* !WINSTL_INCL_WINSTL_H_WINSTL */
  58. /* /////////////////////////////////////////////////////////////////////////
  59. * Namespace
  60. */
  61. #ifndef _WINSTL_NO_NAMESPACE
  62. # if defined(_STLSOFT_NO_NAMESPACE) || \
  63. defined(STLSOFT_DOCUMENTATION_SKIP_SECTION)
  64. /* There is no stlsoft namespace, so must define ::winstl */
  65. namespace winstl
  66. {
  67. # else
  68. /* Define stlsoft::winstl_project */
  69. namespace stlsoft
  70. {
  71. namespace winstl_project
  72. {
  73. # endif /* _STLSOFT_NO_NAMESPACE */
  74. #endif /* !_WINSTL_NO_NAMESPACE */
  75. /* /////////////////////////////////////////////////////////////////////////
  76. * C functions
  77. */
  78. STLSOFT_INLINE ws_sint_t winstl__calc_SIZE_width(SIZE const* size)
  79. {
  80. WINSTL_ASSERT(NULL != size);
  81. return size->cx;
  82. }
  83. STLSOFT_INLINE ws_sint_t winstl__calc_SIZE_height(SIZE const* size)
  84. {
  85. WINSTL_ASSERT(NULL != size);
  86. return size->cy;
  87. }
  88. STLSOFT_INLINE ws_sint_t winstl__calc_RECT_width(RECT const* rect)
  89. {
  90. WINSTL_ASSERT(NULL != rect);
  91. return rect->right - rect->left;
  92. }
  93. STLSOFT_INLINE ws_sint_t winstl__calc_RECT_height(RECT const* rect)
  94. {
  95. WINSTL_ASSERT(NULL != rect);
  96. return rect->bottom - rect->top;
  97. }
  98. /* /////////////////////////////////////////////////////////////////////////
  99. * C++ functions
  100. */
  101. #ifdef __cplusplus
  102. /* /////////////////////////////////////////////////////////////////////////
  103. * calc_width()
  104. *
  105. * This attribute shim calculates the width of an entity.
  106. */
  107. /** \brief Calculates the width of a \c SIZE instance
  108. *
  109. * \ingroup group__library__windows_window
  110. */
  111. inline ws_sint_t calc_width(SIZE const& size)
  112. {
  113. return winstl__calc_SIZE_width(&size);
  114. }
  115. /** \brief Calculates the width of a \c RECT instance
  116. *
  117. * \ingroup group__library__windows_window
  118. */
  119. inline ws_sint_t calc_width(RECT const& rc)
  120. {
  121. return winstl__calc_RECT_width(&rc);
  122. }
  123. /* /////////////////////////////////////////////////////////////////////////
  124. * calc_height()
  125. *
  126. * This attribute shim calculates the height of an entity.
  127. */
  128. /** \brief Calculates the height of a \c SIZE instance
  129. *
  130. * \ingroup group__library__windows_window
  131. */
  132. inline ws_sint_t calc_height(SIZE const& size)
  133. {
  134. return winstl__calc_SIZE_height(&size);
  135. }
  136. /** \brief Calculates the height of a \c RECT instance
  137. *
  138. * \ingroup group__library__windows_window
  139. */
  140. inline ws_sint_t calc_height(RECT const& rc)
  141. {
  142. return winstl__calc_RECT_height(&rc);
  143. }
  144. #endif /* __cplusplus */
  145. ////////////////////////////////////////////////////////////////////////////
  146. // Unit-testing
  147. #ifdef STLSOFT_UNITTEST
  148. # include "./unittest/scale_functions_unittest_.h"
  149. #endif /* STLSOFT_UNITTEST */
  150. /* ////////////////////////////////////////////////////////////////////// */
  151. #ifndef _WINSTL_NO_NAMESPACE
  152. # if defined(_STLSOFT_NO_NAMESPACE) || \
  153. defined(STLSOFT_DOCUMENTATION_SKIP_SECTION)
  154. } /* namespace winstl */
  155. # else
  156. } /* namespace winstl_project */
  157. } /* namespace stlsoft */
  158. # endif /* _STLSOFT_NO_NAMESPACE */
  159. #endif /* !_WINSTL_NO_NAMESPACE */
  160. /* ////////////////////////////////////////////////////////////////////// */
  161. #endif /* WINSTL_INCL_WINSTL_WINDOW_H_SCALE_FUNCTIONS */
  162. /* ///////////////////////////// end of file //////////////////////////// */