API de Imágenes

Ejemplo URL imagen sin parámetros:

/images/showid/580259

Ejemplo URL imagen con parámetros:

/images/showid2/580259?w=789&zc=1&h=350

Lista completa de parámetros

Parámetro	Valores	¿Qué hace?
w	ancho	define ancho	Ancho en pixeles
h	altura	define altura	Altura en píxeles
r	proporciones	define proporciones	Proporciones que debe tener la imagen
q	calidad	0 a 100	La calidad de compresión. Cuanto mayor sea el número, mejor se verá la imagen. A partir de 95 apenas se percibe diferencia visual y tamaño se incrementa notablemente
un	alineación	c, t, l, r, b, tl, tr, bl, a,br	Cultivos de alineación. a = auto, c = centro, t = arriba, b = abajo, D = derecha, L = izquierda. Las posiciones se pueden unir para crear posiciones diagonales
zc	zoom / recorte	0, 1, 2, 3, 4, 5	Cambiar el modo de recorte y los ajustes de escala
F	filtros	demasiados para mencionar	Vamos a aplicar filtros de imagen para cambiar la imagen cambia de tamaño. Por ejemplo, puede cambiar el brillo / contraste o incluso borrar la imagen
s	suavizar		Aplicar un filtro de enfoque a la imagen, hace que las imágenes en tamaño reducido mirar un poco más nítidas
cc	el color del lienzo/fondo	Valor de color hexadecimal (# ffffff)	Cambiar el color de fondo. La mayoría utiliza al cambiar el zoom y la configuración de los cultivos, que a su vez puede añadir bordes a la imagen.
ct	lienzo de la transparencia	verdadero (1)	Utilice la transparencia e ignorar el color de fondo

Parametros básicos

Estos parámetros son los más usados. Con ellos puedes hacer un redimensionamiento básico.

• w y h – ancho y alto. Totally optional but also almost essential, few people want the default sizes. The width and height can be any value, the image will enlarge or shrink as required.
• q – quality. This specifies the compression level of the images being cropped/ resized.
• r – Establecer las proporciones. Sólo se usa con la opciones zc=5. Ejemplos: r=16:9 r=4:3 Recomendado: r=7:3

zc = Recorte y escalado

Usage is simple. The mysterious zc (Zoom & Crop) parameter comes into action, simply give it the value of 2 and it will apply the borders as required.

Valor	Descripción	Redimensión	Recorte (cuando exterior)	Borde (cuando interior)
0	Redimensionar para encajar en las dimensiones especificadas sin mantener proporciones (sin recortar)	Libre	No	-
1	Redimensionar y recortar para alcanzar las dimensiones especificadas manteniendo proporciones (por defecto)	Porporcional exterior	Si	-
2	Redimensionar porporcionalmente para encajar la imagen entera de las dimensiones especificadas. Añadir bordes si es necesario	Proporcional interior	No	Si
3	Redimensionar porporcionalmente para encajar la imagen entera de las dimensiones especificadas. No añade bordes	Proporcional interior	No	No
4	Redimensionar unicamente si sobrepasa las dimensiones indicadas por los parámetros w y h	Si sobrepasa proporcional interior	No	-
5	Redimensionar de acuerdo al parámetro r que indica proporciones
6	Imagen original	-	-	-

un = Posicionado (para recorte)

El código le permite alinear la región de recorte de diferentes a diferentes de la imagen. No se trata de indicar la coordenadas x, y, aunque porque el 99% de las veces no lo necesitarás y es mucho más simple.

Al recortar una imagen siempre habrá que decidir como por donde se recorta. Se puede indicar explicitamente o tomar el valor por defecto. Los parámetros son bastante sencillos de entender. Son:

• c : posicionar en el centro (valor por defecto)
• a : posicionar automáticamente (de momento no funciona pero cuando lo haga será el por defecto)
• t : alinear arriba
• tr : alinear arriba derecha
• tl : alinear arriba izquierda
• b : alinear abajo
• br : alinear abajo derecha
• bl : alinear abajo izquierda
• l : alinear izquierda
• r : alinear derecha

f = Filtros de imágenes

Cuando hablo de filtros de imagen me refiero a los tipos de efectos que se pueden conseguir en Instagram o Photoshop. Cosas como ajustar el brillo, contraste, desenfoque, relieve o varios a la vez. Los filtros se controlan mediante el parámetro "f".

Algunos filtros requieren argumentos tales como los valores de color o intensidad del filtro (cantidad de contraste, por ejemplo) en esos caso debe pasar el identificador del filtro seguido de los argumentos separados por comas. Por ejemplo, el filtro de brillo (id 3) requiere 1 argumento - así que para fortalecer el brillo con nivel 10 escribiríamos:

f=1,10

Los filtros que puedes usar (con sus correspondientes argumentos) son:

• 1 = Negate/Invertir – Invierte los colores
• 2 = Grayscale/Escala de grises – turn the image into shades of grey
• 3 = Brightness/Brillo – Ajustar el brillo de la imagen. Requiere 1 argumento para especificar la cantidad de brillo a añadir. Los valores pueden ser negativos para hacer la imagen más oscura.
• 4 = Contrast/Contraste – Ajustar contraste de la imagen. Requiere 1 argumento para especificar la cantidad de contraste a aplicar. Los valores mayores que 0 reducirán el contraste y los menores de 0 lo incrementarán.
• 5 = Colorize/ Tint – Aplicar un lavado de color color a la imagen. Requiere los parámetros RGBA
• 6 = Edge Detect – Detectar los bordes de la imagen
• 7 = Emboss/Realizar – Emboss the image (give it a kind of depth), can look nice when combined with the colorize filter above.
• 8 = Gaussian Blur – blur the image, unfortunately you can’t specify the amount, but you can apply the same filter multiple times
• 9 = Selective Blur – a different type of blur. Not sure what the difference is, but this blur is less strong than the Gaussian blur.
• 10 = Mean Removal – Uses mean removal to create a “sketchy” effect.
• 11 = Smooth/Suavizar – Makes the image smoother.

Múltiples filtros a la vez

Para hacer esta super flexible podemos encadenar varios filtros. Basta con separar varios filtros usando un carácter de barra vertical . Por ejemplo los valores a continuación se aplicarían un brillo de 10 a una imagen en escala de grises:

f=2|1,10

s = Nitidez

One little extra I recently added is a sharpen filter. This is separate to the other filters above. All you have to do is add ans=1 value to the query string.
Un poco más recientemente he añadido es un filtro de nitidez. Esto es independiente de los otros filtros anteriores. Todo lo que tiene que hacer es añadir y = 1 valor a la cadena de consulta.