rom/intuition/screenposition.c

   1 /*
   2     Copyright © 1995-2007, The AROS Development Team. All rights reserved.
   3     Copyright © 2001-2003, The MorphOS Development Team. All Rights Reserved.
   4     $Id$
   5 */
   6
   7 #include "intuition_intern.h"
   8
   9 /*****************************************************************************
  10
  11     NAME */
  12 #include <proto/intuition.h>
  13
  14     AROS_LH6(void, ScreenPosition,
  15
  16 /*  SYNOPSIS */
  17          AROS_LHA(struct Screen *, screen, A0),
  18          AROS_LHA(ULONG          , flags, D0),
  19          AROS_LHA(LONG           , x1, D1),
  20          AROS_LHA(LONG           , y1, D2),
  21          AROS_LHA(LONG           , x2, D3),
  22          AROS_LHA(LONG           , y2, D4),
  23
  24 /*  LOCATION */
  25          struct IntuitionBase *, IntuitionBase, 132, Intuition)
  26
  27 /*  FUNCTION
  28     Move a screen to the specified position or by the specified
  29     increment. Resolution is always the screen resolution.
  30     If this move would be out of bounds, the move is clipped at
  31     these boundaries. The real new position can be obtained from
  32     LeftEdge and TopEdge of the screen's structure.
  33
  34     INPUTS
  35     screen - Move this screen
  36     flags - One of SPOS_RELATIVE, SPOS_ABSOLUTE or SPOS_MAKEVISIBLE
  37         Use SPOS_FORCEDRAG to override non-movable screens ie. screens
  38         opened with {SA_Draggable,FLASE} attribute.
  39
  40         SPOS_RELATIVE (or NULL) moves the screen by a delta of x1,y1.
  41
  42         SPOS_ABSOLUTE moves the screen to the specified position x1,y1.
  43
  44         SPOS_MAKEVISIBLE moves an oversized scrolling screen to make
  45         the rectangle (x1,y1),(x2,y2) visible
  46     x1,y1 - Absolute (SPOS_ABSOLUTE) or relative (SPOS_RELATIVE) coordinate
  47         to move screen, or upper-left corner of rectangle
  48         (SPOS_MAKEVISIBLE)
  49     x2,y2 - Ignored with SPOS_ABSOLUTE and SPOS_RELATIVE.
  50         Lower-right corner of rectangle with SPOS_MAKEVISIBLE.
  51
  52     RESULT
  53     None.
  54
  55     NOTES
  56     SPOS_FORCEDRAG should only be used by the owner of the screen.
  57
  58     EXAMPLE
  59
  60     BUGS
  61
  62     SEE ALSO
  63     MoveScreen(), RethinkDisplay()
  64
  65     INTERNALS
  66
  67     HISTORY
  68
  69 *****************************************************************************/
  70 {
  71     AROS_LIBFUNC_INIT
  72
  73 #warning TODO: Write intuition/ScreenPosition()
  74     //    aros_print_not_implemented ("ScreenPosition");
  75
  76     /* shut up the compiler */
  77     IntuitionBase = IntuitionBase;
  78     screen = screen;
  79     flags = flags;
  80     x1 = x1;
  81     x2 = x2;
  82     y1 = y1;
  83     y2 = y2;
  84
  85     AROS_LIBFUNC_EXIT
  86 } /* ScreenPosition */