-1 Error: Exception
Última atualização em
02/11/2026
Saiba mais sobre os atributos de documento, valores de parâmetro e configurações padrão para criar documentos do Photoshop usando comandos do MATLAB.
Criar documentos do Photoshop de forma programática requer atributos de documento e valores de parâmetro válidos. Use esta referência para entender os parâmetros compatíveis, os valores aceitos, as configurações padrão e as dependências ao usar a função psnewdoc do MATLAB para criar novos documentos do Photoshop.
Sintaxe da função psnewdoc.
Use a seguinte sintaxe para criar documentos do Photoshop no MATLAB:
|
|
Descrição |
|
psnewdoc() |
Cria um documento usando valores padrão para todos os atributos. |
|
psnewdoc(W, H) |
Cria um documento com a largura e a altura especificadas. Todos os outros atributos usam valores padrão. |
|
psnewdoc(W, H, R, N, M, F, A, B, P) |
Cria um documento especificando todos os atributos de documento aceitos. |
Nota
Se você quiser especificar um parâmetro posterior sem atribuir um anterior, use a string "undefined" para o parâmetro ignorado.
Exemplo
psnewdoc(10, 10, 72, 'hi', 'cmyk', 'transparent', 2.5, 16, 'U.S. Web Coated (SWOP) v2')
Este comando cria um documento de 10 × 10 chamado “hi” com as seguintes configurações:
- Resolução: 72 ppi
- Modo de cores: CMYK
- Fundo: Transparente
- Proporções de pixel: 2,5
- Profundidade de bits: 16 bits por canal
- Perfil de cores: U.S. Web Coated (SWOP) v2
Atributos do documento.
|
Parâmetro |
Atributo |
Tipo de dados |
Descrição |
|
W |
Largura |
Numérico |
Especifica a largura do documento usando as unidades de régua atuais do Photoshop. |
|
H |
Altura |
Numérico |
Especifica a altura do documento usando as unidades de régua atuais do Photoshop. |
|
R |
Resolução |
Numérico |
Especifica a resolução do documento em pixels por polegada (ppi). |
|
N |
Nome |
-1 Error: Exception |
Especifica o nome do documento exibido no Photoshop. |
|
M |
Modo |
-1 Error: Exception |
Especifica o modo de cores. Os valores aceitos são RGB, CMYK, Lab, Bitmap e Tons de cinza. |
|
F |
Preenchimento |
-1 Error: Exception |
Especifica o conteúdo do fundo. Os valores aceitos são White, BackgroundColor e Transparent. |
|
A |
Proporções |
Numérico |
Especifica as proporções de pixel. Um valor de 1,0 representa pixels quadrados. |
|
B |
Profundidade de Bits |
Numérico |
Especifica os bits por canal. Os valores aceitos são 1, 8, 16 e 32. |
|
P |
Perfil |
-1 Error: Exception |
Especifica o nome do perfil de cores do Photoshop. O valor deve corresponder a um perfil listado em Configurações de cores. |
Valores padrão
Quando você omite parâmetros ou chama psnewdoc() sem argumentos, o Photoshop usa os seguintes padrões:
|
Atributo |
Valor padrão |
|
Largura |
504 pixels |
|
Altura |
360 pixels |
|
Resolução |
72 PPI |
|
Nome |
Sem título-X (em que X é o número sequencial do documento) |
|
Modo |
RGB |
|
Preenchimento |
Branco |
|
Proporções |
1,0 (pixels quadrados) |
|
Profundidade de Bits |
8 bits por canal |
|
Perfil |
Espaço da cor de trabalho para o modo de cores selecionado nas Configurações de cores do Photoshop |
Unidades e dependências
Lembre-se das seguintes dependências ao criar documentos do Photoshop usando o MATLAB:
|
Dependência |
Detalhes |
|
Largura e altura. |
O Photoshop interpreta a largura e a altura de acordo com a preferência atual Unidades e réguas. Altere as unidades da régua antes de executar psnewdoc se quiser usar unidades diferentes de pixels. |
|
Perfil de cores. |
O nome do perfil deve corresponder exatamente a um perfil listado em Editar > Configurações de cores. Se o nome do perfil especificado for inválido, o Photoshop usa o espaço da cor de trabalho do modo de cores selecionado. |
Crie imagens impressionantes com Photoshop
Edite, retoque e transforme fotos com as Ferramentas criativas líderes do setor que você conhece e adora.
