Un CFrame, abbreviazione di Frame di Coordinate, è un tipo di dato usato per ruotare e posizionare oggetti 3D. Come proprietà di un oggetto o come unità autonoma, un CFrame contiene coordinate globali X, Y, e Z oltre ai dati di rotazione per ciascun asse. Inoltre, i CFrames contengono funzioni utili per lavorare con oggetti nello spazio 3D.
Posizionare un CFrame
Puoi creare un CFrame vuoto nella posizione predefinita di (0, 0, 0) utilizzando CFrame.new(). Per posizionare un CFrame in un punto specifico, fornisci le coordinate X, Y, e Z come argomenti a CFrame.new(). Nell'esempio seguente, la proprietà CFrame della parte redBlock cambia in newCFrame, riposizionandola a (-2, 2, 4).
In alternativa, puoi fornire una nuova posizione di Vector3 a CFrame.new() e ottenere lo stesso risultato:
Ruotare un CFrame
Per creare un CFrame ruotato, utilizza il costruttore CFrame.fromEulerAnglesXYZ(), fornendo un angolo di rotazione in radianti per gli assi desiderati. I parametri di CFrame.fromEulerAnglesXYZ() sono in radianti, non in gradi; se preferisci i gradi, usa math.rad() per convertire i gradi in radianti. Nell'esempio seguente, la parte redBlock ruota di 45 gradi in senso antiorario sul suo asse Y.
Fai puntare un CFrame verso un punto
Puoi usare CFrame.lookAt() per puntare la superficie frontale di un CFrame verso un punto specifico nel mondo. L'esempio seguente posiziona redBlock a (0, 3, 0) e punta la sua superficie frontale, contrassegnata dal cerchio bianco, verso la parte blueCube.
Offset di un CFrame
Per spostare un oggetto di un numero specifico di stud dal suo attuale posizione, aggiungi o sottrai un Vector3 a o da un nuovo CFrame nella posizione dell'oggetto. Per ottenere una posizione Vector3 formattata correttamente di un oggetto da usare con CFrame.new(), come visto qui, la sua proprietà Position (redBlock.Position) è un comodo shortcut.
Puoi usare la stessa tecnica per spostare un oggetto dalla posizione di un altro oggetto. Nell'esempio seguente, un Vector3 aggiunge a un nuovo CFrame creato nella posizione del cubo blu invece che nella posizione del blocco.
Orientamento dinamico del CFrame
I costruttori CFrame.new() e CFrame.fromEulerAnglesXYZ() riposizionano o ruotano un oggetto a un'orientazione specifica all'interno del mondo, ma a volte non puoi fare affidamento su una posizione e un angolo di rotazione fissi. Ad esempio:
- Posizionare un tesoro flottante direttamente di fronte a un giocatore che può trovarsi ovunque nel mondo, affrontando qualsiasi direzione.
- Far apparire un genio magico direttamente sopra la spalla destra di un giocatore.
In questi casi, usa i metodi di CFrame invece dei loro costruttori.
Posizione relativa
La funzione CFrame:ToWorldSpace() trasforma un CFrame di un oggetto — rispettando la sua propria orientazione locale — in una nuova orientazione mondiale. Questo la rende ideale per spostare una parte in modo relativo a se stessa o a un altro oggetto, indipendentemente da come è attualmente posizionata/ruotata.
Nell'esempio seguente, la parte redBlock si sposta di 2 stud rispetto all'asse Y del cubo blu (la freccia verde che lo attraversa) e non rispetto all'asse Y globale che punta dritto verso l'alto.
Rotazione relativa
Puoi anche usare CFrame:ToWorldSpace() per ruotare un oggetto relativamente a se stesso. Nell'esempio seguente, la parte redBlock ruota di 70 gradi in senso antiorario sull'asse Y e di 20 gradi in senso orario sull'asse Z.
Fai puntare una superficie specifica verso un punto
Puoi far puntare la parte frontale di un oggetto verso un altro oggetto fornendo un punto Vector3 come secondo parametro di CFrame.new(). Puoi anche utilizzare la rotazione relativa per fare in modo che qualsiasi superficie dell'oggetto punti verso un punto Vector3. L'esempio seguente esegue due operazioni consecutive di CFrame:
- Punta la superficie frontale, contrassegnata dal cerchio bianco, verso il bersaglio.
- Ruota il CFrame in modo che la superficie superiore, contrassegnata dal cerchio nero, punti verso il bersaglio.
Trova un punto tra i punti
Puoi usare l'interpolazione lineare, o lerp, per posizionare un CFrame tra due punti. Nell'esempio seguente, la parte redBlock si riposiziona tra le parti greenCube e cyanCube. Il valore di 0.7 la posiziona al 70% della distanza dal cubo verde.
