@DATABASE "Nucleus.guide"

@NODE Main "Nucleus"

    Nucleus v1.1a

    Copyright © 1995/96 Jon Close. All Rights Reserved.

    @{" CLI           " link CLI}
    @{" Workbench     " link Workbench}

    @{" Introduction  " link Introduction}
    @{" Requirements  " link Requirements}
    @{" Order Form    " link OrderForm}
    @{" Credits       " link Credits}
    @{" Distribution  " link Distribution}
    @{" History       " link History}

    Edit Windows:

    @{" Main          " link Options}
    @{" Edit          " link Edit}
    @{" ToolBar       " link ToolBar}
    @{" Text Gadget   " link TextGad}
    @{" Image Gadget  " link ImageGad}
    @{" Border        " link Border}
    @{" Text          " link Text}
    @{" Image         " link Image}
    @{" Window        " link Window}
    @{" Menu          " link Menu}
    @{" Palette       " link Palette}


@ENDNODE


@NODE Introduction "Introduction"

     Welcome to version 1.1 of Nucleus. I hope you enjoy using this program.
 This product is in continuous development and I have many ideas and options
 to implement in the future. If you use Nucleus regularly, then please
 support the future of this product by filling in the Registration Form and
 send it to Pixel Digital, along with the Registration Fee of £15.

     If you come across any problems with Nucleus, please contact either
 Pixel Digital or the author and explain what the problem is in as much
 detail as possible and give details of what system you are using. Likewise,
 if you have any suggestions for improvements, I would like to hear your
 views. All mail WILL be replied... eventually ;)

    REGISTERED USERS:

    Registered users will receive one free update. Any further updates
 will be available for the reasonable price of £1.00 if you live in the
 UK or £2.00 anywhere else in the world.

    Updates will be available approximately every 4 months.


@ENDNODE

@NODE Requirements "Requirements"

    Nucleus requires...

    the following libraries to be placed in the LIBS: directory

        diskfont.library    v36
        iffparse.library    v37
        amigaguide.library  v34
        reqtools.library    v38

    and the following font to be placed in the FONTS: directory...

        Topal/8
        Topal.font

    ReqTools is Copyright (c) Nico François.
        
@ENDNODE

@NODE OrderForm "Order Form"

    Print out this form, enter your details and send it to Pixel Digital
    along with the registration fee. (If you haven't got access to a
    printer just send your details on a plain piece of paper.)

    NAME    _____________________________________________________________

    ADDRESS _____________________________________________________________ 

    _____________________________________________________________________ 

    _____________________________________________________________________ 

    _____________________________________________________________________ 

    _____________________________________________________________________ 


    WHERE DID YOU HEAR ABOUT NUCLEUS?

    _____________________________________________________________________


    ENTER DETAILS OF YOUR COMPUTER (Type,Memory,Processor,etc.)

    _____________________________________________________________________ 

    _____________________________________________________________________ 

    _____________________________________________________________________ 

    _____________________________________________________________________ 

    _____________________________________________________________________ 


    IS THERE ANYTHING YOU WOULD LIKE
    TO SEE IN FUTURE VERSIONS OF NUCLEUS?

    _____________________________________________________________________ 

    _____________________________________________________________________ 

    _____________________________________________________________________ 

    _____________________________________________________________________ 

    _____________________________________________________________________ 


@ENDNODE

@NODE Credits "Credits"

    Program & Documentation:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Jon Close               
    35 Belfast Rd           
    Old Swan                
    Liverpool 13            
    L13 5SR                 
    Merseyside              
    England                 

    Feel free to contact the author anytime for bug reports, suggestions
    or just to let me know what you think of the program.

    Distribution & Marketing:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Pixel Digital
    Unit 6
    Laurel Business Centre
    15 Laurel Rd
    Liverpool 7
    Merseyside
    England
    0151-259-4017            

    E-Mail: sim@mersinet.co.uk


@ENDNODE

@NODE Distribution "Distribution"

    Nucleus may only be distributed through the following organisations
    including this shareware version...

                Telescan Public Domain
                5th Dimension Licenceware
                Active Software
                Roberta Smith DTP
                Freestyle

    ....we know and trust all companies involved if you would like your
    name added to this list then please phone us on +44-0151-259-4017
    for written permission

    To obtain the full version of Nucleus please send a cheque/POrder
    made payable to J Close at the below address

                Price £8-99 & 50p P&P British Isles
                            & £1-00 P&P International

        Digital Software
        Unit 6,
        Laurel Business Centre,
        15 Laurel Road,
        Kensington,
        Liverpool,
        L7 0LJ.

@ENDNODE


@NODE CLI "CLI"

    Nucleus can be run from the CLI/Shell with the following template...

    Format:    Nucleus [SETTINGS <prefs file>] <data file>

    Template:  Nucleus "SETTINGS/K,FILE"

    Example:   Nucleus SETTINGS=Example.prefs Example.mnu


@ENDNODE

@NODE Workbench "Workbench"

    Nucleus can be run from the Workbench. Only one tooltype is presently
    available.

    * SETTINGS

    This will load the settings you require.

    Example:   SETTINGS=Nucleus.prefs

    If Nucleus is started from a project icon it will first attempt to
    read a settings option from there. If that fails it will then try
    and read a settings option from Nucleus.

@ENDNODE

@NODE Options "Main Window"

    This is the first window you will see upon loading Nucleus.
    From here, you can select what attributes you would like for your
    screen and/or window. Note: If your Edit Window is open and you make
    any changes, it will not be updated until you select "Edit Window"
    again. This is the only window that does not immediately update any
    changes you have made.


    Screen Type:
    ¯¯¯¯¯¯¯¯¯¯¯
    Decide whether you want to use an exising Workbench Screen or Create
    your own. If you opt for Workbench Screen, you will not be able to alter
    the palette, and any screen font you have selected will not be used.


    Screen Mode:
    ¯¯¯¯¯¯¯¯¯¯¯
    Choose the Screen Mode you require. Please note that if you choose a 
    monitor that is not standard on your Amiga (UK Amigas default to PAL,
    US Amigas default to NTSC) you must have that monitor installed before
    running any Executable Menus saved with this program. If you double-click
    on the Screen Mode you require, the size of the Edit Window will be set
    to the size of the screen.


    Overscan:
    ¯¯¯¯¯¯¯¯
    I would suggest you leave this option on either Text or Standard unless
    you are absolutely sure you need a larger screen. Maximum & Video can
    use up to 100k more Chip Mem than standard screens.


    Number Of Colours:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    This option will also affect how much memory is consumed. Try and keep
    the number of colours as low as possible.


    Titles:
    ¯¯¯¯¯¯
    Enter the text you would like to use for the Screen and Window Titles.


    Window Options:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Choose the following gadgets/attributes you want for your Edit Window.

    Close Gadget..
        Adds a Close Gadget to the top left hand corner of your window.

    Depth Gadget..
        Adds a Depth Gadget to the top right corner of your window.

    DragBar..
        Adds a DragBar to the window so that you can move it around.

    BackDrop..
        This turns the Window into a BackDrop Window. You will have no 
        Sizing or Depth control over the window with this option selected.
        Your window will always be behind all other window.

    Zoom Gadget..
        Adds a Zoom Gadget to the top left of the window.

    Size Right..
        Adds a Sizing Gadget to the bottom right hand corner of your window
        with a window bar on the right.

    Size Bottom..
        Adds a Sizing Gadget to the bottom right hand corner of your window
        with a window bar on the bottom.

    Borderless..
        This prevents any borders being used around your window. I recommend
        that you use this option with BackDrop (see above), and unselect any
        of the other window options above. Be careful using a window smaller
        than the size of your screen as you will not be able to see it.


    Screen Options:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    Choose the following gadgets/attributes you want for your Edit Screen.

    DefPubScreen..
        Setting this option will force any programs you run to open their
        window on your own screen instead of Workbench. This will cancel
        the "Private" option when selected.

    Private..
        Setting this option will prevent any other programs opening on your
        screen. This will cancel the "DefPubScreen" option when selected.

    Quiet..
        Set this if you don't want a Title Bar on your screen. This will
        also prevent you from using a Menu Bar.

    Show Title..
        This is used in conjunction with the "BackDrop" option (see above).
        If set, the Screen Title Bar will be seen, otherwise it will remain
        hidden behind your window.


    Edit Window:
    ¯¯¯¯¯¯¯¯¯¯¯
    Hit this button to create/update the options/attributes you have
    selected above. 


    @{" Main Menus " link MainWindowMenu}


@ENDNODE


@NODE Edit "Edit"

    Here you can draw Text Gadgets, Image Gadgets or Borders depending on
    your selection in the Edit Menu. Or you can place Images and Text
    via the Image Window and Text Window respectively.

    Shortcut Keys:
    
    ESC     ....        This will close the Edit Screen & Window.

    F1      ....        Edit @{" Text Gadgets  " link TextGad}
    F2      ....        Edit @{" Image Gadgets " link ImageGad}
    F3      ....        Edit @{" Borders       " link Border}
    F4      ....        Edit @{" Text          " link Text}
    F5      ....        Edit @{" Images        " link Image}
    F6      ....        Edit @{" Window Sizes  " link Window}
    F7      ....        Edit @{" Menus         " link Menu}
    F8      ....        Edit @{" Palette *     " link Palette}

    1       ....        Select Text Gadget Edit-Mode.
    2       ....        Select Image Gadget Edit-Mode.
    3       ....        Select Border Edit-Mode.
    4       ....        Disable Edit-Mode.

    @{" Edit Menus " link EditWindowMenu}

    * Palette Editor is only available when Create New Screen is selected.


@ENDNODE


@NODE MainWindowMenu "Main Menus"

    Project:
    ¯¯¯¯¯¯¯
    Open...
        This opens a requester allowing you to select a new data file to
        be loaded.

    Save
        Save a previously loaded data file.

    Save As...
        This opens a requester allowing you to select a new data file to 
        be saved. (".mnu" will be appended to the end of the name you enter)

    Save Exe...
        This will open a requester allowing you to save a complete,
        single-file, executable menu. Look at the "About..." item on the
        Menu Bar to see what libraries & fonts you will need for your menu
        to run. All executables now support the PUBSCREEN argument when run
        from the CLI. You must have had the "Use Workbench" option set for
        this to work. If the program was set to open its own Custom Screen
        it will use that screen and ignore your CLI arguments.

        Format:   Example.exe [PUBSCREEN <name>]

        Template: Example.exe "PUBSCREEN/K"

        Example:  Example.exe PUBSCREEN Workbench

    Menu
        This will bring the Edit Screen and/or Window to the front.

    About...
        Here you can find the address of either Pixel Digital or the author
        of this great program :-)
        You can also find here a list of libraries and fonts you will need
        for the project you are currently working on.

    Reset
        This will abandon any project you are working on and reset the
        program back to its default options. NOTE: This does not reload
        any Settings so they will remain as they were before reset.

    Quit...
        Err, well, it quits the program.


    Settings:
    ¯¯¯¯¯¯¯¯
    Screen Font...
        Select a Screen font for your Edit Screen & Window...

    Default Screen Font
        Use the same Screen Font as Workbench.

    ToolBar -> ToolBar
                   Decide whether you want the ToolBar open with the Edit
                   Window.

            -> AutoFront
                   If you opt for a Toolbar on the Edit Screen this will
                   keep it in front of any other windows.

            -> Co-Ords
                   This puts the current mouse Co-Ordinates on the title
                   of the ToolBar. Having this option selected will slow
                   down the processing slightly.

    Window PopUp
        If selected, this will open an edit window according to the
        Edit-Mode you have checked on the Edit Window menu bar.

    Overwrite
        If this option is set, you will not be warned when you are about
        to Save either data or executable over an existing file.

    Ignore Borders
        This allows you to draw (using your selected Edit-Mode) in the left
        and top borders surrounding your Edit Window. I recommend you leave
        this unselected.

    Remap Images
        This will automatically remap any images you load in. If you are
        using Workbench as the "Screen Type" Nucleus will remap any images
        using the current Workbench palette, otherwise it will use your
        selected screen palette.

    Confirm Delete
        This will display a requester whenever you try to remove a Gadget,
        Image, Border, a line of Text, or when you clear a Menu Bar. You
        will be asked to confirm your action.


@ENDNODE


@NODE EditWindowMenu "Edit Menus"

    Project:
    ¯¯¯¯¯¯¯
    Help
        Show Online Help.

    Update
        Update the display. Occassionaly, small dots are left on screen
        after highlighting a Gadget or Border. Select this option to render
        the window again.

    Options
        Bring the Main Options window to the front.

    Exit
        Close the Edit Screen and/or Window.

    Editors:
    ¯¯¯¯¯¯¯
    Text Gadget...
        Open the @{" Text Gadget Editor  " link TextGad}

    Image Gadget...
        Open the @{" Image Gadget Editor " link ImageGad}

    Border...
        Open the @{" Border Editor       " link Border}

    Text...
        Open the @{" Text Editor         " link Text}

    Image...
        Open the @{" Image Editor        " link Image}

    Window...
        Open the @{" Window Sizes Editor " link Window}

    Menu...
        Open the @{" Menu Bar Editor     " link Menu}

    Palette...
        Open the @{" Palette Editor      " link Palette}
    

    Edit:
    ¯¯¯¯
    Text Gadget
        Select Text Gadget Edit-Mode.

    Image Gadget
        Select Image Gadget Edit-Mode.

    Border
        Select Border Edit-Mode.

    None
        Disable Edit-Mode.

@ENDNODE


@NODE ToolBar "ToolBar"

    The ToolBar provides a shortcut to some of the functions in the
    Edit Menus, as well as providing a place to display the Co-Ordinates.

    The gadgets in the ToolBar do the following from left to right...

     1. Display the Online Help.
     2. Open the @{" Text Gadget Editor  " link TextGad}
     3. Open the @{" Image Gadget Editor " link ImageGad}
     4. Open the @{" Border Editor       " link Border}
     5. Open the @{" Text Editor         " link Text}
     6. Open the @{" Image Editor        " link Image}
     7. Open the @{" Window Sizes Editor " link Window}
     8. Open the @{" Menu Bar Editor     " link Menu}
     9. Open the @{" Palette Editor      " link Palette}
    10. Activate the Edit Window & bring it to the front.

@ENDNODE


@NODE TextGad "Text Gadget"

    From this window you can edit all the Text Gadgets you have created.
    If any Text Gadgets exist, they will be listed in the listview. Select
    the gadget you wish to edit by moving the mouse over the name/text of
    the gadget and press the left mouse button. The name/text will be
    highlighted in the list and appear in the string gadget. The gadget
    will also be highlighted on the Edit Window so you can check which one
    you are editing. Any changes made here will be updated immediately.

    List:
    ¯¯¯¯
    This is the list of Text Gadgets available for editing. The name
    shown is the text displayed in the Text Gadget itself. Edit the name
    in the string gadget immediately below the list.

    Remove:
    ¯¯¯¯¯¯
    Remove the Text Gadget currently selected in the list.

    Clone:
    ¯¯¯¯¯
    Create a new Text Gadget identical to the currently selected gadget
    in the list. The Editor will be moved behind any other windows and a
    standard border will appear on the Edit Window. Press the left mouse
    button where you want to place the new gadget. If you have "Window
    PopUp" selected in the Settings menu the Editor window will be brought
    to the front again. Use the right mouse button to cancel cloning.

    Move:
    ¯¯¯¯
    Move the selected Text Gadget to another part of the Edit Window. As
    with cloning, the Editor window will be moved to the back until you
    press the left mouse button to accept or right mouse button to cancel.

    Size:
    ¯¯¯¯
    Resize the selected Text Gadget. Once again, the Editor window will be
    moved to the back until you press the left mouse button to accept or
    right mouse button to cancel.

    Left Edge:
    ¯¯¯¯¯¯¯¯¯
    Change the Left Edge of the gadget for pixel perfect alignment.

    Top Edge:
    ¯¯¯¯¯¯¯¯
    Change the Top Edge of the gadget.

    Width:
    ¯¯¯¯¯
    Change the Width of the gadget.

    Height:
    ¯¯¯¯¯¯
    Change the Height of the gadget.

    Font:
    ¯¯¯¯
    Select a font you would like to use for your gadget. You can use a
    separate font for each gadget.

    Default:
    ¯¯¯¯¯¯¯
    Select this if you want to use the standard Screen Font.

    Place Text:
    ¯¯¯¯¯¯¯¯¯¯
    Place your text Above, Below, Left of, Right of, or In the gadget.    

    Command:
    ¯¯¯¯¯¯¯
    See @{" Command " link Command}


@ENDNODE


@NODE ImageGad "Image Gadget"

    From this window you can edit all the Image Gadgets you have created.
    If any Image Gadgets exist, they will be listed in the listview. Select
    the gadget you wish to edit by moving the mouse over the name of the
    gadget and press the left mouse button. The name will be highlighted in
    the list and appear in the string gadget. The gadget will also be
    highlighted on the Edit Window so you can check which one you are
    editing. Any changes made here will be updated immediately.

    List:
    ¯¯¯¯
    This is the list of Image Gadgets available for editing. The name shown
    is for your benefit only. Use it to help identify the gadget.

    Remove:
    ¯¯¯¯¯¯
    Remove the Image Gadget currently selected in the list.

    Clone:
    ¯¯¯¯¯
    Create a new Image Gadget identical to the currently selected gadget
    in the list. The Editor will be moved behind any other windows and a
    standard border will appear on the Edit Window. Press the left mouse
    button where you want to place the new gadget. If you have "Window
    PopUp" selected in the Settings menu the Editor window will be brought
    to the front again. Use the right mouse button to cancel cloning.

    Move:
    ¯¯¯¯
    Move the selected Image Gadget to another part of the Edit Window. As
    with cloning, the Editor window will be moved to the back until you
    press the left mouse button to accept or right mouse button to cancel.

    Size:
    ¯¯¯¯
    Resize the selected Image Gadget. Once again, the Editor window will be
    moved to the back until you press the left mouse button to accept or
    right mouse button to cancel.

    Adjust:
    ¯¯¯¯¯¯
    Adjust the size of the gadget according to the Images you have selected
    for the rendering. The gadget will be resized to the maximum required
    by both images.

    Highlighting:
    ¯¯¯¯¯¯¯¯¯¯¯¯
    No Highlighting
        Do not show any highlighting when gadget is clicked.

    Complement
        Render gadget in opposite colours when clicked.

    Highlight with Box
        Draw a Box around the gadget when clicked.
        
    Alternate Image
        Display an Alternate Image (Select Render) when clicked.

    Left Edge:
    ¯¯¯¯¯¯¯¯¯
    Change the Left Edge of the gadget for pixel perfect alignment.

    Top Edge:
    ¯¯¯¯¯¯¯¯
    Change the Top Edge of the gadget.

    Width:
    ¯¯¯¯¯
    Change the Width of the gadget.

    Height:
    ¯¯¯¯¯¯
    Change the Height of the gadget.

    Gadget Render:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯
    Select the image you want to see before clicking on the gadget. All
    images are loaded in via the @{" Image Editor " link Image}

    Select Render:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯
    Select the image you want to see when you click on the gadget. You need
    to select "Alternate Image" for the highlighting.

    Command:
    ¯¯¯¯¯¯¯
    See @{" Command " link Command}


@ENDNODE


@NODE Border "Border"

    From this window you can edit all the Borders you have created. If any
    Borders exist, they will be listed in the listview. Select the border
    you wish to edit by moving the mouse over the name of the gadget and
    press the left mouse button. The name will be highlighted in the list
    and appear in the string gadget. The Border will also be highlighted
    on the Edit Window so you can check which one you are editing. Any
    changes made here will be updated immediately.

    List:
    ¯¯¯¯
    This is the list of Borders available for editing. The name shown is
    for your benefit only. Use it to help identify the Border.

    Border Type:
    ¯¯¯¯¯¯¯¯¯¯¯
    Button
        Select a Button Border. 

    Ridge
        Select a Ridge Border (as used in String Gadgets).

    DropBox
        Select a DropBox Border.

    Recessed
        This can be used in conjunction with any of the above borders.

    Border Sizes:
    ¯¯¯¯¯¯¯¯¯¯¯¯
    Left Edge
        Change the Left Edge of the Border for pixel perfect alignment.

    Top Edge
        Change the Top Edge of the Border.

    Width
        Change the Width of the Border.

    Height
        Change the Height of the Border.

    Remove:
    ¯¯¯¯¯¯
    Remove the currently selected Border.

    Clone:
    ¯¯¯¯¯
    Create a new Border identical to the currently selected Border in the
    list. The Editor will be moved behind any other windows and a standard
    border will appear on the Edit Window. Press the left mouse button
    where you want to place the new Border. If you have "Window PopUp"
    selected in the Settings menu the Editor window will be brought to
    the front again. Use the right mouse button to cancel cloning.

    Move:
    ¯¯¯¯
    Move the selected Border to another part of the Edit Window. As
    with cloning, the Editor window will be moved to the back until you
    press the left mouse button to accept or right mouse button to cancel.

    Size:
    ¯¯¯¯
    Resize the selected Border. Once again, the Editor window will be
    moved to the back until you press the left mouse button to accept or
    right mouse button to cancel.


@ENDNODE


@NODE Text "Text"

    The Text Editor allows you to create lines of Text using the Font
    of your choosing. 

    List:
    ¯¯¯¯
    This is the list of Text available for editing. The name shown is the
    Text that you wish to place on the Edit Window. Change the Text in the
    string gadget directly below the list.

    DrawMode:
    ¯¯¯¯¯¯¯¯
    Choose the type of rendering for your Text (JAM1, JAM2 or COMPLEMENT).

    Inverted:
    ¯¯¯¯¯¯¯¯
    Select to Invert the DrawMode rendering.

    Font:
    ¯¯¯¯
    Select a font you would like to use for your Text. You can use a
    separate font for each line of Text.

    Default:
    ¯¯¯¯¯¯¯
    Select this if you want to use the standard Screen Font.

    Colour:
    ¯¯¯¯¯¯
    Select the colour for your Text.

    Left Edge:
    ¯¯¯¯¯¯¯¯¯
    Change the Left Edge offset.

    Top Edge:
    ¯¯¯¯¯¯¯¯
    Change the Top Edge offset.

    Add:
    ¯¯¯
    Create a new line of Text. A max of 256 characters per line is possible.

    Remove:
    ¯¯¯¯¯¯
    Remove currently selected Text.

    Place:
    ¯¯¯¯¯
    Place currently selected Text on the Edit Window. The Text Editor will
    be moved behind any other windows and a your Text will appear on the
    Edit Window. Press the left mouse button where you want to place the
    Text. If you have "Window PopUp" selected in the Settings menu the
    Editor window will be brought to the front again. Use the right mouse
    button to cancel.


@ENDNODE


@NODE Image "Image"

    From this Editor you can load Images and use them for Image Gadgets, or
    as backgrounds for your menu. Be careful not to use too many Images
    per Menu as they increase the size of your executable enormously. Take
    a look at the Nucleus.exe example on the disk. That saves out at over
    300K. I did consider adding some kind of compression to the executables,
    but decided against it, for the time being anyway. You would be better
    using CrunchMania or PowerPacker to keep the size down.

    Image List:
    ¯¯¯¯¯¯¯¯¯¯
    List of Images available for use as an Image for an Image Gadget, or as
    a background Image.

    Add:
    ¯¯¯
    Load Images. Only IFF supported at the moment. I may add support for
    datatypes. Write to me if you want it.

    Remove:
    ¯¯¯¯¯¯
    Remove currently selected Image.

    Place:
    ¯¯¯¯¯
    Place currently selected Image on the Edit Window. The Image Editor will
    be moved behind any other windows and a standard border will appear on
    the Edit Window. Press the left mouse button where you want to place the
    Image. If you have "Window PopUp" selected in the Settings menu the
    Editor window will be brought to the front again. Use the right mouse
    button to cancel. Each Image can be placed multiple times, so you can
    create a complete backround out of a small brush. Do this to keep the
    size of your executable menus down to a minimum.
    
    View:
    ¯¯¯¯
    View currently selected Image. Palette will be changed to that of
    Image while it is displayed.

    Remap:
    ¯¯¯¯¯¯
    Remap selected image.

    Pattern:
    ¯¯¯¯¯¯¯¯
    Use the selected image as a background pattern to fill your edit window.
    (Users with Kickstart 3 will have their selection highlighted.)

    Image Position List:
    ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯
    This is the list of Images that have been placed using the button
    above. When you select an item here, the Image will be highlighted
    on the Edit Window.

    Move:
    ¯¯¯¯
    Move the Image Position to another part of the Edit Window.

    Remove:
    ¯¯¯¯¯¯
    Remove the currently selected Image Position.

    Up:
    ¯¯¯
    Change the priority of the selected position. The higher up the list,
    the lower the priority.

    Down:
    ¯¯¯¯¯
    Change the priority of the selected position. The lower down the list,
    the higher the priority.

    Left Edge:
    ¯¯¯¯¯¯¯¯¯
    Change the Left Edge offset.

    Top Edge:
    ¯¯¯¯¯¯¯¯
    Change the Top Edge offset.


@ENDNODE


@NODE Window "Window"

    From here, you can change the size and position of your window. Useful
    if you have no DragBar or Sizing gadgets selected.

    Limits:
    ¯¯¯¯¯¯
    You only need take notice of these if you have a Sizing Gadget on your
    Edit Window. If you set any of these to 0 it will prevent it from
    being sized in a particular direction. (i.e. If you set Min Width to 50,
    Max Width to -1, Min Height to 0, and Max height to 0 you will only be
    able to resize the Edit Window horizontally)

    Min Width
        Change the Minimum Width of the Edit Window.

    Max Width
        Change the Maximum Width of the Edit Window. (Max. Possible = 65535)

    Min Height
        Change the Minimum Height of the Edit Window

    Max Height
        Change the Maximum Height of the Edit Window. (Max. Possible = 65535)

    Zoom:
    ¯¯¯¯
    If you set all the Zoom sizes to 0, it will default to 1/3 Width of the
    screen and the Height of the Title Bar.

    Left Edge
        Change the Left Edge of Edit Window when Zoomed.

    Top Edge
        Change the Top Edge of Edit Window when Zoomed.

    Width
        Change the Width of Edit Window when Zoomed.

    Height
        Change the Hight of Edit Window when Zoomed.

    Window:
    ¯¯¯¯¯¯
    These are the standard dimensions the Edit Window will use when opened.

    Left Edge
        Change Left Edge of Edit Window.

    Top Edge
        Change Top Edge of Edit Window.

    Width
        Change Width of Edit Window.

    Height
        Change Height of Edit Window.

    OK:
    ¯¯
    Accept changes and close Window Sizes Editor.

    Update:
    ¯¯¯¯¯¯
    Update new Window Sizes.

    Cancel:
    ¯¯¯¯¯¯
    Cancel any recent changes.


@ENDNODE


@NODE Menu "Menu"

    This Editor allows you to create a Menu Bar using whatever Font you
    prefer. All changes will be updated immediately. You may find that
    there is a slight delay when creating a large number of Titles & Items.

    Add:
    ¯¯¯
    Add a new Title to the Menu Bar.

    Remove:
    ¯¯¯¯¯¯
    Remove currently selected Title and any associated Items.

    Up:
    ¯¯
    Move currently selected Title up.

    Down:
    ¯¯¯¯
    Move currently selected Title down.

    Font:
    ¯¯¯¯
    Select a font you would like to use for your Menu Bar. You can only
    use one font for all the Items in a Menu Bar.

    Default:
    ¯¯¯¯¯¯¯
    Select this if you want to use the standard Screen Font.

    Colour:
    ¯¯¯¯¯¯
    Select the colour of the text in the Menu Bar.

    Clear Menus:
    ¯¯¯¯¯¯¯¯¯¯¯
    Remove all Menu Titles and Items.

    Add:
    ¯¯¯
    Add an Item to the currently selected Title.

    Remove:
    ¯¯¯¯¯¯
    Remove the currently selected Item.

    Up:
    ¯¯
    Move the currently selected Item up.

    Down:
    ¯¯¯¯
    Move the currently selected Item down.

    ShortCut:
    ¯¯¯¯¯¯¯¯
    Enter a character to use as a ShortCut to emulate an Item selection.

    Bar Label:
    ¯¯¯¯¯¯¯¯¯
    Make this Item a Bar Label. This is not selectable, so don't bother
    entering a command.

    Command:
    ¯¯¯¯¯¯¯
    See @{" Command " link Command}


@ENDNODE


@NODE Palette "Palette"

    From here you can change the palette to your own preferences, grab a
    palette from an open Screen, or an Image you have loaded previously.

    Palette:
    ¯¯¯¯¯¯¯
    Select the colour that you would like to change. The colour is
    displayed in a box on the left hand side.

    R:
    ¯
    Increase or decrease the amount of Red in the selected colour.

    G:
    ¯
    Increase or decrease the amount of Green in the selected colour.

    B:
    ¯
    Increase or decrease the amount of Blue in the selected colour.

    Lock Colour:
    ¯¯¯¯¯¯¯¯¯¯¯
    Lock the currently selected colour. This will prevent you from altering
    the selected colour manually or by grabbing an Image or Screen palette.

    OK:
    ¯¯
    Accept all changes you have made.

    Reset:
    ¯¯¯¯¯
    Restore colours back to those when you opened the Palette Editor.

    Grab:
    ¯¯¯¯
    See @{" Grab Palette " link Grab}

    Pens:
    ¯¯¯¯¯
    See @{" Screen Pens " link Pens}

    Cancel:
    ¯¯¯¯¯¯
    Cancel any changes you have made and restore colours back to those when
    you opened the Palette Editor.


@ENDNODE

@NODE Grab "Grab Palette"

    List:
    ¯¯¯¯
    You will either see a list of available Screens to grab a palette from
    or a list of Images if you have loaded any.

    Grab from...:
    ¯¯¯¯¯¯¯¯¯¯¯¯
    Choose to grab a Screen Palette or Image Palette.

    Grab:
    ¯¯¯¯
    OK, Grab the palette. If you dont like the palette just select Cancel
    or Reset on the @{" Palette Editor " link Palette}

@ENDNODE

@NODE Pens "Screen Pens"

    Palette:
    ¯¯¯¯¯¯¯¯
    Choose the colour you would like for the selected Screen Pen.

    Screen Pens:
    ¯¯¯¯¯¯¯¯¯¯¯¯
    The list of currently available Screen Pens.

    OK:
    ¯¯¯
    Accept any changes.

    Update:
    ¯¯¯¯¯¯¯
    Accept changes, but keep window open.

    Default:
    ¯¯¯¯¯¯¯¯
    Reset to default screen pens.

    Reset:
    ¯¯¯¯¯¯
    Reset screen pens to the way they were when the window was last opened.

    Cancel:
    ¯¯¯¯¯¯¯
    Cancel any changes you have made since window was last opened.

    NOTE: When the screen is closed and reopened to reflect any changes
          in the screen pens, whatever palette is currently being used
          will remain and will not be able to be reset.

@ENDNODE

@NODE Command "Command"

    Type:
    ¯¯¯¯
    Select the type of command you want to execute/run.
    
    AmigaDOS
        Run a standard DOS command. The command will be run asynchronously
        so you can continue to use your menu. If the command needs to
        display any output, a Shell window will be opened. If you want to
        prevent any output to a shell then redirect the command to NIL:

        (e.g. The following command will read all the files and directories
        in the current directory but no window will be opened to show them.
    
        Dir >NIL: ALL

        Just remove the NIL: part to have a window opened.)

    Script
        Execute a script file. You will not be able to use your menu while
        this file is processed.

    Arexx
        Execute an Arexx script. If you want to use Arexx you will need
        RexxMast running on your system and the following libraries...

            rexxsyslib.library
            mathieeedoubbas.library

        If these libraries cannot be found, the program will not fail
        but you will not be able to execute any Arexx scripts.

    Internal
        See @{" Internal " link Internal}

    Command:
    ¯¯¯¯¯¯¯
        Enter the command you want to be run. If you would prefer to select
        your command via a requester then press the button on the left hand
        side of the string gadget.

    Action:
    ¯¯¯¯¯¯
        This is the Action that will be taken when you select the command
        being processed. You have the choice of...

            None
                No Action will be taken.

            Quit
                Quit program after running/executing command string.

            Iconify
                Iconify program after running/executing command string.

            WBToFront
                Bring Workbench Screen to the front.


@ENDNODE

@NODE Internal "Internal Commands"

The following are available for use as INTERNAL commands:

    Iconify:
    ¯¯¯¯¯¯¯
    This will Close your menu temporarily and add an AppIcon to the
    Workbench. Just double-click the Icon to Re-Open.
    (NOTE: If Workbench is not loaded then this option will do nothing)

    Quit:
    ¯¯¯¯
    This will close the program down completely.

    ShowReq:
    ¯¯¯¯¯¯¯
    This is a simple requester to show a short amount of text. Use \\n
    within the text to use a new line.

    e.g. Draw a Gadget and select Internal as the type of command to use.
         Enter the following line of text into the Command string gadget
         exactly as it is shown below;

           ShowReq This is the first line.\\nThis is the second line.

         Now save a new executable menu and run it. When you click on the
         gadget you created you will see a requester like this...

                       ______________________________
                      |Nucleus                     | | 
                      |¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯|
                      |   This is the first line.    |
                      |   This is the second line.   |
                      |             ----             |
                      |            | OK |            |
                      |             ----             |
                       ¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯¯

    WBToFront:
    ¯¯¯¯¯¯¯¯¯
    Bring the Workbench Screen to the front.

@ENDNODE

@NODE History "History"

    Nucleus v1.0 BETA (16-Oct-95)

    -   Released for review purposes only.

    Nucleus v1.0 (18-Nov-95)

    -   Now works properly on WB2.

    Nucleus v1.0a (11-Dec-95)

    -   Script files were not being executed correctly.

    -   Data & Exe Icons could not be located occasionally.

    Nucleus v1.1 (13-Apr-96)

    -   View window will now close by pressing a key.

    -   "Confirm Delete" added to settings.

    -   Screen Pens Editor added, available through the Palette Editor.

    -   "Remap" images added to Image Editor.

    -   "Remap Images" option added to settings.

    -   Background "Pattern" added, available through the Image Editor.

    -   All window rendering has been enhanced due to above improvement.

    -   Some minor internal optimizations.

    Nucleus v1.1a (23-Apr-96)

    -   The offset coordinates for the images were calculated incorrectly
        when the edit window was first opened. When the window was updated
        all the images would move to their correct positions. This also
        happened with all the executables.

@ENDNODE
