nxtk_getwindow.c 4.9 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126
  1. /****************************************************************************
  2. * graphics/nxtk/nxtk_getwindow.c
  3. *
  4. * Copyright (C) 2011 Gregory Nutt. All rights reserved.
  5. * Author: Gregory Nutt <gnutt@nuttx.org>
  6. *
  7. * Redistribution and use in source and binary forms, with or without
  8. * modification, are permitted provided that the following conditions
  9. * are met:
  10. *
  11. * 1. Redistributions of source code must retain the above copyright
  12. * notice, this list of conditions and the following disclaimer.
  13. * 2. Redistributions in binary form must reproduce the above copyright
  14. * notice, this list of conditions and the following disclaimer in
  15. * the documentation and/or other materials provided with the
  16. * distribution.
  17. * 3. Neither the name NuttX nor the names of its contributors may be
  18. * used to endorse or promote products derived from this software
  19. * without specific prior written permission.
  20. *
  21. * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS
  22. * "AS IS" AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT
  23. * LIMITED TO, THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS
  24. * FOR A PARTICULAR PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE
  25. * COPYRIGHT OWNER OR CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT,
  26. * INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING,
  27. * BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS
  28. * OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED
  29. * AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  30. * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN
  31. * ANY WAY OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE
  32. * POSSIBILITY OF SUCH DAMAGE.
  33. *
  34. ****************************************************************************/
  35. /****************************************************************************
  36. * Included Files
  37. ****************************************************************************/
  38. #include <nuttx/config.h>
  39. #include <stdlib.h>
  40. #include <errno.h>
  41. #include <debug.h>
  42. #include <nuttx/nx/nx.h>
  43. #include <nuttx/nx/nxtk.h>
  44. #include "nxfe.h"
  45. #include "nxtk_internal.h"
  46. /****************************************************************************
  47. * Pre-Processor Definitions
  48. ****************************************************************************/
  49. /****************************************************************************
  50. * Private Types
  51. ****************************************************************************/
  52. /****************************************************************************
  53. * Private Data
  54. ****************************************************************************/
  55. /****************************************************************************
  56. * Public Data
  57. ****************************************************************************/
  58. /****************************************************************************
  59. * Private Functions
  60. ****************************************************************************/
  61. /****************************************************************************
  62. * Public Functions
  63. ****************************************************************************/
  64. /****************************************************************************
  65. * Name: nxtk_getwindow
  66. *
  67. * Description:
  68. * Get the raw contents of graphic memory within a rectangular region. NOTE:
  69. * Since raw graphic memory is returned, the returned memory content may be
  70. * the memory of windows above this one and may not necessarily belong to
  71. * this window unless you assure that this is the top window.
  72. *
  73. * Input Parameters:
  74. * wnd - The window structure reference
  75. * rect - The location to be copied
  76. * plane - Specifies the color plane to get from.
  77. * dest - The location to copy the memory region
  78. * deststride - The width, in bytes, the the dest memory
  79. *
  80. * Return:
  81. * OK on success; ERROR on failure with errno set appropriately
  82. *
  83. ****************************************************************************/
  84. int nxtk_getwindow(NXTKWINDOW hfwnd, FAR const struct nxgl_rect_s *rect,
  85. unsigned int plane, FAR uint8_t *dest,
  86. unsigned int deststride)
  87. {
  88. FAR struct nxtk_framedwindow_s *fwnd = (FAR struct nxtk_framedwindow_s *)hfwnd;
  89. struct nxgl_rect_s getrect;
  90. #ifdef CONFIG_DEBUG
  91. if (!hfwnd || !rect || !dest)
  92. {
  93. gvdbg("Invalid parameters\n");
  94. set_errno(EINVAL);
  95. return ERROR;
  96. }
  97. #endif
  98. /* Move the rectangle to that it is relative to the containing
  99. * window. If part of the rectangle lies outside the window,
  100. * it will contain garbage data, but the contained area will be
  101. * valid.
  102. */
  103. nxgl_rectoffset(&getrect, rect,
  104. fwnd->fwrect.pt1.x - fwnd->wnd.bounds.pt1.x,
  105. fwnd->fwrect.pt1.y - fwnd->wnd.bounds.pt1.y);
  106. /* Then get it */
  107. return nx_getrectangle((NXWINDOW)hfwnd, &getrect, plane, dest, deststride);
  108. }