Aquesta és una revisió antiga del document

---

libGDX : Viewport i resolucions

Referències: jocs_libgdx

libGDX és multiplataforma i podrem compilar el mateix codi per a diferents dispositius. És un gran avantatge però ens planteja un problema: la resolució de les pantalles pot ser diferent en cada dispositiu.

De forma nadiua libGDX treballa en píxels, però no ho podem fer així si volem obtenir el mateix resultat en diferents dispositius. Necessitarem unes «coordenades virtuals» i que després es tradueixi a cada plataforma (i dispositiu) adientment.

Per a aquest propòsit disposem de 2 eines fonamentals: Viewport i OrtographicCamera. En anteriors versions variava una mica la configuració d'aquests objectes. Ara, la OrtographicCamera ja va dintre del Viewport, i això ens facilita la tasca.

Hi ha diferents tipus de Viewports. Farem l'exemple bàsic amb FitViewport, que manté la relació d'aspecte entre els diferents dispositius omplint amb fons negre les parts que excedeixin per tal d'acomplir aquesta relació d'aspecte.

Configuració Viewport bàsica

El codi mínim que ens quedaria per a una aplicació amb FitViewport seria la següent, amb una configuració d'aspecte de 8×5 unitats d'amplada per alçada. Aquestes «unitats» les podríem considerar «metres», però és una «resolució virtual» que ens convé a nosaltres. En altres ocasions podrien ser kilòmetres, per exemple si mostréssim un mapa.

Al ser unitats divisibles caldrà emprar floats, i no integers com es podria fer servir pels píxels.

Joc.java

// Exemple amb ApplicationAdapter, però podria ser una Screen
public class Joc extends ApplicationAdapter {
    private SpriteBatch batch;
    public FitViewport viewport;
 
    @Override
    public void create() {
        batch = new SpriteBatch();
        viewport = new FitViewport(8, 5); // 8x5 unitats (amplada x alçada)
    }
 
    @Override
    public void render() {
        // pintem background de color
        ScreenUtils.clear(0.15f, 0.15f, 0.2f, 1f);
        // PUNT CLAU: ajustem càmera per traduir resolucions quan pintem
        viewport.apply();
        batch.setProjectionMatrix(viewport.getCamera().combined);
        // pintem!
        batch.begin();
        //...
        batch.end();
    }
 
    // SUPER IMPORTANT, sense resize no funciona el Viewport
    // és un error típic oblidar aquest mètode, esteu avisats
    @Override
    public void resize(int width, int height) {
        viewport.update(width, height, true);
    }
 
    @Override
    public void dispose() {
        batch.dispose();
        font.dispose();
    }
}

Desktop

Si volem que la pantalla de l'aplicació Desktop coincideixi amb la relació d'aspecte definit al joc, convindrà redefinir-la a l'arxiu Lwjgl3Launcher.java:

Lwjgl3Launcher.java

public class Lwjgl3Launcher {
    // ...
    private static Lwjgl3ApplicationConfiguration getDefaultConfiguration() {
        // ...
 
        // configurem 800x500 px però podria ser altra resolució que compleixi amb la relació d'aspecte
        configuration.setWindowedMode(800, 500);
        // ...
    }
}