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.

Anteckning

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.

Tillgänglig i alla sökvägar som stöder malluttryck:

blend_name:

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

blend_dir:

Ställer in filsökvägen så att den är relativ till den aktuella öppnade blend-filen.

blend_name_lib:

Som blend_name, förutom att för sökvägsegenskaper på bibliotekslänkade datablock kommer det att vara namnet på den biblioteksblandningsfil som datablocket kommer från.

blend_dir_lib:

Som blend_dir, förutom att för sökvägsegenskaper på bibliotekslänkade datablock kommer det att vara sökvägen till den biblioteksblandningsfil som datablocket kommer från.

Endast tillgänglig i renderoutputsökvägar (inklusive i compositorns File Output-nod):

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.

scene_name:

Namnet på målbenet.

camera_name:

Name of the current render camera.

Endast tillgängligt i egenskaper för sökväg på en nod:

node_name:

Namnet på det objekt som kroken pekar på.

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:

../_images/files_file_paths-invalid_path_template.png

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:

../_images/files_file_paths-invalid_path_template_tooltip.png

Anteckning

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.