r4493@vps: verhaegs | 2007-04-19 14:44:00 -0400
[AROS.git] / rom / graphics / coercemode.c
blob3b01c0c47a314d63fbace60c959a971e59b02f4c
1 /*
2 Copyright © 1995-2001, The AROS Development Team. All rights reserved.
3 $Id$
5 Desc: Graphics function CoerceMode()
6 Lang: english
7 */
8 #include <aros/debug.h>
9 #include <graphics/view.h>
11 /*****************************************************************************
13 NAME */
14 #include <proto/graphics.h>
16 AROS_LH3(ULONG, CoerceMode,
18 /* SYNOPSIS */
19 AROS_LHA(struct ViewPort *, RealViewPort, A0),
20 AROS_LHA(ULONG, MonitorID, D0),
21 AROS_LHA(ULONG, Flags, D1),
23 /* LOCATION */
24 struct GfxBase *, GfxBase, 156, Graphics)
26 /* FUNCTION
27 Determine the best mode in the MonitorID to coerce RealViewPort to.
29 INPUTS
30 RealViewPort - ViewPort to coerce
31 MonitorID - Monitor number to coerce to
32 (i.e. a mode masked with MONITOR_ID_MASK)
33 Flags - PRESERVE_COLORS - keep the number of bitplanes
34 in the ViewPort
35 AVOID_FLICKER - do not coerce to an interlace mode
37 RESULT
38 ID - ID of best mode to coerce to, or INVALID_ID if could not coerce
40 NOTES
42 EXAMPLE
44 BUGS
46 SEE ALSO
48 INTERNALS
50 HISTORY
53 ******************************************************************************/
55 AROS_LIBFUNC_INIT
56 AROS_LIBBASE_EXT_DECL(struct GfxBase *,GfxBase)
58 #warning TODO: Write graphics/CoerceMode()
59 aros_print_not_implemented ("CoerceMode");
61 return INVALID_ID;
63 AROS_LIBFUNC_EXIT
64 } /* CoerceMode */