formZ SDK | 5.0 API Reference | System | Runtime Library (FZRT) | Graphics

# fzrt_copy_bits

Description

This function will copy the pixels from a source port to a destination port. If the srcRect and destination rectangle are different sizes, the image is stretched, or shrunk to fit the destination. The bits are combined based on the transfer mode specified. The current foreground and background colors are used during the transfer. The user can define a mask region to limit what part of the rectangle is copied. The source and destination port can be the same.

Plugin Prototype

void fzrt_copy_bits(

const fzrt_graf_ptr | srcBits,
const fzrt_graf_ptr | dstBits,
const fzrt_rect * | srcRect,
const fzrt_rect * | dstRect,
short | mode,
fzrt_rgn_ptr | maskRgn )

Parameters

srcBits [Input]

pointer to graf port to read source pixel from

dstBits [Input]

pointer to graf port to write source pixel to

srcRect [Input]

pointer to rectangle that defines where in port to read pixels

dstRect [Input]

pointer to rectangle that defines where in destination port to put resulting pixels

mode [Input]

the transfer mode to use when combining pixel from source port to destination port

maskRgn [Input, Optional]

pointer to a region that defines mask to use

Availability

5.0.0.0

See Also

fzrt_source_mode_enum, fzrt_arith_mode_enum

Function Set

fz_fzrt_graf_fset

Defined in

fzrt_api.h