r3wp [groups: 83 posts: 189283]
  • Home
  • Script library
  • AltME Archive
  • Mailing list
  • Articles Index
  • Site search
 

World: r3wp

[!REBOL3 GUI]

BrianH
5-Feb-2010
[437]
What (preferrably short) word means a prototype for a collection 
of facets? Perhaps "model"?
Henrik
5-Feb-2010
[438x2]
Graham, the word list is from the prototype, so "Not documented" 
would be accurate.
These are the words for a face instance:

style:   ; WORD!   - name of the style for this face

facets:  ; OBJECT! - properties unique to this face (from style/faced)
state:   ; OBJECT! - state variables (not properties)
gob:     ; GOB!    - graphical object(s) for this face
options: ; OBJECT! - optional facet changes as specified

; NOTE: optionally extended in face creation with:
;name    ; WORD!   - reference name
;reactors; BLOCK!  - block of user actions

; PANEL faces also add:
;grid    ; OBJECT! - layout parameters and limits
;faces   ; BLOCK!  - faces of the panel:
;triggers; BLOCK!  - triggers used by panels
Graham
5-Feb-2010
[440x3]
template
mask
mold
BrianH
5-Feb-2010
[443]
Template is a good one, though it would need to be documented. Mask 
isn't quite right. Mold would be awkward because of MOLD.
Graham
5-Feb-2010
[444x3]
about: "documentationi" would be better ...
no more confusing than 'copy or 'to in parse
well, possibly more ...
Henrik
5-Feb-2010
[447]
About "Documentation" would be more misleading when reading out the 
autogenerated help for the style.
BrianH
5-Feb-2010
[448x5]
You don't assign copy or to in parse to variables - they're keywords.
It's a prototype for a style. There default documentation for a style, 
so "Not documented" makes sense.
Graham, if you called it "mold" then the word 'mold would be bound 
in that object, which would make use of the function MOLD difficult 
in code that is bound to that object.
There default -> There is no default
Oh, I get it, "faced" is short for "prototype of the face visible 
properties (facets) collection". Perhaps "ideal" (in the Platonic 
sense).
Graham
5-Feb-2010
[453x2]
The FACED block is similar to FACETS, but makes them local to each 
instance of the face. Now, they can be modified without effecting 
any other faces that are of the same CIRCLE style.
http://www.rebol.net/wiki/GUI_howto_styles
BrianH
5-Feb-2010
[455x2]
Right, I got the usage. I was just trying to find a good name.
Your "template" and "model" are the most accurate, if not specific. 
The word "ideal" would require too much explanation.
Graham
5-Feb-2010
[457x2]
they look like local variables to me ...
on-make: [

                face/facets/area-fill: span-colors get-facet face 'area-color [2.0 
                .2]
            ]

            on-resize: [ ; arg is the size
                face/gob/size: arg
                face/facets/area-size: arg - 2
                face/facets/diameter: (min arg/y arg/x) - 5 / 2
            ]
BrianH
5-Feb-2010
[459x3]
Ah, but they're not local variables. They're the prototype for local 
variables in another object.
And facets are the visible properties, not just any locals.
The faced object is the prototype - that's what I'm trying to name.
Graham
5-Feb-2010
[462x2]
their usage is not shown in this example
ok, try 'defaults
BrianH
5-Feb-2010
[464x2]
Right, I didn't realize at first that you were talking about facets. 
I thought you were talking about faced. Defaults are what the facets 
object in the style object is. The faced objects are the prototype 
of the specifics (non-defaults).
faced objects are -> faced object is
And it might not be an object, I don't remember.
Graham
5-Feb-2010
[466x2]
view/no-wait [ text-list []]
crashe if you try and use the mouse to close the window down
>> w: view [ tl: text-list []]
handler added

== make gob! [offset: 569x340 size: 142x120 alpha: 0 text: "REBOL: 
untitle

>> value? 'tl
== false

so how do you access the faces ?
Henrik
5-Feb-2010
[468x2]
that's another issue to solve.
you can access them freely from other faces in the layout.
Graham
5-Feb-2010
[470]
Yes ... 
and some are 

set-face and others are set ...
ChristianE
5-Feb-2010
[471x3]
tl: w/data/faces/1/names/tl
It's nice that face names aren't global, but hiding them like this 
a pane, I never remember the correct path.
pane = pain
BrianH
5-Feb-2010
[474]
You aren't supposed to have to remember a path - there's supposed 
to be accessors.
ChristianE
5-Feb-2010
[475]
Yes, but currently there isn't any, is it?  (I am aware of the fact 
that the GUI is barely alpha)
BrianH
5-Feb-2010
[476]
You're too generous. The GUI is pre-alpha, and wouldn't be considered 
alpha without the layout model changes Carl has said he has planned 
(but then had to take a break to work on lower-level stuff for a 
year).
Graham
5-Feb-2010
[477]
perhaps at initialization ... grab all the set words in names and 
store them in a block in the top window
BrianH
5-Feb-2010
[478]
It might not be a good idea to access these faces outside of the 
GUI code. There might be synchonization or multitasking issues.
Graham
5-Feb-2010
[479]
that's going to make separation of gui from code more difficult
BrianH
5-Feb-2010
[480]
I mean accessing data from the actions rather than from outside code. 
Using the accessors to set state.
Henrik
6-Feb-2010
[481]
One shouldn't need to access faces directly. In time, I think GET-FACE 
and SET-FACE will do this, but you might need to pass the window 
face first:

get-face window my-form


Carl already has used a /field refinement, but I'm not sure what 
it does.
Gregg
6-Feb-2010
[482]
Someone should write a software book called 'The Joy of Naming'. 


We're used to 'facets, and I don't have anything against it, but 
it's telling that description for it uses both 'attributes and 'properties. 
I don't expect it will change at this point. We all just need to 
help new users learn what it means. 


'Template doesn't sound bad. It's funny, in OOP you have the concept 
of inheritance from a parent, but I don't know of a common term used 
for the view from the other direction. 'Attributes is probably the 
most common, but you don't hear it discussed as the base classing 
passing them on.
Gabriele
6-Feb-2010
[483]
Henrik: make-gob is "complete" in the sense that it has all the features 
that were necessary for VID. I'm not sure I'd call it "finished" 
though - for example I wanted to add hinting, and a number of things 
may need improvements. Also, maybe the code can be cleaned up.
Henrik
6-Feb-2010
[484x2]
Gabriele, OK.
http://rebol.net/wiki/R3_GUI_Specs

This is not the list Carl made.
Pekr
6-Feb-2010
[486]
My take on naming - I will probably learn anything we come-up with. 
My english is pretty weak, so I am not a good measure, but I never 
ever used word FACET. I might have old brain already, but I always 
forget what it means. And I can assure you, there will be many such 
users as me. So more general naming would not hurt. It is really 
laughable, like we use special word (FACET), and then in its docced 
description to explain its meaning we use words like attributes, 
properties. So - why use FACET at all then? 


Quite contrary though, I was able to remember FACED. It sounded for 
me like sticked to the face instance :-) Anyway - I think that we 
have much more important things for the GUI to work on. And good 
docs with some diagram might be worth a thousands words ...