Nota
O acesso a esta página requer autorização. Pode tentar iniciar sessão ou alterar os diretórios.
O acesso a esta página requer autorização. Pode tentar alterar os diretórios.
Representa as opções de configuração que controlam a função do ImageAnalyzer.
Se estiver a fazer a Análise de Imagens com o modelo padrão, tem de chamar SetFeatures() e definir uma ou mais funcionalidades visuais para analisar. Não existe uma seleção predefinida para funcionalidades visuais. Se estiver a utilizar um modelo personalizado ou a fazer Segmentação de Imagens, não precisa de especificar funcionalidades visuais.
Membros
Avançado
Sintaxe: public AdvancedOptions & Advanced;
Opções e parâmetros avançados.
SetFeatures
Sintaxe: public inline void SetFeatures ( const std::vector< ImageAnalysisFeature > & ImageAnalysisFeatures );
Defina uma lista de uma ou mais funcionalidades visuais para extrair da imagem.
Se estiver a utilizar o modelo predefinido, tem de especificar pelo menos uma funcionalidade visual. Se estiver a utilizar um modelo preparado sob medida (ao chamar SetModelName), não precisa de especificar quaisquer funcionalidades visuais, uma vez que estão implícitas no modelo. Se estiver a fazer Segmentação de Imagens (ao chamar SetSegmentationMode), não precisa de especificar funcionalidades visuais. Tenha em atenção que pode extrair funcionalidades visuais (ao chamar SetFeatures e/ou SetModelName) ou fazer segmentação (ao chamar SetSegmentationMode), mas não pode fazer ambas ao mesmo tempo.
Parâmetros
ImageAnalysisFeaturesUma lista de funcionalidades visuais
GetFeatures
Sintaxe: public inline std::vector< ImageAnalysisFeature > GetFeatures ( );
Obtém a lista de uma ou mais funcionalidades visuais para extrair da imagem.
Devoluções
Uma lista de funcionalidades visuais
SetCroppingAspectRatios
Sintaxe: public inline void SetCroppingAspectRatios ( const std::vector< double > & aspectRatios );
Define a lista de proporções que as sugestões de recorte devem tentar ajustar (também conhecidas como culturas inteligentes)
Uma proporção é calculada ao dividir a largura do recorte de destino pela altura.
Os valores suportados estão entre 0,75 e 1,8 (inclusive).
Chamar este método só é relevante quando ImageAnalysisFeature::CropSuggestions é definido como uma das funcionalidades de imagem a analisar (consulte o método ImageAnalysisOptions::SetFeatures).
Se SetCroppingAspectRatios() não for chamado, mas ImageAnalysisFeature::CropSuggestions for especificado como uma funcionalidade, o serviço devolverá uma sugestão de recorte com uma proporção que considera adequada entre 0,5 e 2,0 (inclusive).
Parâmetros
aspectRatiosUma lista de rações de aspeto (um número positivo)
GetCroppingAspectRatios
Sintaxe: public inline std::vector< double > GetCroppingAspectRatios ( );
Obter a lista de proporções a utilizar para o recorte (também conhecido como culturas inteligentes)
Devoluções
Uma lista de proporções. Esta lista estará vazia se as proporções não tiverem sido definidas antes
Uma proporção é calculada ao dividir a largura do recorte de destino pela altura.
Os valores suportados estão entre 0,75 e 1,8 (inclusive).
SetLanguage
Sintaxe: public inline void SetLanguage ( const std::string & language );
Define o idioma que a Análise de Imagens deve utilizar nos resultados.
Este idioma deve ser fornecido como um código ISO 639-1, por exemplo, "en" para inglês ou "fr" para francês. Se este valor não estiver definido, o valor predefinido é "en" para inglês. Veja https://aka.ms/cv-languages para obter uma lista de códigos de idioma suportados e que funcionalidades visuais são suportadas para cada idioma.
Parâmetros
languageO código de idioma
GetLanguage
Sintaxe: public inline std::string GetLanguage ( );
Obtém o idioma que a Análise de Imagens deve utilizar nos resultados.
Devoluções
O idioma que o serviço utilizará nos resultados da Análise de Imagens.
O idioma está no formato ISO 639-1, por exemplo, "en" para inglês ou "fr" para francês. Se este valor não estiver definido, o valor predefinido é "en" para inglês. Veja https://aka.ms/cv-languages para obter uma lista de códigos de idioma suportados e que funcionalidades visuais são suportadas para cada idioma.
SetModelVersion
Sintaxe: public inline void SetModelVersion ( const std::string & modelVersion );
Define a versão do modelo que o Image Analysis Service deve utilizar. Se esta opção não estiver definida, a predefinição é "mais recente".
"mais recente" é o único valor atualmente suportado pelo serviço. Em futuras atualizações de serviço, as versões de modelo suportadas serão "mais recentes" ou no formulário "YYYY-MM-DD" ou "YYYY-MM-DD-preview", em que YYYYY, MM, DD são ano, mês e dia, respetivamente.
Parâmetros
modelVersionA versão do modelo
GetModelVersion
Sintaxe: public inline std::string GetModelVersion ( );
Obtém a versão do modelo que o Image Analysis Service deve utilizar. Se esta opção não tiver sido definida, a predefinição é "mais recente".
Devoluções
A versão do modelo de IA utilizada pelo serviço. O único valor suportado neste momento é "mais recente".
SetGenderNeutralCaption
Sintaxe: public inline void SetGenderNeutralCaption ( const bool genderNeutral );
Define a neutralidade de género do resultado da Análise de Imagens legenda.
Parâmetros
genderNeutralSe for "verdadeiro", o legenda não terá termos de género. Se "verdadeiro", as palavras "Homem/Mulher" serão substituídas por "Pessoa" e "Menino/Menina" serão substituídas por "Criança". Se não estiver definido, a predefinição é "falso".
Só é relevante se ImageAnalysisFeature::Caption estiver incluído na lista Funcionalidades (Consulte ImageAnalysisOptions::SetFeatures).
GetGenderNeutralCaption
Sintaxe: public inline bool GetGenderNeutralCaption ( );
Obtém a neutralidade de género do resultado da Análise de Imagens legenda.
Devoluções
"verdadeiro" se o legenda devolvido não tiver termos de género. "false" (a predefinição) caso contrário.
SetModelName
Sintaxe: public inline void SetModelName ( const std::string & modelName );
Define o nome do modelo preparado sob medida que o Serviço de Análise de Imagens deve utilizar. Se esta opção não estiver definida, será utilizado o modelo predefinido (padrão). Tenha em atenção que pode extrair funcionalidades visuais (ao chamar SetFeatures e/ou SetModelName) ou fazer segmentação (ao chamar SetSegmentationMode), mas não pode fazer ambas ao mesmo tempo.
Parâmetros
modelNameO nome do modelo personalizado
GetModelName
Sintaxe: public inline std::string GetModelName ( );
Obtém o nome do modelo de preparação personalizada que o Serviço de Análise de Imagens utiliza.
Devoluções
O nome do modelo personalizado ou uma cadeia vazia se um modelo personalizado não tiver sido definido (nesse caso, será utilizado o modelo padrão).
SetSegmentationMode
Sintaxe: public inline void SetSegmentationMode ( const ImageSegmentationMode segmentationMode );
Define o modo de segmentação que o Serviço de Análise de Imagens deve utilizar.
Ao definir ImageSegmentationMode::BackgroundRemoval ou ImageSegmentationMode::ForegroundMatting, o serviço Análise de Imagens executará uma operação de segmentação e, se tiver êxito, devolverá uma única imagem PNG da segmentação resultante. Por predefinição, não é feita nenhuma segmentação. Tenha em atenção que pode extrair funcionalidades visuais (ao chamar SetFeatures e/ou SetModelName) ou fazer segmentação (ao chamar SetSegmentationMode), mas não pode fazer ambas ao mesmo tempo.
Parâmetros
segmentationModeO modo de segmentação pretendido
GetSegmentationMode
Sintaxe: public inline ImageSegmentationMode GetSegmentationMode ( );
Obtém o modo de segmentação atual.
Devoluções
O modo de segmentação atual.
~ImageAnalysisOptions
Sintaxe: public ~ImageAnalysisOptions ( ) = default;
Desestrui uma instância da classe ImageAnalysisOptions.
Criar
Sintaxe: public inline static std::shared_ptr< ImageAnalysisOptions > Create ( );
Inicializa uma nova instância da classe ImageAnalysisOptions.
Devoluções
O recém-criado ImageAnalysisOptions moldado dentro de um std::shared_ptr