|
|
- /* --COPYRIGHT--,BSD
- * Copyright (c) 2013, Texas Instruments Incorporated
- * All rights reserved.
- *
- * Redistribution and use in source and binary forms, with or without
- * modification, are permitted provided that the following conditions
- * are met:
- *
- * * Redistributions of source code must retain the above copyright
- * notice, this list of conditions and the following disclaimer.
- *
- * * Redistributions in binary form must reproduce the above copyright
- * notice, this list of conditions and the following disclaimer in the
- * documentation and/or other materials provided with the distribution.
- *
- * * Neither the name of Texas Instruments Incorporated nor the names of
- * its contributors may be used to endorse or promote products derived
- * from this software without specific prior written permission.
- *
- * THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS AND CONTRIBUTORS "AS IS"
- * AND ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO,
- * THE IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
- * PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
- * CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
- * EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
- * PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR PROFITS;
- * OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY,
- * WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR
- * OTHERWISE) ARISING IN ANY WAY OUT OF THE USE OF THIS SOFTWARE,
- * EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
- * --/COPYRIGHT--*/
-
-
- #include "grlib.h"
-
-
- //*****************************************************************************
- //
- //! \addtogroup rectangle_api
- //! @{
- //
- //*****************************************************************************
-
- //*****************************************************************************
- //
- // Make sure min and max are defined.
- //
- //*****************************************************************************
- #ifndef min
- #define min(a, b) (((a) < (b)) ? (a) : (b))
- #endif
-
- #ifndef max
- #define max(a, b) (((a) < (b)) ? (b) : (a))
- #endif
-
- //*****************************************************************************
- //
- //! Draws a rectangle.
- //!
- //! \param pContext is a pointer to the drawing context to use.
- //! \param pRect is a pointer to the structure containing the extents of the
- //! rectangle.
- //!
- //! This function draws a rectangle. The rectangle will extend from \e lXMin
- //! to \e lXMax and \e lYMin to \e lYMax, inclusive.
- //!
- //! \return None.
- //
- //*****************************************************************************
- void
- GrRectDraw(const tContext *pContext, const tRectangle *pRect)
- {
- //
- // Check the arguments.
- //
- assert(pContext);
- assert(pRect);
-
- //
- // Draw a line across the top of the rectangle.
- //
- GrLineDrawH(pContext, pRect->sXMin, pRect->sXMax, pRect->sYMin);
-
- //
- // Return if the rectangle is one pixel tall.
- //
- if(pRect->sYMin == pRect->sYMax)
- {
- return;
- }
-
- //
- // Draw a line down the right side of the rectangle.
- //
- GrLineDrawV(pContext, pRect->sXMax, pRect->sYMin + 1, pRect->sYMax);
-
- //
- // Return if the rectangle is one pixel wide.
- //
- if(pRect->sXMin == pRect->sXMax)
- {
- return;
- }
-
- //
- // Draw a line across the bottom of the rectangle.
- //
- GrLineDrawH(pContext, pRect->sXMax - 1, pRect->sXMin, pRect->sYMax);
-
- //
- // Return if the rectangle is two pixels tall.
- //
- if((pRect->sYMin + 1) == pRect->sYMax)
- {
- return;
- }
-
- //
- // Draw a line up the left side of the rectangle.
- //
- GrLineDrawV(pContext, pRect->sXMin, pRect->sYMax - 1, pRect->sYMin + 1);
- }
-
- //*****************************************************************************
- //
- //! Draws a filled rectangle.
- //!
- //! \param pContext is a pointer to the drawing context to use.
- //! \param pRect is a pointer to the structure containing the extents of the
- //! rectangle.
- //!
- //! This function draws a filled rectangle. The rectangle will extend from
- //! \e lXMin to \e lXMax and \e lYMin to \e lYMax, inclusive. The clipping of
- //! the rectangle to the clipping rectangle is performed within this routine;
- //! the display driver's rectangle fill routine is used to perform the actual
- //! rectangle fill.
- //!
- //! \return None.
- //
- //*****************************************************************************
- void
- GrRectFill(const tContext *pContext, const tRectangle *pRect)
- {
- tRectangle sTemp;
-
- //
- // Check the arguments.
- //
- assert(pContext);
- assert(pRect);
-
- //
- // Swap the X coordinates if sXMin is greater than sXMax.
- //
- if(pRect->sXMin > pRect->sXMax)
- {
- sTemp.sXMin = pRect->sXMax;
- sTemp.sXMax = pRect->sXMin;
- }
- else
- {
- sTemp.sXMin = pRect->sXMin;
- sTemp.sXMax = pRect->sXMax;
- }
-
- //
- // Swap the Y coordinates if sYMin is greater than sYMax.
- //
- if(pRect->sYMin > pRect->sYMax)
- {
- sTemp.sYMin = pRect->sYMax;
- sTemp.sYMax = pRect->sYMin;
- }
- else
- {
- sTemp.sYMin = pRect->sYMin;
- sTemp.sYMax = pRect->sYMax;
- }
-
- //
- // Now that the coordinates are ordered, return without drawing anything if
- // the entire rectangle is out of the clipping region.
- //
- if((sTemp.sXMin > pContext->sClipRegion.sXMax) ||
- (sTemp.sXMax < pContext->sClipRegion.sXMin) ||
- (sTemp.sYMin > pContext->sClipRegion.sYMax) ||
- (sTemp.sYMax < pContext->sClipRegion.sYMin))
- {
- return;
- }
-
- //
- // Clip the X coordinates to the edges of the clipping region if necessary.
- //
- if(sTemp.sXMin < pContext->sClipRegion.sXMin)
- {
- sTemp.sXMin = pContext->sClipRegion.sXMin;
- }
- if(sTemp.sXMax > pContext->sClipRegion.sXMax)
- {
- sTemp.sXMax = pContext->sClipRegion.sXMax;
- }
-
- //
- // Clip the Y coordinates to the edges of the clipping region if necessary.
- //
- if(sTemp.sYMin < pContext->sClipRegion.sYMin)
- {
- sTemp.sYMin = pContext->sClipRegion.sYMin;
- }
- if(sTemp.sYMax > pContext->sClipRegion.sYMax)
- {
- sTemp.sYMax = pContext->sClipRegion.sYMax;
- }
-
- //
- // Call the low level rectangle fill routine.
- //
- DpyRectFill(pContext->pDisplay, &sTemp, pContext->ulForeground);
- }
-
- //*****************************************************************************
- //
- //! Determines if two rectangles overlap.
- //!
- //! \param psRect1 is a pointer to the first rectangle.
- //! \param psRect2 is a pointer to the second rectangle.
- //!
- //! This function determines whether two rectangles overlap. It assumes that
- //! rectangles \e psRect1 and \e psRect2 are valid with \e sXMin < \e sXMax and
- //! \e sYMin < \e sYMax.
- //!
- //! \return Returns 1 if there is an overlap or 0 if not.
- //
- //*****************************************************************************
- long
- GrRectOverlapCheck(tRectangle *psRect1, tRectangle *psRect2)
- {
- if((psRect1->sXMax < psRect2->sXMin) ||
- (psRect2->sXMax < psRect1->sXMin) ||
- (psRect1->sYMax < psRect2->sYMin) ||
- (psRect2->sYMax < psRect1->sYMin))
- {
- return(0);
- }
- else
- {
- return(1);
- }
- }
-
- //*****************************************************************************
- //
- //! Determines the intersection of two rectangles.
- //!
- //! \param psRect1 is a pointer to the first rectangle.
- //! \param psRect2 is a pointer to the second rectangle.
- //! \param psIntersect is a pointer to a rectangle which will be written with
- //! the intersection of \e psRect1 and \e psRect2.
- //!
- //! This function determines if two rectangles overlap and, if they do,
- //! calculates the rectangle representing their intersection. If the rectangles
- //! do not overlap, 0 is returned and \e psIntersect is not written.
- //!
- //! \return Returns 1 if there is an overlap or 0 if not.
- //
- //*****************************************************************************
- long
- GrRectIntersectGet(tRectangle *psRect1, tRectangle *psRect2,
- tRectangle *psIntersect)
- {
- //
- // Make sure we were passed valid rectangles.
- //
- if((psRect1->sXMax <= psRect1->sXMin) ||
- (psRect1->sYMax <= psRect1->sYMin) ||
- (psRect2->sXMax <= psRect2->sXMin) ||
- (psRect2->sYMax <= psRect2->sYMin))
- {
- return(0);
- }
-
- //
- // Make sure that there is an intersection between the two rectangles.
- //
- if(!GrRectOverlapCheck(psRect1, psRect2))
- {
- return(0);
- }
-
- //
- // The rectangles do intersect so determine the rectangle of the
- // intersection.
- //
- psIntersect->sXMin = max(psRect1->sXMin, psRect2->sXMin);
- psIntersect->sXMax = min(psRect1->sXMax, psRect2->sXMax);
- psIntersect->sYMin = max(psRect1->sYMin, psRect2->sYMin);
- psIntersect->sYMax = min(psRect1->sYMax, psRect2->sYMax);
-
- return(1);
- }
-
- //*****************************************************************************
- //
- // Close the Doxygen group.
- //! @}
- //
- //*****************************************************************************
|