This dialog can be used to configure the global project settings. It is mainly used to tell Hollywood how it shall display your project. The dialog consists of the following pages: General, Display, Backfill, Scaling, Icons, Languages, Text, Linker, Plugins, Keyboard, Custom code, Other, and Advanced.
The first page can be used to define some general properties, i.e. you can set the author of the project, copyright, version string and a description of your project. You should also enter the Hollywood version that your project requires. The contents of the text field "Title" will be shown in the title bar of your project window (if the window has a border). All other settings are only for information purposes.
A unique project identifier must be set in case you want your project to be able to remember certain user selections and inputs when it is closed and restarted again. For example, Hollywood Designer projects can remember their window position and size if the "Remember position and size" option is set on the "Display" page of the project properties dialog. Also, Hollywood Designer supports editable text objects. The user can change the contents of those text objects by clicking on them. All those features that save individual user settings require a unique project identifier. This identifier must be specified in reverse DNS notation, e.g. "com.airsoftsoftwair.test", and no Hollywood Designer projects must use the same identifier. See User settings for details.
The "Delete project user data" button can be used to delete all user selections that your project has remembered, e.g. the last language used if the "Remember this language change on next start" option was selected in the Change language action event, the window's position and size, selections that were made using the Choose file to open action event and so on. See User settings for details.
The display page is used to define how your project shall be shown. Mode can be one of the following settings:
You can also configure the monitor your project should be opened on.
If the display mode has been set to "Full screen", you can set the exact full screen configuration using the widgets below. The following options are available for full screen configuration:
Furthermore, you can also configure the window style to use when your project is run in windowed mode:
Finally, there are some other display settings that can be configured on this page:
The third page allows you to configure the backfill of your project. A backfill could for example be just a black shielding window, or a picture, a pattern or a gradient. If you define a backfill, it will fill the whole background area of your screen that is not used by Hollywood. If you set the checkmark "Hide screen's title bar", the backfill will also be displayed over the title bar of your screen. The following backfill types are possible:
This dialog page allows you to promote your project to a different resolution. This is very useful if you need your project in a larger (or smaller) resolution but of course you do not want to adapt the layout of all your pages manually. On this page, you have to choose the desired scaling engine (layer scaling is highly recommended here for best results and speed), as well as the desired output resolution. Furthermore, you can configure whether or not interpolated scaling should be used. Note that the settings here affect your project only when running it. The resolution of the pages in your project will be left untouched.
If you select "Always keep proportions", Hollywood Designer will take care that the aspect-ratio of your pages will never be changed. Thus, pages will never appear distorted if you select this option.
This dialog page allows you to choose a set of icons for your project. The icons you configure here will be linked into your project when you save it as an executable. Icons should be provided in PNG format with alpha channel transparency for the best look. Also, icons must be exactly of the specified size. Note that embedded icons in executables are only supported by Microsoft Windows, macOS, and Linux at the moment.
This dialog page allows you to manage all languages supported by your project. You can add, remove, and rename languages on this page. Please see the chapter Localizing your projects for more information.
If you select the "Append language name to all external programs" option, Hollywood Designer will append the name of the current language to all external programs started by the "Run program" action event. This is useful in case you want to launch different programs depending on the currently active language. Note that if the current language is "Default", nothing will be appended.
This page allows you to configure where Hollywood Designer should store the contents of editable text objects. Normally, this should be set to "Use preferences", which means that the contents of editable text objects are stored using Hollywood's preferences manager. Note that you need to assign a unique identifier to your project in the "General" tab if you choose "Use preferences". Alternatively, you can also specify two custom paths to use for saving the contents of editable text objects.
Additionally, you can specify whether or not a password needs to be entered before the user will be able to edit text objects. If you activate the "Only ask for password once per session" option, the user will not be asked for the password any more as soon as he has successfully entered it once.
The "Use platform independent font engine" enables the platform independent font engine. This is generally recommended if you plan on using your project on different platforms. If you do not use the platform independent font engine, TrueType text will look (slightly) different on each platform. If you don't want that, make sure to enable this option. Important note: The platform independent font engine will only work when you use the font names as they appear in the *.TTF TrueType file. Normally this is the case. However, some font managers allow you to reassign new names to TTF fonts when you install them. For example, you could install Arial.ttf as "foofont" into the system. Then "foofont" can be opened by Hollywood Designer's normal font engine but *not* by the platform independent font engine because the platform independent font engine does not care for system specific font names. It searches inside the font files directly. Thus, you must pass a correct font name. Some font managers also remove spaces from the font names which leads to contractions like "Dejavusanscondensedbold". This will also not work with the platform independent font engine! It has to be "DejaVu Sans Condensed Bold" in order to work!
This page allows you to configure options that will be passed to the linker when you compile your project as an executable. You can choose which plugins should be linked to your project when you compile it as an executable and you can also configure whether data files and fonts should be linked to your executable. Finally, you can enable or disable compression here.
Choosing to link all external files into your output executable is quite convenient if you want to have everything in one file, e.g. for taking the executable with you on a USB stick, etc. However, make sure to check the licenses of all files, fonts, and plugins you want to link to your program. Lots of fonts are copyrighted and require a permission for embedding them into documents. You can circumvent this problem by using the fonts that are inbuilt in Hollywood Designer. See Text dialog for details.
Here you can select the plugins which are required by your project. Designer will make sure then that those plugins are available when starting your project.
Note that the plugins you select here won't be automatically loaded by Designer at startup but only by Hollywood when it runs your project. If you want Designer to load the plugins as well, you need to select them in the preferences. See Preferences for details.
This page allows you to define one or more keyboard shortcuts that shall be active while your project is running. If you want to use multiple shortcuts, simply separate them using commas. If you don't want to have any shortcut for a certain operation, just leave the corresponding text entry widget empty.
Note that even though this section is called "Keyboard", you can actually also use the mouse buttons as shortcuts using the special codes LMB for the left mouse button, RMB for the right mouse button and MMB for the middle mouse button.
You can also define shortcuts for pages in your project. If you do so, Designer will automatically jump to the corresponding page whenever the shortcut is pressed.
Furthermore, there are some options containing Hollywood shortcuts on this page:
This dialog can be used to enhance your project with custom code. You can provide custom code for three different contexts: Code that is executed once at startup, code that is executed before each page and code that is executed after each page. This can be useful for fine-tuning your project with custom code.
This page can be used to specify some other properties. First and foremost you can configure the presentation mode here. The following options are available:
Furthermore, the following graphics settings can be configured on this page:
Furthermore, the following sound settings can be configured on this page:
Furthermore, the following mouse pointer settings can be configured on this page:
Finally, the following settings can be configured on this page:
This page allows you to configure some advanced settings for your project.
To enable password protection of your project, simply activate the corresponding checkbox and enter a password. You can also specify a numeric value that specifies the number of attempts the user should have for entering the password. Enter 0 for unlimited attempts.
You can also activate magic word protection. In that case, your project will only start if it is passed the magic word via a console argument. For example, if you specify "secret" as a magic word, then your project, when compiled as an executable, will only start if it is passed the console argument "-secret".
You can also declare a page in your project as a screenblanker page. To create a blanker page for your project, activate the corresponding checkbox and select a page from your project that should be shown after the user has been inactive for the specified time. If you select the option "Always return to first page", Designer will always jump to the very first page of your project after the blanker has exited. Otherwise, it will return to the page that had been active last before the blanker skipped in.
Finally, you can specify the storage locations for contents of user-configurable action events as well as for broken links. Normally, this should be set to "Use preferences", which means that the data is stored using Hollywood's preferences manager. Note that you need to assign a unique identifier to your project in the "General" tab if you choose "Use preferences". Alternatively, you can also specify custom paths to use here. User-configurable action events are action events that can remember user actions, e.g. the Choose file to open action event can remember the file the user selected in a file requester. See User settings for details.
If you activate the "Allow user to fix broken program links" option, the user will be prompted to select an alternative program to run in case a Run program action event fails because the specified file does not exist. In that case, the user's selection will also be permanently saved in the path you specify below. This should normally be set to "Use preferences", which means that the data is stored using Hollywood's preferences manager. Note that you need to assign a unique identifier to your project in the "General" tab if you choose "Use preferences". Alternatively, you can also specify a custom path to use here. See User settings for details.