IIM_base_8bit_direct (static)

A static i_img object used to initialize direct 8-bit per sample images.

im_img_8_new(ctx, x, y, ch) =category Image creation/destruction =synopsis i_img *img = im_img_8_new(aIMCTX, width, height, channels); =synopsis i_img *img = i_img_8_new(width, height, channels);

Creates a new image object x pixels wide, and y pixels high with ch channels.

i_img_empty(im, x, y)

Re-new image reference (assumes 3 channels)

im - Image pointer
x - xsize of destination image
y - ysize of destination image

**FIXME** what happens if a live image is passed in here?

Should this just call i_img_empty_ch()?

i_img_empty_ch(im, x, y, ch)

Re-new image reference

im - Image pointer
x  - xsize of destination image
y  - ysize of destination image
ch - number of channels

8-bit per sample image internal functions

These are the functions installed in an 8-bit per sample image.

i_ppix_d(im, x, y, col)

Internal function.

This is the function kept in the i_f_ppix member of an i_img object. It does a normal store of a pixel into the image with range checking.

Returns 0 if the pixel could be set, -1 otherwise.

i_gpix_d(im, x, y, &col)

Internal function.

This is the function kept in the i_f_gpix member of an i_img object. It does normal retrieval of a pixel from the image with range checking.

Returns 0 if the pixel could be retrieved, -1 otherwise.

i_glin_d(im, l, r, y, vals)

Reads a line of data from the image, storing the pixels at vals.

The line runs from (l,y) inclusive to (r,y) non-inclusive

vals should point at space for (r-l) pixels.

l should never be less than zero (to avoid confusion about where to put the pixels in vals).

Returns the number of pixels copied (eg. if r, l or y is out of range)

i_plin_d(im, l, r, y, vals)

Writes a line of data into the image, using the pixels at vals.

The line runs from (l,y) inclusive to (r,y) non-inclusive

vals should point at (r-l) pixels.

l should never be less than zero (to avoid confusion about where to get the pixels in vals).

Returns the number of pixels copied (eg. if r, l or y is out of range)

i_ppixf_d(im, x, y, val)

i_gpixf_d(im, x, y, val)

i_glinf_d(im, l, r, y, vals)

Reads a line of data from the image, storing the pixels at vals.

The line runs from (l,y) inclusive to (r,y) non-inclusive

vals should point at space for (r-l) pixels.

l should never be less than zero (to avoid confusion about where to put the pixels in vals).

Returns the number of pixels copied (eg. if r, l or y is out of range)

i_plinf_d(im, l, r, y, vals)

Writes a line of data into the image, using the pixels at vals.

The line runs from (l,y) inclusive to (r,y) non-inclusive

vals should point at (r-l) pixels.

l should never be less than zero (to avoid confusion about where to get the pixels in vals).

Returns the number of pixels copied (eg. if r, l or y is out of range)

i_gsamp_d(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y, i_sample_t *samps, int *chans, int chan_count)

Reads sample values from im for the horizontal line (l, y) to (r-1,y) for the channels specified by chans, an array of int with chan_count elements.

Returns the number of samples read (which should be (r-l) * bits_set(chan_mask)

i_gsampf_d(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y, i_fsample_t *samps, int *chans, int chan_count)

Reads sample values from im for the horizontal line (l, y) to (r-1,y) for the channels specified by chan_mask, where bit 0 is the first channel.

Returns the number of samples read (which should be (r-l) * bits_set(chan_mask)

i_psamp_d(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y, i_sample_t *samps, int *chans, int chan_count)

Writes sample values to im for the horizontal line (l, y) to (r-1,y) for the channels specified by chans, an array of int with chan_count elements.

Returns the number of samples written (which should be (r-l) * bits_set(chan_mask)

i_psampf_d(i_img *im, i_img_dim l, i_img_dim r, i_img_dim y, const i_fsample_t *samps, int *chans, int chan_count)

Writes sample values to im for the horizontal line (l, y) to (r-1,y) for the channels specified by chans, an array of int with chan_count elements.

Returns the number of samples written (which should be (r-l) * bits_set(chan_mask)

AUTHOR

Arnar M. Hrafnkelsson <addi@umich.edu>

Tony Cook <tony@develop-help.com>

SEE ALSO

Imager