Skip to end of metadata
Go to start of metadata

You are viewing an old version of this content. View the current version.

Compare with Current View Version History

« Previous Version 5 Next »

A "Document" Object is a type of object that generates a printable report that includes information about the project.

Parameters of Document Object:

Label

 Mandatory

 Description

 Example

1

 Title

Yes

 Title of the Document / Project.

Title="Column"

Title="Project Report"

The sub-components of the Document object will be displayed.

1)DocSection Object:

It breaks down the document into different sections, and also includes a sidebar that provides links to other sections within the document for easier navigation.

Example:

 ...
 ...
    <O T="Document" Title="Document Example">
        <O T="DocSection" Title="Introduction ">
            <O T="DocText">
                Width |width|, height |height| This is an example of a text description for an object created using a ParamML parametric language
            </O>
        </O>
        <O T="DocSection" Title="3D Model ">
            <O T="DocText">
                <![CDATA[
            --md
                In this section of the document, a visual representation of the 3D object will be provided.
            ]]>
            </O>
            <O T="Doc3D" Width="600" Height="300">
                <P N="Obj3D" V="Vol" />
            </O>
        </O>
...
...

Parameters of DocSection Object:

Label

 Mandatory

 Description

 Example

1

 Title

Yes

 Title of the specified Document Section.

Title="Graph"

Title="3D Model"

2)DocText Object

The text contained within this object is displayed in the designated section as paragraphs.

To begin, the text should be typed in Markdown format (--md). All subsequent text should be aligned with --md.

Example:

 ...
 ...

        <O T="DocSection" Title="3D Model ">
            <O T="DocText">
                <![CDATA[
            --md
                In this section of the document, a visual representation of the 3D object will be provided.
            ]]>
            </O>
            <O T="Doc3D" Width="600" Height="300">
                <P N="Obj3D" V="Vol" />
            </O>
        </O>
...
...

Header Size: The size of the header is determined by the number of hash symbols (#) used. One hash symbol (#) is used for the largest heading, while six hash symbols (######) are used for the smallest heading. The more hash symbols used, the smaller the header size will be.

Heading Size: The size of the heading is determined by the use of equal signs (=) and hyphens (-). Equal signs result in larger text compared to hyphens. To create a heading, place either a hyphen or an equal sign beneath the text.

Printing with a Different Color (Emphasis): Text enclosed within grave accents ( ) will be highlighted in a different color.

Font Style (Italic): Text enclosed within asterisks (* *) will be displayed in italic style.

Font Style (Bold): Text enclosed within two asterisks (** **) will be displayed in bold.

Table: Table headings are enclosed within vertical slashes ( | | ). The position of the columns in the table is determined by the use of colons ( : ) placed between the vertical slashes. If two dots are placed next to the left vertical slash, the text in that column will be aligned to the left. The opposite is true for alignment to the right. If two dots are placed next to both the left and right vertical slashes, the text will be centered within the column. The text within the vertical slashes will be displayed in the table in the same order.

Reading a Value from a Parameter: When a value is enclosed within vertical slashes ( |d| ) in the code, it is treated as a parameter.

Striking Text: Text enclosed within two tildes (~~ ~~) will be crossed out.

Creating a CheckBox: A checkbox can be created by leaving a space after one hyphen, followed by square brackets with spaces inside. If there is a space within the brackets, the checkbox will be unselected. If an "x" is used instead of a space, the checkbox will be selected.

Creating a Code Block: Text enclosed within three grave accents ( ) will be displayed as a code block.

Creating Emoji: Emojis can be created by enclosing the emoji name within two colons (:smile:).

Creating an Image: An image can be created by typing "![Logo]", followed by the image link within parentheses and the hover text within double quotation marks (" ") after the link.

Example:

Example:

<O N="DocumentObject1" T="Project" Category="Document Object" TransAlignRule="Right">
    <!-- created by ParamML Examples on 09.02.2023 -->
    <P N="width" V="20" Role="Input" />
    <P N="height" V="10" Role="Input" />
    <O N="Vol" T="Volume" Z="height" Opacity="0.9">
        <O N="surface1" T="Surface" Z="0">
            <O T="Point" X="width" Y="-width" />
            <O T="Point" X="width" Y="width" />
            <O T="Point" X="-width" Y="width" />
            <O T="Point" X="-width" Y="-width" />
        </O>
        <O N="surface2" T="Surface" Z="height">
            <O T="Point" X="width/2" Y="-width/2" />
            <O T="Point" X="width/2" Y="width/2" />
            <O T="Point" X="-width/2" Y="width/2" />
            <O T="Point" X="-width/2" Y="-width/2" />
        </O>
    </O>
    <O N="BottomSection" T="CADD" RZ="PI/2">
        <O T="CADDShape">
            <O T="Point" X="width" Y="-width" />
            <O T="Point" X="width" Y="width" />
            <O T="Point" X="-width" Y="width" />
            <O T="Point" X="-width" Y="-width" />
        </O>
    </O>
    <O N="TopSection" T="CADD" DisplayWidth="1">
        <O T="CADDShape">
            <O T="Point" X="width/2" Y="-width/2" />
            <O T="Point" X="width/2" Y="width/2" />
            <O T="Point" X="-width/2" Y="width/2" />
            <O T="Point" X="-width/2" Y="-width/2" />
        </O>
    </O>
    <O T="Document" Title="Document Example">
        <O T="DocSection" Title="Introduction ">
            <O T="DocText">
                Width |width|, height |height| This is an example of a text description for an object created using a ParamML parametric language
            </O>
        </O>
        <O T="DocSection" Title="3D Model ">
            <O T="DocText">
                <![CDATA[
            --md
                In this section of the document, a visual representation of the 3D object will be provided.
            ]]>
            </O>
            <O T="Doc3D" Width="600" Height="300">
                <P N="Obj3D" V="Vol" />
            </O>
        </O>
        <O T="DocSection" Title="CADD Drawing ">
            <O T="DocText">
                In this section of the document, a visual representation section of the 2D object will be provided.
            </O>
            <O T="DocText">
                Top Section
            </O>
            <O T="DocCADD" Width="400" Height="300">
                <P N="CADD" V="TopSection" T="CADD" />
            </O>
            <O T="DocText">
                Bottom Section
            </O>
            <O T="DocCADD" Width="400" Height="300">
                <P N="CADD" V="BottomSection" T="CADD" />
            </O>
        </O>
        <O T="DocSection" Title="ParamML Code ">
            <O T="DocCode" Width="300" Height="400">
                n="Vol" t="Volume" z="height" opacity="0.9">
                <o t="Point" x="-width/2" y="width/2">
                    <o t="Point" x="-width/2" y="-width/2">
                    </o>
                </o>
            </O>
        </O>
        <O T="DocSection" Title="Picture ">
            <O T="DocImage" Image="" />
        </O>
        <O T="DocSection" Title="Inputs">
            <O T="DocInput" Param="width" />
            <O T="DocInput" Param="height" />
        </O>
        <O T="DocSection" Title="28 days Concrete strength ">
            <O T="DocTable">
                <O T="DocRow">
                    <O T="DocCell">
                        concrete grade
                    </O>
                    <O T="DocCell">
                        Typical Compressive Strength fck (MPa)
                    </O>
                    <O T="DocCell">
                        Typical Axial Tension Strength fctk (MPa)
                    </O>
                </O>
                <O T="DocRow">
                    <O T="DocCell">
                        C16/20
                    </O>
                    <O T="DocCell">
                        16
                    </O>
                    <O T="DocCell">
                        1.4
                    </O>
                </O>
                <O T="DocRow">
                    <O T="DocCell">
                        C18/22
                    </O>
                    <O T="DocCell">
                        18
                    </O>
                    <O T="DocCell">
                        1.5
                    </O>
                </O>
                <O T="DocRow">
                    <O T="DocCell">
                        C20/25
                    </O>
                    <O T="DocCell">
                        20
                    </O>
                    <O T="DocCell">
                        1.6
                    </O>
                </O>
            </O>
        </O>
        <O T="DocSection" Title="Diagram ">
            <O T="DocGraph" Width="400" Height="300" Title="X Graph" DataList="[[0,0],[1,3],[2,4],[3,4.5],[4,4.75],[5,4.75],[6,4.5]]" AxisLabelY="Force(N)" AxisLabelX="Disp(mm)" />
        </O>
    </O>
</O>

To view this example in the library, see (https://openbrim.org/platform/?application=inc&author=ParamML_Examples_OpenBrIM+Platform&obj=objid0f7ab4sjh1fl38g9nx5clhn)

  • No labels