These Varkon user commands set-up standard linework configurations. The color code is the standard AutoCAD color code (Both ACAD & Varkon colors are shown. The linework setup is:

    *Part Name - Line Type   - VarkColor/ACadClr/#  -WIDTH/# - lFONT#   
    *--------------------------------------------------------------------
    *cns()..   - Construction     -Red/Yellow/2      -0.10/1  - Contin/0 
    *ifc()     - In Function      -DkBlue/Black/7    -0.35/4  - Contin/0 
    *ofc()     - Out of Function  -LtBlue/Same/4     -0.25/3  - Contin/0
    *cmp()     - Component        -DkRed/DkBlue/5    -0.35/4  - Contin/0 
    *asy()     - Assembly         -Black/Red/1       -0.35/4  - Contin/0 
    *sas()     - Sub-Assembly     -DkGreen/Magenta/6 -0.35/4  - Contin/0 
    *ssa()     - Sub-Sub-Assembly -Brown/Grey/8      -0.35/4  - Contin/0 
    *pce()     - Piece            -LtGreen/Same/3    -0.35/4  - Contin/0 

The following commands draw specific lines and set up three sizes of text:

    *Part Name   - Level-Name/#      - Color/#      -WIDTH/# -lFONT#   
    *----------------------------------------------------------------------
    *BdrLn(+)   - Border           -LtGreen/Same/3  -0.50/5  -Contin/0 
    *DshLn(+)   - Dashed lines     -LtBlue/Same/4   -0.15/2  -Dashed/1 
    *CtrLn(+)   - Center lines     -LtGreen/Same/3  -0.10/1  -CL/2 
    *DmnLn(+)   - Dimensions       -Black/Red/1     -0.25/3  -Contin/0 
    *xxTxt(#)   - Text             -Black/Red/1     -0.35/4  -Contin/0 

Note: The BdrLn(), DmnLn(), and xxTxt() modules are unimplemented at this time.

These modules control the line characteristics of all subsequent Varkon user linework commands until another of the above commands is executed.

Layer names and ON/OFF status are controlled by the LevelInit() and LevelSet() modules. Please see those commands for layer configuration.

Under normal usage all linework is placed in a construction layer specified using 'LevelSet()' and that layer is kept turned 'OFF'. Line work to be displayed is placed in other layers using 'LevelSet()' and turned 'ON' or 'OFF' as the user desires. The above modules allow line characteristics to be easily controlled.

See 'Layers.txt' for layer configuration for 'asy': *asy() - Assembly -Black/Red/1 -0.35/4 - Contin/0

See 'Layers.txt' for layer configuration for 'cmp'.

    *cmp()  - Component   - DkBlue/7(5)   - 0.35/4  - Contin/0

See 'Layers.txt' for layer configuration for 'cns'.

    *cns().... - Construction  - Yellow/9(2) - 0.10/1 - Contin/0 

See 'Layers.txt' for layer configuration for 'ifc'.

    *ifc() - In Function - Black/1(7) -0.35/4  -Contin/0

This module initializes the level storage array used by LevelSet() and the various layer name modules. See LevelSet() and README/Layers for more information (e.g. cns()).

This module assigns a level number to each level name (an ASCII string) passed to it. The level name is used by the various display control modules (See cns(), ifc(), ofc(), asy(), cmp(), sas(), ssa(), and pce()). Each of these modules sets standardized linelweights, colors, etc for the linework specified in the module's callout. This module is also used to turn the layer specified on 'ON' or 'OFF' by passing one of those two strings to this module as the LevelStatus (See README/Layers). If one layer is established, (e.g. 'ConstLines') as the default layer which is kept in 'OFF', the linework for any other declared layers can be turned on/off for viewing.

The LevelStatus(100,2)*24 string array must be delared in each module that uses the Layer control system. The LevelInit() module must be run in the 1st module to use the Layer Control system.

See 'Layers.txt' for layer configuration for 'ofc': *ofc() -Out of Function -LtBlue/Same/4 -0.25/3 -Contin/0

See 'Layers.txt' for layer configuration for 'pce': *pce() -Piece -LtGreen/Same/3 -0.35/4 -Contin/0

See 'Layers.txt' for layer configuration for 'sas': *sas() -Sub-Assembly -DkGreen/Magenta/6 -0.35/4 -Contin/0

See 'Layers.txt' for layer configuration for 'ssa': *ssa() -Sub-Sub-Assembly -Brown/Grey/8 -0.35/4 -Contin/0

This prototype watercraft's cross-section incorporates a water ballast chamber below the floor level which will be placed 4-1/2 inches above the keel. The water ballast is intended to stabilize the watercraft when it is not in motion. As the craft is propelled forward (by rowing, paddling, or a small motor) the water ballast will naturally drain from the hole at the base of the transom. The craft's floor will have a forward vent tube to prevent formation of vacuum in the ballast chamber during drainage.

The purpose of the water ballast is to stabilize the craft's roll while motionless. As the water drains from the ballast chamber the craft should lift up in the water and the forces associated with forward motion will take over to stabilize the craft's roll while it is moving. The craft's waterline after the ballast is drained is narrower to minimize drag. The minimized drag will permit more speed. A quarter-turn ball valve will be inlcuded to retain or exclude water from the ballast chamber.

    -- John Hughes (Email: n4yvt@arrl.net)

This module may be pasted into the interactive active module of VARKON under the NGB project files directory. This permits interactive adjustment of the control points which alter the watercrafts hull surface. The module's content is described in the following lists of steps.

Declare the following Variables and Constants:

• L - This a parametric value used to control the length of the watercraft
• Pt - This is an array used to transfer all edited points to the Main() module which plots and evaluates the glideboat.
• Blanking variables (CrdBlnk, etc) - These control which points are visible for editing
• Array Indices - Constants used to name the rows of the 'Pt' array which are transferred to the 'Main() module for use.

Steps Taken:

• Generate the Keel Board Edge from a series of parametric 'L' based values. All of the Cross-Section curves begin from the edge of this board. The parametric values establish the 'rocker' curve for the keel.
• Set up Blanking values for each set of section control points. These values are manually edited to select one section for editing.
• Locate and declare the coordinate system for each section's control points.
• Initialize coordinates for all 36 X-Section control points (6 Sections w/6 points each). These values may be edited interactively.

The point coordinates can all be edited manually 6 nodes at a time (blank all others). The editing can be done interactively using the 'xy' view and moving the points for any of the unblanked 6 nodes. Any node adjustment made will be propogated through the entire model. The model must be executed with the 'RUN' button in the main window after editing.

Copyright 2006, John J. Hughes (Email: n4yvt@arrl.net)

GNU General Public License

This source code file is part of the 'NGB' project files which execute interactively under the 'Varkon' program, which is distributed under the terms of the GNU General Public License.

The 'NGB' project files are also distributed under the terms of the GNU GeneralPublic License. See the GNU General Public License n included ithe file name "COPYING.txt" in the Varkon ./app/NGB/doc directory for more details.

NGB is free software; you can redistribute it and/or modify it under the terms of the GNU General Public License as published by the Free Software Foundation; either version 2 of the License, or (at your option) any later version.

NGB is distributed in the hope that it will be useful, but WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License included in the file name "COPYING.txt".

You should have received a copy of the GNU General Public License along with NGB; if not, write to the Free Software Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA 02110-1301 USA

The file 'Control.MBS' should be cut and pasted into the interactive active project file named 'Control()'. See the Control() documentation for more information. 'Control' calls this MBS file.

The steps performed in this module are:

• Set-Up Layers & Initialize Arrays
• Set up Cross-Section Curves
• Develop the Hull Surface
• Develop the 'lines' of the glideboat with b_plane curve intersects
• Plot 15" oc Station Section
• Develop Keel Board Drawing from model <Later>
• Develop Station Mold Drawings from model <Later>
• Develop Stem Mold Drawing from model <Later>
• Develop Transom Drawing from model <Later>
• Develop Valve Detail Drawing from model <Later>
• Develop Floor Support Drawing from model <Later>
• Develop Floor Rail Drawing from model <Later>
• Develop Typical Gunwale (inwale & outwale) <Later>

The following lists provide sub-topic breakdown for selected steps listed above.

Layers & Array Initialization

Steps are as folows:

• Set up layers for model
• Transfer Pts to Pt to get zero index option
• Create Views
• Display Centerlines
• 2-way Midplanes (These were used to generate cross-section views originally but ultimately line blanking was used instead)

Cross-Section Curves

Steps as follows:

• Load point cloud for display of historical glideboat profile data comparison. NOTE: This command is commented out, but it may be uncommented if the address of the data file (which is distributed in the ./app/NGB directory) is updated for for your system in the PointCloud.MBS file.
• Add Z offset to convert local planes into BASIC coordinates
• Develop each Bezier Section Curve from 'Pt' array data

Hull Surface

To Develop the Hull Surface:

• Initialize the longitudinal curve U-Values in a vector (This selects the inflection points and curve transition location)
• Capture coordinates for longitudinal surface generation lines
• Capture coordinates for Tangent surface generation lines for the longitudinals above the keel, Keel coordinates loaded #60 to #70
• Project longitudinal and tangent points onto Z-Plane beyond tip and replace last point, which was on the Tip Curve, with the point which intersects the Z-Plane.
• First initialize Temporary vector CrvPts & NoPts for all longitudinal and tangential lines for conic lofting surface
• Generate Longitudinals, including Generation of 'P' & P-value vectors needed to generate 'CubicCrv()' longitudinal and tangent curves.
• Generate Tangent Lines for each longitudinal
• Generate Hull Surface Spine
• Generate a Hull Surface "P-value" lines
• Generate the half-hull surface of the Guideboat
• Generate the Tip Curve along the bicubic surface intersect with the X=0 plane
• Get Layer for Fore and Aft Keelboard Edge
• Pick up side-hull craft edges
• Generate Transom Plane and transom
• Place drain hole
• Mirror Both Sides of the Glideboat
• Mirror Both Surface Edges of the Glideboat
• Transom hull intersect opposite edge

Waterline Intersect Curves

To develop the 'lines' of the glideboat:

• Store all surface REFs in array for later referance
• Generate faceted surfaces for rendered viewing
• Call module to generate waterline intersect curves
• Generate Rulers

The steps followed are:

• Input the 6 3D coordinate locations for the nodes defining the curve.
• Create points at each node location.
• Connect the nodes with lines
• Place points at each line mid-point & connect lines between mid-points.
• Place points at quarter points & connect quarter point lines.
• Place mid-points on each line defining tangent points at each curve connection node
• Place the Bezier curve connecting all the tangent points using cur_conic().
• Get location of tangent point preceding point #1 for return

This module generates all the data required to produce a bicubic curve from 13 or fewer intersction points. No tangent points are provided to this module since they are interpolated inside the module using a spline curve generated using cur_splarr(). A 'P' array is required to control the 'fullness' of the curve.

The steps followed are:

• Generate a simple spline curve using cur_splarr() using the 13 points input via the CrvPts array.
• The 'PValues' and 'CrvPts' arrays must be declared and initialized prior to calling this function. The 'PValues' array may be initialized to a single value using the PValInit() function. After PValInit() initializes the 'PValues' array selected points (e.g. at ends) may be set just prior to calling this function.
• Initialize all of arrays except 'CrvPts' and P-Values. P-Values passed to this module must be between 0.0 and 0.85.
• Generate tangents vector needed to generate cur_conic curves
• A bicubic curve in then formed using cur_conarr().

This module sums the coordinates of each provided point and divides the sum by 2 to locate the mid-point.

Module steps:

• Initialize unset points on 'P' value unit vector to zero.
• Generate a 2-segment spline curve with 3 points with its length equal to NoPts.
• Put interpolated points back in 'PValues' array for return.

The steps followed are:

• Declare a 35x2x11array (named 'Pt') to hold 3D coordinate of all the measured points from the 'Durant' Adirondack Guide Boat book. Measurements were taken by John Gardner in 1964. Data is in the public domain.
• Open the 'NGB-final-offsets.txt' file for reading.
• Loop through the text file and store the coordinates in the 'Pt' array.
• Plot 3D points ('poi_free')

The 'start' and 'end' values passed to this module limit the range of stations (between 0 and 34) which are displayed.

Note: Change file location in the first line of the source code if the data file is relocated.

Use

The steps in the module are: *

Use coordinate system planes & hull surface intersects to develop the water, buttock, and mold (cross-section) station lines.

The steps in the module are:

• Generate vertical csys to intersect hull mold cross-sections
• Generate the Mold Station lines
• Generate horizontal csys to intersect waterlines
• Generate intersect waterlines
• Generate Buttock lines for both sides of the hull

This module take the following steps to locate and return the new point:

• Check to make sure a line passing through both points intersects the Z-Plane
• Select as Point 'A' (PtA), the point fartherest to the plane
• Set Point 'B' (PtB) to the unselected point
• Generate a blanked line (Ln) from 'PtA' to 'PtB'
• Obtain the direction Cosines vector (UnitVec) for 'Ln' using the Varkon tangt() function
• Calculate the hypotenuse length (Hyp) for a line projecting from 'PtB' to the specified Z-Plane
• Multiply 'hyp' x 'UnitVec' to obtain vector (DeltaVec) from 'PtB' to the Z-Plane
• Sum DeltaVec + PtB vector to obtain new Z-Plane intersect point as return value
• Close loop

This module take the following steps to place U-isolines :

• Retrieve number of patches. Calls of GETSURH
• Create U parameter lines

This module take the following steps to place V-isolines :

• Retrieve number of patches. Calls of GETSURH
• Create V parameter lines

This documentation package addresses all projects developed in the NGB directory of the VARKON directory tree. The documentation is in the NBGDoc.html file in the ./NGB/doc directory. [./ROBODOCScript.sh executes to produce the docs. Of coarse 'robodoc' must be installed].

This module take the following steps to ..... :

• Bulleted item bulleted item continuation line (indented one space from '*' above (don't use any tabs!)
• Next item .....

Inserts an image with the image stored in the ./Projectname/doc directory.

This module draws a center line without altering the global layer setup.

See 'Layers.txt' for layer configuration for 'ctrln' which is a center-line: *ctrln(+) -Center lines -LtGreen/Same/3 -0.10/1 -CL/2

This module draws a dashed line without altering the global layer setup.

See 'Layers.txt' for layer configuration for 'DshLn' which is a center-line: *dshln(+) - Dashed lines -LtBlue/Same/4 -0.15/2 -Dashed/1

This module takes the following steps to draw a ruler line (See Figure 1 below for layout) at the origin aligned in the x-direction on the coordinate system provided by the user:

• Set up units for either Metric or Imperial Base units per drawing unit
• Calculate bounding box Delta x, y, and z and select maximum length
• Set Ruler height (Ht) based on maximum length
• Setup coordinate systems & Total Length for each of six rulers
• Outer loop selects each coordinate system in succession
• Draw horizontal ruler lines (See Figure) Turn off lines that are too dense to plot
• Start loop to draw vertical ruler line (See Figure) & draw vertical lines
• Return to Global