Blame docs/naturaldocs/html/files/gd_webp-c.html

Packit ed3af9
Packit ed3af9
Packit ed3af9
<html><head><meta http-equiv="Content-Type" content="text/html; charset=UTF-8"><title>WebP IO</title><link rel="stylesheet" type="text/css" href="../styles/main.css"><script language=JavaScript src="../javascript/main.js"></script><script language=JavaScript src="../javascript/prettify.js"></script><script language=JavaScript src="../javascript/searchdata.js"></script></head><body class="ContentPage" onLoad="NDOnLoad();prettyPrint();"><script language=JavaScript>
Packit ed3af9
if (browserType) {document.write("
");if (browserVer) {document.write("
"); }}// --></script>
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9

WebP IO

Read and write WebP images.

Summary
WebP IORead and write WebP images.
Functions
gdImageCreateFromWebpgdImageCreateFromWebp is called to load truecolor images from WebP format files.
gdImageCreateFromWebpPtrSee gdImageCreateFromWebp.
gdImageCreateFromWebpCtxSee gdImageCreateFromWebp.
gdImageWebpCtxWrite the image as WebP data via a gdIOCtx.
gdImageWebpExgdImageWebpEx outputs the specified image to the specified file in WebP format.
gdImageWebpVariant of gdImageWebpEx which uses the default quality (-1).
gdImageWebpPtrSee gdImageWebpEx.
gdImageWebpPtrExSee gdImageWebpEx.
Packit ed3af9
Packit ed3af9

Functions

Packit ed3af9
Packit ed3af9

gdImageCreateFromWebp

gdImagePtr gdImageCreateFromWebp (FILE *inFile)

gdImageCreateFromWebp is called to load truecolor images from WebP format files.  Invoke gdImageCreateFromWebp with an already opened pointer to a file containing the desired image.  gdImageCreateFromWebp returns a gdImagePtr to the new truecolor image, or NULL if unable to load the image (most often because the file is corrupt or does not contain a WebP image).  gdImageCreateFromWebp does not close the file.

You can inspect the sx and sy members of the image to determine its size.  The image must eventually be destroyed using gdImageDestroy.

The returned image is always a truecolor image.

Variants

gdImageCreateFromJpegPtr creates an image from WebP data already in memory.

gdImageCreateFromJpegCtx reads its data via the function pointers in a gdIOCtx structure.

Parameters

infileThe input FILE pointer.

Returns

A pointer to the new truecolor image.  This will need to be destroyed with gdImageDestroy once it is no longer needed.

On error, returns NULL.

Packit ed3af9
Packit ed3af9

gdImageCreateFromWebpPtr

gdImagePtr gdImageCreateFromWebpPtr (int size,
void *data)

See gdImageCreateFromWebp.

Parameters

sizesize of WebP data in bytes.
datapointer to WebP data.
Packit ed3af9
Packit ed3af9

gdImageCreateFromWebpCtx

gdImagePtr gdImageCreateFromWebpCtx (gdIOCtx *infile)

See gdImageCreateFromWebp.

Packit ed3af9
Packit ed3af9

gdImageWebpCtx

void gdImageWebpCtx (gdImagePtr im,
gdIOCtx *outfile,
int quality)

Write the image as WebP data via a gdIOCtx.  See gdImageWebpEx for more details.

Parameters

imThe image to write.
outfileThe output sink.
qualityImage quality.

Returns

Nothing.

Packit ed3af9
Packit ed3af9

gdImageWebpEx

void gdImageWebpEx (gdImagePtr im,
FILE *outFile,
int quality)

gdImageWebpEx outputs the specified image to the specified file in WebP format.  The file must be open for writing.  Under MSDOS and all versions of Windows, it is important to use “wb” as opposed to simply “w” as the mode when opening the file, and under Unix there is no penalty for doing so.  gdImageWebpEx does not close the file; your code must do so.

If <u>quality</u> is -1, a reasonable quality value (which should yield a good general quality / size tradeoff for most situations) is used.  Otherwise <u>quality</u> should be a value in the range 0-100, higher quality values usually implying both higher quality and larger image sizes.

Variants

gdImageWebpCtx stores the image using a gdIOCtx struct.

gdImageWebpPtrEx stores the image to RAM.

Parameters

imThe image to save.
outFileThe FILE pointer to write to.
qualityCompression quality (0-100).

Returns

Nothing.

Packit ed3af9
Packit ed3af9

gdImageWebp

void gdImageWebp (gdImagePtr im,
FILE *outFile)

Variant of gdImageWebpEx which uses the default quality (-1).

Parameters

imThe image to save
outFileThe FILE pointer to write to.

Returns

Nothing.

Packit ed3af9
Packit ed3af9

gdImageWebpPtr

void * gdImageWebpPtr (gdImagePtr im,
int *size)

See gdImageWebpEx.

Packit ed3af9
Packit ed3af9

gdImageWebpPtrEx

void * gdImageWebpPtrEx (gdImagePtr im,
int *size,
int quality)

See gdImageWebpEx.

Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
var searchPanel = new SearchPanel("searchPanel", "HTML", "../search");
Packit ed3af9
--></script>
<input type=text id=MSearchField value=Search onFocus="searchPanel.OnSearchFieldFocus(true)" onBlur="searchPanel.OnSearchFieldFocus(false)" onKeyUp="searchPanel.OnSearchFieldChange()"><select id=MSearchType onFocus="searchPanel.OnSearchTypeFocus(true)" onBlur="searchPanel.OnSearchTypeFocus(false)" onChange="searchPanel.OnSearchTypeChange()"><option id=MSearchEverything selected value="General">Everything</option><option value="Constants">Constants</option><option value="Files">Files</option><option value="Functions">Functions</option><option value="Macros">Macros</option><option value="Types">Types</option></select>
<script language=JavaScript>
Packit ed3af9
HideAllBut([1], 4);// --></script>
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
gdImagePtr gdImageCreateFromWebp (FILE *inFile)
gdImageCreateFromWebp is called to load truecolor images from WebP format files.
gdImagePtr gdImageCreateFromWebpPtr (int size,
void *data)
See gdImageCreateFromWebp.
gdImagePtr gdImageCreateFromWebpCtx (gdIOCtx *infile)
See gdImageCreateFromWebp.
void gdImageWebpCtx (gdImagePtr im,
gdIOCtx *outfile,
int quality)
Write the image as WebP data via a gdIOCtx.
gdIOCtx structures hold function pointers for doing image IO.
void gdImageWebpEx (gdImagePtr im,
FILE *outFile,
int quality)
gdImageWebpEx outputs the specified image to the specified file in WebP format.
void gdImageWebp (gdImagePtr im,
FILE *outFile)
Variant of gdImageWebpEx which uses the default quality (-1).
void * gdImageWebpPtr (gdImagePtr im,
int *size)
See gdImageWebpEx.
void * gdImageWebpPtrEx (gdImagePtr im,
int *size,
int quality)
See gdImageWebpEx.
The data structure in which gd stores images.
void gdImageDestroy (gdImagePtr im)
gdImageDestroy is used to free the memory associated with an image.
gdImagePtr gdImageCreateFromJpegPtr(int size,
void *data)
gdImagePtr gdImageCreateFromJpegCtx(gdIOCtx *infile)
See gdImageCreateFromJpeg.
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
Packit ed3af9
<iframe src="" frameborder=0 name=MSearchResults id=MSearchResults></iframe>Close
Packit ed3af9
Packit ed3af9
Packit ed3af9
<script language=JavaScript>
Packit ed3af9
if (browserType) {if (browserVer) {document.write(""); }document.write("");}// --></script></body></html>