Sökvägar för filer

Sökvägsmallar

Sökvägsmallar ersätter malluttryck (skrivna {abcd}, där ”abcd” är ett variabelnamn) i en filväg när sökvägen används.

Till exempel, om den aktuella öppna blandningsfilen är dance.blend och sökvägen för renderingsutdata är inställd på detta:

//my_render_dir/{blend_name}.png

Vid rendering kommer Blender sedan att behandla sökvägen som:

//my_render_dir/dance.png

Med {blend_name} som ersätts av dance från dance.blend.

Denna substitution sker internt vid användningstillfället (t.ex. vid rendering), så mallsyntaxen kommer att förbli oförändrad i sökvägsfältet.

Observera

För närvarande stöds sökvägsmallar endast för render output path i Scene properties och utdatasökvägarna i compositorns File Output node. Fler filsökvägar kommer att stödja mallar i framtida versioner.

Tillgängliga variabler

Följande variabler är för närvarande tillgängliga i malluttryck:

blend_name:

Namnet på den aktuella blendfilen (utan .blend).

fps:

Antal bilder per sekund för den aktuella scenen.

resolution_x / resolution_y:

Den återgivna bildens x- och y-upplösning. Detta tar även hänsyn till upplösningsskalan, så om scenupplösningen är 1000x600 och skalan är 50%, kommer resolution_x och resolution_y att vara 500 respektive 300.

Uppsättningen av tillgängliga variabler kommer att utökas med tiden.

Syntax

Ett grundläggande malluttryck omsluter helt enkelt ett variabelnamn med hakparenteser:

dance_{fps}.png

Format: ASCII

Malluttryck kan också innehålla en formatspecifikator. Formatangivelser instruerar Blender hur det ersatta värdet ska formateras. De skrivs efter ett avskiljande kolon, så här:

dance_{fps:FORMAT}.png

Formatangivelser kan för närvarande endast användas med variabler som representerar numeriska värden, inte strängvärden. De tillgängliga formatspecificerarna är:

• dance_{fps:###}.png: formatera som ett heltal med minst 3 siffror.

• dance_{fps:.###}.png: formatera som ett flyttal med exakt 3 siffror efter decimaltecknet.

• dance_{fps:###.##}.png: formatera som ett flyttal med minst 3 siffror för heltalsdelen och exakt 2 siffror för bråkdelen.

I samtliga fall anger antalet hashsymboler (#) det önskade antalet siffror.

Till exempel, om fps är 29.97, då:

• dance_{fps:###}.png -> dance_030.png

• dance_{fps:.###}.png -> dance_29.970.png

• dans_{fps:###.##}.png -> -> dans_029.97.png

Observera att värdena är korrekt avrundade för det angivna antalet siffror.

Om ingen formatspecifikation anges används standardformatering för den namngivna variabeln (t.ex. flyttal för fps, heltal för upplösning).

Escape-sekvenser

Eftersom { och } används för malluttryck i sökvägar som stöder dem, måste de undantas genom att skrivas dubbelt när en bokstavlig { eller } önskas i en sådan sökväg:

• {{ översätts till en enda { i den slutliga sökvägen.

• }} översätts till en enda } i den slutliga sökvägen.

Till exempel:

• my_weird}}_{{path.png -> my_weird}_{path.png

• //my_render_{{dir}}/{blend_name}.png -> //my_render_{dir}/dance.png

• //my_render_dir/{{{blend_name}}}.png -> //my_render_dir/{dance}.png

Fel

Sökvägar som stöder mallar kan ha mallfel, vilket hindrar sökvägen från att bearbetas.

Till exempel i följande sökväg:

//my_render_dir/{blend_name.png

Uttrycket {blend_name är inte korrekt avslutat, vilket kommer att resultera i ett fel.

När det finns mallfel i en sökväg markeras fältet för sökvägen med rött i användargränssnittet:

Om du håller muspekaren över sökvägsfältet visas ett verktygstips som innehåller en lista över de mallfel som har påträffats för den sökvägen:

Observera

Beroende på sökvägen kan mallfel förhindra vissa åtgärder. Om det t.ex. finns fel i sökvägen för rendering av utdata kommer renderingen av en animation att misslyckas med ett felmeddelande som anger sökvägsfelen.