Settings
These settings apply to your entire comic.
They need to be set before calling start()
in your main.lua
file.
Example:
import "libraries/panels/Panels"
import "comicData.lua"
-- change settings before calling start
Panels.Settings.snapToPanels = false
Panels.Settings.useChapterMenu = false
Panels.start(comicData)
Table of contents
Path Settings
path
default: “libraries/panels/”
The path to the Panels library in your project source.
There is normally no need to change this unless you need to put Panels in a different location in your project.
imageFolder
default: “images/”
The path to the folder where images are stored in your project source. With this set, you can omit the folder name when specifying images in your comic data files.
Usage:
-- With the default setting, instead of this:
{ image = "images/s01/image-1.png" }
-- you'd omit the base folder name to make things slightly cleaner:
{ image = "s01/image-1.png" }
If you wish to specify images using the full path, set this property to ""
.
audioFolder
default: “audio/”
The path to the folder where audio files are stored in your project source. With this set, you can omit the folder name when specifying audio in your comic data files.
If you wish to specify files using the full path, set this property to ""
.
Panel Settings
defaultFrame
default: {gap = 50, margin = 8}
This default frame will be used for any panel that does not specify a frame in your comicData
table.
You can override this frame for any individual panel in your comic by specifying the frame
property for that panel.
snapToPanels
default: true
When set to true, scrolling lightly snaps to the edges of panels.
sequenceTransitionDuration
default: 750
The duration (in milliseconds) of the transition (in and out) between sequences.
defaultFont
default: playdate.graphics.getSystemFont()
Set the default font for your entire comic. This font will be used for any text layers that do not specify a font.
borderWidth
default: 2
The thickness (in pixels) of the border drawn around panels.
borderRadius
default: 2
The corner radius (in pixels) of the border drawn around panels.
typingSounds
default: Panels.Audio.TypingSound.DEFAULT
Change or disable the sound effect used for the TYPE_ON
text layer effect.
When using a custom sound the path should be relative to the folder specified in the audioFolder
setting.
Options:
Panels.Audio.TypingSound.DEFAULT
Panels.Audio.TypingSound.NONE
- path to custom sound file
Menu Settings
menuImage
default: “menuImage.png”
The image that will be shown behind the comic’s main menu. This should be a full screen (400x240) image. The system will look for this image in the folder specified in the imageFolder
setting.
Note: The bottom 45 pixels of the image will be covered by the menu options.
showMenuOnLaunch
default: false
By default, users are taken straight into the comic at the start of the chapter where they last left off.
Change this setting to true
to instead display the comic’s main menu when the game launches.
skipMenuOnFirstLaunch
default: false
If you choose to display the menu on launch, you can set this to true
to skip the menu if the user is starting out on the first chapter. This gives you the opportunity to show an intro chapter on first play—skipping the menu until next launch.
playMenuSounds
default: true
Disable the menu navigation and select sounds.
Chapter Menu Settings
listLockedSequences
default: true
Set this to false
to prevent locked sequences from appearing in the chapter menu. By default, locked sequences are displayed in the chapter menu, but are not selectable.
chapterMenuHeaderImage
default: nil
Set an image (likely your comic’s logo) to display at the top of the chapter menu. The image will be centered at the top of the menu.
The system will look for this image in the folder specified in the imageFolder
setting.
If this option is not set, the chapter menu will display “Chapters” in plain text.
useChapterMenu
default: true
Set this to false
if you don’t wish to use a chapter menu in your comic. This will remove the “Chapters” items from the system menu and the comic’s main menu.
Without the chapter menu, users will be forced to play through your comic in strict linear order (or start over from the beginning).
Debug Settings
listUnnamedSequences
default: false
By default, sequences that don’t list a title
property are not listed in the chapter menu.
Set this to true
to make unnamed sequences selectable. This is useful to more easily skip to a sub-chapter during testing and debugging. Unnamed sequences appear in the chapter menu as “–”, therefore it is not recommended to ship your game with this option turned on.
debugControlsEnabled
default: false
Set this to true
to enable debugging controls.
Current debugging controls are:
- press
0
key to unlock all sequences (requires restart)