Amos Professional Unity Alpha Release 2


New commands and updates available in the future Amos Professional Unity Alpha Release 2


___________________________________________________________________

Unity Color Palette banks Commands set :
____________________________________________________________________

Command Name : Grab Screen Palette

Syntax :
  Grab Screen Palette BANKID

Details :
This method will grab the current screen color palette, and put it in a Color Palette bank
BANKID = The Amos Bank that contains the Color Palette

Additional informations :
-


___________________________________________________________________

Unity new Fading system Commands set :
____________________________________________________________________

Command Name : Unity Fade To Palette

Syntax :
  Unity Fade To Palette BANK,STEP(,COLORSAMOUNT)

Details :
This method will fade to a color palette
BANK = The Amos Bank that contains the Color Palette
STEP = The speed to fade. Positive value only.
COLORSAMOUNT (Optional) = Allow you to force fading to handle more colors than the screen depth uses. It is usefull to makes fading effect, affect sprites colors when these are out of the screen color palette.

Additional informations :
It is advised to use the new fading methods from Unity instead of the older Amos Professional one as they are working on both ECS and AGA version of Amos Professional Unity. Previous Amos fading commands are kept available in the language for compatibility purpose with older source code. 


___________________________________________________________________

AGA Sprites  Commands set :
____________________________________________________________________

Command Name : Set Sprites To Ecs Compatibility

Syntax :
  Set Sprites To ECS Compatibility

Details :
This method will makes AGA sprites uses the ECS compatibility display mode

Additional informations :
The command "Set Sprite Width 16" will force the mode "Set Sprites To Lowres". So to use ECS/OCS sprites in Amos Professional Unity, you have two alternatives :
- Never use the "Set Sprite Width" method/call in your program
- Calle "Set Sprites To Ecs Compatibility" after "Set Sprite Width" calls that restore sprites to 16 pixels width mode (ECS/OCS sprites are always 16 pixels width 4 or 16 colors sprites combinations)

Command Name : Set Sprites To Lowres (not working)

Syntax :
  Set Sprites To Lowres

Details :
This method will makes AGA sprites uses LowRes display mode

Additional informations :
-

Command Name : Set Sprites To Hires (not working)

Syntax :
  Set Sprites To Hires

Details :
This method will makes AGA sprites uses Hires display mode

Additional informations :
-

Command Name : Set Sprites To SHres (not working)

Syntax :
  Set Sprites To SHres

Details :
This method will makes AGA sprites uses Super Hires display mode

Additional informations :
-

Command Name : Get Sprites Resolution

Syntax :
  VALUE = Get Sprites Resolution

Details :
This method will return the sprite resolution set. Results are :
0 = ECS Compatibility mode
1 = AGA Lowres
2 = AGA Hires
3 = AGA SHres

Additional informations :
-

Command Name : Enable Sprites Borders (not yet available)

Syntax :
  Enable Sprites Borders

Details :
This method will makes AGA sprites being not displayed out of screens limits

Additional informations :
-

Command Name : Disable Sprites Borders (not yet available)

Syntax :
  Disable Sprites Borders

Details :
This method will makes AGA sprites being displayed if out of screens limits

Additional informations :
-

Command Name : Set Sprite Width

Syntax :
  Set Sprite Width PIXEL_WIDTH

Details :
This method will enable AGA sprite width modes to allow bigger sprites than ECS/OCS ones.
PIXEL_WIDTH can be 16 (native ECS/OCS width), 32 (AGA Only) or 64 (AGA Only)

Additional informations :
 This method have no effect on ECS/OCS Unity.

___________________________________________________________________

Simple Rainbox FX Commands set :
____________________________________________________________________

Command Name : Create Rainbow Fx Bank

Syntax :
  Create Rainbow Fx Bank BANKID

Details :
This method prepare an Amos Professional bank to receive Simple Rainbow FX colors datas
BANKID = The ID number of the bank to use to store the Simple Rainbox FX datas

Additional informations :
You can have more than one Simple Rainbox FX bank in memory
Per default, the color used for Rainbox FW will be color 0, but you can use any color from 0 to 255.
The Simple Rainbow FX must be attached to a screen (it can be attached to more than one screen.
The Rainbow fx will not be visible in the current screen until you call the "Apply Rainbow Fx To Screen BANKID" command
The effect is removed from the current screen by calling the "remove Rainbow fx from screen" or by closing the screen.

Command Name : Set Rainbow Fx Color

Syntax :
  Set Rainbow Fx Color BANKID, COLOR_INDEX_ID

Details :
This method makes Simple Rainbow FX be used on COLOR_INDEX_ID instead of default color 0
BANKID = The ID number of the bank where the Simple Rainbow FX datas are stored
COLOR_INDEX_ID = any of the colors from the range 000-255 in Aga graphic chipset

Additional informations :
-

Command Name : Set Rainbox Fx Color Line

Syntax :
  Set Rainbow Fx Color Line BANKID, Y_HARDWARE_LINE, RGB(12/15/24)ColorValue

Details :
This method will modify one line of the Simple Rainbox FX in the memory bank BANKID.
BANKID = The ID number of the bank where the Simple Rainbow FX datas are stored
Y_HARDWARE_LINE = The Hardware line between 50-255.
RGB(12/15/24)COLOR_VALUE = The RGB color value to apply to the Y_HARDWARE_LINE of the Simple Rainbow FX

Additional informations :
You can enter RGB12 (native ECS/OCS color in format R4G4B4), RGB15 or RGB24 (using for example =Rgb24(R8,G8,B8) command )

Command Name : Apply Rainbow Fx To Screen BANKID

Syntax :
  Apply Rainbow Fx To Screen BANKID

Details :
This method will immediately apply the Simple Rainbow FX available in the memory bank BANKID to the current screen.
BANKID = The ID number of the bank where the Simple Rainbow FX datas are stored

Additional informations :
-

Command Name : Remove Rainbow Fx From Screen

Syntax :
  Remove Rainbox Fx From Screen

Details :
This method will remove the Rainbow Fx from the current screen

Additional informations :
-

Command Name : Get Rainbow Fx Color Line

Syntax :
  Rgb24ColorValue = Get Rainbow Fx Color Line( BANKID, Y_HARDWARE_LINE)

Details :
This method will return the RGB24 color value defined in the Simple Rainbow FX bank BANKID.
If no color is defined to the specified Y hardware line, the value -1 will be returned (meaning it's the original screen color that will be applied on that line)
BANKID = The ID number of the bank where the Simple Rainbow FX datas are stored
Y_HARDWARE_LINE = The Hardware line between 50-255.

Additional informations :
-

Last update : 2021.04.18 11.25