Skip to content

[Sync-En] imagick: amend Imagick::sigmoidalContrastImage() parameter names #1137

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Merged
julionc merged 1 commit into from
Aug 28, 2026
Merged

[Sync-En] imagick: amend Imagick::sigmoidalContrastImage() parameter names #1137

Changes from all commits
Commits
Show all changes
1 commit
Select commit
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
80 changes: 41 additions & 39 deletions reference/imagick/imagick/sigmoidalcontrastimage.xml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -1,5 +1,5 @@
<?xml version="1.0" encoding="utf-8"?>
<!-- EN-Revision: 6047c10c1f9c7f5f2cc76603807b14b3ac3637b0 Maintainer: PhilDaiguille Status: ready -->
<!-- EN-Revision: d9fec5dc8a61c5bbee1d7f70a7bea50c2388e0fd Maintainer: PhilDaiguille Status: ready -->

<refentry xmlns="http://docbook.org/ns/docbook" xml:id="imagick.sigmoidalcontrastimage" xmlns:xlink="http://www.w3.org/1999/xlink">
<refnamediv>
Expand All @@ -16,21 +16,24 @@
<methodparam><type>float</type><parameter>beta</parameter></methodparam>
<methodparam choice="opt"><type>int</type><parameter>channel</parameter><initializer>Imagick::CHANNEL_DEFAULT</initializer></methodparam>
</methodsynopsis>
<para>
<simpara>
Ajusta el contraste de la imagen con un algoritmo de contraste sigmoide
no lineal. Aumenta el contraste de la imagen utilizando una función
de transferencia sigmoide sin saturar las luces altas y las sombras.
El contraste indica cuánto debe aumentarse (0 para no hacer nada, 3 es
un valor típico, 20 es un valor alto); el punto medio indica dónde
estarán los tonos medios en la imagen resultante (0 corresponde a blanco,
50 a gris y 100 a negro). Establezca el parámetro <parameter>sharpen</parameter>
en &true; para aumentar el contraste de la imagen; de lo contrario,
el contraste se reducirá.
</para>
<para>
Consulte también los <link xlink:href="&url.imagemagick.usage.color_mods.sigmoidal;">ejemplos
de ImageMagick V6 - Transformaciones de imágenes - Contraste no lineal</link>
</para>
<parameter>alpha</parameter> indica cuánto debe aumentarse el contraste:
<literal>0.00</literal> para no hacer nada; <literal>3.00</literal> es
un valor típico; <literal>20.00</literal> es un valor extremo.
<parameter>beta</parameter> indica dónde estarán los tonos medios en la
imagen resultante, como una fracción del rango del quantum:
<literal>0.0</literal> corresponde a blanco, <literal>0.5</literal> a
gris medio y <literal>1.0</literal> a negro (se debe multiplicar por
<code>getQuantumRange()['quantumRangeLong']</code> para obtener el valor
a pasar).
</simpara>
<simpara>
Consúltense también los <link xlink:href="&url.imagemagick.usage.color_mods.sigmoidal;">ejemplos
de ImageMagick -- Modificaciones de color — Contraste no lineal sigmoide</link>.
</simpara>
</refsect1>

<refsect1 role="parameters">
Expand All @@ -40,35 +43,37 @@
<varlistentry>
<term><parameter>sharpen</parameter></term>
<listitem>
<para>
Si es &true;, el contraste aumentará; de lo contrario, el contraste disminuirá.
</para>
<simpara>
Si es &true;, el contraste aumentará; si es &false;, el contraste disminuirá.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>alpha</parameter></term>
<listitem>
<para>
La cantidad de contraste a aplicar. -1 representa una cantidad muy pequeña,
5 una cantidad significativa y 20 el máximo.
</para>
<simpara>
La cantidad de contraste a aplicar. <literal>1.00</literal> representa una cantidad
muy pequeña, <literal>5.00</literal> una cantidad significativa y
<literal>20.00</literal> un valor extremo.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>beta</parameter></term>
<listitem>
<simpara>
Dónde debe situarse el punto medio del gradiente. Este valor debe estar
en el intervalo 0-1, multiplicado por el valor del quantum para ImageMagick.
en el intervalo de <literal>0.00</literal> a <literal>1.00</literal>,
multiplicado por el valor del quantum para ImageMagick.
</simpara>
</listitem>
</varlistentry>
<varlistentry>
<term><parameter>channel</parameter></term>
<listitem>
<para>
<simpara>
Canales de color sobre los cuales debe aplicarse el contraste.
</para>
</simpara>
</listitem>
</varlistentry>
</variablelist>
Expand All @@ -91,32 +96,29 @@

<refsect1 role="examples">
&reftitle.examples;
<para>
<example>
<title>
Crea un degradado de imagen utilizando el método
<function>Imagick::sigmoidalContrastImage</function>
para mezclar dos imágenes suavemente, donde la mezcla
está definida por las variables $contrast y $midpoint.
</title>
<programlisting role="php">
<example>
<title>
Crea un degradado de imagen utilizando el método
<function>Imagick::sigmoidalContrastImage</function>
para mezclar dos imágenes suavemente, donde la mezcla
está definida por <parameter>alpha</parameter> y <parameter>beta</parameter>
</title>
<programlisting role="php">
<![CDATA[
<?php

function generateBlendImage($width, $height, $contrast = 10, $midpoint = 0.5) {
function generateBlendImage($width, $height, $alpha = 10, $beta = 0.5)
{
$imagick = new Imagick();
$imagick->newPseudoImage($width, $height, 'gradient:black-white');
$quanta = $imagick->getQuantumRange();
$imagick->sigmoidalContrastImage(true, $contrast, $midpoint * $quanta["quantumRangeLong"]);
$imagick->sigmoidalContrastImage(true, $alpha, $beta * $quanta["quantumRangeLong"]);

return $imagick;
}

?>
]]>
</programlisting>
</example>
</para>
</programlisting>
</example>
</refsect1>

</refentry>
Expand Down