Tipi di parametri Job

Ogni voce nell'parameterDefinitionselenco di un modello di lavoro dichiara un parametro di lavoro. Ogni parametro ha un name e a type e può avere a descriptiondefault, a e un userInterface blocco con a labelgroupLabel, a e acontrol. Il tipo determina quali valori il parametro accetta, quali campi di vincoli supporta e quali controlli vengono visualizzati nella finestra di dialogo di invio per impostazione predefinita. Un modello si riferisce al valore come. {{Param.Name}} I tipi sono i seguenti.

Alcuni tipi fanno parte della specifica Open Job Description di base. Gli altri vengono aggiunti dall'EXPRestensione e un modello che li utilizza deve essere elencato EXPR nella suaextensions. Per la definizione campo per campo di ogni tipo, consultate le definizioni dei parametri di lavoro Open Job Description sul sito Web. GitHub

INT

Un numero intero, come numero o stringa numerica. Vincoli:,,. allowedValues minValue maxValue Controllo: SPIN_BOX o DROPDOWN_LIST quando allowedValues è impostato.

FLOAT

Un numero, come numero o stringa numerica. Vincoli:allowedValues,,. minValue maxValue Controllo: SPIN_BOX o DROPDOWN_LIST quando allowedValues è impostato. Il decimals campo imposta il numero di cifre decimali modificabili.

STRING

Una stringa. Vincoli:allowedValues,,minLength. maxLength Controllo: LINE_EDIT o DROPDOWN_LIST quando allowedValues è impostato. Accetta ancheMULTILINE_EDIT, e CHECK_BOX quando ne allowedValues tiene in mano, una true/false coppia come["true", "false"].

PATH

Un percorso di file o directory. Le regole di mappatura dei percorsi vengono applicate al valore sul lavoratore. Vincoli:allowedValues,,,minLength,maxLength. objectType dataFlow Controllo:CHOOSE_INPUT_FILE, o CHOOSE_OUTPUT_FILECHOOSE_DIRECTORY, a seconda objectType di e. dataFlow

BOOL(richiedeEXPR)

trueoppurefalse; i numeri 1 o0; o le stringhetrue,,,yes,on,1, false nooff, 0 in qualsiasi lettera maiuscola. Nessun vincolo. Controllo:. CHECK_BOX

RANGE_EXPR(richiedeEXPR)

Un'espressione di intervallo intero come "1-100""1-100:10", o"1,3,5-9". Vincoli:,. minLength maxLength Controllo:. LINE_EDIT

LIST[STRING](richiedeEXPR)

Un elenco di stringhe. Vincoli: minLength e maxLength per l'elenco;item.allowedValues,item.minLength, e item.maxLength per ogni elemento. Controllo:. LINE_EDIT_LIST

LIST[PATH](richiedeEXPR)

Un elenco di percorsi. Le regole di mappatura dei percorsi vengono applicate a ciascun valore. Vincoli: i vincoli di elenco e elemento di, plus e. LIST[STRING] objectType dataFlow Controllo:CHOOSE_INPUT_FILE_LIST, o CHOOSE_OUTPUT_FILE_LISTCHOOSE_DIRECTORY_LIST, a seconda di and. objectType dataFlow

LIST[INT], LIST[FLOAT] (richiedeEXPR)

Un elenco di numeri. Vincoli: minLength e maxLength per l'elenco;item.allowedValues,item.minValue, e item.maxValue per ogni elemento. Controllo:. SPIN_BOX_LIST

LIST[BOOL](richiedeEXPR)

Un elenco di valori booleani, ognuno dei quali accetta gli stessi valori di. BOOL Vincoli:,. minLength maxLength Controllo:. CHECK_BOX_LIST

LIST[LIST[INT]](richiedeEXPR)

Un elenco di elenchi di numeri interi, per input strutturati come un elenco di adiacenze. Vincoli: vincoli annidati. item Controllo: HIDDEN non esiste un controllo visivo per questo tipo.

Ogni tipo accetta anche HIDDEN come controllo, il che mantiene il parametro fuori dalla finestra di dialogo di invio. Impostato HIDDEN per i valori che una pipeline fornisce a livello di codice.

I LIST[PATH] tipi PATH and contengono due campi aggiuntivi. objectTypeè FILE oDIRECTORY, ed dataFlow è INOUT,INOUT, oNONE. Gli allegati Job leggono questi campi per decidere quali percorsi caricare come input e quali controllare per gli output. Un PATH parametro supporta anche fileFilters e fileFilterDefault per la finestra di dialogo dei file. Per ulteriori informazioni, consulta Elementi del modello di lavoro per i pacchetti di lavoro.

Le seguenti definizioni mostrano una casella di controllo, un intervallo di fotogrammi, un elenco di nomi di telecamere e un elenco di file di input. Il modello elenca EXPR perché gli ultimi quattro tipi lo richiedono.

specificationVersion: 'jobtemplate-2023-09'
extensions:
  - EXPR
parameterDefinitions:
  - name: Samples
    type: INT
    default: 64
    minValue: 1
    maxValue: 4096
  - name: UseGpu
    type: BOOL
    default: false
    userInterface:
      label: Render on GPU
  - name: Frames
    type: RANGE_EXPR
    default: "1-100"
    userInterface:
      label: Frame Range
  - name: Cameras
    type: LIST[STRING]
    default: ["main", "closeup"]
    minLength: 1
    userInterface:
      label: Cameras to Render
  - name: Textures
    type: LIST[PATH]
    objectType: FILE
    dataFlow: IN
    default: []

In un modello con EXPR estensione, ogni parametro ha un tipo di espressione corrispondente: intfloat,string,path,bool,range_expr, olist[T]. Un parametro RANGE_EXPR o list può appartenere direttamente a un parametro range di attività, in modo che ogni frame o elemento diventi un'attività. For PATH andLIST[PATH], RawParam.Name è il valore inviato, come stringa, prima della mappatura del percorso.

steps:
  - name: Render
    parameterSpace:
      taskParameterDefinitions:
        - name: Camera
          type: STRING
          range: "{{Param.Cameras}}"
        - name: Frame
          type: INT
          range: "{{Param.Frames}}"
    script:
      actions:
        onRun:
          command: render
          args:
            - "--camera"
            - "{{Task.Param.Camera}}"
            - "--frame"
            - "{{Task.Param.Frame}}"
            - "--samples"
            - "{{Param.Samples}}"
            - "{{ '--gpu' if Param.UseGpu else null }}"
            - "{{ ['--textures', Param.Textures.join(',')] if len(Param.Textures) > 0 else null }}"

Gli ultimi due argomenti sono espressioni. Un null risultato non aggiunge alcun argomento e un risultato di elenco aggiunge ogni elemento come argomento separato. Per ulteriori informazioni, consulta Espressioni nei modelli di lavoro.

Per inviare un pacchetto di lavori che utilizza i tipi di EXPR parametri, la CLI di Deadline Cloud e la finestra di dialogo di invio e il monitor Deadline Cloud devono essere una versione che supporti l'estensione. deadline bundle gui-submit I clienti più anziani rifiutano i modelli con questi tipi.