Q&A (internal)

>Q001: Surface object: how do you check that all point lay on single plane?

We don't -- for all geometric transformation, we use the first 3 points of the surface to determine its plane and its local axis. All transformations are done using this information. I am not entirely sure what happens if the surface is not on a plane. You should try and see. :-)

>Q002: Surface object: What is direction of surface thickness?

The local x axis of the surface is from first point to second point. Z axis is normal to the plane of the surface. Thickness is extruded in positive local z direction.

>Q003: How do you check that XML (ParamML) is correct? Do you have XSD scheme?

We do not use XSD. This is the third generation system, we did use XML validation in previous versions (http://openbrim.org/). In version 3, we perform general syntactical XML validation (and this is not strict at all). For more detailed validation, we use what we call object description files. I am attaching a sample file (see attached to this page) that is deployed with STARK. This document contains documentation and structural information on objects. On STARK, under BrIM view, if you click on Help -- it displays the attached object description file. So we use this file for validation (loosely at this point as parameters and objects change during development), for documentation and also STARK app Object explorer makes use of this file so author's can work with ParamML without doing XML coding.

>Q004: Is it equvalent strings: T="Expr"?, T=" Expr", T=" Expr", T=" Expr " (space symbols)

There was no particular specification for this. I am not sure how it got implemented. I have a feeling that they are not equivalent -- though I am not sure if it would cause any problems because if the type of the parameter is unknown, it is automatically taken as Expr. That is because we like to take shortcuts sometime and define the parameter of the object as attribute on the object's node.

For example, <O T="Point" X="10" /> is actually a syntactical sugar for:

<O T="Point">

<P N="X" V="10" T="Expr" />

</O>

>Q005: As I see I can use right panel "Object" to examine model ParamML structure. How can I check and edit "Guard" parameter?

You can't at this point -- only through XML. But please make a enhancement request on https://bitbucket.org/redrepo/stark/issues so you would know when it is implemented.

>Q006: Is it necessary to inform about bugs (things looks similar to bug)? Is it any instruction about bug reporting? (for example: if I will open left panel (with Model, CADD, Asstes, Brim) and then will open Right params panel, then first panel will overlap second panel. I can add screenshoot)

Yes, all bugs, improvement requests and ideas should be posted on https://bitbucket.org/redrepo/stark/issues

>Q007: I've passed and check in BRiM all samples from StarkPlatformDevelopment.pdf - except last (check sample01.txt). It's say on "Import" button: "TypeError: undefined is not a function"

What's wrong with XML?

I tried the text file you sent and it seems to work. Which browser are you using? Here is the link to the project I made -- let me know if it does not work for you. http://stark.red/objidce99xpl4j8ht1hz0bq3ihpp3c8.stark?edt=1

I was tried it again in empty project and it's ok now.

It's strange, but currently it's work on my project too (and I'm using Chrome browser)

>Q008: Wil you create account for me on https://bitbucket.org/ for adding and comment issues? (bugs, e.t.c)