|
Menu location |
---|
Drafting → Forma a partir de texto Anotação → Forma a partir de texto |
Workbenches |
Draft, BIM |
Default shortcut |
None |
Introduced in version |
0.14 |
See also |
Draft Text, Draft Label, Part Extrude |
O comando Draft ShapeString gera uma forma composta baseada em uma sequência de texto. Essa forma pode ser utilizada para criar letras em 3D utilizando o comando Part Extrude.
O comando Draft ShapeString não é adequado para criar anotações de texto padrão. Para essa finalidade, utilize os comandos Draft Text ou Draft Label.
Um único ponto é necessário para posicionar o ShapeString
Para usuários do Windows: por favor, leia primeiro o parágrafo Seleção de arquivos de fonte no Windows.
É possível especificar um caminho relativo para o arquivo de fonte. Para isso, o documento do FreeCAD deve ter sido salvo pelo menos uma vez.
Alguns exemplos:
No Windows, o acesso à pasta padrão de fontes é restrito. Isso afeta a seleção de arquivos de fonte para ShapeStrings. Há três casos no FreeCAD em que é possível especificar um arquivo de fonte para ShapeStrings: no painel de tarefas ShapeString, ao alterar a propriedade DadosArquivo de Fonte de um ShapeString e ao especificar o arquivo de fonte padrão nas Preferências da Bancada Draft.
true
, que é o valor padrão para essa preferência. Isso abrirá uma caixa de diálogo de arquivo não nativa ao pressionar o botão ... no painel de tarefas ShapeString. Com essa caixa de diálogo, é possível acessar a pasta padrão de fontes do Windows.true
. Isso instruirá o FreeCAD a sempre usar a caixa de diálogo de arquivo não nativa.C:\
; uma lista suspensa aparecerá. Selecione Windows
da lista, adicione \F
, selecione Fonts
da nova lista suspensa, adicione \
e insira as primeiras letras do arquivo de fonte para selecioná-lo na lista suspensa.Consulte o parágrafo Preferências abaixo para localizar as preferências mencionadas.
** Defina Ferramentas → Editar parâmetros... → BaseApp → Preferences → Dialog → DontUseNativeFontDialog comotrue
para usar o seletor de arquivos não nativo ao escolher um arquivo de fonte no painel de tarefas do ShapeString. ** Alternativamente, defina Ferramentas → Editar parâmetros... → BaseApp → Preferences → Dialog → DontUseNativeDialog comotrue
para sempre usar o seletor de arquivos não nativo.
Veja também: Editor de Propriedades.
Draft
File
): Nome do arquivo da fonte.Bool
): Funde as faces caso haja sobreposição entre elas, geralmente não é necessário (pode ser muito lento). Ignorado se DadosMake Face estiver false
. introduced in version 1.0Enumeration
): Alinhamento horizontal e vertical. Opções: Top-Left
, Top-Center
, Top-Right
, Middle-Left
, Middle-Center
, Middle-Right
, Bottom-Left
, Bottom-Center
, Bottom-Right
. introduced in version 1.0Enumeration
): Referência de altura usada para o alinhamento. Opções: Cap Height
, Shape Height
. A altura da forma depende dos caracteres no DadosString. introduced in version 1.0Bool
): Mantém a margem esquerda e os espaços em branco iniciais quando o alinhamento é à esquerda. introduced in version 1.0Bool
): Preenche as letras com faces.Angle
): Ângulo de inclinação. Deve estar no intervalo de -80° a +80°. introduced in version 1.0Bool
): Ajusta para garantir que a altura do topo das letras seja igual ao tamanho definido. Se configurado como false
, dependendo da fonte, a altura do topo das letras pode não corresponder exatamente ao DadosSize. introduced in version 1.0Length
): Altura do texto.String
): Sequência de texto. Um ShapeString só pode exibir uma única linha de texto.Distance
): Espaçamento entre caracteres. O tipo dessa propriedade foi atualizado (introduced in version 1.0).A altura do retângulo vermelho (linha contínua) é igual à altura do topo das letras (cap height).
A altura do retângulo verde (linha tracejada) é igual à altura da forma (shape height).
Os cantos, os pontos médios das bordas e o centro dos retângulos
correspondem às 9 opções de alinhamento: de Superior-Esquerdo a Inferior-Direito.
Veja também: Documentação de API Gerada Automaticamente e Noções Básicas de Script no FreeCAD.
Para criar um **Draft ShapeString**, utilize o método make_shapestring
(introduced in version 0.19) do módulo **Draft**. Este método substitui o método obsoleto makeShapeString
.
shapestring = make_shapestring(String, FontFile, Size=100, Tracking=0)
shapestring
usando a String
especificada e o caminho completo de um FontFile
compatível.Size
é a altura do texto resultante em milímetros.Tracking
é o espaçamento entre os caracteres em milímetros.A posição do **ShapeString** pode ser alterada sobrescrevendo seu atributo Placement
, ou individualmente sobrescrevendo os atributos Placement.Base
e Placement.Rotation
.
Exemplo:
import FreeCAD as App
import Draft
doc = App.newDocument()
font1 = "/usr/share/fonts/truetype/msttcorefonts/Arial.ttf"
font2 = "/usr/share/fonts/truetype/dejavu/DejaVuSerif.ttf"
font3 = "/usr/share/fonts/truetype/freefont/FreeSerifItalic.ttf"
S1 = Draft.make_shapestring("This is a sample text", font1, 200)
S2 = Draft.make_shapestring("Inclined text", font2, 200, 10)
zaxis = App.Vector(0, 0, 1)
p2 = App.Vector(-1000, 500, 0)
place2 = App.Placement(p2, App.Rotation(zaxis, 45))
S2.Placement = place2
S3 = Draft.make_shapestring("Upside-down text", font3, 200, 10)
S3.Placement.Base = App.Vector(0, -1000, 0)
S3.Placement.Rotation = App.Rotation(zaxis, 180)
doc.recompute()