Skip to content

PSCC Callback Functions v1.0.0

Choose a tag to compare

View all tags
@MetaNite64 MetaNite64 released this 12 Jun 00:19
PSCC-Callback-1.0
597b41e

PSCC Custom Animation Functions + New Color Schemes [QuickLava, MetaNite64]

The "PSCC Callback Template v1.0.0" folder is a template function written entirely by QuickLava, which serves as a frame to write your own function. The actual function included in the template simply runs the RGB color backwards compared to the one included in Project+, and uses callback ID 1.
Both remaining folders in this zip file are custom functions written by MetaNite64. The "Small Gradient" function cycles the hue back and forth over 1/8th of the color wheel, and the "Luminance" function cycles the brightness back and forth from (roughly) 0 to 1. Small Gradient is given callback ID 1, while Luminance has ID 2. Make sure you edit one of the IDs if you include both the template and the small gradient.

Install guide:

  • put a function's folder into the Code Menu Builder's Addons folder. The Code Menu will autodetect all addons by default, no need to manually include them.
  • add a color definition to your build's config xml file that takes advantage of a callback function, and use that new color in a color scheme.
    • a reference EX_Config.xml file is included in the download, which adds 5 new elemental schemes using both included functions on top of unmodified P+Ex v1.5.5's Code Menu.
    • the full RGB hue gradient as seen in P+ by default is hardcoded to callback function ID 0, and can be used in another color definition if you wish (e.g. lower saturation).
  • Recompile the Code Menu, and then the build's codeset.

For the assembly-inclined, writing your own function takes place entirely in the Source.asm file from the template. That file also has plenty of documentation on register usage as well as how to change the function's ID. Don't forget to update the name and shortname of your new addon in its Definition.xml file, especially if you're adding multiple functions.

Huge thanks to QuickLava for talking me through the callback function system and writing the template for me on a whim, as well as all the work that's gone into making the Code Menu in general. This would have been exceedingly difficult to make and distribute without the Addons system or his support and guidance.
-Meta

Example Color Scheme Details

All values are given as if they were included in the config as a static color (i.e. hue ranges from 0 to 360, luminance ranges from 0 to 1)
"Flame": red-orange gradient. Hue boundaries are 0.0 and 45.0
"Growth": yellow-green gradient. Hue boundaries are 57.0 and 102.0
"Water": blue gradient. Hue boundaries are 190.0 and 235.0
"Decay": purple-pink gradient. Hue boundaries are 280.0 and 325.0
"Void": black-to-white gradient. Luminance goes back and forth between 0 and roughly 1.

Assets 3
Loading