createVignettePublishFormat

Crea un nuevo formato de publicación para una viñeta.

Los formatos de viñeta especifican el tamaño de las viñetas publicadas y sus miniaturas, así como los niveles de zoom, los parámetros de nitidez y la versión del formato de archivo para las viñetas producidas a partir de viñetas principales publicadas en un servidor de renderización de imágenes desde IPS.

Las versiones de servidor de renderización de imágenes más recientes admiten viñetas piramidales, lo que elimina la necesidad de definir tamaños de formato de viñeta específicos para la publicación.

Tipos de usuarios autorizados

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

Parámetros

Entrada (createVignettePublishFormatParam)

Nombre Tipo Obligatorio Descripción
companyHandle xsd:string Sí Gestionar a la empresa a la que pertenece la viñeta.
name Frase de código Sí Nombre para identificar el formato de publicación de la viñeta.
targetWidth Frase de código Sí

Especifica el ancho de destino de la vista de viñeta resultante en píxeles.

Utilice cero para que la viñeta de salida tenga el mismo tamaño que la viñeta principal.

targetHeight Frase de código Sí Crea una viñeta piramidal optimizada para la ampliación y la reducción en el servidor de procesamiento de imágenes. Partiendo desde el tamaño máximo, definido por los campos de tamaño de la viñeta de destino, esta opción crea múltiples vistas de tamaño en un solo archivo de salida de viñetas. Los tamaños de vista se van reduciendo a la mitad en orden hasta que la altura y la anchura están dentro del límite de 128 x 128 píxeles.
createPyramid Frase de código Sí Especifica el ancho de cada miniatura resultante en píxeles. Esta configuración es opcional. Deje como cero para ningún archivo en miniatura.
thumbWidth Frase de código Sí Especifica el formato de archivo de las viñetas publicadas. Dado que hay una nueva versión de Creación de imágenes y una versión anterior del servidor de renderización de imágenes, debe especificar una versión de la viñeta que el servidor de renderización de imágenes pueda leer. Si especifica una versión superior, el servidor de renderización de imágenes no podrá leer las viñetas publicadas. Establézcalo en cero para publicar viñetas en la última versión.
saveAsVersion Frase de código Sí Especifica el carácter que separa el nombre de la viñeta y el sufijo que indica su anchura.
sizeSuffixSeparator Frase de código Sí Especifica el carácter que separa el nombre de la viñeta y el sufijo que indica su anchura.
enfocar Frase de código No Aplica nitidez a la imagen de vista principal para cada tamaño de viñeta de publicación. El enfoque puede compensar el desenfoque cuando se escalan los viñedos.
usmAmount Frase de código Sí El enmascaramiento de enfoque digital es una forma flexible y potente de aumentar la nitidez, especialmente en imágenes escaneadas. Esto controla la magnitud de cada rebasamiento (cuánto más oscuros y claros se vuelven los bordes de borde).
usmRadius Frase de código Sí Afecta al tamaño de los bordes que se van a mejorar o a la anchura de los bordes, por lo que un radio más pequeño mejora el detalle de escala más pequeña. Los valores de radio más altos pueden causar halos en los bordes. El detalle fino necesita un radio más pequeño, ya que se pierde un detalle minúsculo del mismo tamaño o menor que el radio.
usmThreshold Frase de código Sí Controla el cambio mínimo de brillo que se debe enfocar o la distancia que deben estar los valores tonales adyacentes antes de que funcione el filtro. Este ajuste puede enfocar los bordes más pronunciados sin modificar los bordes más sutiles. El rango permitido de umbral de 0 a 255.

Salida (createVignettePublishFormatReturn)

Nombre Tipo Obligatorio Descripción
*viñetaFormatoControlador* xsd:string Sí El identificador del formato de viñeta creado.

Ejemplos

Este código crea el formato de publicación de la viñeta. La solicitud de creación especifica un nombre, una anchura y altura de destino y otros valores necesarios.

Solicitar

<createVignettePublishFormatParam xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <companyHandle>c|21</companyHandle>
   <name>APIcreateVignettePublishFormat1</name>
   <targetWidth>1200</<targetWidth>
   <targetHeight>800</targetHeight>
   <createPyramid>true</createPyramid>
   <thumbWidth>400</thumbWidth>
   <saveAsVersion>0</saveAsVersion>
   <sizeSuffixSeparator>-</sizeSuffixSeparator>
   <sharpen>50</sharpen>
   <usmAmount>230.0</usmAmount>
   <usmRadius>1.1</usmRadius>
   <usmThreshold>130</usmThreshold>
</createVignettePublishFormatParam>

Respuesta

<createVignettePublishFormatReturn xmlns="http://www.scene7.com/IpsApi/xsd/2008-01-15">
   <vignetteFormatHandle>v|21|282</vignetteFormatHandle>
</createVignettePublishFormatReturn>

En esta página