spd - Configure option

image0

This option is used to set or amend configuration settings for the current project (which may be the default project).

Working directory

Programs are loaded and compiled from this directory, using a relative pathname if necessary. If no working directory is specified, programs are loaded and compiled from the directory that contains them.

Browse directory

The directory where the Load Program browse window starts. If blank, this defaults initially to the directory where the program designer resides, and, after a program has been loaded, to the directory containing the currently selected program.

Binary directory

Compiled programs are moved to the binary directory if one is specified.

Execute directory

The Execute Program option executes compiled programs from this directory, using an absolute pathname if necessary. If no execute directory is specified, programs are executed in the directory where they reside.

Compile script
Debug Compile script

The compile scripts for programs in this project. The following defaults are assigned to new projects, and are also used if a compile script is not provided:

Compile script

-scc -e “%S”

Debug Compile script

-scc -e -d “%S”

The characters have the following meaning:

-scc

The “-” sign in front of the scc command tells the program not to execute it in a DOS window.

-e

Output error messages to a file progname.e (the source file name with a .e extension). If this option is not used, compilation errors are not displayed.

-d

Add debug information to the object file (progname.g, progname.q). The program may then be run with the debug run time interpreter (sagewcd | srepwcd, executed by the Sculptor program debug tool scdebug.

%s

The name of the program sourcefile without any path (progname.f, progname.r) is substituted.

%S

The full, absolute pathname ofthe program source file is substituted.

%%

A single % character.

The program designer uses the return value of scc (0 means OK).

Execute script
Debug Execute script

The execute scripts for programs in this project. The following defaults are assigned to new projects, and are also used if an execute script is not provided:

Execute script

-%e “%B” &

Debug Execute script

-%ed “%B” &

The characters have the following meaning:

%b

The program binary file without any path (progname.g, progname.q) is substituted.

%B

The full, absolute pathname of the program binary file is substituted.

-%e

The appropriate execute program is substituted - srepwc for .q source files, sagewc for .g files. The “-” sign is an instruction not to execute the program in a DOS window.

d

Tells Sculptor to use scdebug to execute the program.

%%

A single % character.

&

Allows the program designer to be minimised or used while the executed program is running. If this option is not used, the program designer windows remain open behind the executed program and cannot be minimised or used.

Arguments may be accessed within the program by means of the subscripted Sculptor system variable sys.Arg. Note that the space character denotes the end of an argument. If an argument contains a space, enclose it in double quotes.

Tab size

This defines the tab size to be used in the source code window.

Debug

Check this box if programs are to be compiled and run in debug mode.

This means that the Compile Program option calls the program compiler scc with the -d option, causing debug information to be stored, while the Execute Program option calls the Sculptor program debug tool scdebug. This program executes sagewcd | srepwcd, versions of the run time interpreters with debug facility.

Space between controls

If this is checked, a blank line is inserted between window and window control definitions in the source code.

!include relative loc

Since Sculptor version 6.1.6. If this is checked, the include files are opened relative to the file that includes them (like compiling with the -i option)

Application workspace

This feature simplifies the creation and editing of a program that is to be run on a different-sized screen from the one being used by the programmer. The application workspace (the dark grey area that occupies most of the screen) is reduced or enlarged to the size specified, with scroll bars being provided if necessary. If the workspace is smaller than the current screen size, the remainder of the screen background is painted light grey. The programmer can then design the application to fit the area that will be available for it.

The dimensions of the workspace can be selected from a listbox containing standard screen sizes, or typed into the Width and Height boxes. Setting the width and/or height to 0 causes the current screen width and/or height to be used.


RELATED TOPICS

The Sculptor program designer

Projects

External configuration