Advanced Scripting for Precise Cross Section Editing
ScriptX is our new scripting tool for Civil Site Design, designed to work with the existing Variations feature. It gives designers the power to write their own scripts for editing cross sections, which can be as simple or as complex as needed. With ScriptX, whether you are constructing a conditional retaining wall or making minor sectional adjustments, designers can start with the basics and progressively build up their scripting skills, customising edits as they grow more comfortable with the tool’s capabilities.
Figure 1: An example of a ScriptX-implemented gabion wall, illustrating the use of conditional logic to automate design adjustments.
Logical Operations for Customised Editing
ScriptX enhances cross section editing by allowing designers to embed conditional logic directly into their designs. A designer can, for example, set a cross section to widen to an alignment only if it meets certain conditions. Similarly, sections can be programmed to insert or remove themselves automatically, depending on the logic criteria established in the script.
Integration into Design Data Form
Scripts created with ScriptX are added to the Variations list through the Design Data Form. By specifying a chainage range, the script is configured to methodically apply its logic to each corresponding section within the range. These ScriptX scripts function in tandem with other Variations, ensuring they are executed in sequence as the software progresses through the Variations list.
Figure 2: The Design Data Form showcasing the Variations list, with the option to add a new ScriptX script for custom cross-section modifications.
ScriptX Basics: Getting Started
After creating a new ScriptX script entry, begin by right-clicking within the script editor to access the Menu system. Here, you will find a helpful link to the ScriptX help system — your go-to programmer’s reference that details the script’s syntax and provides easy-to-follow examples to kick-start your scripting process.
The Menu System is organised into categories: ‘Control Structures’, ‘Properties’, and ‘Commands’. ‘Control Structures’ help you weave in logic, like ‘if’ statements, into your scripts. ‘Properties’ give you access to design details such as current code elevations or offsets. ‘Commands’ are there for you to make edits to the current cross section, including inserting, deleting, or modifying codes.
Figure 3: The ScriptX editor interface displaying the right-click menu system, offering quick access to help resources and a variety of scripting commands for efficient script construction.
Below is a straightforward example of ScriptX in action:
This basic script defines a variable called ‘newSlope’ with a value of 7, which is then assigned to the slope property of the LFPI code.
// Override slope behind kerb
newSlope == 7
SetCodeSlope LFPI|newSlope
Figure 4: The resulting cross-section after applying the ScriptX code, which sets the ‘LFPI’ code’s slope to the new value of 7, demonstrating the immediate impact of script adjustments.
ScriptX Collaboration: Share, Download, and Customise with Ease
Sharing and collaboration are easy with ScriptX. To save a script, select ‘Save Script’ from the ‘File’ section in the Menu System. To use a script someone else has created, choose ‘Insert Script’ from the same menu.
Download a Driveway Layback Example Script:
Ready to see ScriptX in action? Click below to download a sample script for a driveway layback. Once you have inserted the script into your project, you can adjust the variables to specify the layback dimensions and modify the necessary codes.
Below is a link to download the Driveway Layback script:
Download: https://www.downloads.civilsurveysolutions.com//TrainingFiles/DrivewayLayback.scX
Figure 5: Visual representation of a driveway layback created using ScriptX, illustrating how the scripting language can handle more complex cross section edits.
In Conclusion: Unleashing Full Potential with ScriptX
The introduction of ScriptX marks a new era of versatility in editing cross sections within Civil Site Design. To fully harness the capabilities of ScriptX, delve into our Programmer’s Reference, which offers a wealth of information to enhance your scripting skills.
ScriptX Programmer’s Reference: https://www.downloads.civilsurveysolutions.com/CSD/Documents/ScriptX-ProgrammersReference.pdf
We are excited to see the sophisticated solutions you will craft with ScriptX at your fingertips.
We are pleased to announce the release of Stringer Topo V25.00. This version includes new features and improvements that aim to streamline your surveys within the CAD environment. Stringer Topo V25.00 is available on the following platforms: AutoCAD 2019 to AutoCAD 2025 BricsCAD V22 to BricsCAD V24 Civil 3D 2019 to Civil 3D 2025 Traverse […]
The Stringer Topo V25.00 release will enable access to a Network version. Our adoption of a new Licensing system (QLM) allows us to reintroduce our popular Network version, which has been temporarily unavailable. For Stringer Topo customers who currently have Network licenses on software maintenance, you will be issued new Stringer Topo V25.00 Network license(s) […]
“Civil Site Design: A Year in Review and a Glimpse into the Future,” recording is now available. We have dived into the transformative developments of the past year and shared some plans for the upcoming version V25. This session was led by one of our software developers, Andrew Banson, showcased the major enhancements and new […]
