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

# fzrt_copy_bits_colorize

Description

Copies the pixels from the source port to the destination colorizing with the specified colors. 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 foreground and background colors are set to those specified before the transfer is made. The user can define a mask region to limit or clip what part of the rectangle is copied.

Plugin Prototype

void fzrt_copy_bits_colorize(

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

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

fcolor [Input, Optional]

pointer to rgb structure that contains the color to use for foreground color , if no color is specified, black is use for foreground

bcolor [Input, Optional]

pointer to rgb structure that contains the color to use for background color , if no color is specified, white is use for background

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