Ajustar temperatura de color de imagen

Estima la temperatura de color correlacionada del promedio, aplica el cambio cálido o frío solicitado y devuelve ganancias RGB normalizadas. Usted puede usar el resultado en un flujo de color con luz lineal para lograr un balance de blancos reproducible sin subir la imagen. El cálculo es determinista y la API cuesta $0.002 por solicitud.

Prepare un valor RGB medio representativo

Comience con la media aritmética de cada canal sRGB de 8 bits en los píxeles que deban representar la corrección. Introduzca esos valores como avg_r, avg_g y avg_b en la escala habitual de 0 a 255. Un promedio de toda la imagen resulta útil para fotografías con iluminación uniforme, lotes de productos, miniaturas y vistas previas automatizadas. Sin embargo, cuando el motivo posee un color dominante, el promedio de una zona neutra puede describir mejor la iluminación que el encuadre completo. Una pared roja o un mar azul pueden dominar la media global aunque el balance de blancos de la cámara sea correcto. La calculadora no examina píxeles, identifica objetos neutros ni separa la luz del color del motivo: utiliza exactamente el resumen que usted proporciona. Se rechaza una media totalmente negra porque no contiene cromaticidad para estimar la temperatura. También se rechazan números no finitos y valores fuera del intervalo de 8 bits. Mantenga el mismo método de muestreo en todo el lote para obtener correcciones comparables.

Elija el desplazamiento Kelvin y comprenda el modelo

Introduzca shift_kelvin como cambio relativo, no como destino absoluto. Un valor positivo eleva la temperatura estimada y genera una corrección más fría; uno negativo la reduce y produce una corrección más cálida. Se admiten desplazamientos de -10,000 a 10,000 Kelvin, y el objetivo resultante debe permanecer entre 1,000 y 40,000 Kelvin. Primero se linealizan los canales sRGB medios, se convierten a cromaticidad CIE XYZ y se estima la temperatura correlacionada mediante la aproximación cúbica de McCamy. Después se evalúan curvas RGB de cuerpo negro deterministas para las temperaturas estimada y objetivo. La proporción entre ambos puntos blancos se transforma en ganancias de canal normalizadas para que el verde valga uno. Se trata de una aproximación técnica, no de una medición espectral. La temperatura correlacionada es más significativa cerca del lugar planckiano, por lo que promedios muy saturados solo permiten una estimación orientativa. El método y las temperaturas devueltos dejan constancia de estas premisas.

Aplique los multiplicadores sin dañar la imagen

Aplique red_multiplier, green_multiplier y blue_multiplier a valores RGB en luz lineal, no directamente a números de canal de 8 bits con gamma. Un flujo fiable descodifica sRGB a luz lineal, multiplica cada canal por su ganancia, trata los valores que superan el rango visible mediante exposición o mapeo tonal y vuelve a codificar el resultado en sRGB. Multiplicar bytes codificados puede parecer aceptable con cambios pequeños, pero no conserva la relación prevista entre la luz y los valores almacenados. El verde se normaliza a uno, de modo que el resultado expresa el equilibrio cromático y no un cambio general de exposición. El rojo o el azul pueden superar uno y provocar recorte en las altas luces; trabaje con coma flotante o suficiente profundidad antes de exportar. Revise imágenes representativas antes de procesar una colección grande, sobre todo si la media procede de escenas coloridas. La API cuesta $0.002 por solicitud y la calculadora web realiza localmente la misma operación determinista.