Plugin di invio per DCC

Il plugin di invio SuperRenders è una piccola estensione all'interno del software 3D che aggiunge un menu o un pulsante di shelf "SuperRenders", in modo da poter inviare un job di rendering alla nostra render farm senza uscire dal DCC. Il plugin confeziona la scena, esegue un controllo pre-volo degli asset e della versione, e consegna il job alla coda della render farm in un unico passaggio.

La maggior parte degli utenti installa il plugin di invio dalla scheda PLUGIN di Client App: l'App rileva ciascun DCC supportato sulla workstation e installa il plugin corrispondente. Le sezioni seguenti trattano l'installazione per DCC, gli aggiornamenti, la correzione del menu mancante e come rimuovere il plugin in modo pulito.

Questa pagina tratta le funzionalità del plugin di invio, i DCC e i motori supportati, l'installazione per DCC da SuperRenders App, la procedura di aggiornamento, la correzione del menu o shelf mancante, come rimuovere il plugin in modo pulito e una matrice delle funzionalità.

Per il flusso di lavoro di invio dei job una volta installato il plugin, consultare la Guida rapida e il doc di configurazione DCC pertinente per le note specifiche del motore. Per l'installazione di Client App, consultare Client App.

Panoramica del plugin

Il plugin di invio è il companion lato DCC di Client App. Client App gestisce caricamento, monitoraggio dei job e download sul desktop; il plugin gestisce "scena → job" all'interno del DCC.

Cosa fa il plugin all'interno del DCC:

Aggiunge un menu o un pulsante di shelf SuperRenders in modo da poter avviare la finestra di dialogo di invio senza uscire dal DCC.
Legge la scena attiva — intervallo di frame, percorso di output, impostazioni di rendering, asset referenziati — e precompila il modulo del job.
Esegue un controllo degli asset pre-invio per segnalare texture mancanti, riferimenti mancanti e percorsi di file non funzionanti prima che inizi il caricamento.
Versiona il file della scena insieme ai suoi asset in modo che la render farm esegua il rendering esattamente dello stato della scena inviato, non di una modifica successiva.
Consegna il job confezionato a Client App (Client App deve essere in esecuzione; può restare nell'area di notifica o nella barra dei menu) per il caricamento.

Questa pagina documenta i plugin di invio che si installano dalla scheda PLUGIN di SuperRenders App: 3ds Max (2023 e successive), Maya (2022–2027), Cinema 4D (2023–2026), Houdini e Blender (4.2 LTS e successive). Ogni sezione DCC di seguito tratta il percorso di installazione e la copertura delle versioni.

Prima dell'installazione

Alcune cose da verificare prima di installare il plugin dall'App:

Usare lo stesso account utente che esegue il DCC. Il plugin si installa nella cartella degli script DCC dell'utente, non nella directory dei file di programma del DCC. Se si installa mentre si è connessi come utente diverso (ad esempio, un account amministratore usato solo per l'installazione del software), il plugin non apparirà quando l'utente normale apre il DCC. Accedere come l'utente che effettivamente apre il DCC e rieseguire il programma di installazione.
Avviare il DCC almeno una volta prima dell'installazione. La maggior parte dei DCC crea la cartella degli script specifica dell'utente al primo avvio. L'installazione prima che questa cartella esista fallisce silenziosamente su alcune versioni di Maya e 3ds Max.
Chiudere il DCC durante l'installazione. Lo script di avvio del plugin viene letto quando si carica il DCC. Se il DCC è in esecuzione durante l'installazione, riavviarlo dopo l'installazione affinché lo script venga acquisito.
Avere un account SuperRenders pronto. Il plugin richiede l'accesso al primo avvio.

Se lo studio utilizza un'immagine workstation bloccata in cui gli utenti non possono scrivere nella propria cartella Documenti, contattare il supporto — il plugin richiede l'accesso in scrittura alla directory degli script DCC standard.

Installazione per DCC

Per installare il plugin in qualsiasi DCC: installare Client App, aprire il pannello Plugins e fare clic su Scan to update. Client App rileva i DCC installati e inserisce il plugin corretto in ciascuno di essi. Se scan-to-update non rileva il DCC, aprire un ticket indicando la versione del DCC e il sistema operativo.

3ds Max

Il plugin per 3ds Max si installa dalla scheda PLUGIN di Client App.

Installare Client App e aprire la scheda PLUGIN.
Installare il plugin per 3ds Max. L'App lo installa in ciascuna versione di 3ds Max rilevata.
Riavviare 3ds Max se il menu SuperRenders non compare. Alcune versioni di 3ds Max rileggono le definizioni dei menu di primo livello solo all'avvio.

Copertura delle versioni di 3ds Max. La farm supporta 3ds Max dal 2013 al 2027. Il plugin che si installa dalla scheda PLUGIN di Client App copre 3ds Max 2023 e successive.

Una nota sulle versioni di PySide / Qt in 3ds Max 2026: Autodesk ha cambiato le versioni Qt nelle recenti release di 3ds Max, il che ha storicamente influenzato le GUI dei plugin. Se il menu SuperRenders compare ma la finestra di dialogo di invio si apre vuota o genera un errore Python, si prega di aprire un ticket — verificheremo se è necessaria una patch lato plugin.

Maya

Il plugin per Maya si installa dalla scheda PLUGIN di Client App in ciascuna versione di Maya rilevata, dal 2022 al 2027.

Per installare:

Installare Client App e aprire la scheda PLUGIN.
Installare il plugin per Maya. L'App lo installa in ciascuna versione di Maya rilevata.
Riavviare Maya. Lo shelf SuperRenders compare.

Copertura delle versioni di Maya. La farm supporta Maya 2014–2027. Il plugin che si installa dalla scheda PLUGIN di Client App copre Maya dal 2022 al 2027.

Cinema 4D

Il plugin per Cinema 4D si installa dalla scheda PLUGIN di SuperRenders App.

Per installare:

Installare SuperRenders Client App.
Aprire il pannello Plugins all'interno di Client App.
Fare clic su Scan to update. Client App rileva ciascuna versione di Cinema 4D installata sulla workstation e installa il plugin corrispondente nella directory dei plugin C4D.
Riavviare Cinema 4D. La voce di invio SuperRenders appare nel menu Estensioni di C4D.

Se scan-to-update riporta la versione di Cinema 4D come "non supportata", aprire un ticket con la versione C4D e il sistema operativo. Estendiamo il plugin alle nuove release di Cinema 4D su base continuativa man mano che Maxon le distribuisce.

Copertura delle versioni di Cinema 4D. Il plugin che si installa dalla scheda PLUGIN di Client App copre Cinema 4D dal 2023 al 2026. La farm stessa supporta Cinema 4D R14–2027. Per una scena Cinema 4D 2027, contattarci per confermare prima del caricamento.

Blender

Blender 4.2 LTS e successive dispone di un add-on di invio SuperRenders. Si installa dalla scheda PLUGIN di Client App. Dopo il riavvio di Blender compare un menu SuperRenders, da cui si invia la scena aperta.

Per le versioni di Blender precedenti alla 4.2, o se si preferisce non installare l'add-on, l'invio avviene tramite il flusso di caricamento drag-and-drop di Client App o tramite il pannello di controllo web. I metadati del file .blend vengono analizzati al caricamento; Client App precompila automaticamente la maggior parte dei campi di invio.

Se il menu SuperRenders non compare dopo il riavvio, verificare che la versione di Blender sia la 4.2 o successiva, quindi contattare l'assistenza indicando la versione di Blender e il sistema operativo.

Altri DCC

Anche Houdini dispone di un plugin di invio, che si installa dalla scheda PLUGIN di Client App. Per After Effects e per gli altri DCC supportati dalla render farm, il flusso di invio avviene tramite:

il pannello di controllo web (Guida rapida) — funziona per ogni DCC che la render farm renderizza,
il caricamento drag-and-drop di Client App (Client App) — funziona per ogni DCC, con i vantaggi del caricamento ripristinabile e del download automatico.

Per suggerimenti sull'invio specifici di Houdini consultare Configurare Houdini; per After Effects consultare Configurare After Effects. After Effects non dispone di un plugin di invio SuperRenders; il relativo doc di configurazione spiega come confezionare e inviare un progetto senza di esso.

Procedura di aggiornamento

SuperRenders App mantiene il plugin aggiornato automaticamente. Quando SuperRenders distribuisce un aggiornamento (una nuova versione DCC, una correzione al ri-linker degli asset), l'App recupera il nuovo plugin e propone di installarlo al prossimo avvio.

Per eseguire manualmente un aggiornamento:

Chiudere il software 3D. I DCC bloccano i file del plugin durante l'esecuzione e possono bloccare silenziosamente l'aggiornamento.
Aprire il pannello Plugins di Client App e fare clic su Scan to update. Client App confronta le versioni del plugin installate con le più recenti e installa quelle più nuove dove disponibili.
Attendere che ogni riga mostri "Up to date".
Riavviare il DCC. La nuova versione del plugin viene letta al prossimo avvio.

Se "Scan to update" fallisce per un DCC specifico, le cause usuali sono: il DCC è ancora in esecuzione e mantiene un blocco sul file; l'account utente che esegue Client App non dispone dell'autorizzazione di scrittura alla cartella degli script del DCC (eseguire Client App con lo stesso utente Windows che esegue il DCC); oppure un'installazione precedente fallita ha lasciato una cartella parziale del plugin (rimuoverla seguendo la sezione Rimozione del plugin e rieseguire la scansione).

Se Client App non riesce ad aggiornare il plugin per un DCC, rimuovere il plugin (vedere Rimozione del plugin) e rieseguire Scan to update.

Se il plugin si installa senza errori ma il menu o l'icona dello shelf SuperRenders non compare mai, la causa sottostante è quasi sempre una di queste due: il plugin è finito nella directory sbagliata, oppure uno strumento di terze parti ha corrotto le preferenze di avvio del DCC.

Causa 1 — Plugin installato nella directory degli script sbagliata.

Il plugin deve trovarsi nella cartella degli script specifica dell'utente per la versione DCC in esecuzione. Se finisce altrove — nella cartella di un'altra versione Maya, o nel profilo di un diverso utente Windows — il DCC non lo troverà all'avvio.

Verificare in Maya aprendo l'Editor di Script ed eseguendo:

text

import superrenders_runner
superrenders_runner.init()

Se la finestra di invio SuperRenders si apre, il plugin è installato correttamente e il problema dello shelf è un problema dell'interfaccia utente (Causa 2). Se si ottiene ImportError: No module named superrenders_runner, il plugin non è nel percorso Python di Maya. Rimuovere il plugin (vedere Rimozione del plugin) e installarlo di nuovo da Client App, quindi verificare:

La versione Maya nel percorso corrisponde alla Maya che si avvia (ad es. maya/2023/scripts/superrenders per Maya 2023).
L'utente Windows nel percorso corrisponde all'utente che avvia Maya.
Il percorso all'interno di userSetup.mel usa barre forward, non barre rovesciate.

La stessa logica si applica a 3ds Max e Cinema 4D — il percorso di installazione deve corrispondere all'account utente in esecuzione e alla versione DCC.

Causa 2 — Uno strumento di terze parti ha corrotto le preferenze dello shelf del DCC.

Se l'Editor di Script conferma che superrenders_runner viene importato ma l'icona dello shelf è ancora mancante, le preferenze dello shelf salvate del DCC sono solitamente corrotte — tipicamente perché un altro plugin le ha riscritte.

In Maya:

Chiudere Maya.
Individuare userPrefs.mel: - Windows: C:\Users\<NomeUtenteWindows>\Documents\maya\<VersioneMaya>\prefs\userPrefs.mel - macOS: ~/Library/Preferences/Autodesk/maya/<VersioneMaya>/prefs/userPrefs.mel
Rinominare userPrefs.mel in userPrefs.mel.backup (non eliminare — conservare i layout dello shelf personalizzati nel caso si voglia riunirli in seguito).
Riavviare Maya. Maya rigenera un userPrefs.mel nuovo e lo shelf SuperRenders dovrebbe comparire.

Si perderanno le personalizzazioni dello shelf e gli elenchi dei file recenti; riunirli dal backup se sono importanti.

In 3ds Max, la correzione equivalente è Personalizza → Ripristina layout UI di avvio, quindi reinstallare il plugin dalla scheda PLUGIN di Client App.

Se nessuna delle cause corrisponde, aprire un ticket di supporto con: nome e versione DCC, sistema operativo e account utente, il testo completo dell'errore dall'editor di script / MAXScript Listener, e il contenuto di userSetup.mel (Maya) o del log di installazione MAXScript (3ds Max).

Rimozione del plugin

Per disinstallare il plugin (per una reinstallazione pulita o per la pulizia di una workstation condivisa), la procedura è per DCC.

Maya:

Chiudere Maya.
Eliminare la cartella superrenders sotto la directory degli script di Maya: - Windows: C:\Users\<NomeUtenteWindows>\Documents\maya\<VersioneMaya>\scripts\superrenders - macOS: ~/Library/Preferences/Autodesk/maya/<VersioneMaya>/scripts/superrenders
Aprire userSetup.mel e rimuovere il blocco tra /***superrenders_begin***/ e /***superrenders_end***/. Salvare.
Riavviare Maya. Ripetere per ogni versione Maya sulla workstation.

3ds Max:

Chiudere 3ds Max.
Ripristinare l'interfaccia utente ai valori predefiniti da Personalizza → Ripristina layout UI di avvio al prossimo avvio, oppure eliminare i file macroscript SuperRenders da C:\Users\<NomeUtenteWindows>\AppData\Local\Autodesk\3dsMax\<Versione>\ENU\usermacros\ (file che iniziano con SuperRenders_).
Riavviare 3ds Max.

Cinema 4D: chiudere Cinema 4D, eliminare la cartella del plugin SuperRenders sotto la directory dei plugin C4D per quella versione C4D e riavviare Cinema 4D. Client App non espone attualmente un pulsante di disinstallazione per DCC.

Dopo la rimozione, Client App e il pannello di controllo web continuano a inviare job senza il plugin.

Matrice delle funzionalità supportate dal plugin di invio

La matrice seguente riassume le funzionalità del plugin di invio per DCC. La riga della versione riflette il plugin che oggi si installa da SuperRenders App. Le altre righe di 3ds Max, Maya e Cinema 4D provengono dagli elenchi delle funzionalità documentati per la generazione precedente del plugin (2023–2024) e non sono state riconfermate una per una per il plugin attuale. L'add-on Blender (Blender 4.2 LTS e successive) si installa dalla scheda PLUGIN di SuperRenders App e invia la scena aperta; le sue altre funzionalità non sono ancora documentate qui. Anche il plugin Houdini si installa da SuperRenders App e non è ancora coperto da questa matrice.

Funzionalità	3ds Max	Maya	Cinema 4D	Blender
Versioni DCC coperte dal plugin di invio (più ristretta dell'intervallo di supporto della farm)	2023 e successive (Client App)	2022–2027 (Client App)	2023–2026 (Client App)	4.2 LTS e successive (Client App)
Confezionamento scena all'invio	Sì	Sì	Sì	Non ancora documentato
Controllo asset pre-invio	Sì	Sì	Sì	Non ancora documentato
Ri-linker degli asset (texture tracker)	Sì	Sì	Sì (texture tracker C4D)	Non ancora documentato
Invio intervallo di frame / singolo frame / intervallo / frame selezionati	Sì	Sì	Sì	Non ancora documentato
Scene referenziate / XRef	Sì	Sì (binario .mb + ASCII .ma)	Sì (XRef, sequenze di file, texture, mappe GI)	Non ancora documentato
Output render-pass / multi-pass	Sì	Sì	Sì (main + multi-pass + render elements + AOV + buffer Corona)	Non ancora documentato
Versionamento della scena lato farm	Sì	Sì (integrazione automatica completa)	Sì (versionamento della scena lato server + controllo)	Non ancora documentato
Rendering tiled / still ad alta risoluzione	—	—	Sì (telecamera tiled C4D)	Non ancora documentato
Modalità cache GI multiple	—	—	Sì (Irradiance cache, QMC, Light Mapping, Radiosity, UHD Cache, HD Cache, Path Tracing, Light Cache, Brute Force)	Non ancora documentato
Motori supportati	V-Ray, Corona (il supporto del motore è lato farm; il plugin confeziona la scena indipendentemente)	Arnold, V-Ray, Redshift (il supporto del motore è lato farm; il plugin confeziona la scena indipendentemente)	Advanced Render, Physical, V-Ray, Corona (il supporto del motore è lato farm; il plugin confeziona la scena indipendentemente)	Il supporto del motore è lato farm; vedere Configurare Blender

La matrice traccia ciò che il plugin gestisce all'interno del DCC. Il supporto del motore lato farm (quali motori renderizzano effettivamente il job) è più ampio ed è tracciato nel doc di configurazione DCC pertinente. Il plugin confeziona la scena; il renderer (Arnold, V-Ray, Redshift, ecc.) viene eseguito lato farm.

Nota sulla versione

Client App installa il plugin per 3ds Max 2023 e successive, Maya 2022–2027, Cinema 4D 2023–2026 e Blender 4.2 LTS e successive. L'intervallo di supporto della farm è più ampio. Se si riscontra un problema del plugin su un DCC più recente, si prega di aprire un ticket; lo trattiamo come P1.

Quando il plugin non è il percorso giusto

Alcuni flussi di lavoro sono meglio serviti senza il plugin anche quando è installato e funzionante:

Invii occasionali in cui non si desidera installare nulla nel DCC. Utilizzare il pannello di controllo web.
Workstation di studio bloccate in cui gli utenti non dispongono dell'accesso in scrittura alla propria cartella degli script. Utilizzare il pannello di controllo web.
Macchine di rendering headless senza GUI per fare clic nella finestra di dialogo di invio del plugin. Utilizzare il drag-and-drop di Client App.
DCC senza un plugin di invio (ad esempio After Effects) e Blender precedente alla 4.2. Inviare tramite Client App o il pannello di controllo web.

Client App, il pannello di controllo web e il plugin di invio non si escludono a vicenda — un singolo progetto può essere caricato tramite Client App e inviato tramite plugin, oppure caricato tramite web e inviato tramite il plugin. Scegliere il percorso più adatto alla workstation.

Riferimenti incrociati

Client App — wrapper desktop per caricamento, invio e download
Guida rapida — flusso di invio da browser senza il plugin
Invio via web — dettagli sull'invio da browser
Upload e download — confronto dei metodi di caricamento
Configurare Maya — note sull'invio specifiche per Maya
Configurare 3ds Max — note sull'invio specifiche per 3ds Max
Configurare Cinema 4D — note sull'invio specifiche per Cinema 4D
Configurare Blender — invio da Blender tramite Client App / web
Errori comuni — risoluzione dei problemi tra DCC

FAQ

Q: Devo installare il plugin di invio, o posso inviare job senza di esso? A: Il plugin è opzionale. Client App e il pannello di controllo web inviano entrambi job senza un plugin DCC. Il plugin è una comodità per gli utenti che preferiscono inviare dall'interno del software 3D con un clic.

Q: Quali applicazioni 3D dispongono di un plugin di invio SuperRenders? A: I plugin che si installano dalla scheda PLUGIN di Client App coprono 3ds Max (2023 e successive), Maya, Cinema 4D, Houdini e Blender (4.2 LTS e successive). After Effects non dispone di un plugin di invio; i job da After Effects vengono inviati tramite Client App o il pannello di controllo web.

Q: Perché il menu SuperRenders non compare dopo l'installazione? A: Le cause più comuni: il plugin è finito nella cartella degli script sbagliata (spesso perché lo si è installato come utente diverso da quello che esegue il DCC), oppure le preferenze dello shelf salvate del DCC sono corrotte. Consultare la sezione Menu o shelf del plugin mancante per il flusso diagnostico completo.

Q: Come si aggiorna il plugin? A: Aprire il pannello Plugins di Client App, fare clic su "Scan to update" e riavviare il DCC. La nuova versione sovrascrive quella precedente in posizione.

Q: Il plugin funziona su Maya 2024+, 3ds Max 2025+, o l'ultima versione di Cinema 4D? A: Il plugin che si installa da Client App copre 3ds Max 2023 e successive, Maya 2022–2027 e Cinema 4D 2023–2026. La farm supporta 3ds Max 2013–2027, Maya 2014–2027 e Cinema 4D R14–2027. Per una scena Cinema 4D 2027, contattarci per confermare prima del caricamento. Aprire un ticket se si riscontra un problema su un DCC più recente; lo trattiamo come P1.

Q: Posso installare il plugin senza installare Client App? A: No. I plugin di invio si installano dalla scheda PLUGIN di Client App. Se si preferisce non installare l'App, inviare i job tramite il pannello di controllo web, che funziona per ogni DCC che la render farm renderizza.

Q: Il plugin si apre ma l'invio fallisce. Dove cerco? A: Gli errori al momento dell'invio di solito significano che la scena è stata confezionata correttamente ma la render farm ha rifiutato qualcosa — un asset mancante, una versione del renderer / motore non supportata dalla farm, o un problema di fatturazione dell'account. Verificare il testo dell'errore rispetto agli Errori comuni. Se il messaggio non è elencato, aprire un ticket con il testo dell'errore e l'ID del job.

---