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

# fzrt_pbuf_put_pixels

Description

Moves memory based pixel data into a pixel buffer. This will load a memory buffer filled with pixel data into an allocated pixel buffer, converting the pixel data if necessary.

Plugin Prototype

fzrt_error_td fzrt_pbuf_put_pixels(

fzrt_ptr | src_ptr,
fzrt_int | src_rowbytes,
short | src_pixdepth,
short | src_pixbytes,
fzrt_pix_format_enum | src_pix_format,
const fzrt_pbuf_rect_td * | src_bounds,
fzrt_color_table_ptr | src_ctab,
fzrt_pbuf_ptr | dst_pixbuf,
const fzrt_pbuf_point_td * | dst_off,
fzrt_pbuf_apply_alpha_enum | apply_alpha,
fzrt_boolean | flip_buff,
unsigned char * | gamma_lut )

Parameters

src_ptr [Input]

pointer to pixel data

src_rowbytes [Input]

number of bytes per scanline

src_pixdepth [Input]

number of bits per pixel (1,8,16,24,32)

src_pixbytes [Input]

number of bytes per pixel

src_pix_format [Input]

format of pixel data (RGB, BGR, RGBA, PIX555, indexed...)

src_bounds [Input]

bounding rectangle to read pixel data from

src_ctab [Input]

source Color Table pointer

dst_pixbuf [Input]

Destination GWorld fzrt_ptr

dst_off [Input]

offset to (top,left) dst. pixel (size is same src rect)

apply_alpha [Input]

apply alpha channel to destination

flip_buff [Input]

flip pixel data along x & y axis when pushing to destination

gamma_lut [Input, Optional]

gamma look up table to apply to src during copy- NULL if none

Returns

FZRT_NOERR if successful, error number otherwise

Availability

5.0.0.0

See Also

fzrt_pbuf_get_pixels

Function Set

fz_fzrt_graf_fset

Defined in

fzrt_api.h