From 7dd76bf89221bc0a4664efd9bcc0f8b1817e00bb Mon Sep 17 00:00:00 2001 From: lacatoire Date: Tue, 8 Sep 2026 09:50:24 +0200 Subject: [PATCH] [Sync-En] imagick: document the image types --- reference/imagick/constants.xml | 77 ++++++++++++- reference/imagick/imagick/getimagetype.xml | 126 ++++++++++----------- reference/imagick/imagick/setimagetype.xml | 41 ++++--- reference/imagick/imagick/settype.xml | 33 +++--- 4 files changed, 180 insertions(+), 97 deletions(-) diff --git a/reference/imagick/constants.xml b/reference/imagick/constants.xml index f7dc9e9c45..6d89b665e3 100644 --- a/reference/imagick/constants.xml +++ b/reference/imagick/constants.xml @@ -1,6 +1,6 @@ - + &reftitle.constants; @@ -1029,7 +1029,26 @@ Constantes <constant>IMGTYPE_<replaceable>*</replaceable></constant> - + + Un tipo de imagen combina un modelo de color con la presencia o ausencia de + un canal alfa. + Pasar una de estas constantes a + Imagick::setImageType convierte la imagen a ese + tipo. + Imagick::getImageType informa del tipo de una + imagen, pero solo devuelve un tipo que describa datos de píxeles reales, + nunca imagick::IMGTYPE_UNDEFINED ni + imagick::IMGTYPE_OPTIMIZE. + + + Las constantes cuyo nombre termina en MATTE son las + variantes que llevan un canal alfa; las demás no lo tienen. + En ImageMagick 6 el canal alfa se conocía como canal matte, y cuando + Imagick se compila contra ImageMagick 7 cada una de estas constantes existe + también bajo un nombre + IMGTYPE_*ALPHA con el mismo + valor. + imagick::IMGTYPE_UNDEFINED @@ -1037,6 +1056,9 @@ + El tipo de imagen no se conoce. + Imagick::setImageType no convierte nada para este + valor, pero lo registra igualmente en la imagen. @@ -1047,6 +1069,10 @@ + Solo dos colores. + La imagen se convierte a escala de grises, se estira su contraste y cada + píxel pasa a ser negro o blanco según sea más claro o más oscuro que el + gris medio; cualquier canal alfa se descarta. @@ -1057,6 +1083,9 @@ + Tonos de gris. + La imagen se convierte al espacio de color de escala de grises y cualquier + canal alfa se descarta. @@ -1067,6 +1096,10 @@ + Tonos de gris con un canal alfa. + Igual que imagick::IMGTYPE_GRAYSCALE, salvo que el + canal alfa se conserva y, si la imagen no tiene ninguno, se le añade uno + opaco. @@ -1077,6 +1110,9 @@ + Color indexado. + La imagen se convierte a sRGB y, si no está ya indexada o tiene más de 256 + colores, se cuantiza a 256 colores; cualquier canal alfa se descarta. @@ -1087,6 +1123,12 @@ + Color indexado con un canal alfa. + La imagen se convierte a sRGB, el canal alfa se conserva y, si la imagen + no tiene ninguno, se le añade uno opaco. + A diferencia de imagick::IMGTYPE_PALETTE, los colores + se cuantizan incluso cuando la imagen ya está indexada, y el canal alfa se + incluye en la cuantización. @@ -1097,6 +1139,8 @@ + Color directo: un valor de rojo, verde y azul por píxel, sin paleta. + La imagen se convierte a sRGB y cualquier canal alfa se descarta. @@ -1107,6 +1151,10 @@ + Color directo con un canal alfa. + Igual que imagick::IMGTYPE_TRUECOLOR, salvo que el + canal alfa se conserva y, si la imagen no tiene ninguno, se le añade uno + opaco. @@ -1117,6 +1165,9 @@ + Un canal por tinta de impresión, sin paleta. + La imagen se convierte al espacio de color CMYK y cualquier canal alfa se + descarta. @@ -1127,6 +1178,26 @@ + Un canal por tinta de impresión, sin paleta, más un canal alfa. + Igual que imagick::IMGTYPE_COLORSEPARATION, salvo que + el canal alfa se conserva y, si la imagen no tiene ninguno, se le añade uno + opaco. + + + + + + imagick::IMGTYPE_PALETTEBILEVELMATTE + (int) + + + + Color indexado con un canal alfa totalmente transparente o totalmente + opaco. + La imagen se convierte a sRGB, se le añade un canal alfa opaco si no tiene + ninguno, ese canal por sí solo se reduce a dos valores y después se + cuantizan los colores. + Este es el tipo de un PNG que usa transparencia binaria. @@ -1137,6 +1208,8 @@ + Imagick::setImageType no convierte nada para este + valor, pero lo registra igualmente en la imagen. diff --git a/reference/imagick/imagick/getimagetype.xml b/reference/imagick/imagick/getimagetype.xml index d3f6b74d38..cc8387ac6e 100644 --- a/reference/imagick/imagick/getimagetype.xml +++ b/reference/imagick/imagick/getimagetype.xml @@ -1,12 +1,12 @@ - + Imagick::getImageType - Obtiene el tipo posible de imagen + Obtiene el tipo de imagen @@ -15,9 +15,12 @@ public intImagick::getImageType - - Devuelve el tipo posible de imagen. - + + Devuelve el tipo de la imagen, deducido de su espacio de color, de su clase + de almacenamiento y de si lleva un canal alfa. Los píxeles en sí no se + examinan, por lo que el valor refleja cómo está representada actualmente la + imagen y no el tipo más pequeño al que podría reducirse. + @@ -27,66 +30,59 @@ &reftitle.returnvalues; - - Obtiene el tipo posible de imagen. - - - - imagick::IMGTYPE_UNDEFINED - - - - - imagick::IMGTYPE_BILEVEL - - - - - imagick::IMGTYPE_GRAYSCALE - - - - - imagick::IMGTYPE_GRAYSCALEMATTE - - - - - imagick::IMGTYPE_PALETTE - - - - - imagick::IMGTYPE_PALETTEMATTE - - - - - imagick::IMGTYPE_TRUECOLOR - - - - - imagick::IMGTYPE_TRUECOLORMATTE - - - - - imagick::IMGTYPE_COLORSEPARATION - - - - - imagick::IMGTYPE_COLORSEPARATIONMATTE - - - - - imagick::IMGTYPE_OPTIMIZE - - - - + + Devuelve una de las siguientes constantes + imagick::IMGTYPE_*. + imagick::IMGTYPE_UNDEFINED e + imagick::IMGTYPE_OPTIMIZE nunca se devuelven. + + + + + imagick::IMGTYPE_BILEVEL + + + + + imagick::IMGTYPE_GRAYSCALE + + + + + imagick::IMGTYPE_GRAYSCALEMATTE + + + + + imagick::IMGTYPE_PALETTE + + + + + imagick::IMGTYPE_PALETTEMATTE + + + + + imagick::IMGTYPE_TRUECOLOR + + + + + imagick::IMGTYPE_TRUECOLORMATTE + + + + + imagick::IMGTYPE_COLORSEPARATION + + + + + imagick::IMGTYPE_COLORSEPARATIONMATTE + + + diff --git a/reference/imagick/imagick/setimagetype.xml b/reference/imagick/imagick/setimagetype.xml index c4b30f631f..a8d9f58328 100644 --- a/reference/imagick/imagick/setimagetype.xml +++ b/reference/imagick/imagick/setimagetype.xml @@ -1,6 +1,6 @@ - + Imagick::setImageType @@ -13,24 +13,35 @@ public boolImagick::setImageType intimage_type - - Establece el tipo de imagen. - + + Convierte la imagen al tipo dado, que combina un modelo de color con la + presencia o ausencia de un canal alfa. + Según el tipo, esto puede cambiar el espacio de color, cuantizar los colores + o cambiar si la imagen tiene un canal alfa. + + + Imagick::setImageType modifica la propia imagen. + Para establecer en su lugar el tipo con el que se escriben las imágenes + siguientes, use Imagick::setType. + &reftitle.parameters; - - - - image_type - - - - - - - + + + image_type + + + Una de las constantes + imagick::IMGTYPE_*. + imagick::IMGTYPE_UNDEFINED e + imagick::IMGTYPE_OPTIMIZE no convierten nada, pero + se registran igualmente en la imagen. + + + + diff --git a/reference/imagick/imagick/settype.xml b/reference/imagick/imagick/settype.xml index 0dd6483233..c419c93b20 100644 --- a/reference/imagick/imagick/settype.xml +++ b/reference/imagick/imagick/settype.xml @@ -1,6 +1,6 @@ - + Imagick::setType @@ -13,24 +13,27 @@ public boolImagick::setType intimage_type - - Establece el atributo tipo de imagen. - + + Establece el tipo de imagen aplicado a las imágenes que se escriban + posteriormente. + Para convertir en su lugar la imagen actual, use + Imagick::setImageType. + &reftitle.parameters; - - - - image_type - - - - - - - + + + image_type + + + Una de las constantes + imagick::IMGTYPE_*. + + + +