
  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. *
# ---------------------------------------------------------------------------
# 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 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. Only one Prefix is
				allowed in this function along with the
				foreground and background colour values.
				---------------------------------------------
				! 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)		Force the Cursor Anywhere in 'rows' and
				'cols', default values '1' for both.

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.

# ****************************** 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.

# ******************************** 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.

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

