dmSetImageDefaults(3dm)dmSetImageDefaults(3dm)NAME
dmSetImageDefaults, dmImageFrameSize - parameters for digital-media
images
SYNOPSIS
#include <dmedia/dm_image.h>
DMstatus dmSetImageDefaults
( DMparams* params,
int width,
int height,
DMpacking packing )
size_t dmImageFrameSize( DMparams* params )
DESCRIPTION
dmSetImageDefaults sets up a parameter list with all of the necessary
parameters to describe an image for the digital-media libraries. The
parameters that are set and their values are: DM_MEDIUM = DM_IMAGE,
DM_IMAGE_WIDTH = width, DM_IMAGE_HEIGHT = height, DM_IMAGE_RATE = 15.0,
DM_IMAGE_COMPRESSION = DM_IMAGE_UNCOMPRESSED, DM_IMAGE_INTERLACING =
DM_IMAGE_NONINTERLEAVED, DM_IMAGE_PACKING = packing, DM_IMAGE_ORIENTATION
= DM_BOTTOM_TO_TOP, DM_IMAGE_PIXEL_ASPECT = 1.0.
dmSetImageDefaults returns DM_SUCCESS if there was enough memory
available to set up the parameters, and DM_FAILURE if not.
dmImageFrameSize takes an image parameter list and returns the number of
bytes needed to store an uncompressed image in that format.
EXAMPLE
DMparams* imageParams;
if ( dmParamsCreate( &imageParams ) != DM_SUCCESS ) {
printf( "Out of memory.\n" );
exit( 1 );
}
if ( dmSetImageDefaults( imageParams,
320, /* width */
240, /* height */
DM_PACKING_RGBX ) != DM_SUCCESS ) {
printf( "Out of memory.\n" );
exit( 1 );
}
printf( "%d bytes per image.\n",
dmImageFrameSize( imageParams ) );
dmParamsDestroy( imageParams );
Page 1
dmSetImageDefaults(3dm)dmSetImageDefaults(3dm)SEE ALSOdmParams(3dm), dmSetAudioDefaults(3dm).
Page 2
