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

# fzrt_pbuf_new

Description

This will create a new pixel buffer with the specified dimensions, pixel depth, and format. If the FZRT_PBUF_FLAG_PORT flag is specified, the pixel buffer can be set as the current port and will be the target of drawing calls. A Drawable pixel buffer is limited in size on the Macintosh to 4096x4096, and on Windows may perform slower than a non-drawable pixel buffer.

Plugin Prototype

fzrt_error_td fzrt_pbuf_new(

fzrt_pbuf_ptr * | pixbuf_ptr,
const fzrt_pbuf_rect_td * | bounds,
short | pixdepth,
fzrt_pix_format_enum | pix_format,
fzrt_unsigned_int | flags )

Parameters

pixbuf_ptr [Result]

pointer for new pixbuf

bounds [Input]

bounds of pixbuf

pixdepth [Input]

depth of pixels in bits, 1,8,24,32

pix_format [Input]

format of pixel data

flags [Input]

flags - FZRT_PBUF_FLAG_PORT

Returns

error number, FZRT_NOERR if successful

Availability

5.0.0.0

See Also

fzrt_pbuf_dispose, , fzrt_pbuf_set_port, fzrt_pbuf_get_port

Function Set

fz_fzrt_graf_fset

Defined in

fzrt_api.h