STAR TREK 2d20
Page 1 of 44 12311 ... Last
  1. #1
    Trenloe's Avatar
    Join Date
    May 2011
    Location
    Colorado, USA
    Posts
    33,291

    Enhanced Images (layers) for FG 3.0 CoreRPG (and rulesets based on CoreRPG)

    FG Classic only. Do not use in Unity.

    With the advent of FG 3.0 and the CoreRPG ruleset layer architecture I have updated Dr Zeuss's excellent Enhanced Images extension to work with this new architecture. For those who aren't aware of this extension, it provides 3 layers within an image - primarily useful for putting tokens on 3 different layers and stopping them messing with each other (known as token stacking issues). This functionality can be useful if the GM wants to use mapping tokens to draw maps on the fly or use larger tokens for underlying image functionality - a good example is a ship token on a sea/river image - put the ship token on the middle layer and all of the PC/NPC tokens on the top layer and there are no token stacking/selection issues.

    v2.1.6 February 16th, 2021 FGC v2021-02-01 release compatibility updates.

    *** Please make sure you run this extension only with compatible rulesets and extensions. For example, this is not compatible with the 5E Combat Enhancer extension - as the layer code is incorporated in that extension.


    Previous versions:

    v2.1.5 March 5th, 2020 Further v3.3.10 compatibility fixes.

    v2.1.4 March 4th, 2020 FG v3.3.10 compatibility hotfix.

    v2.1.3a December 15th, 2019. Changed load order from 10 to 50 to cater for other extensions that may clash. If you experience issues with this change please revert to the previous version.

    v2.1.3 February 12th, 2019. Movement of named tokens (tokens added from the CT or tokens given a name) on the top (play) layer will move the related shadow token on the lower layer (image or features_image).

    v2.1.2 January 4th, 2019. v3.3.7 compatibility update - now works correctly on the two new desktop panels (back panel and full panel). Note: resize to grid is only available in the window mode, as the two panels do not have any resize controls available via the right-click menu.

    v2.1.1b July 11th, 2018. Read only maps will open with the bottom (image) layer enabled so that links created in an original non-layered image module can be selected. Note - this could break any personally created read-only modules with links on the top layer!

    v2.1.1a April 21st, 2018. Update for encounter token placement on bottom layer.

    v2.1.1 April 2018. Update for FG v3.3.5 compatibility. Issue fixed: https://www.fantasygrounds.com/forum...l=1#post386219

    v2.1.0 March 2018. Re-mastering of the extension, targeting removed on base and features layers. Support for Savage Worlds. Thanks to Ikael.

    V2.0.5e May 31st, 2017: Very minor update. Base image control now has a minimum size of 200x200 pixels. Don't use maps smaller than this.

    V2.0.5d May 9th, 2017: Very minor update. Resize to grid functionality now caters for dynamic toolbars and different sized image window frames to display the full, resized, image. Details here: https://www.fantasygrounds.com/forum...l=1#post340247

    V2.0.5c April 23rd, 2017: Fix for getDatabaseNode script errors raised when adding tokens or navigating layers after one image window had been closed. Errors reported here: https://www.fantasygrounds.com/forum...l=1#post334171

    V2.0.5b April 15th, 2017: Minor update to include /tvsize syntax info. More details on /tvsize and the auto size to grid functionality here: https://www.fantasygrounds.com/forum...-To-Face-games

    V2.0.5a April 14th, 2017: Added map resize extension functionality. Info here: https://www.fantasygrounds.com/forum...-To-Face-games

    V2.0.5 April 14th, 2017: Updated for Fantasy Grounds 3.3.0 compatibility.

    V2.0.4 January 19th, 2017: Updated for Fantasy Grounds 3.2.2 compatibility.

    V2.0.3 November 20th, 2016: Updated for Fantasy Grounds 3.2.1 plus set original size issue fix and zoom icon mismatch.

    V2.0.2 November 4th, 2016: Updated for Fantasy Grounds 3.2.0 and token shadow functionality (inc scaling + orientation).

    V1.0.8 November 5th, 2015: Updated for Fantasy Grounds 3.1.3.

    V1.0.7 August 6th, 2015: Updated for Fantasy Grounds 3.1.2.

    V1.0.6 1st June 2015: Updated for Fantasy Grounds 3.1.0.

    V1.0.5 25th September 2014: Updated for Fantasy Grounds 3.0.8.

    V1.0.3 June 2014: Updated for Fantasy Grounds 3.0.4 and minor bug fix.

    V1.0.2 10th March 2014: Updated for Fantasy Grounds 3.0.3.

    The extension adds a "layer" icon to all images on the GM side - which when clicked reveals 3 icons that an be used to access (from left-to-right) the base, middle and top layers. Dr Zeuss shows how the original extension works in a video in this post: https://www.fantasygrounds.com/forum...l=1#post114668

    NOTE: Currently does not work with hex grids - only square or no grid images.

    Things to note:
    • This extension shows in Fantasy Grounds as "Enhanced Images (CoreRPG+)" and will be selectable for all rulesets, however it will only work for rulesets layered on top of the FG 3.0 CoreRPG base ruleset.
    • Use only square grids or no grids. Hex grids will not work and will raise script errors.
    • This *should* be compatible with previous extensions - so campaign images with layers from previous versions should work OK.
    • Players can only interact with the top layer - GMs must put PC and NPC tokens on this top layer otherwise players can't move their PCs or target NPCs.
    • Masking only works on the base layer - and then only when the map/image is based on an image file (this is the usual FG mask functionality - you can't mask a freehand drawing).
    • As masking only works on the base layer, anything that the GM wants to mask should be put on the base layer - tokens that are used for mapping, etc.. If you want to hide NPC tokens don't put them on the base layer, put them on the top layer and use the individual token "visibility" setting (or the visibility setting for the NPC in the combat tracker) to hide/reveal the token to the players.
    • Grid settings (on/off), offset and size are the same across all 3 layers - there is 1 grid throughout. Other grid functionality is specific to an individual layer - lock tokens, snap-to grid, etc.. Be careful which layer you change these settings on as you will have to be on the same layer if you want to change them later.
    • Drawing (and erasing of a drawing) only works on the top layer. Drawings are never masked so there is no point in having drawings on any layer other then the top layer - this helps to keep memory use down too.
    • If you open an image that was from a campaign that was created without the layer extension then everything will be on the base layer. With the exception of the grid - this will be synchronised across all layers.
    • Issue: GMs can select targeting on the lower layers (if there are tokens on those layers) - but I don't think this will work in any way, especially as PC and NPC tokens should be on the top layer anyway. Essentially the targeting arrows will appear if the GM "targets" a token on any layer. This could be confusing so GMs should keep an eye on this... I hope to be able to limit targeting to the top layer only in the future.
    • Shortcuts (pushpin) that link to campaign entries can be put on any layer - but they are only active (can be selected) on that layer, even though they are viewable on the higher layers. Note: If you open an image from a module that has pushpins these will be visible across all layers but only selectable on the base layer.
    • For encounters with token placement created in a campaign that didn't use this extension (or a previous version) the extension will convert the token placement layer to the top layer on-the-fly so that the NPC tokens are placed on the correct layer. The original encounter record is not changed. Note: this will only work for placement on maps/images that have already been opened within the campaign with the extension enabled - so the play_image layer already exists. If the map hasn't been opened with the extension enabled then an error will be raised and the tokens won't appear on the map.
    • Grid drawing mode will be remembered when you leave and return to a layer - i.e. if activated mask mode will remain active on the bottom layer and drawing/erasing mode will remain active on the top layer. The mask, draw and erase icons will reflect what state is active on which layer.
    • New Token Shadow functionality: Adds shadows of the tokens on the higher levels when you activate a lower level - this aids in lower layer token placement and unmasking. These "shadows" are actually tokens set to invisible, so they are tokens and you will have the usual token stacking issues with these shadow tokens. You can move them out of the way, they don't impact the original tokens they shadow.


    Any questions/issues please post in this thread.

    The issues list is contained in the next post.
    Attached Files Attached Files
    Last edited by Trenloe; February 16th, 2021 at 22:44. Reason: Updated extension file with v2.15 reflected in the chat window message
    Private Messages: My inbox is forever filling up with PMs. Please don't send me PMs unless they are actually private/personal messages. General FG questions should be asked in the forums - don't be afraid, the FG community don't bite and you're giving everyone the chance to respond and learn!

  2. #2
    Trenloe's Avatar
    Join Date
    May 2011
    Location
    Colorado, USA
    Posts
    33,291

    Issue List

    The following is a list of issues in the current release v1.0.1:

    1. Hex grids do not work. Square and no grids are OK. There may be a work around of setting a square grid first, then changing it - some info here: https://www.fantasygrounds.com/forum...l=1#post314922
    2. Blank (new images without an image file) are sized at 200x200 (to avoid another issue where images would zoom into the top left 200x200 area when zooming for the first time). The "expand drawing" functionality (on the bottom layer only) can be used to expand the image in size, but the layers then need to by synced - close and open the image and zoom in/out once to sync the layers.
    3. Pins put on a map without using the extension are placed on the bottom layer when using the extension - they can be seen on all layers, but only selected by the GM on the base layer.
    4. Pre-placement of encounter tokens on the middle layer will raise an error when activating the encounter. Not planning on fixing as this is not what encounter pre-placement is primarily used for - more info here: https://www.fantasygrounds.com/forum...l=1#post239794
    5. Double grid alignment issue when image fully zoomed out. One "notch" zoom in appears to fix issue. Details here: https://www.fantasygrounds.com/forum...l=1#post296034 Workaround - zoom in one notch.
    6. Middle and Top layers do not get exported into a module. This is being blocked by the FG architecture and there is no API method to get around this. Note: as the only "thing" that gets exported with an image is the pushpin links (not tokens or drawings) this issue only effects pushpins. Workaround: for images you want to export, put pushpins on the lowest layer. If you *really* want pushpins in a module on a layer other then the bottom layer, do the initial export and then manually copy the two additional two layer entries from the campaign db.xml to the module db.xml, then repackage the module.
    7. When a player opens an image/map that the GM currently has open it will sync the center and zoom to that of the GM view. The player can zoom/pan and use as normal once open.
    8. No longer compatible with Savage Worlds - both SWD and SWADE.
    9. If you revert changes to a module and an image from that module is open, you'll need to close and re-open the image to re-set the layers.





    The following is a list of issues that have been fixed with the version number containing the fix.

    1. v1.0.1 - For images greater than 200x200 the first time the image is zoomed-in it will zoom to the top-left 200x200 section of the image. Zoom-out to the view you want and this should not happen again. This is a result of the default size of the image being removed to fix grid drawing issues.
    2. v2.1.0 - For GMs only: Target selection and targeting arrows can appear on all layer where there are tokens. Ideally this should only occur on the top layer.
    3. v2.1.0 - Not compatible with the Savage Worlds ruleset.


    Future Development

    1. Right-click menu to move token from one layer to another. Targeted for future release. Include ability to select a number of tokens and use <image>.getSelectedTokens() to return a table of tokens to be moved.
    Last edited by Trenloe; July 29th, 2020 at 13:19.
    Private Messages: My inbox is forever filling up with PMs. Please don't send me PMs unless they are actually private/personal messages. General FG questions should be asked in the forums - don't be afraid, the FG community don't bite and you're giving everyone the chance to respond and learn!

  3. #3
    Zeus's Avatar
    Join Date
    Mar 2009
    Location
    Olympus
    Posts
    2,658
    Blog Entries
    2
    Nicely done Trenloe. Thanks for picking this up. I haven't had anytime recently to work on these old extensions.
    FG Project Development
    Next Project(s)*: Starfinder v1.2 Starship Combat

    Current Project:
    Starfinder v1.1 - Character Starships
    Completed Projects: Starfinder Ruleset v1.0, Starfinder Core Rulebook, Alien Archive, Paizo Pathfinder Official Theme, D&D 5E data updates
    * All fluid by nature and therefore subject to change.

  4. #4
    Blackfoot's Avatar
    Join Date
    Oct 2010
    Location
    New Jersey, USA
    Posts
    4,202
    Blog Entries
    4
    Got the following error when I opened my first image.

    Script Error: [string "scripts/imagewindow.lua"]:137: setGridOffset: Grid size is zero

    Hmm.. can't seem to get around it by setting the grid... in fact the same error pops each time I set it.
    Full License Operator - You must have a 'Lite' License to play in my games.
    Member and GM in the Fantasy Grounds Pathfinder Society Group.
    PFS Fantasy Grounds Forum
    FG Community Teamspeak Server: ts.fg-con.com
    Interested in Custom Character Portraits and Tokens? Contact me.

  5. #5
    Trenloe's Avatar
    Join Date
    May 2011
    Location
    Colorado, USA
    Posts
    33,291
    Quote Originally Posted by Blackfoot View Post
    Got the following error when I opened my first image.

    Script Error: [string "scripts/imagewindow.lua"]:137: setGridOffset: Grid size is zero

    Hmm.. can't seem to get around it by setting the grid... in fact the same error pops each time I set it.
    Can you zip up your campaign folder and email it to me please. I've never seen this error. Please include steps to reproduce.
    Private Messages: My inbox is forever filling up with PMs. Please don't send me PMs unless they are actually private/personal messages. General FG questions should be asked in the forums - don't be afraid, the FG community don't bite and you're giving everyone the chance to respond and learn!

  6. #6
    Blackfoot's Avatar
    Join Date
    Oct 2010
    Location
    New Jersey, USA
    Posts
    4,202
    Blog Entries
    4
    I added the extension to an already existing campaign. The map I opened had previously been set up with a HEX grid... beyond that all I did was open the map and the error appeared.
    Full License Operator - You must have a 'Lite' License to play in my games.
    Member and GM in the Fantasy Grounds Pathfinder Society Group.
    PFS Fantasy Grounds Forum
    FG Community Teamspeak Server: ts.fg-con.com
    Interested in Custom Character Portraits and Tokens? Contact me.

  7. #7
    Trenloe's Avatar
    Join Date
    May 2011
    Location
    Colorado, USA
    Posts
    33,291
    Quote Originally Posted by Blackfoot View Post
    I added the extension to an already existing campaign. The map I opened had previously been set up with a HEX grid... beyond that all I did was open the map and the error appeared.
    HEX "grids" currently don't work. Noted in post #1 and added as an issue in #2.

    Thanks for bringing this to my attention. I'll try and address in future.
    Last edited by Trenloe; January 20th, 2014 at 17:33.
    Private Messages: My inbox is forever filling up with PMs. Please don't send me PMs unless they are actually private/personal messages. General FG questions should be asked in the forums - don't be afraid, the FG community don't bite and you're giving everyone the chance to respond and learn!

  8. #8
    Blackfoot's Avatar
    Join Date
    Oct 2010
    Location
    New Jersey, USA
    Posts
    4,202
    Blog Entries
    4
    *Sniff* No one loves HEX grids...
    Full License Operator - You must have a 'Lite' License to play in my games.
    Member and GM in the Fantasy Grounds Pathfinder Society Group.
    PFS Fantasy Grounds Forum
    FG Community Teamspeak Server: ts.fg-con.com
    Interested in Custom Character Portraits and Tokens? Contact me.

  9. #9
    i love hex grids, it is nice feaure no skip this feature plz

  10. #10
    FYI: Latest test release (v3.0.3) seems to cause an issue with the current version of this extension. I get a script error when starting up a 4E campaign. I don't have any more details than that, but disabling the extension removes the script error.

Thread Information

Users Browsing this Thread

There are currently 1 users browsing this thread. (0 members and 1 guests)

Bookmarks

Posting Permissions

  • You may not post new threads
  • You may not post replies
  • You may not post attachments
  • You may not edit your posts
  •  
DICE PACKS BUNDLE

Log in

Log in