
  Functions Available:-
  ---------------------

If this code is _sourced_ into Python then the 'ESC.' prefix can be omitted.
If this is considered a module then it is called as 'ESC.function(?)'

               !!!READ THE CODE FOR MUCH MORE INFORMATION!!!
               ---------------------------------------------

IMPORTANT NOTE! To remove the end newline in Python 3.x.x 'print()'; USE:-
>>> print(ESC.cls()+"A test line before the prompt if needed...", end="")
A test line before the prompt if needed...>>> _

# ********************************* GENERAL. ********************************
# For almost any platform that has a Python from Version 1.3.0 to 3.15.0b3. *
# ---------------------------------------------------------------------------
#            (For the word 'prefix' _read_ the word 'attribute'.)
#
# General functions:-
# -------------------
#
default()			Displays ALL the Python builtin escape codes.

tr()				Terminal Reset.

ctr()				Complete Terminal Reset. 

cls()				Clear the screen/window, ONLY.

ra()				Reset all attributes only to the default.

pfb(prefix=0, fg=31, bg=40)	A Prefix, Foreground colour, and Background
				colour function. For multiple prefixes use
				the 'po()' function below.
				Text appearance, bold/underline/colours etc;
				default values, '0', '31', and '40' for a
				stock AMIGA A1200(HD), and Python 1.4.0.
				Read the 'Prefix_for_pfb_function.txt' for
				much more information.
				! IMPORTANT !
                                Only one Prefix is allowed in this function
				along with the foreground and background
				colour values. If you need more add the
				'po()' function with the relevant numerical
				value below.
				---------------------------------------------
				! REMEMBER !
				A classic stock AMIGA A1200(HD) only has the
				first 4 Workbench colours in default STOCK
				mode. You will need to increase the number of
				Workbench colours to 8 minimum to get full
				usage.

po(prefix=0)			Prefix Only; can be used multiple times to
				obtain your desired text effect[s].
				Single integer argument only of the 'pfb()'
				function above.
				This can be used multiple times to get
				the full usable attributes AND colours one
				requires. See 'po_test()' for an example.
				Valid values for the AMIGA are:-
				0, 1, 3, 4, 7, 22, 23, 24, 27, 30 to 37, 39,
				40 to 47 and finally 49; assuming an 8 or
				greater coloured Workbench.

ca(rows=1, cols=1, mode="f")	Force the Cursor Anywhere in 'rows' and
				'cols', default values '1' for both. 'mode'
				can be either 'f' or 'H' and do the same job.

hm()				Cursor, HOME position ONLY.

cup(y), cdn(y), clt(x), crt(x)	Cursor, up, down, left, right, default value
				'1' for all; any sensible integers here.

generic(your_string='*e[1;33;42m Bold, foreground, and background colours are relative to the platform. *e[0m')
				Generic function to put raw escape codes in a
				complete string setup to use os.system() to
				run it. See the code for more information.
				The string above is in AmigaShell format as
				the default.

# ****************************** INTERMEDIATE. ******************************
# ************** AMIGA USERS! Use this section with caution. ****************
# * These may suit advanced None[-]Commodore AMIGA variants, BUT, BE AWARE! *
# IF you are using a classic AMIGA and have ADE the *NIX emulation then......
# ......'tput civis' turns the cursor OFF, and 'tput cnorm' turns it back ON!
# ---------------------------------------------------------------------------
# Intermediate functions:-
# ------------------------
#
con()				Cursor enabled, ON.

coff()				Cursor disabled, OFF.

ext_col(fg=90, bg=107)		Extended Colours; foreground colour range
				90 to 97, and background colour range 100 to
				107; 'prefix', as in 'pfb()', is not added.
				This is black on white, for any prefixes.....
				.....Use the 'po()' in the 'GENERAL' section
				to obtain any attribute changes you require.

slf(), rlf()			Set Line Feed, Reset Line Feed. Also valid
				for the AMIGA family. NO test for these as
				Python can use a combination of the default
				escape codes to do the same job.

# ******************************** ADVANCED. ********************************
# ******* These are '*NIX' compatible ONLY. !!!NOT FOR AMIGA USERS!!! *******
# Advanced Functions:-
# --------------------
#
graph(graphics="OFF")		Enable 'ON', disable 'OFF' graphics mode.

tb(title="Text here.", ver="your_version", tb="ON")
				Writes to the Title Bar whatever you want!
				'your_version' is a string and can be empty.

fg24(r=0, g=0, b=0)		Foreground 24 bit colour access, each value
				range 0 to 255, default setting as black.

bg24(r=255, g=255, b=255)	Background 24 bit colour access, each value
				range 0 to 255, default setting as white.

fg8(pal=226)			Foreground paletted colour access, the value
				range 0 to 255, default setting is yellow.

bg8(pal=21)			Background paletted colour access, the value
				range 0 to 255, default setting is blue.

te(rows=24, cols=80, mode=8)	Terminal Expansion, 'te()'. Set a size of the
				terminal window almost any size to nearly
				full screen. There are two types 4 and 8, 8
				is the default. I suggest you keep it at 8 as
				that is sized using text rows and columns.
				Default sizing down to 20 rows and 60 colums.

# ***************************************************************************

