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 para vinhetas produzidas a partir de vinhetas primárias publicadas em um servidor de Renderização de imagem do IPS.

As versões mais recentes do servidor de Renderização de imagem podem oferecer suporte a vinhetas pirâmides, o que elimina a necessidade de definir tamanhos específicos de formato de vinheta 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 Lide com a empresa à qual a vinheta pertence.
name Frase do código Sim Nome para identificar o formato de publicação da vinheta.
targetWidth Frase do código Sim

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

Use zero para que a vinheta de saída tenha o mesmo tamanho da vinheta primária.

targetHeight Frase do código Sim Cria uma vinheta pirâmide otimizada para aumentar o zoom no servidor de Renderização de imagem. Começando pelo tamanho máximo, definido pelos campos Tamanho da vinheta do Target, isso cria visualizações de vários tamanhos em um único arquivo de saída da vinheta. Cada tamanho de exibição subsequente é dividido até que a largura e a altura estejam dentro de 128x128 pixels.
createPyramid Frase do código Sim Especifica a largura de cada miniatura resultante em pixels. Essa configuração é opcional. Deixe como zero para nenhum arquivo de miniatura.
thumbWidth Frase do código Sim Especifica o formato de arquivo para as vinhetas publicadas. Dada uma nova versão da Criação de Imagens e uma versão mais antiga do Servidor de Renderização de Imagens, você deve especificar uma versão de vinheta que seu Servidor de Renderização de Imagens 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 do código Sim Especifica o caractere que separa o nome da vinheta e o sufixo que indica sua largura.
sizeSuffixSeparator Frase do código Sim Especifica o caractere que separa o nome da vinheta e o sufixo que indica sua largura.
afiador Frase do código Não Aplica nitidez à imagem de exibição principal para cada vinheta de publicação A nitidez pode compensar o desfoque quando as vinhetas são dimensionadas.
usmAmount Frase do código Sim O mascaramento com nitidez digital é uma maneira flexível e poderosa de aumentar a nitidez, especialmente em imagens digitalizadas. Isso controla a magnitude de cada superação (quanto mais escuro e claro as bordas se tornam).
usmRadius Frase do código Sim Afeta o tamanho das bordas a serem melhoradas ou a largura das bordas, de modo que um raio menor melhora detalhes em escala menor. Valores de raio mais altos podem causar halos nas bordas. Os detalhes finos precisam de um raio menor, pois detalhes minúsculos do mesmo tamanho ou menores que o raio é perdido.
usmThreshold Frase do código Sim Controla a alteração mínima do brilho para ser nitidamente definida ou a distância que os valores de tons adjacentes devem estar entre si antes que o filtro funcione. Essa configuração pode tornar as bordas mais pronunciadas mais nítidas, deixando as bordas mais sutis intocadas. O intervalo permitido de 0 a 255.

Saída (createVignettePublishFormatReturn)

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

Exemplos

Esse código cria o formato de publicação da vinheta. A solicitação de criação especifica um nome, a largura e a altura do target 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