(C) 1998 AROS - The Amiga Research OS


NAME
#include <proto/graphics.h>

void BitMapScale (bitScaleArgs)

LOCATION
In GfxBase at offset 113

SYNOPSIS
struct BitScaleArgs * bitScaleArgs

FUNCTION
Scale a source bit map to a destination bit map other than the source bit map.

INPUTS
Pass a BitScaleArgs structure filled with the following args to this function:
bsa_SrcX, bsa_SrcY
upper left coordinate in source bitmap
bsa_SrcWidth, bsa_SrcHeight
Width and Height or source bitmap
bsa_DestX, bsa_DestY
upper left coordinate in destination bitmap
bsa_DestWidth, bsa_DestHeight
this function will set these values. Use the bsa_???Factor for scaling
bsa_XDestFactor
Set these to get approximately the same ratio as bsa_XSrcWidth:bsa_XDestWidth, but usually not exactly the same number.
bsa_YDestFactor
Set these to get approximately the same ratio as bsa_YSrcWidth:YDestWidth, but usually not exactly the same number.
bsa_SrcBitMap
pointer to source bitmap to be scaled
bsa_DestBitMap
pointer to destination bitmap which will will hold the scaled bitmap. Make sure it's big enough!
bsa_Flags
reserved for future use. Set it to zero!
bsa_XDDA, bsa_YDDA
for future use. bsa_Reserved1, bsa_Reserved2 - for future use.

RESULT
bsa_DestWidth and bsa_DestHeight will be set by this function

EXAMPLE

SEE ALSO
ScalerDiv() graphics/scales.h

NOTES
- Overlapping source and destination bitmaps are not supported - Make sure that you provide enough memory for the destination bitmap to hold the result - In the destination bitmap only the area where the scaled source bitmap is put into is changed. A frame of the old bitmap is left.

BUGS

INTERNALS

HISTORY