createVignettePublishFormat

Cria um novo formato de publicação para uma vinheta.

Os formatos de vinheta especificam o tamanho das vinhetas publicadas e suas miniaturas, bem como os níveis de zoom, os parâmetros de nitidez e a versão do formato de arquivo das vinhetas produzidas a partir de vinhetas primárias publicadas em um servidor de Renderização de Imagem a partir de IPS.

As versões mais recentes do servidor de Renderização de imagem podem oferecer suporte a vinhetas em pirâmide, o que elimina a necessidade de definir tamanhos de formato de vinheta específicos para publicação.

Tipos de usuário autorizados

  • IpsAdmin
  • IpsCompanyAdmin
  • TrialSiteAdmin
  • ImagePortalAdmin

Parâmetros

Entrada (createVignettePublishFormatParam)

Nome Tipo Obrigatório Descrição
companyHandle xsd:string Sim Processe a empresa à qual a vinheta pertence.
name Frase de código Sim Nome para identificar o formato de publicação da vinheta.
targetWidth Frase de código Sim

Especifica a largura alvo da exibição de vinheta resultante em pixels.

Use zero para que a vinheta de saída tenha o mesmo tamanho da vinheta principal.

targetHeight Frase de código Sim Cria uma vinheta em pirâmide otimizada para aplicar zoom no servidor de Renderização de imagem. Começando pelo tamanho máximo, definido pelos campos Tamanho da vinheta do Target, isso cria várias exibições de tamanho em um único arquivo de saída de vinheta. Cada tamanho de exibição subsequente é reduzido pela metade até que a largura e a altura fiquem dentro de 128x128 pixels.
createPyramid Frase de código Sim Especifica a largura de cada miniatura resultante em pixels. Esta configuração é opcional. Deixe como zero para nenhum arquivo de miniatura.
thumbWidth Frase de código Sim Especifica o formato de arquivo para as vinhetas publicadas. Dada uma nova versão da Criação de imagem e uma versão anterior do Servidor de renderização de imagem, você deve especificar uma versão de vinheta que seu Servidor de renderização de imagem possa ler. Se você especificar uma versão superior, o servidor de Renderização de Imagem não poderá ler as vinhetas publicadas. Defina como zero para publicar vinhetas na versão mais recente.
saveAsVersion Frase de código Sim Especifica o caractere que separa o nome da vinheta e o sufixo que indica sua largura.
sizeSuffixSeparator Frase de código Sim Especifica o caractere que separa o nome da vinheta e o sufixo que indica sua largura.
nitidez Frase de código Não Aplica nitidez à imagem de exibição principal para cada tamanho de vinheta de publicação. A nitidez pode compensar o desfoque quando os vinhetas são dimensionados.
usmAmount Frase de código Sim O mascaramento digital sem nitidez é uma maneira flexível e eficiente de aumentar a nitidez, especialmente em imagens digitalizadas. Isso controla a magnitude de cada superação (o quanto mais escuro e claro se tornam as bordas).
usmRadius Frase de código Sim Afeta o tamanho das bordas a serem aprimoradas ou a largura das bordas, de modo que um rádio menor melhora os detalhes de escala menor. Valores de raio mais altos podem causar halos nas bordas. Detalhes finos precisam de um raio menor, pois detalhes pequenos do mesmo tamanho ou menores do que o raio são perdidos.
usmThreshold Frase de código Sim Controla a alteração mínima de brilho a ser nitidez ou a distância entre os valores de tons adjacentes antes do funcionamento do filtro. Essa configuração pode ajustar a nitidez de bordas mais pronunciadas, deixando bordas mais sutis intocadas. O intervalo permitido de limite de 0 a 255.

Saída (createVignettePublishFormatReturn)

Nome Tipo Obrigatório Descrição
vinhetaFormatarAlça xsd:string Sim O identificador para o formato de vinheta criado.

Exemplos

Esse código cria o formato de publicação de vinheta. A solicitação de criação especifica um nome, a largura e a altura do público-alvo e outros valores necessários.

Solicitação

<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>

Resposta

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

Nesta página