World: r3wp

That's also how rebgui does it ...   across is default so vpanel 
2 [ .. ] is two coumns

columns

I've actually not used either, Pekr just asked for other interpretations 
- and that's how I first read Cyphre's code.


Pekr:  Elements divided by number, rounded up (with final column 
simply containing the remainder) is how I would do it...

The thing is: Either the number is like a SKIP refinement or like 
the number for LOOP

IMO SKIP is more useful as it eleminates explict NEWLINE items.

Izkata: understood, and how about the Hpanel? There you want the 
layout proposed by Pekr?

The number for rows/cols still isn't intuitive to me ("2 columns" 
or "2 rows" would be clear). As far as ordering, it would be nice 
if you could lay out your code so it "maps" visually to the layout.

That goes along with what Daniel (Iskata) is saying.

If you have V* than the number is always H and vice versa. IMO that's 
something good to remember. Otherwise source can become to chatty. 
And yes, laying out the code in the intended way is good style anyway.

Not his layout, but the idea of "I have n groups".

Aha, did not know, that RebGUI did it that way

So, if you specify an H or V mode (and mindset), then when you're 
grouping your faces, do you think in terms of a FORSKIP look or a 
SPLIT model? And what makes it easy to add a new row or col?

vpanel 1 [
	button "1"
	button "2"
	button "3"
	button "4"
	button "5"
	button "6"
]
vpanel 2 [
	button "1" button "2"
	button "3" button "4"
	button "5" button "6"
]
vpanel 3 [
	button "1" button "2" button "3"
	button "4" button "5" button "6"
]



hpanel 1 [

 button "1" button "2" button "3" button "4" button "5" button "6"
]
hpanel 2 [
	button "1" button "2" button "3" 
	button "4" button "5" button "6"
]
hpanel 3 [
	button "1" button "2" 
	button "3" button "4" 
	button "5" button "6"
]

an alternate type of grouping could be blocks of blocks:

panel [
	[button "1" button "2"]
	[button "3" button "4"]
	[button "5" button "6"]
]

not sure how useful that is.

Note, I am not saying that's what I expect, but rather it's to visualize 
how the orientation affects the order. 


Something else to think about is whether you can, or should be able 
to, invert H and V and have the layout still work.

invert H and V and have the layout still work

 - that is generally not impossible, of course, but it is against 
 the readability requirement Cyphre mentioned as his reason why he 
 proposed Hpanel and Vpanel styles instead of having panel #H panel 
 #V

In order to transpose the grid, you need to know the number of items 
in the opposite axis of the panel.

In order to be able to show the grid you need to know the number 
of items in both axes, but that is not the problem to compute

This is more a dialect design problem, i.e. what will be more "intuitive" 
for the user

I don' t know how the row/col value overrides, or avoids conflicting 
with, the width of the face, or if the parent' panel is sized as 
a layout, based on sub-faces and you can't change it. A pair! would 
have the same problem, if used to explicity state both the number 
of rows and columns.

Yes, and I think the grouping of the data in the code layout is the 
driving force there. The number tells you how many "groups" (H or 
V) and then you enter items so they are contextually related in the 
code.

A pair! has two more problems, actually:


1) it is redundant, since knowing the number of cells, and just one 
of the dimensions, you can easily compute the other one; such a data 
redundancy is, in databases, called "denormalized data" and is undesirable

2) the user frequently wants to give just one number, assuming, that 
the other is computed every time some cells are added or removed, 
thus, not wishing to give the value for both dimensions

1) Eliminating redundancy is not the same as normalization. 

2) "the user frequently wants to..." This is speculation, isn't it? 
:-) 


I could just as easily say that the normal case is that I know how 
I want my canonical grid laid out, and I may want to specify some 
cells to be empty.

the user frequently wants to...

 - that it is not a speculation, I was told by Cyphre that there are 
 at least two users frequently wanting that

And while we can say that normalization's goal is to eliminate redundancy 
in storage, we can also say that it doesn't solve the redundancy 
problem at all levels (e.g. when joining data). There are also reasons 
to denormalize. It's interesting to think about though.

specify some cells to be empty

 - the number of cells is given by specifying the graphical objects 
 in the layout; the software can count them and know the number of 
 cells; if you want to obtain "empty cells" just put in some Pads

...that there are at least two users frequently wanting that

I stand corrected. :-)

Pads - Yes, Gabriele's design had an elegant solution for this IIRC.

the last time I worked on a grid, the sizing values where autocomputed 
and shared accross rows and columns.

when one cell changed a single X or Y value, all the other cells 
of the same row or column where aware and could update on their own.

Please, keep in mind, that this discussion is not about computation! 
This is about the dialect, which must not be redundant to not allow 
to specify impossible combinations

the overall sizing algorithm took care of "collateral" effects.

but the *design* of the layout engine provides logical clues into 
how it should be expressed in terms of a dialect.

Max - Which brings up the point of what controls the size. Do the 
sub-faces control the size of the panel, or does the panel control 
the size of the sub-faces?

Ladislav - Yes.

if the system uses the whole column to resize things horizontally 
(width affecting word-wrap and thus controls height indirectly) then 
the height should be automatic.

should
 == "could"

to me a lot of this discussion resembles HTML table box model discussion... 
maybe you should look into how they solved the various issues.


for example, cells can "span", which is an elegent way to solve the 
gaps in cell data.

Yes, I think tables are key here (tbl did spanning long before HTML 
I believe :-). Do H and V panels help that much, e.g. to reduce clutter? 
I imagine the team talked about that, and whether just a TABLE would 
be enough.

Gregg: regarding the difference between Vpanel and Hpanel. Pekr wrote 
something that makes sense to me, showing how a layout should look. 
You wrote a "source code", which does not allow me to "see the look 
you want", in fact.

Do you want in Vpanel the second element to be below the first one, 
or to the right of it?

(assuming both positions are available)

My example was not to show what I want (thought I said that), but 
to show that the orientation affects how you might lay out your code, 
to group things contextually, and how that relates to making it easy 
to add new items.

Aha, so you want the layout to be always related to the source, i.e. 
the second graphic object to be to the right of the first one? (assuming 
that the position below the first one as well as the position to 
the right of the first one are both available)

I'm trying to think of a good scenario where I would use Vpanel. 
The first thing that comes to mind is a multi-column file or directory 
listing. Is there a particular need it's meant to fill?

Yes, sort of. Like switching between across and below today so I 
can group related things together in the code.

Myabe it's on my mind because I had to do some SQL recently, where 
the insert statement was one col per line, and lots of lines, followed 
by the values to insert, also one per line. :-\

Hmm, but that does not lay e.g. the multi-column listing in the expected 
order, where the second one is usually below the first one, not to 
the right of it

Yes, sorry, don't look at my example for that, look at Daniel's (Izkata). 
Mine was not done to show that.

Aha, OK, Cyphre and I were wondering...

Right now, my mind wants to say vpanel = below, hpanel= across.