HDevelop understands many command line switches when started from a console or terminal window. Run the following command to get a list of all supported command line switches:
hdevelop -h
In general, HDevelop is started using
hdevelop [OPTIONS] [FILE]
FILE can be an HDevelop program, an external procedure, a library file, or an image file. The default action is to load the given file for editing. If an image file is given, it is preselected in the dialog Read Image... (same behavior as dragging an image file onto a running instance of HDevelop).
hdevelop -run example.hdev
hdevelop -override_stop 0 -run example.hdev
hdevelop -external_proc_path:C:/projects"
Specified path names are put first in the list of directories that are searched for external procedures and libraries. Separate multiple directories by the system-dependent separator (“;” on Windows and “:” on Linux). This is a temporary setting for the current session only. See also section “Procedure Locations”.
hdevelop -unlock:crypt secret.hdev
hdevelop -convert example.dvp example.hdvp
hdevelop -convert example.hdvp example.dvp
hdevelop -unprotect:crypt -convert secret.hdvp nosecret.hdvp
hdevelop -protect:crypt -convert example.hdvp example.hdvp
hdevelop -convert example.hdev example.cpp
HDevelop accepts the following command line switches:
hdevelop [options]
HDevelop options:
<program>.{hdev,dev}
load the program for editing, converting, or running
{<procedure_file>,<procedure_library_file>}
load the procedure or procedure library for editing
-{protect,unprotect,unlock}:<password>
modify the protection state of an HDevelop program or
procedure
-load_recent_prog load the recent program irrespective of the appropriate
option that was selected in the preferences dialog
-load_no_prog do not load the recent program irrespective of the
appropriate option that was selected in the preferences
dialog
-run start execution of the passed program
<image_file> load an image file with read_image
-help show this help info in a message box
--help show this help information on the console
-version show version information in a message box
--version show version information on the console
-external_proc_path:<external procedure path(s)>
an external procedure path may point either to a directory
or a procedure library file
multiple external procedure paths are separated by semicolons
on windows systems, or by colons on all other systems
-convert <source> <destination> [<options>]
convert an HDevelop program or procedure into a
file of the specified type
(not possible combinations:
convert dev, hdev, hdpl into dvp, hdvp
convert dev, hdev, dvp, hdvp into hdpl)
source: <src_file>.{hdev,dev}
<src_file>.{hdvp,dvp}
<src_file>.{hdpl}
destination: dest_file.<type>
<type> write to <src_file>.<type>
- <type> write to stdout
type: hdev,dev HDevelop program
hdvp,dvp HDevelop procedure
hdpl HDevelop procedure library
c,cpp C, C++
cs,vb C#, VisualBasic.NET
txt text
options: [-external_procs_only_interfaces]
export only the interface(s) of the procedures
(the declarations) without the bodies
[-no_export_of_referred_procs]
export only the passed program or procedure but
do not include any referred external procedures
[-no_msg_box]
suppress error messages
[-reset_free_text]
reset free text formating
[-delete_local_procs]
[-delete_unused_local_procs]
[-no_use_hdevelop_template]
[-encoding native]
exported string constants are encoded in native
local-8-bit encoding instead of UTF-8
[-encoding UTF-8]
exported string constants are encoded in UTF-8 (default)
Please note that non-ASCII characters in string constants
are exported as octal codes in order to guarantee that
the strings are correctly created on all systems,
independent on any compiler settings
-reset_preferences
reset all persistent settings from previous sessions
-add_preferences <file>
start HDevelop with additional preferences
from a file
(replaces -preferences <file> that became deprecated)
-load_preferences <file>
reset all persistent settings and
start HDevelop with the preferences from a file
-use_preferences <file>
start HDevelop with the preferences from file
and store all modified preferences to file
-override_stop <time>
override stop() operator with wait_seconds(time)
-override_wait <time>
replace time of wait_seconds() operator with <time>
Export library project options:
-export_project
Export a library project
-export_type <type>
Type of project. Currently supported:
cmake
-input_file <file>
*.hdev or *.hdpl file used as project source
-project_name <name>
Name of exported project
(must be a valid identifier in the target language)
-output_folder <path>
Target path for exported files
-encoding <encoding>
Set output encoding. Currently supported:
native
UTF-8
-namespace <name>
Namespace of project
(must be a valid identifier in the target language)
-language <language>
Set source code language. Currently supported:
cpp
cs
GUI options:
-style[=] <style>
sets the application GUI style. Possible values are:
Windows Motif CDE Plastique Cleanlooks
X11 options:
-display <display>
sets the X display (default is $DISPLAY).
-geometry <geometry>
sets the client geometry of the first window that is shown.
-graphicssystem {native|raster|opengl}
sets the graphics backend used (default: native).
-{fn|font} <font>
defines the application font. The font should be specified
using an X logical font description.
-{bg|background} <color>
sets the default background color and an application palette
(light and dark shades are calculated).
-{fg|foreground} <color>
sets the default foreground color.
-{btn|button} <color>
sets the default button color.
-name <name> sets the application name.
-title <app_title> sets the application title.
-visual TrueColor forces the application to use a TrueColor visual on an
8-bit display.
-ncols <count> limits the number of colors allocated in the color cube on
an 8-bit display if the application is using the
QApplication::ManyColor color specification. If count is 216
then a 6x6x6 color cube is used (i.e., 6 levels of red,
6 of green, and 6 of blue); for other values, a cube
approximately proportional to a 2x3x1cube is used.
-cmap causes the application to install a private color map on an
8-bit display.