dmSetImageDefaults(3dm) dmSetImageDefaults(3dm)
NAME
dmSetImageDefaults, dmImageFrameSize - parameters for digital-media
images
SYNOPSIS
#include <dmedia/dmimage.h>
DMstatus dmSetImageDefaults
( DMparams* params,
int width,
int height,
DMpacking packing )
sizet 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: DMMEDIUM = DMIMAGE,
DMIMAGEWIDTH = width, DMIMAGEHEIGHT = height, DMIMAGERATE = 15.0,
DMIMAGECOMPRESSION = DMIMAGEUNCOMPRESSED, DMIMAGEINTERLACING =
DMIMAGENONINTERLEAVED, DMIMAGEPACKING = packing, DMIMAGEORIENTATION
= DMBOTTOMTOTOP, DMIMAGEPIXELASPECT = 1.0.
dmSetImageDefaults returns DMSUCCESS if there was enough memory
available to set up the parameters, and DMFAILURE 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 ALSO
dmParams(3dm), dmSetAudioDefaults(3dm).
Page 2