DocumentaçãoAPI do sistema de produção de imagens Dynamic Media

createVignettePublishFormat

Última atualização: 20 de julho de 2024
  • Tópicos:

Criado para:

  • Desenvolvedor
  • Administrador

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)

NomeTipoObrigatórioDescrição
companyHandlexsd:stringSimProcesse a empresa à qual a vinheta pertence.
nomeFrase codificadaSimNome para identificar o formato de publicação da vinheta.
targetWidthFrase codificadaSim

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.

targetHeightFrase codificadaSimCria 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.
createPyramidFrase codificadaSimEspecifica a largura de cada miniatura resultante em pixels. Esta configuração é opcional. Deixe como zero para nenhum arquivo de miniatura.
thumbWidthFrase codificadaSimEspecifica 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.
saveAsVersionFrase codificadaSimEspecifica o caractere que separa o nome da vinheta e o sufixo que indica sua largura.
sizeSuffixSeparatorFrase codificadaSimEspecifica o caractere que separa o nome da vinheta e o sufixo que indica sua largura.
nitidezFrase codificadaNãoAplica 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.
usmAmountFrase codificadaSimO 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).
usmRadiusFrase codificadaSimAfeta 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.
usmThresholdFrase codificadaSimControla 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)

NomeTipoObrigatórioDescrição
vinhetaFormatarAlçaxsd:stringSimO 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>
recommendation-more-help
4e9b9d8c-5839-4215-aa35-01b652869681