impaginazione

- impaginazione del codice sorgente
- correzioni generali
This commit is contained in:
Raffaele Mignone 2019-01-17 15:36:23 +01:00
parent 471e296ef3
commit a41ac06658
Signed by: norangebit
GPG Key ID: 4B9DF72AB9508845

View File

@ -1,6 +1,6 @@
## Runtime building models ## Runtime building models
Lo scopo di questo progetto è mostrare come sia possibile costruire dei semplici modelli tridimensionali senza dover ricorrere ad asset pre costruiti. Lo scopo di questo progetto è mostrare come sia possibile costruire dei semplici modelli tridimensionali senza dover ricorrere ad asset pre costituiti.
L'SDK di Sceneform fornisce due classi per adempiere a questo compito: L'SDK di Sceneform fornisce due classi per adempiere a questo compito:
@ -8,7 +8,7 @@ L'SDK di Sceneform fornisce due classi per adempiere a questo compito:
- `MaterialShape`: consente di creare delle semplici forme geometriche come cilindri, sfere e cuboidi. - `MaterialShape`: consente di creare delle semplici forme geometriche come cilindri, sfere e cuboidi.
Nel caso specifico è stata realizzata un'applicazione che in seguito al tocco dell'utente renderizza nella scena un oggetto dalla forma e dal colore *pseudo-casuali*. Nel caso specifico è stata realizzata un'applicazione che in seguito al tocco dell'utente renderizza nella scena un oggetto dalla forma e dal colore *pseudo-casuali*.
Inoltre è stato aggiunto un ulteriore elemento di interazione con l'utente, che gli consente di cliccare anche sull'oggetto renderizzato, al fine di cambiare la tinta di quest'ultimo. Inoltre è stato aggiunto un ulteriore elemento di interazione con l'utente, che gli consente di cliccare sull'oggetto renderizzato, al fine di cambiare la tinta di quest'ultimo.
### Interazione con l'utente ### Interazione con l'utente
@ -16,16 +16,20 @@ Anche in questo caso l'interazione con l'utente è gestita mediante il metodo `s
```kotlin ```kotlin
override fun onCreate(savedInstanceState: Bundle?) { override fun onCreate(savedInstanceState: Bundle?) {
//... // ...
arFragment.setOnTapArPlaneListener(this::addModel) arFragment.setOnTapArPlaneListener(this::addModel)
//... // ...
} }
``` ```
Dove la funzione `addModel` si occupa della creazione del materiale e della forma e infine dell'aggiunta del modello alla scena. Dove la funzione `addModel` si occupa della creazione del materiale e della forma e infine dell'aggiunta del modello alla scena.
```kotlin ```kotlin
private fun addModel(hitResult: HitResult, plane: Plane, motionEvent: MotionEvent) { private fun addModel(
hitResult: HitResult,
plane: Plane,
motionEvent: MotionEvent
) {
val color = generateColor() val color = generateColor()
buildMaterial(this, color) { buildMaterial(this, color) {
@ -48,7 +52,7 @@ private fun addModel(hitResult: HitResult, plane: Plane, motionEvent: MotionEven
### Creazione del materiale ### Creazione del materiale
La creazione del materiale avviene mediante la funzione `buildMaterial` che a sua volta richiama la funzione di libreria ` MaterialFactory.makeOpaqueWithColor`. La creazione del materiale avviene mediante la funzione `buildMaterial` che a sua volta richiama la funzione di libreria ` MaterialFactory .makeOpaqueWithColor`.
Come già visto in precedenza, la soluzione adottata da Sceneform per interagire con oggetti *pesanti* è una callback che nel caso specifico può essere specificata mediante il parametro `onSuccess`. Come già visto in precedenza, la soluzione adottata da Sceneform per interagire con oggetti *pesanti* è una callback che nel caso specifico può essere specificata mediante il parametro `onSuccess`.
@ -76,7 +80,8 @@ fun buildShape(
val center = Vector3(0.0f, 0.0f, 0.0f) val center = Vector3(0.0f, 0.0f, 0.0f)
return when (shape) { return when (shape) {
Shape.CUBE -> ShapeFactory Shape.CUBE -> ShapeFactory
.makeCube(Vector3(0.2f, 0.2f, 0.2f), center, material) .makeCube(Vector3(0.2f, 0.2f, 0.2f),
center, material)
Shape.CYLINDER -> ShapeFactory Shape.CYLINDER -> ShapeFactory
.makeCylinder(0.1f, 0.2f, center, material) .makeCylinder(0.1f, 0.2f, center, material)
Shape.SPHERE -> ShapeFactory Shape.SPHERE -> ShapeFactory
@ -89,7 +94,7 @@ Come è possibile notare a seconda della figura, vanno specificate le caratteris
### Aggiunta del nodo alla scena ### Aggiunta del nodo alla scena
L'aggiunta del nodo alla scena avviene mediante la funzione `addTransformableNodeToScene` che presenta il medesimo comportamento visto nei precedenti progetti, con l'unica differenza del valore di ritorno. L'aggiunta di un nuovo nodo alla scena avviene mediante la funzione `addTransformableNodeToScene` che presenta il medesimo comportamento visto nei precedenti progetti, con l'unica differenza del valore di ritorno.
Infatti se prima veniva restituito un'`Unit`[^unit] in questo caso viene restituito un oggetto di tipo `Node`. Infatti se prima veniva restituito un'`Unit`[^unit] in questo caso viene restituito un oggetto di tipo `Node`.
Questa modifica si rende necessaria per poter aggiungere al nodo un listener sull'evento di tocco. Questa modifica si rende necessaria per poter aggiungere al nodo un listener sull'evento di tocco.
@ -107,7 +112,7 @@ fun changeColorOfMaterial(
} }
``` ```
Quest'ultima si occupa di creare un nuovo materiale e sostituirlo a quello precedente. Quest'ultima funzione si occupa di creare un nuovo materiale e sostituirlo a quello precedente.
[^texture]: In ambito grafico con il termine *texture* si è soliti indicare una qualità visiva che si ripete mediante un pattern ben definito. [^texture]: In ambito grafico con il termine *texture* si è soliti indicare una qualità visiva che si ripete mediante un pattern ben definito.