From 6d8719360f32f5e49da46c2a742ec8a8214bf388 Mon Sep 17 00:00:00 2001 From: Mehdi Achour Date: Tue, 23 Jan 2007 02:57:08 +0000 Subject: [PATCH] Document imageconvolution() imagecolorallocate* return FALSE on error since 5.1.3 git-svn-id: https://svn.php.net/repository/phpdoc/en/trunk@227941 c90b9560-bf6c-de11-be94-00142212c4b1 --- .../image/figures/imageconvolution_emboss.png | Bin 0 -> 3004 bytes .../figures/imageconvolution_gaussian.png | Bin 0 -> 1266 bytes .../image/functions/imagecolorallocate.xml | 27 ++++++- .../functions/imagecolorallocatealpha.xml | 25 +++++- .../image/functions/imageconvolution.xml | 73 ++++++++++++++++-- reference/image/functions/imagefilter.xml | 10 ++- 6 files changed, 126 insertions(+), 9 deletions(-) create mode 100644 reference/image/figures/imageconvolution_emboss.png create mode 100644 reference/image/figures/imageconvolution_gaussian.png diff --git a/reference/image/figures/imageconvolution_emboss.png b/reference/image/figures/imageconvolution_emboss.png new file mode 100644 index 0000000000000000000000000000000000000000..a4c063b4846b52d28675c8f82d88a062a33c5f61 GIT binary patch literal 3004 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 literal 0 HcmV?d00001 diff --git a/reference/image/functions/imagecolorallocate.xml b/reference/image/functions/imagecolorallocate.xml index 4c2cf7cdeb..8c538d5154 100644 --- a/reference/image/functions/imagecolorallocate.xml +++ b/reference/image/functions/imagecolorallocate.xml @@ -1,5 +1,5 @@ - + imagecolorallocate @@ -68,7 +68,30 @@ &reftitle.returnvalues; - A color identifier or -1 if the allocation failed. + A color identifier or &false; if the allocation failed. + + + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + Prior to 5.1.3 + + Returns -1 if the allocation failed. + + + + + diff --git a/reference/image/functions/imagecolorallocatealpha.xml b/reference/image/functions/imagecolorallocatealpha.xml index b472798293..371b39065c 100644 --- a/reference/image/functions/imagecolorallocatealpha.xml +++ b/reference/image/functions/imagecolorallocatealpha.xml @@ -1,5 +1,5 @@ - + imagecolorallocatealpha @@ -71,6 +71,29 @@ A color identifier or &false; if the allocation failed. + + &reftitle.changelog; + + + + + + &Version; + &Description; + + + + + Prior to 5.1.3 + + Returns -1 if the allocation failed. + + + + + + + &reftitle.examples; diff --git a/reference/image/functions/imageconvolution.xml b/reference/image/functions/imageconvolution.xml index b468e637c6..5e09b25f74 100644 --- a/reference/image/functions/imageconvolution.xml +++ b/reference/image/functions/imageconvolution.xml @@ -1,20 +1,23 @@ - + imageconvolution - Apply a 3x3 convolution matrix, using coefficient div and offset + Apply a 3x3 convolution matrix, using coefficient and offset &reftitle.description; boolimageconvolution resourceimage - arraymatrix3x3 + arraymatrix floatdiv floatoffset - &warn.undocumented.func; + + Applies a convolution matrix on the image, using the given coefficient and + offset. + &reftitle.parameters; @@ -22,9 +25,10 @@ &gd.image.description; - matrix3x3 + matrix + A 3x3 matrix: an array of three arrays of three floats. @@ -32,6 +36,7 @@ div + The divisor of the result of the convolution, used for normalization. @@ -51,10 +56,68 @@ &return.success; + + &reftitle.examples; + + + Embossing the PHP.net logo + + +]]> + + &example.outputs; + + + + + + Gaussian blur + + +]]> + + &example.outputs; + + + + + + &reftitle.notes; ¬e.bundled.gd; + + &reftitle.seealso; + + + imagefilter + + + + imagefilter @@ -200,6 +200,14 @@ imagedestroy($im); &reftitle.notes; ¬e.bundled.gd; + + &reftitle.seealso; + + + imageconvolution + + +