variáveis

O darktable suporta a substituição de variáveis em diversos módulos e configurações de preferências. Por exemplo:

🔗variáveis disponíveis

As seguintes variáveis estão disponíveis, ainda que nem todas sejam aplicáveis em todos os contextos:

$(ROLL.NAME)		rolo de filme da imagem de entrada
$(FILE.FOLDER)		pasta contendo a imagem de entrada
$(FILE.NAME)		nome base da imagem de entrada
$(FILE.EXTENSION)	extensão da imagem de entrada
$(ID)			id da imagem
$(VERSION)		número da versão da duplicata
$(VERSION.IF_MULTI)	como $(VERSION) mas texto nulo se existe somente uma versão
$(VERSION.NAME)		nome de versão a partir dos metadados
$(DARKTABLE.VERSION)	a versão da instância do darktable em execução
$(DARKTABLE.NAME)	nome de darktable
$(SEQUENCE)		um número sequencial em um trabalho de exportação
$(WIDTH.SENSOR)		largura dos dados RAW em pixels antes do recorte RAW
$(HEIGHT.SENSOR)	altura dos dados RAW em pixels antes do recorte RAW
$(WIDTH.RAW)		largura dos dados RAW em pixels após o recorte RAW
$(HEIGHT.RAW)		altura dos dados RAW em pixels após o recorte RAW
$(WIDTH.CROP)		largura da imagem em pixels ao final do pixelpipe, antes de redimensionar para exportação
$(HEIGHT.CROP)		altura da imagem em pixels ao final do pixelpipe, antes de redimensionar para exportação
$(WIDTH.EXPORT)		largura da imagem em pixels ao final do pixelpipe, após redimensionar para exportação
$(HEIGHT.EXPORT)	altura da imagem em pixels ao final do pixelpipe, após redimensionar para exportação
$(WIDTH.MAX)		limite máximo de largura da imagem na sessão de exportação
$(HEIGHT.MAX)		limite máximo de altura da imagem na sessão de exportação
$(YEAR)			ano da data de importação/exportação
$(YEAR.SHORT)		ano com dois dígitos da data de importação/exportação
$(MONTH)		mês da data de importação/exportação
$(MONTH.LONG)		mês completo da data de importação/exportação
$(MONTH.SHORT)		mês abreviado da data de importação/exportação
$(DAY)			dia da data de importação/exportação
$(HOUR)			hora do momento de importação/exportação
$(MINUTE)		minuto do momento de importação/exportação
$(SECOND)		segundo do momento de importação/exportação
$(MSEC)			milissegundo do momento de importação/exportação
$(EXIF.YEAR)		ano a partir do EXIF
$(EXIF.YEAR.SHORT)	ano com dois dígitos a partir do EXIF
$(EXIF.MONTH)		mês a partir do EXIF
$(EXIF.MONTH.LONG)	mês completo a partir do EXIF
$(EXIF.MONTH.SHORT)	mês abreviado a partir do EXIF
$(EXIF.DAY)		dia a partir do EXIF
$(EXIF.HOUR)		hora a partir do EXIF
$(EXIF.MINUTE)		minuto a partir do EXIF
$(EXIF.SECOND)		segundo a partir do EXIF
$(EXIF.MSEC)		milissegundo a partir do EXIF
$(EXIF.DATE.REGIONAL)	data EXIF usando o formato de data regional preferido
$(EXIF.TIME.REGIONAL) 	hora EXIF usando o formato de data regional preferido
$(EXIF.ISO)		valor ISO a partir do EXIF
$(EXIF.EXPOSURE)	exposição a partir do EXIF
$(EXIF.EXPOSURE.BIAS)	compensação da exposição a partir do EXIF
$(EXIF.APERTURE)	abertura a partir do EXIF
$(EXIF.CROP_FACTOR)	fator de corte a partir do EXIF
$(EXIF.FOCAL.LENGTH)	comprimento focal a partir do EXIF
$(EXIF.FOCAL.LENGTH.EQUIV) comprimento focal equivalente a 35 mm a partir do EXIF
$(EXIF.FOCUS.DISTANCE)	distância focal a partir do EXIF
$(IMAGE.EXIF)		informações básicas de exposição a partir do EXIF (abertura, exposição, ISO)
$(LONGITUDE)		longitude
$(LATITUDE)		latitude
$(ELEVATION)		elevação
$(GPS.LOCATION)		latitude, longitude e elevação (omitindo qualquer valor não definido)
$(STARS)		classificação por estrelas (somente texto)
$(RATING.ICONS)		classificação por estrelas (usando caracteres de estrela)
$(LABELS)		etiquetas de cor (etiquetas de cor como texto)
$(LABELS.ICONS)		etiquetas de cor (etiquetas de cor como ícones)
$(MAKER)		fabricante da câmera
$(MODEL)		modelo da câmera
$(LENS)			lente
$(TITLE)		título a partir dos metadados
$(DESCRIPTION)		descrição a partir dos metadados
$(CREATOR)		criador a partir dos metadados
$(PUBLISHER)		editor a partir dos metadados
$(RIGHTS)		direitos autorais a partir dos metadados
$(TAGS)			lista de etiquetas (Xmp.dc.Subject)
$(CATEGORYn(categoria))	nome da etiqueta de nível n [0,9] da categoria selecionada (ou etiqueta)
$(SIDECAR_TXT)		conteúdo de texto do arquivo auxiliar (se houver)
$(FOLDER.PICTURES)	pasta de imagens
$(FOLDER.HOME)		pasta '/home'
$(FOLDER.DESKTOP)	pasta de área de trabalho
$(OPENCL.ACTIVATED)	se o OpenCl está ativo
$(USERNAME)		nome de usuário definido pelo sistema operacional
$(NL)			caractere de nova linha
$(JOBCODE)		código de trabalho interno do trabalho atual

🔗substituição de texto

Todas as variáveis suportam a substituição de texto básica inspirada pelo bash, ainda que alguns detalhes sejam diferentes.

Todos os padrões são tratados como simples comparações de cadeias de texto. Não há nenhum suporte a expressões regulares.

As seguintes funções de substituição de texto são fornecidas, onde var é uma das variáveis listadas acima:

$(var-default)			Se var está vazio, devolve "default"
				É possível usar outra variável como "default", por exemplo
				$(WIDTH.CROP-$(WIDTH.RAW))

$(var+alt_value)		Se var foi fixada, devolve "alt_value" caso contrário, devolve cadeia vazia

$(var:offset)			Devolve o valor de var começando pelo caractere de número "offset"
				Se offset é negativo, conta a partir do final da cadeia de caracteres

$(var:offset:comprimento)	A partir da posição de "offset", devolve o máximo de "comprimento" de caracteres de var
				Se offset é negativo o comprimento se conta a partir do final de var
				Se comprimento é negativo, isto indica o final do resultado,
				contando a partir do final de var, e não o comprimento real

$(var#padronagem)		Elimina "padronagem" do início de var

$(var%padronagem)		Elimina "padronagem" do final de var

$(var/padronagem/substituicao)	Sustitui a primeira ocorrência de "padronagem" em var com "substituicao"
				Se "substituicao" está vazio, "padronagem" é eliminado

$(var//padronagem/substituicao)	Sustitui todas as ocorrências de "padronagem" em var com "substituicao"
				Se "substituicao" está vazio, "padronagem" é eliminado

$(var/#padronagem/substituicao)	Se var começa por "padronagem" então "padronagem" é substituído com "substituicao"

$(var/%padronagem/substituicao)	Se var termina com "padronagem" então "padronagem" é substituído com "substituicao"

$(var^)				Converte o primeiro caractere de var em maiúscula

$(var^^)			Converte todos os caracteres de var em maiúsculas

$(var,)				Converte o primeiro caractere de var em minúscula

$(var,,)			Converte todos os caracteres de var em minúsculas

🔗formatação

Os padrões de informações da imagem suportam marcação. Por exemplo, adicionar o seguinte fornecerá um aviso claro (texto grande, vermelho e em negrito) quando o OpenCL falhar ao inicializar:

<span alpha='1%'>$(OPENCL_ACTIVATED/no/<span foreground='red' weight='heavy' size='xx-large' alpha='100%'>ATIVAÇÂO DO OPENCL FALHOU</span>$(NL))</span>

translations