Amos Professional Unity Alpha Release 1


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

Command Name : Screen Open

Syntax :
  Screen Open SCREENID, WIDTH, HEIGHT, DEPTH, MODE

Details :
  This method will open a screen using entered parameters.
  SCREENID = the screen number from 0-7
  WIDTH = The width of the screen in pixels
  HEIGHT = The height of the screen in pixels
  DEPTH = the amount of colours available in the screen (2,4,8,16,32,64,128,256,4096,262144,Ham8)
  MODE = graphic mode uses (lowres, hires, laced)
 

Additional informations :
Now, on AGA configuration, screen can use up to 256 colors, and Ham8 mode.
Additional checkings are added for resolution fetch mode restrictions. Due to this, Width must be multiple of 16 pixels.

Command Name : Colour

Syntax :
  Colour COLOR_INDEX, RGB_VALUE
  RGB24COLOR = Colour( COLOR_INDEX )

Details :
This method can be used to modify a colour of a screen, or to read one.
COLOR_INDEX is the index number from 0 to 255 in AGA, of the color to read/write
RGB_VALUE of the new color value to apply to the color. It can be in RGB12, RGB15 and RGB24 color format.
RGB24COLOR : The returned color value in RGB24 bits mode.

Additional informations :
 Amos Professional Unity Format for RGB12,RGB15 and RGB24 are these :
 RGB12 = %00000000000000000000RRRRGGGGBBBB
 RGB15 = %00000001000000000RRRRRGGGGGBBBBB (bit #25 set to define RGB15 format)
 RGB24 = %00000001RRRRRRRRGGGGGGGGBBBBBBBB (bit #24 set to define RGB24 format)

Command Name : Is Aga Available()

Syntax :
  FLAG = Is Aga Available()

Details :
This method will return 1 if the program run on an computer where AGA chipset is available, otherwise 0.

Additional informations :
 

Command Name : Is Ham 8

Syntax :
  FLAG = Is Ham8()

Details :
This method will return 1 if the current screen uses Ham8 mode, otherwise 0.

Additional informations :
 - 

Command Name : True64

Syntax :
  = True64

Details :
This method will return the value you need to use with "Screen Open" commands to create a true 64 colors (non EHB) screen on AGA.

Additional informations :
 -

Command Name : Ham8

Syntax :
  = Ham8  

Details :
This method was created to easily get the value 262144 that correspond to Ham8 mode when opening an Ham8 screen.

Additional informations :
 -

Command Name : Rgb24

Syntax :
  RGB24COLOR = Rgb24( RED4, GREEN4, BLUE4 )

Details :
This method will return a RGB24 color value from the RED8, GREEN8 and BLUE8 color component
RED8 = 8 bits red color value
GREEN8 = 8 bits green color value
BLUE8 = 8 Bits blue color value
RGB24COLOR = 24 Bits RGB color value

Additional informations :
 Amos Professional Unity Format for RGB12,RGB15 and RGB24 are these :
 RGB12 = %00000000000000000000RRRRGGGGBBBB
 RGB15 = %00000001000000000RRRRRGGGGGBBBBB (bit #25 set to define RGB15 format)
 RGB24 = %00000001RRRRRRRRGGGGGGGGBBBBBBBB (bit #24 set to define RGB24 format)

Command Name : Rgbr8

Syntax :
  RGB8 = RgbR8( RGBCOLORVALUE )

Details :
This method will return the red component of a RGB color value
RGBCOLORVALUE = RGB Color value from where the RED 8 bits color component will be extracted. This method support RGB12,RGB15 and RGB24 input formats.
RGB8 = 8 bits Red color component

Additional informations :
 -

Command Name Rgbg8

Syntax :
  RGB8 = RgbG8( RGBCOLORVALUE )

Details :
This method will return the green component of a RGB color value
RGBCOLORVALUE = RGB Color value from where the GREEN 8 bits color component will be extracted. This method support RGB12,RGB15 and RGB24 input formats.
RGB8 = 8 bits green color component

Additional informations :
 -

Command Name Rgbb8

Syntax :
  RGB8 = RgbB8( RGBCOLORVALUE )

Details :
This method will return the blue component of a RGB color value
RGBCOLORVALUE = RGB Color value from where the BLUE 8 bits color component will be extracted. This method support RGB12,RGB15 and RGB24 input formats.
RGB8 = 8 bits blue color component

Additional informations :
 -

Command Name : Rgb12

Syntax :
  RGB12COLOR = Rgb12( RED4, GREEN4, BLUE4 )

Details :
This method will return a RGB12 color value from the RED4, GREEN4 and BLUE4 color component
RED4 = 4 bits red color value
GREEN4 = 4 bits green color value
BLUE4 = 4 Bits blue color value
RGB12VALUE = 12 Bits RGB color value

Additional informations :
 -

Command Name : Rgbr4

Syntax :
  RGB4 = RgbR4( RGBCOLORVALUE )

Details :
This method will return the red component of a RGB color value
RGBCOLORVALUE = RGB Color value from where the RED 4 bits color component will be extracted. This method support RGB12,RGB15 and RGB24 input formats.
RGB4 = 4 bits Red color component

Additional informations :
 -

Command Name : Rgbg4

Syntax :
  RGB4 = RgbG4( RGBCOLORVALUE )

Details :
This method will return the green component of a RGB color value
RGBCOLORVALUE = RGB Color value from where the GREEN 4 bits color component will be extracted. This method support RGB12,RGB15 and RGB24 input formats.
RGB4 = 4 bits green color component

Additional informations :
 -

Command Name : Rgbb4

Syntax :
  RGB4 = RgbB4( RGBCOLORVALUE )

Details :
This method will return the blue component of a RGB color value
RGBCOLORVALUE = RGB Color value from where the BLUE 4 bits color component will be extracted. This method support RGB12,RGB15 and RGB24 input formats.
RGB4 = 4 bits blue color component

Additional informations :
 -

Command Name : Create Palette

Syntax :
  Create Palette BANK
  Create Palette BANK, COLOR_AMOUNT
  
Details :
This method will create a color palette AMOS BANK.
BANK = The number of the AMOS bank that contain the Color Palette 
COLOR_AMOUNT = The amount of color the color palette will contains (valid values are 2,4,8,16,32,64,128,256)

Additional informations :
If the optional parameter COLOR_AMOUNT is not specified, the method will automatically create a 32 colors palette on ECS/OCS chipset, and a 256 colors palette on AGA chipset.

Command Name : Get Palette Colors Amount

Syntax :
  COLOR_AMOUNT = Get Palette Colors Amount( BANK )

Details :
This method will return the amount of colors that are stored in the color palette bank.
BANK = The number of the AMOS bank that contain the Color Palette

Additional informations :
 -

Command Name : Load Cmap To Palette

Syntax :
  Load Cmap To Palette FILENAME$, BANK

Details :
This method will load a CMAP contained in a IFF/ILBM color palette and create a color palette bank using it. 
FILENAME$ = The name if the IFF/ILBM CMAP color file to load
BANK = The number of the AMOS bank that contain the Color Palette

Additional informations :
 -

Command Name : Get Palette Color

Syntax :
  RGBValue = Get Palette Color( BANK, COLOR_INDEX )
  
Details :
This method will return the RGB24 color value contained in a color from a color palette AMOS Bank. 
BANK = The number of the AMOS bank that contain the Color Palette
COLOR_INDEX = The number of the color to modify

Additional informations :
 -

Command Name : Set Palette Color

Syntax :
  Set Palette Color BANK, COLOR_INDEX, RGBVALUE

Details :
This method will modify a color inside a color palette
BANK = The number of the AMOS bank that contain the Color Palette
COLOR_INDEX = The number of the color to modify
RGBVALUE = The new RGB value used to modify the color. This method support RGB12,RGB15 and RGB24 input formats.

Additional informations :

Command Name : Unity Step Fade

Syntax :
  Unity Step Fade STEP

Details :
This method will fade to black or white
STEP = The speed to fade. If negative the fade will go to white, if positive, it will run to black

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. 

Command Name : Unity Fade

Syntax :
  Unify Fade SLOWDOWN

Details :
This method will fade to black or white
SLOWDOWN = will define the speed used to fade to black or white. Real gradient shift = 1/SLOWDOWN. Method will go to white if value is negative, and it will fade to white of value is positive.

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. 

Command Name : Unity Fade To Palette

Syntax :
  Unity Fade To Palette BANK,STEP  

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.

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.