Params: Layout

[zhak5388]

Intro

Quelques notes introductives du 04/05/2026

Il y a deux grands problème sur le paramétrage des `Layout`:

1. Pour chacun des layouts, il y a 2/3 champs en plus. En général, ce n'est pas génant, mais avec une structure complexe, ça devient assez illisible obligeant à changer l'ordre pour garder l'information (atleast, along, atLeast)
2. Il y a un niveau d'imbraction élévé.

Pour le point 2, c'est assez difficile de casser l'emboitement sans perdre la richesse. (Ou sinon pour structure plate, turtle graphic, quelque chose en étapes, mais je n'ai pas creusé).

Pour le point 1, ça peut s'éviter en ajouter des clés qui sont des "sucres syntaxiques" pour les actions les plus courantes. L'idée est de passer des plusieurs champs (along, atLeast, atMost, concatenate) à une seule clé. Les clefs sucres cohabitent avec la forme complete (canonique).

La syntaxe pour repeat et concatenate semble être fixée après discussion.

TODO:

• Revoir FillWith

Paramétrage actuel des facades

along: x
adjust: z
concatenate:
- at: [ 0, -1..0, 0 ]
  put: *corner-material
  stretchX:
    at: 0
  stretchZ:
    at: 0
  priority: -1
- along: z
  adjust: x
  concatenate:
    - priority: 1
      along: x
      adjust: z
      concatenate:
        - atLeast: 0
          along: x
          repeat:
            axes: [ z, x ]
            blueprint: [ "-O==O", "-O**O", "-O**O", "-O**O", "-O==O", "-O--O" ]
            with : *materials
            stretchZ:
              at: 0
        - axes: [ z, x ]
          blueprint: [ "-O==O-", "-O  O-", "-O  O-", "-O  O-", "-O  O-", "-O  O-" ]
          with : *materials
          stretchZ:
            at: 0
        - along: x
          atLeast: 0
          repeat:
            axes: [ z, x ]
            blueprint: [ "O==O-", "O**O-", "O**O-", "O**O-", "O==O-", "O--O-" ]
            with: *materials
            stretchZ:
              at: 0
    - at: [ 0, 0, 0 ]
      put: *cornice-material
      stretchX:
        at: 0
    - priority: 2
      along: z
      atLeast: 0
      repeat:
        along: x
        adjust: z
        concatenate:
          - at: [ 0, 0, 0..5 ]
            put: *other-material
          - along: x
            repeat:
              axes: [ y, z, x ]
              blueprint:
                - [ "O==O+", "O**O+", "O**O+", "O**O+", "O==O+", "O--O+" ]
                - [ "     ", "     ", "     ", "|||| ", "==== ", "O  O " ]
              with : *materials
              yOffset: -1
    - at: [ 0, 0, 0 ]
      put: *cornice-material
      stretchX:
        at: 0
      stretchZ:
        at: 0
- at: [ 0, -1..0, 0 ]
  put: *corner-material
  stretchX:
    at: 0
  stretchZ:
    at: 0
  priority: -1

Paramétrage des facades après modification

adjust: z
concatenateAlongX:
# FillWith à revoir
- fillWithAlongXZ: *corner-material
  at: [ 0, -1..0, 0 ]
  priority: -1
- adjust: x
  concatenateAlongZ:
    - adjust: z
      concatenateAlongX:
        - repeatOptionallyAlongX:
            axes: [ z, x ]
            blueprint: [ "-O==O", "-O**O", "-O**O", "-O**O", "-O==O", "-O--O" ]
            with : *materials
            stretchableAtZ: 0
        - axes: [ z, x ]
          blueprint: [ "-O==O-", "-O  O-", "-O  O-", "-O  O-", "-O  O-", "-O  O-" ]
          with : *materials
          stretchableAtZ: 0
        - repeatOptionallyAlongX:
            axes: [ z, x ]
            blueprint: [ "O==O-", "O**O-", "O**O-", "O**O-", "O==O-", "O--O-" ]
            with: *materials
            stretchableAtZ: 0
    - at: [ 0, 0, 0 ]
      put: *cornice-material
      stretchableAtZ: 0 # Ou un fill
    - priority: 2
      repeatOptionallyAlongZ:
        adjust: z
        concatenateAlongX:
          - at: [ 0, 0, 0..5 ]
            put: *other-material
          - repeatAlongX:
              axes: [ y, z, x ]
              blueprint:
                - [ "O==O+", "O**O+", "O**O+", "O**O+", "O==O+", "O--O+" ]
                - [ "     ", "     ", "     ", "|||| ", "==== ", "O  O " ]
              with : *materials
    - at: [ 0, 0, 0 ]
      fillWithAlongXZ: *cornice-material
- at: [ 0, -1..0, 0 ]
  fillWithAlongXZ: *corner-material
  priority: -1

Structure à LayoutBuilder

On passe d'une Structure à un LayoutBuilder en rendant certaines zones de la structure étirable. C'est donc une structure qui possède une certaine propriété, l'usage d'un adjectif semble être le plus adapté. L'idée est d'utiliser le paramétrage de la structure et d'ajouter des champs supplementaires.

Stretchable

Forme canonique

axes: x
blueprint: "rvb"
with:
  "r": wool:red
  "v": wool:green
  "b": wool:blue
stretchable: # Optionnel
  alongX: # Optionnel
  	at: 1 # Obligatoire
  	atLeast: 2 # Défaut : 1
  	atMost: 5 # Défaut: Infini
  alongY: # Optionnel
  	at: 1 # Obligatoire
  	atLeast: 2 # Défaut : 1
  	atMost: 5 # Défaut: Infini
  alongZ: # Optionnel
  	at: 1 # Obligatoire
  	atLeast: 2 # Défaut : 1
  	atMost: 5 # Défaut: Infini

Pour les autres structures

structure:
- put: *voxel-grass
  at: [0, 0, 0]
- put: *voxel-dirt
  at: [0, 0, -3..-1]
- put: *voxel-stone
  at: [0, 0, -20..-4]
stretchable: # Optionnel
  alongX:
  	at: 1
  	atLeast: 2 # Défaut : 1
  	atMost: 5 # Défaut: Infini

put: *voxel-grass
at: [0..4, 0, 0]
stretchable: # Optionnel
  alongX:
  	at: 1
  	atLeast: 2 # Défaut : 1
  	atMost: 5 # Défaut: Infini

Formes raccourcies

axes: x
blueprint: "rvb"
with:
  "r": wool:red
  "v": wool:green
  "b": wool:blue
stretchableAtX: 1 # 1..N
stretchableAtY: 0 # 1..N
stretchableAtZ: 0 # 1..N

Notes:

• Si une autre cardinalité est voulue (2..N), cette forme raccourcie oblige l'utilisateur à revenir sur la forme canonique en modifant la clef (streatchableAtX- > streatchable).
• La forme streatchableAtXY: [1, 0] n'est pas forcement lisible

FillWith

Ca serait assez pratique d'exprimer le fait de remplir l'espace restant avec un Placeable. La syntaxe est pas encore pleinement décidée.

along: y
fillWith: Placeable
onX: -1..1
onZ: 0..1

Repeat et Concatenate

Repeat

Forme canonique

repeat: otherBuilder
along: x # Obligatoire
atLeast: 1 # Défaut: 1
atMost: 2 # Défaut: Infini

Formes raccourcies:

repeatAlongX/Y/Z : 1..N

repeatAlongX/Y/Z: otherBuilder
atLeast: 1 # Défaut: 1
atMost: 2 # Défaut: Infini

Notes:

• repeatAlongX/Y/Z = repeatAlongX ou repeatAlongY ou repeatAlongZ
• La présence des champs optionnels atLeast et atMost c'est pour permettre à l'utilisateur de changer les valeurs par défaut sans devoir revenir à la forme canonique.

repeatOptionallyAlongX/Y/Z : 0..N

repeatOptionallyAlongX/Y/Z: otherBuilder
atLeast: 0 # Défaut: 0
atMost: 2 # Défaut: Infini

Notes:

• On semble utiliser beaucoup repeat avec comme atLeast: 0, d'ou la présence de la clef repeatOptionally

Concatenate

Forme canonique

concatenate:
  - priority: 1 # Défaut: 0
    otherBuilder
  - priority: 2 # Défaut: 0
    anotherBuilder
along: y
adjust: [x, z]

Notes :

• En ayant une forme adjustAll, adjust pourrait devenir optionnel. Aussi forcant des Layout en XY, XZ, YZ, adjust pourrait être déduit. D'ici là, ce champ est obligatoire.

Forme raccourcies

concatenateAlongX/Y/Z:
  - priority: 1 # Défaut: 0
    otherBuilder
  - priority: 2 # Défaut: 0
    anotherBuilder
adjust: [x, z]

[zhak5388]

@pyrollo Il manque quelques remarques, mais le plus gros y est.

[pyrollo]

Remarques

Je suis plutôt pour garder des tags stretch...X/Y/Z car un tag stretchable ne fait qu'ajouter un niveau et un tag supplémentaire:

axes: x
blueprint: "rvb"
with:
  "r": wool:red
  "v": wool:green
  "b": wool:blue
stretchableAlongX: # Optionnel
  	at: 1 # Obligatoire
  	atLeast: 2 # Défaut : 1
  	atMost: 5 # Défaut: Infini
stretchableAlongY: # Optionnel
  	at: 1 # Obligatoire
  	atLeast: 2 # Défaut : 1
  	atMost: 5 # Défaut: Infini
stretchableAlongZ: # Optionnel
  	at: 1 # Obligatoire
  	atLeast: 2 # Défaut : 1
  	atMost: 5 # Défaut: Infini

Plan immédiat

On fait l'évident d'abord, on ne garde que les formes canoniques et on fait les raccourcis plus tard.

Renommage / verifications

stretchX -> stretchableAlongX
stretchY -> stretchableAlongY
stretchZ -> stretchableAlongZ

Reste à voir:

• adjust: Ce truc va nous embêter, il faut trouver une solution pour hériter de ce truc.

Plus tard

Les raccourcis:

• FillWith
• repeatAlong*
• repeatOptionallyAlong*
• concatenateAlong*

[pyrollo]

Stretchable et structures

Il y a un problème avec les box structures et le stretch, on peut faire un stretch sur une structure mono box mais pas multi box:

at: [ 0, -1..0, 0 ]
put: ...
stretchX:
  at: 0

En revanche, les multi boites sont des listes, impossible d'ajouter un champ:

- at: [ 0, -1..0, 0 ]
  put: ...
- at: [ 1, -1..0, 0 ]
  put: ...

[pyrollo]

Une idée est d'ajouter le tag structure:

structure:
   ...
stretchableAlongX:
  at: 0

Ce qui donne;

structure:
  - at: [ 0, -1..0, 0 ]
    put: ...
stretchableAlongX:
  at: 0

En dehors des structures, le stretch a peu de sens:

• Pattern: il faudrait autre chose (il suffit de donner les bornes sur les axes si l'on veut pouvoir utiliser les patterns)
• Voxel / Nothing : ce serait plutôt le rôle du Fill
• Liste de placeables : ?